Tovább a tartalomhoz

Nova Post API

A Globe Pickup Points integrálódik a Nova Posttal, így az uniós országokból feladott csomagok rendeléseit közvetlenül a Shopifyból exportálhatja, és a szállítási címkéket is ott nyomtathatja. Ezzel az integrációval a következőket teheti:

  • Rendeléseit közvetlenül a Shopifyból exportálhatja a Nova Posthoz
  • Szállítási címkéket nyomtathat a Shopifyban
  • A pénztárban kiválasztott Nova Post fiókba, csomagautomatába vagy PUDO pontra, illetve a vásárló címére szállíthat
  • Csomagokat szállíthat Ukrajnába, Moldovába és az Egyesült Királyságba a rendelésből készített vámszámlával
  • Utánvétet szedhet be azokon az útvonalakon, ahol a Nova Post ezt kínálja

A Nova Post API integráció aktiválása

Szekció neve “A Nova Post API integráció aktiválása”
  1. A Shopify adminisztrációjában nyissa meg a Globe Pickup Points alkalmazást, és lépjen a Szállítási címkék szekcióba. Kattintson a Szállítói integráció hozzáadása gombra, és válassza a Nova Post lehetőséget.
  2. Adja meg az API-kulcs értékét. A kulcsot a my.novapost.com oldalon hozhatja létre az Integrations, API keys menüpontban, a Nova Post szerződésében megnevezett meghatalmazott képviselőként bejelentkezve.
  3. Válassza ki a Környezet értékét: Éles a valódi küldeményekhez, Fejlesztés a Nova Post tesztkörnyezetéhez. Az éles kulcs csak az Éles, a tesztkulcs csak a Fejlesztés környezettel működik.
  4. Adja meg a Szerződésszám értékét. A küldeményeket Ön fizeti feladóként, és a Nova Post erre a szerződésre számlázza őket. Ha külön szerződése van a nemzetközi szállításra, adja meg a Nemzetközi szerződés száma mezőben. A Globe ezt használja a más országba menő csomagokhoz.
  5. Adja meg a Cég adószáma értékét: a Nova Post szerződésében szereplő szervezet adóazonosítóját, például IČO, NIP vagy Steuernummer. Ennek olyan szervezetnek kell lennie, amelyhez az API-kulcsát létrehozták.
  6. Töltse ki a Feladó cég neve, a Feladó neve (a címkén megjelenő kapcsolattartó), a Feladó telefonszám (teljes nemzetközi szám, például +420777123456), a Feladó e-mail és a Feladó ország mezőt. A feladó országának az EU-ban kell lennie.
  7. Állítsa be, hogyan jutnak el a csomagjai a Nova Posthoz:
    • Fiókban: adja meg a Nova Post fiók a csomagok leadásához mezőben a fiók számát úgy, ahogy a Nova Post mutatja (például 14/1), vagy a részleg azonosítóját (division ID).
    • Futárral az Ön címéről: hagyja üresen a fiókot, és töltse ki a Feladó utca, a Feladó házszám, a Feladó irányítószám és a Feladó város mezőt. A házszámot a Feladó utca mezőbe is beírhatja.
  8. Adja meg az Alapértelmezett hossz milliméterben, az Alapértelmezett szélesség milliméterben és az Alapértelmezett magasság milliméterben értékét. A Nova Post minden csomagnál megköveteli a hosszt, a szélességet és a magasságot, és ezekből számítja a térfogatsúlyt. A Globe ezeket az értékeket küldi minden csomaghoz.
  9. Ha utánvétet kínál, töltse ki az Utánvét (COD) részben leírt utánvétes beállításokat.
  10. A Speciális beállítások megjelenítése alatt beállíthatja a Vámfeltételek (Incoterms), a Feladó EORI száma, az Alapértelmezett szállítmánytartalom leírás, az Alapértelmezett HS kód és az Alapértelmezett súly (kg) értékét. A vámbeállításokat a Vám és nemzetközi szállítmányok rész írja le.
  11. Igény szerint állítsa be a Rendelések automatikus teljesítése, a Rendelések automatikus megcímkézése nyomkövetési számmal és az Egyéni címke az export után lehetőséget.
  12. A Szállítási módok alatt rendelje hozzá a Shopify szállítási módjait a Szolgáltatástípusok részben leírt Nova Post szolgáltatásokhoz. Szállítási módokat a 27 uniós országhoz, Ukrajnához, Moldovához és az Egyesült Királysághoz rendelhet hozzá.

