Nova Post API
Globe Pickup Points se napojuje na Nova Post a umožňuje exportovat objednávky a tisknout přepravní štítky přímo ze Shopify pro zásilky odesílané ze země EU. S touto integrací můžete:
- Exportovat objednávky do Nova Post přímo ze Shopify
- Tisknout přepravní štítky přímo v Shopify
- Posílat zásilky na pobočku Nova Post, do balíkomatu nebo na místo PUDO vybrané v pokladně, nebo na adresu zákazníka
- Posílat zásilky na Ukrajinu, do Moldavska a do Spojeného království s celní fakturou sestavenou z objednávky
- Vybírat dobírku na trasách, kde ji Nova Post nabízí
Aktivace integrace Nova Post API
Sekce “Aktivace integrace Nova Post API”- Ve své Shopify administraci otevřete Globe Pickup Points a přejděte do sekce Přepravní štítky. Klikněte na Přidat dopravce a vyberte Nova Post.
- Zadejte svůj API klíč. Vytvoříte ho v my.novapost.com v části Integrations, API keys, přihlášeni jako oprávněný zástupce uvedený ve vaší smlouvě s Nova Post.
- Vyberte Prostředí: Produkce pro skutečné zásilky, Vývoj pro testovací prostředí Nova Post. Produkční klíč funguje jen s Produkcí, testovací klíč jen s Vývojem.
- Zadejte Číslo smlouvy. Zásilky platíte vy jako odesílatel a Nova Post je účtuje na tuto smlouvu. Pokud máte samostatnou smlouvu pro mezinárodní přepravu, zadejte ji do pole Číslo mezinárodní smlouvy. Globe ji pak použije pro zásilky do jiné země.
- Zadejte IČO firmy: daňové identifikační číslo organizace z vaší smlouvy s Nova Post, například IČO, NIP nebo Steuernummer. Musí to být organizace, pro kterou byl váš API klíč vytvořen.
- Vyplňte Název firmy odesílatele, Název odesílatele (kontaktní osoba uvedená na štítku), Telefon odesílatele (celé mezinárodní číslo, například
+420777123456), Email odesílatele a Země odesílatele. Země odesílatele musí být v EU. - Nastavte, jak se vaše zásilky dostanou k Nova Post:
- Na pobočce: vyplňte pole Pobočka Nova Post pro předání zásilek, a to buď číslo pobočky, jak ho uvádí Nova Post (například
14/1), nebo ID pobočky. - Kurýrem z vaší adresy: pobočku nechte prázdnou a vyplňte Ulice odesílatele, Číslo popisné odesílatele, PSČ odesílatele a Město odesílatele. Číslo popisné můžete napsat i do pole Ulice odesílatele.
- Na pobočce: vyplňte pole Pobočka Nova Post pro předání zásilek, a to buď číslo pobočky, jak ho uvádí Nova Post (například
- Vyplňte pole Výchozí délka balíku v milimetrech, Výchozí šířka balíku v milimetrech a Výchozí výška balíku v milimetrech. Nova Post vyžaduje délku, šířku a výšku u každého balíku a počítá z nich objemovou hmotnost. Globe tyto hodnoty posílá pro všechny balíky.
- Pokud nabízíte dobírku, vyplňte nastavení dobírky popsaná v části Dobírka (COD).
- Po kliknutí na Zobrazit pokročilá nastavení můžete nastavit Celní podmínky (Incoterms), EORI číslo odesílatele, Výchozí popis obsahu zásilky, Výchozí HS kód a Výchozí hmotnost (kg). Celní nastavení popisuje část Clo a mezinárodní zásilky.
- Podle potřeby nastavte Automaticky splnit objednávky, Automaticky označit objednávky číslem sledování a Vlastní tag po exportu.
- V části Dopravní metody přiřaďte své dopravní metody v Shopify ke službám Nova Post popsaným v části Typy služeb. Dopravní metody lze přiřadit pro 27 zemí EU, Ukrajinu, Moldavsko a Spojené království.
Export a tisk štítků
Sekce “Export a tisk štítků”Objednávky můžete exportovat do Nova Post a přepravní štítky tisknout přímo ze Shopify, hromadně i jednotlivě. Obecný postup najdete v průvodci Vytváření přepravních štítků.
Před odesláním první objednávky Globe zkontroluje nastavení a přihlásí se k Nova Post vaším API klíčem. Pokud nějaké nastavení chybí nebo je klíč odmítnut, žádná objednávka se neodešle. Globe také u každé objednávky kontroluje údaje, které by Nova Post odmítla, například chybějící telefonní číslo nebo číslo popisné. Objednávka, která těmito kontrolami neprojde, se neodešle, takže ji můžete opravit a exportovat znovu.
Každá objednávka se odešle jako jedna zásilka s jedním balíkem:
- Hmotnost: hmotnost objednávky zaokrouhlená na 10 g (nejméně 10 g)
- Rozměry: výchozí délka, šířka a výška z nastavení
- Pojistná hodnota: Deklarovaná hodnota, ve výchozím stavu celková cena objednávky, v měně objednávky
- Obsah: Popis obsahu, nebo názvy produktů objednávky, když je prázdný
Hmotnost, deklarovanou hodnotu, částku dobírky, HS kód a popis obsahu zásilky můžete při vytváření štítku změnit v části Pokročilé.
Nova Post vrátí číslo zásilky, například SHCZ0123456789. Globe ho uloží jako sledovací číslo a štítek stahuje z Nova Post při každém tisku. Sledovací odkaz otevře https://novapost.com/en-<country>/tracking/<shipment number>/ pro zemi z čísla zásilky (například en-pl pro SHPL…), nebo en-cz, když daná země sledovací stránku nemá. Pokud je zapnuté Automaticky splnit objednávky, splnění objednávky se vytvoří s číslem zásilky, názvem dopravce Nova Post a tímto odkazem.
Pokud Nova Post včas neodpoví nebo se spojení přeruší, zásilka může u Nova Post existovat, i když pro ni Globe nemá číslo. Globe pak objednávku označí poznámkou, abyste před dalším vytvořením štítku zkontrolovali my.novapost.com, a zastaví dávku před další objednávkou. Objednávky, které se neodeslaly, můžete bezpečně exportovat znovu.
Globe zásilky u Nova Post neruší. Chcete-li zásilku zrušit, smažte ji v my.novapost.com.
Typy služeb
Sekce “Typy služeb”Při mapování dopravních metod nebo vytváření štítku zvolte jednu z těchto služeb:
| Služba | Doručení |
|---|---|
| Nova Post (branch or parcel locker if selected, otherwise address) | Na pobočku Nova Post, do balíkomatu nebo na místo PUDO, které zákazník vybral v pokladně. Objednávka bez výdejního místa jde na adresu zákazníka. |
| Nova Post courier (address) | Vždy na doručovací adresu zákazníka, i když má objednávka výdejní místo. |
| Nova Post branch or parcel locker | Na pobočku Nova Post, do balíkomatu nebo na místo PUDO z objednávky. Objednávka bez výdejního místa se odmítne. |
U obou služeb, které doručují na výdejní místo, se výdejní místo ze sítě jiného dopravce odmítne, místo aby se zásilka poslala na adresu zákazníka. Vyberte místo Nova Post akcí Upravit výdejní místo, nebo vytvořte štítek se službou Nova Post courier (address).
Výdejní místa vs. doručení na adresu
Sekce “Výdejní místa vs. doručení na adresu”Služby, které doručují na výdejní místo, posílají zásilku na pobočku Nova Post, do balíkomatu nebo na místo PUDO, které zákazník vybral v pokladně. Globe posílá ID tohoto místa v systému Nova Post, takže místo musí pocházet ze sítě Nova Post ve výběru výdejních míst Globe. Chcete-li v pokladně nabízet místa Nova Post, přidejte Nova Post jako dopravce výdejních míst, viz Přidání výdejních míst. Pobočky Nova Post, které jiný dopravce uvádí ve vlastní síti, například Zásilkovna nebo Boxpi, mají ID daného dopravce, a proto se odmítnou.
Nova Post nemá pobočky, balíkomaty ani místa PUDO v Bulharsku, Chorvatsku, na Kypru, v Řecku, na Maltě a ve Slovinsku. Zásilky do těchto zemí mohou jít jen na adresu zákazníka.
Pro doručení na adresu potřebuje Nova Post ulici a číslo domu v samostatných polích. Globe vezme číslo domu z prvního řádku adresy (Vinohradská 12/34, 12 rue de la Paix) nebo ze začátku druhého řádku a číslo bytu napsané za číslem domu (byt 4, m. 5, Apt 2B) pošle jako číslo bytu. Adresa bez čísla domu, ulice, města nebo PSČ se odmítne.
Nova Post vyžaduje telefonní číslo příjemce u každé zásilky, i u poboček a balíkomatů. Číslo bez předvolby země se bere jako číslo cílové země. Nova Post odmítne příjemce v Polsku bez polského čísla (+48) a příjemce na Ukrajině bez ukrajinského čísla (+380).
Clo a mezinárodní zásilky
Sekce “Clo a mezinárodní zásilky”Zásilky, které opouštějí EU (na Ukrajinu, do Moldavska nebo do Spojeného království), potřebují celní fakturu. Globe vyplní z údajů objednávky obchodní fakturu Nova Post. Můžete ji vytisknout spolu se štítkem (viz Tisk štítků).
Faktura obsahuje celkovou hodnotu zboží, měnu objednávky, důvod vývozu Selling a Celní podmínky (Incoterms) z nastavení: DAP (dovozní clo platí zákazník) (výchozí), nebo DDP (dovozní clo platíte vy). Z každého řádku produktu, který se odesílá a má cenu, vznikne jedna položka, která obsahuje:
- název produktu ze Shopify jako název položky i jako její anglický název (Nova Post očekává tento název anglicky)
- množství a jednotkovou cenu
- HS kód z produktu v Shopify, jinak hodnotu z pole HS kód zadanou při vytváření štítku nebo hodnotu Výchozí HS kód
- zemi původu z produktu, pokud je nastavená
- podíl na hmotnosti balíku podle hmotnosti produktu, aby hmotnosti položek dávaly dohromady hmotnost balíku, jak Nova Post vyžaduje
HS kódy potřebují alespoň 6 číslic. Nova Post přijímá 8 až 10 číslic, proto Globe šestimístný kód doplní nulami (610910 se změní na 61091000). Zásilky do Moldavska dostanou přesně 10 číslic. Když se žádný řádek produktu nehodí, Globe deklaruje celý balík jako jednu položku s popisem obsahu (nebo Goods), hodnotou objednávky a hodnotou z pole HS kód zadanou při vytváření štítku nebo hodnotou Výchozí HS kód.
Nova Post deklaruje zboží pod HS 210690 (potravinové přípravky, například doplňky stravy) a HS 630900 (obnošené oděvy) v kilogramech. Globe u těchto položek přepočítá množství na kilogramy podle hmotnosti produktu. Balík může obsahovat jen jednu takovou položku, a to nejvýše 10 kg.
Zásilky opouštějící EU také potřebují v objednávce e-mailovou adresu zákazníka. Zásilky na Ukrajinu potřebují Název odesílatele v latince: diakritika je povolená, cyrilice a řecká písmena ne. EORI číslo odesílatele je volitelné a doporučené pro zásilky opouštějící EU.
Dobírka (COD)
Sekce “Dobírka (COD)”Nova Post vybírá dobírku v rámci Česka, Polska a Německa a z Česka, Polska, Německa a Slovenska na Ukrajinu. Dobírku vám musí Nova Post povolit ve smlouvě (smlouva o dobírce).
Když je platební metodou objednávky dobírka, Globe přidá službu dobírky Nova Post s nezaplacenou částkou objednávky. Částku můžete při vytváření štítku změnit v poli Dobírka.
Vyplňte tato nastavení:
- IBAN pro dobírku: účet, na který Nova Post vyplácí vybrané peníze. Výplata jde firmě uvedené v poli IČO firmy.
- Číslo smlouvy o dobírce: číslo vaší smlouvy o dobírce. Pokud máte jen jednu smlouvu, nechte pole prázdné.
- Kdo platí poplatek za dobírku: Odesílatel (vy) (výchozí), nebo Příjemce. Musí odpovídat vaší smlouvě o dobírce.
Globe posílá dobírku jen tehdy, když je objednávka v měně země odesílatele: CZK z Česka, PLN z Polska, EUR z Německa a Slovenska. Objednávka na dobírku na trase, kde Nova Post dobírku nevybírá, v jiné měně nebo bez platného IBAN se odmítne dřív, než cokoli vznikne.
Tisk štítků
Sekce “Tisk štítků”Globe stahuje štítky z Nova Post při tisku jako PDF. K dispozici jsou dvě možnosti tisku:
| Možnost tisku | Co se vytiskne |
|---|---|
| 10x15 or 10x10 cm (size set by Nova Post) | Štítek zásilky. Velikost určuje Nova Post u každé zásilky: 100 × 150 mm nebo 100 × 100 mm. |
| Label + commercial invoice A4 (parcels leaving the EU) | Štítek a za ním obchodní faktura Nova Post na A4 pro každou zásilku, která opouští EU. Zásilky v rámci EU dostanou jen štítek. |
Když tisknete více zásilek, Globe spojí jejich dokumenty do jednoho PDF v pořadí zásilek. Pozice na papíru je vždy 1.
Řešení problémů
Sekce “Řešení problémů”| Problém | Řešení |
|---|---|
| „Nova Post settings are incomplete“ | Zpráva uvádí chybějící nastavení. Vyplňte je v účtu dopravce a uložte. |
| „Globe creates Nova Post labels for senders in the EU“ | V poli Země odesílatele nastavte zemi EU, ze které odesíláte. |
| „The sender phone must be a full international number“ | Zadejte Telefon odesílatele s předvolbou země, například +420777123456. |
| „The sender address needs a house number“ | Zadejte Číslo popisné odesílatele, nebo vyplňte pole Pobočka Nova Post pro předání zásilek. |
| „Nova Post did not accept the API key“ nebo „Nova Post says the API key is not active“ | Zkontrolujte API klíč a Prostředí: produkční klíč funguje jen s Produkcí, testovací klíč jen s Vývojem. Neaktivní klíč musí aktivovat v my.novapost.com vy nebo váš manažer u Nova Post. |
| „Access to the company is forbidden by API key“ nebo „Nova Post refused the request for this API key“ | IČO firmy musí patřit organizaci, pro kterou byl váš API klíč vytvořen. Zkontrolujte klíč v my.novapost.com. |
| „Recipient phone number is missing“, „Nova Post needs a Polish phone number (+48)“ nebo „…a Ukrainian phone number (+380)“ | Doplňte do doručovací adresy objednávky telefonní číslo zákazníka s předvolbou země. Příjemci v Polsku potřebují polské číslo, příjemci na Ukrajině ukrajinské. |
| „Nova Post needs the house number in its own field“ nebo „the shipping address needs a street, city and postcode“ | Doplňte doručovací adresu objednávky včetně čísla domu. |
| „Nova Post does not know the recipient’s city“ | Zkontrolujte název města v doručovací adrese. |
| „Order … has no weight“ | Nastavte hmotnosti produktů v Shopify, zadejte hmotnost při vytváření štítku, nebo nastavte Výchozí hmotnost (kg) v pokročilých nastaveních. |
| „has no Nova Post branch or parcel locker“, „is not a Nova Post branch or parcel locker“ nebo „is not a Nova Post division id“ | Vyberte pobočku nebo balíkomat Nova Post akcí Upravit výdejní místo, nebo vytvořte štítek se službou Nova Post courier (address) a pošlete zásilku na adresu zákazníka. |
| „parcels to Ukraine need the sender name in Latin letters“ | Změňte Název odesílatele na latinku. |
| „Nova Post needs the customer’s e-mail for parcels leaving the EU“ | Doplňte do objednávky e-mailovou adresu zákazníka. |
| „parcels leaving the EU need an HS code“ | Doplňte HS kód k produktu v Shopify, nebo nastavte Výchozí HS kód v pokročilých nastaveních. |
| Zboží pod HS 210690 nebo 630900 odmítnuto | Nova Post přijme jednu takovou položku na balík, nejvýše 10 kg, a potřebuje její hmotnost. Doplňte hmotnost produktu v Shopify, nebo zboží rozdělte do více balíků v my.novapost.com. |
| Dobírka odmítnuta kvůli trase nebo měně | Nova Post vybírá dobírku jen na trasách a v měnách uvedených v části Dobírka (COD). Pošlete objednávku jiným dopravcem, nebo při vytváření štítku nastavte pole Dobírka na 0. |
| „no valid IBAN for the collected money“ nebo „Nova Post refused the cash on delivery bank account“ | Zkontrolujte IBAN pro dobírku a Číslo smlouvy o dobírce v nastavení. |
| „Nova Post did not answer in time“, „did not confirm the shipment“ nebo „The connection to Nova Post broke off“ | Zásilka může existovat. Než štítek vytvoříte znovu, zkontrolujte my.novapost.com. |
| „Globe could not connect to Nova Post“, „the Nova Post login did not answer“ nebo „Nova Post is limiting requests right now“ | Nic nevzniklo. Zkuste to znovu za minutu. |
| „Do not create the label again“ | Nova Post zásilku vytvořila, ale Globe ji nemohl uložit. Vytiskněte štítek v my.novapost.com, nebo tam zásilku smažte, než vytvoříte novou. |
| „Globe stopped before sending order …“ | Dřívější objednávka v dávce nedostala použitelnou odpověď nebo ji nebylo možné uložit. Pro tuto objednávku nic nevzniklo, takže její štítek můžete vytvořit znovu. |
| Jiné zprávy začínající „Nova Post:“ | Text pochází z validace Nova Post a uvádí pole, které odmítla. Opravte objednávku nebo nastavení a exportujte znovu. |
| „Error printing Nova Post labels“ | Podrobnosti uvádějí číslo zásilky a důvod od Nova Post, například Shipment not found. Zkontrolujte zásilku v my.novapost.com. |