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”- 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.
- 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.
- 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.
- 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.
- 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.
- 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. - Á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.
- 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
- 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.
- 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.
- 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.
- 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.
- 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á.
Export és címkenyomtatás
Szekció neve “Export és címkenyomtatás”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.
Szolgáltatástípusok
Szekció neve “Szolgáltatástípusok”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ás | Ké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 locker | A 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.
Vám és nemzetközi szállítmányok
Szekció neve “Vám és nemzetközi szállítmányok”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.
Utánvét (COD)
Szekció neve “Utánvét (COD)”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.
Címkenyomtatás
Szekció neve “Címkenyomtatás”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ás | Mit 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.
Hibaelhárítás
Szekció neve “Hibaelhárítás”| Probléma | Megoldá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ította | A 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 miatt | A 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ű üzenetek | A 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. |