A rendeléseket exportálhatja a Nova Posthoz, és a szállítási címkéket közvetlenül a Shopifyból nyomtathatja, akár tömegesen, akár egyenként. A címkézés menetéről a Szállítási címkék létrehozása oldalon olvashat.

Az első rendelés elküldése előtt a Globe ellenőrzi a beállításokat, és bejelentkezik a Nova Posthoz az Ön API-kulcsával. Ha egy beállítás hiányzik, vagy a Nova Post elutasítja a kulcsot, a Globe egyetlen rendelést sem küld el. A Globe minden rendelésnél azt is ellenőrzi, hogy nincs-e benne olyan adat, amelyet a Nova Post elutasítana, például hiányzó telefonszám vagy házszám. Az ellenőrzésen fennakadó rendelést a Globe nem küldi el, így javíthatja, és újra exportálhatja.

A Globe minden rendelést egy küldeményként, egy csomaggal küld el:

  • Súly: a rendelés súlya 10 g-ra kerekítve (legalább 10 g)
  • Méretek: a beállításokban megadott alapértelmezett hossz, szélesség és magasság
  • Biztosítási érték: a Deklarált érték, alapértelmezés szerint a rendelés végösszege, a rendelés pénznemében
  • Tartalom: a Tartalom leírása, vagy ha az üres, a rendelés termékeinek neve

A címke létrehozásakor a Speciális alatt módosíthatja a küldemény súlyát, deklarált értékét, utánvét-összegét, HS-kódját és tartalomleírását.

A Nova Post egy küldeményszámot ad vissza, például SHCZ0123456789. A Globe ezt nyomkövetési számként tárolja, és minden nyomtatáskor letölti a címkét a Nova Posttól. A nyomkövetési link a küldeményszámban szereplő ország https://novapost.com/en-<country>/tracking/<shipment number>/ oldalát nyitja meg (például SHPL… esetén en-pl), vagy az en-cz oldalt, ha az adott országnak nincs nyomkövetési oldala. Ha a Rendelések automatikus teljesítése be van kapcsolva, a Globe a küldeményszámmal, a Nova Post futárszolgálatnévvel és ezzel a linkkel hozza létre a teljesítést.

Ha a Nova Post nem válaszol időben, vagy megszakad a kapcsolat, lehet, hogy a küldemény már létezik a Nova Postnál, bár a Globe nem kapott hozzá számot. A Globe ilyenkor megjegyzéssel jelöli meg a rendelést, hogy a címke újbóli létrehozása előtt ellenőrizze a my.novapost.com oldalt, és a köteget a következő rendelés előtt leállítja. Az el nem küldött rendelések biztonságosan újra exportálhatók.

A Globe nem törli a küldeményeket a Nova Postnál. Ha törölni szeretne egy küldeményt, ezt a my.novapost.com oldalon teheti meg.


A szállítási módok hozzárendelésekor vagy egy címke létrehozásakor válasszon az alábbi szolgáltatások közül:

SzolgáltatásKézbesítés
Nova Post (branch or parcel locker if selected, otherwise address)A vásárló által a pénztárban kiválasztott Nova Post fiókba, csomagautomatába vagy PUDO pontra. Az átvételi pont nélküli rendelés a vásárló címére megy.
Nova Post courier (address)Mindig a vásárló szállítási címére, akkor is, ha a rendeléshez átvételi pont tartozik.
Nova Post branch or parcel lockerA rendelésen szereplő Nova Post fiókba, csomagautomatába vagy PUDO pontra. Az ilyen pont nélküli rendelést a Globe elutasítja.

Mindkét pontra kézbesítő szolgáltatás elutasítja a másik futárszolgálat hálózatából származó átvételi pontot, ahelyett hogy a vásárló címére küldené a csomagot. Válasszon Nova Post pontot az Átvételi pont módosítása művelettel, vagy hozza létre a címkét a Nova Post courier (address) szolgáltatással.


Átvételi pontok vs. kézbesítés címre

Szekció neve “Átvételi pontok vs. kézbesítés címre”

A pontra kézbesítő szolgáltatások a vásárló által a pénztárban kiválasztott Nova Post fiókba, csomagautomatába vagy PUDO pontra küldik a csomagot. A Globe az adott pont Nova Post azonosítóját küldi el, ezért a pontnak a Globe átvételi pont választójában a Nova Post hálózatából kell származnia. Ha Nova Post pontokat szeretne kínálni a pénztárban, adja hozzá a Nova Postot átvételi pontos futárszolgálatként (lásd: Csomagátvételi pont futárszolgálatok hozzáadása). Azok a Nova Post fiókok, amelyeket egy másik futárszolgálat a saját hálózatában listáz, például a Packeta vagy a Boxpi, az adott futárszolgálat azonosítóit tartalmazzák, és a Globe elutasítja őket.

A Nova Postnak nincsenek fiókjai, csomagautomatái és PUDO pontjai Bulgáriában, Horvátországban, Cipruson, Görögországban, Máltán és Szlovéniában. Az ezekbe az országokba menő csomagok csak a vásárló címére mehetnek.

Címre történő kézbesítésnél a Nova Postnak külön mezőben kell megadni az utcát és a házszámot. A Globe a házszámot az első címsorból (Vinohradská 12/34, 12 rue de la Paix) vagy a második sor elejéről veszi, a házszám után írt lakásszámot (byt 4, m. 5, Apt 2B) pedig lakásszámként küldi el. A házszám, utca, város vagy irányítószám nélküli címet a Globe elutasítja.

A Nova Post minden küldeménynél megköveteli a címzett telefonszámát, a fiókokba és a csomagautomatákba menőknél is. Az országkód nélküli számot a célország számaként értelmezi. A Nova Post elutasítja a lengyel szám (+48) nélküli lengyelországi címzettet és az ukrán szám (+380) nélküli ukrajnai címzettet.


Az EU-t elhagyó csomagokhoz (Ukrajnába, Moldovába vagy az Egyesült Királyságba) vámszámla szükséges. A Globe a rendelésből kitölti a Nova Post saját kereskedelmi számláját. Ezt a címkével együtt kinyomtathatja (lásd: Címkenyomtatás).

A számlán szerepel az áruk teljes értéke, a rendelés pénzneme, a Selling exportálási ok és a beállításokban megadott Vámfeltételek (Incoterms): az alapértelmezett DAP (a behozatali vámot a vásárló fizeti) vagy a DDP (a behozatali vámot Ön fizeti). Minden szállított, árral rendelkező terméksorból egy tétel lesz, a következőkkel:

  • a termék neve a Shopifyból, tételnévként és angol névként is (a Nova Post ezt a nevet angolul várja)
  • mennyiség és egységár
  • a termék Shopifyban megadott HS-kódja, ennek hiányában a címke létrehozásakor megadott HS kód vagy az Alapértelmezett HS kód
  • a termék származási országa, ha meg van adva
  • a csomag súlyának a termék súlya szerinti része, hogy a tételek súlya kiadja a csomag súlyát, ahogy a Nova Post megköveteli

A HS-kódnak legalább 6 számjegyből kell állnia. A Nova Post 8-10 számjegyet fogad el, ezért a Globe a 6 jegyű kódot nullákkal egészíti ki (a 610910 kódból 61091000 lesz). A Moldovába menő csomagok pontosan 10 számjegyet kapnak. Ha egyetlen terméksor sem felel meg, a Globe az egész csomagot egy tételként vallja be a tartalomleírással (vagy Goods szöveggel), a rendelés értékével és a címke létrehozásakor megadott HS kód vagy az Alapértelmezett HS kód értékével.

A Nova Post a HS 210690 (élelmiszer-készítmények, például étrend-kiegészítők) és a HS 630900 (használt ruha) alá tartozó árukat kilogrammban vallja be. A Globe ezeket a tételeket a termék súlyából kilogrammra váltja át. Egy csomagban csak egy ilyen tétel lehet, abból is legfeljebb 10 kg.

Az EU-t elhagyó csomagokhoz a rendelésen a vásárló e-mail-címének is szerepelnie kell. Az Ukrajnába menő csomagokhoz latin betűs Feladó neve szükséges: az ékezetek megengedettek, a cirill és a görög betűk nem. A Feladó EORI száma nem kötelező, de az EU-t elhagyó csomagokhoz ajánlott.


A Nova Post Csehországon, Lengyelországon és Németországon belül, valamint Csehországból, Lengyelországból, Németországból és Szlovákiából Ukrajnába szed be utánvétet. Az utánvétet a Nova Postnak kell engedélyeznie a szerződésén (utánvétes megállapodás).

Ha a rendelés fizetési módja utánvét, a Globe hozzáadja a Nova Post utánvétes szolgáltatását a rendelés még kifizetetlen összegével. Az összeget a címke létrehozásakor az Utánvét összege mezőben módosíthatja.

Töltse ki a következő beállításokat:

  • IBAN az utánvéthez: az a számla, amelyre a Nova Post a beszedett összeget utalja. A kifizetés a Cég adószáma mezőben megadott cégnek megy.
  • Utánvétes megállapodás száma: az utánvétes megállapodás száma. Hagyja üresen, ha csak egy szerződése van.
  • Ki fizeti az utánvét díját: az alapértelmezett Feladó (Ön) vagy a Címzett. Egyeznie kell az utánvétes megállapodással.

A Globe csak akkor küld utánvétet, ha a rendelés a feladó országának pénznemében van: Csehországból CZK, Lengyelországból PLN, Németországból és Szlovákiából EUR. Azt az utánvétes rendelést, amely olyan útvonalon megy, ahol a Nova Post nem szed be utánvétet, más pénznemben van, vagy nincs hozzá érvényes IBAN, a Globe elutasítja, mielőtt bármi létrejönne.


A Globe nyomtatáskor PDF formátumban tölti le a címkéket a Nova Posttól. Két nyomtatási beállítás érhető el:

Nyomtatási beállításMit nyomtat a Globe
10x15 or 10x10 cm (size set by Nova Post)A küldemény címkéje. A méretet a Nova Post határozza meg minden küldeménynél: 100 × 150 mm vagy 100 × 100 mm.
Label + commercial invoice A4 (parcels leaving the EU)A címke, utána pedig minden EU-t elhagyó csomaghoz a Nova Post A4-es kereskedelmi számlája. Az EU-n belüli csomagokhoz csak a címke készül.

Ha több küldeményt nyomtat, a Globe a dokumentumaikat a küldemények sorrendjében egyetlen PDF-be fűzi. A Pozíció a papíron értéke mindig 1.


ProblémaMegoldás
„Nova Post settings are incomplete”Az üzenet felsorolja a hiányzó beállításokat. Töltse ki őket a futárszolgálat beállításaiban, és mentse azokat.
„Globe creates Nova Post labels for senders in the EU”Állítsa a Feladó ország értékét arra az uniós országra, ahonnan szállít.
„The sender phone must be a full international number”Adja meg a Feladó telefonszám értékét országkóddal, például +420777123456.
„The sender address needs a house number”Adja meg a Feladó házszám értékét, vagy állítsa be a Nova Post fiók a csomagok leadásához mezőt.
„Nova Post did not accept the API key” vagy „Nova Post says the API key is not active”Ellenőrizze az API-kulcs és a Környezet értékét: az éles kulcs csak az Éles, a tesztkulcs csak a Fejlesztés környezettel működik. Az inaktív kulcsot a my.novapost.com oldalon kell aktiválni, vagy ezt a Nova Post kapcsolattartója teheti meg.
„Access to the company is forbidden by API key” vagy „Nova Post refused the request for this API key”A Cég adószáma mezőben olyan szervezetnek kell szerepelnie, amelyhez az API-kulcsát létrehozták. Ellenőrizze a kulcsot a my.novapost.com oldalon.
„Recipient phone number is missing”, „Nova Post needs a Polish phone number (+48)” vagy „…a Ukrainian phone number (+380)”Adja meg a vásárló telefonszámát országkóddal a rendelés szállítási címében. A lengyelországi címzetteknek lengyel, az ukrajnai címzetteknek ukrán szám kell.
„Nova Post needs the house number in its own field” vagy „the shipping address needs a street, city and postcode”Egészítse ki a rendelés szállítási címét, a házszámmal együtt.
„Nova Post does not know the recipient’s city”Ellenőrizze a város nevét a szállítási címben.
„Order … has no weight”Adja meg a termékek súlyát a Shopifyban, írja be a súlyt a címke létrehozásakor, vagy állítsa be az Alapértelmezett súly (kg) értékét a speciális beállításokban.
„has no Nova Post branch or parcel locker”, „is not a Nova Post branch or parcel locker” vagy „is not a Nova Post division id”Válasszon Nova Post fiókot vagy csomagautomatát az Átvételi pont módosítása művelettel, vagy a vásárló címére szállításhoz hozza létre a címkét a Nova Post courier (address) szolgáltatással.
„parcels to Ukraine need the sender name in Latin letters”Írja át a Feladó neve értékét latin betűkre.
„Nova Post needs the customer’s e-mail for parcels leaving the EU”Adja hozzá a rendeléshez a vásárló e-mail-címét.
„parcels leaving the EU need an HS code”Adja meg a HS-kódot a terméknél a Shopifyban, vagy állítson be Alapértelmezett HS kód értéket a speciális beállításokban.
A HS 210690 vagy 630900 alá tartozó árut a Nova Post elutasítottaA Nova Post csomagonként egy ilyen tételt fogad, legfeljebb 10 kg-ot, és szüksége van a súlyára. Adja meg a termék súlyát a Shopifyban, vagy ossza el az árut több csomagra a my.novapost.com oldalon.
Az utánvétet a Nova Post elutasította az útvonal vagy a pénznem miattA Nova Post csak az Utánvét (COD) részben felsorolt útvonalakon és pénznemekben szed be utánvétet. Adja fel a rendelést másik futárszolgálattal, vagy a címke létrehozásakor állítsa az Utánvét összege értékét 0-ra.
„no valid IBAN for the collected money” vagy „Nova Post refused the cash on delivery bank account”Ellenőrizze az IBAN az utánvéthez és az Utánvétes megállapodás száma értékét a beállításokban.
„Nova Post did not answer in time”, „did not confirm the shipment” vagy „The connection to Nova Post broke off”Lehet, hogy a küldemény már létezik. A címke újbóli létrehozása előtt ellenőrizze a my.novapost.com oldalt.
„Globe could not connect to Nova Post”, „the Nova Post login did not answer” vagy „Nova Post is limiting requests right now”Semmi sem jött létre. Próbálja újra egy perc múlva.
„Do not create the label again”A Nova Post létrehozta a küldeményt, de a Globe nem tudta elmenteni. Nyomtassa ki a címkét a my.novapost.com oldalon, vagy új címke létrehozása előtt törölje ott a küldeményt.
„Globe stopped before sending order …”A köteg egy korábbi rendelése nem kapott használható választ, vagy nem sikerült elmenteni. Ehhez a rendeléshez semmi sem jött létre, így a címkéje újra létrehozható.
Egyéb, „Nova Post:” kezdetű üzenetekA szöveg a Nova Post ellenőrzéséből származik, és megnevezi az elutasított mezőt. Javítsa a rendelést vagy a beállításokat, és exportáljon újra.
„Error printing Nova Post labels”A részletek mutatják a küldeményszámot és a Nova Post indoklását, például Shipment not found. Ellenőrizze a küldeményt a my.novapost.com oldalon.