Slovenská pošta API

Globe Pickup Points integruje se Slovenskou poštou, slovenským poštovním operátorem, prostřednictvím jejího WebEPH API, což umožňuje export objednávek a tisk přepravních štítků přímo ze Shopify. S touto integrací můžete:

Exportovat objednávky do vašeho účtu Slovenské pošty (Moje zásielky)
Tisknout přepravní štítky přímo v Shopify ve formátu A6 nebo A4
Doručovat na pošty, do balíkomatů BalíkoBOX nebo na adresu zákazníka
Podporovat dobírku vyplácenou na váš IBAN

Integrace je nabízena pro Slovensko a adresa odesílatele je vždy slovenská adresa.

Aktivace integrace Slovenská pošta API

Ve vaší Shopify administraci otevřete Globe Pickup Points a přejděte do sekce Přepravní štítky. Přidejte nového dopravce a vyberte Slovenská pošta.
Zadejte ID uživatele a API klíč — jsou to přihlašovací údaje k WebEPH API z vašeho účtu Slovenské pošty. WebEPH API musí být pro účet aktivováno, jinak ověření neproběhne.
Vyplňte blok odesílatele: Název odesílatele, Ulice odesílatele, Město odesílatele a PSČ odesílatele jsou povinné. Organizace odesílatele, Telefon odesílatele a Email odesílatele jsou volitelné.
Zvolte Způsob podání — Podat na poště nebo Podat kurýrovi — podle toho, jak zásilky předáváte.
Zvolte Způsob platby poštovného: Úvěr poštovného, Výplatní stroj, Poštovní známky, Placeno převodem, Placeno v hotovosti, Položka poštovní služby, Faktura nebo Online.
Zaškrtněte Smlouva, pokud máte se Slovenskou poštou uzavřenou smlouvu.
Pokud odesíláte na dobírku, vyplňte IBAN pro dobírku.
Volitelně nastavte Pojištění zásilek, Výchozí hodnota pojištění, Výchozí hmotnost (kg), Automaticky splnit objednávky, Automaticky označit objednávky číslem sledování a Vlastní tag po exportu.
Namapujte vaše Shopify dopravní metody na produkty Slovenské pošty, které máte sjednané s dopravcem.

Export a tisk štítků

Objednávky lze exportovat do Slovenské pošty a tisknout přepravní štítky přímo ze Shopify, ať už hromadně nebo jednotlivě — viz Vytváření přepravních štítků.

Každý export vytvoří jeden hárok (podací arch) pro každý typ produktu: objednávky se seskupí podle vybraného produktu, pro každou skupinu se otevře hárok, přidají se do něj zásilky a hárok se pak automaticky zaregistruje. Pokud registrace selže, zásilky jsou přesto vytvořeny a hárok lze zaregistrovat později v Moje zásielky.

Hmotnost objednávky se převádí z gramů na kilogramy, minimálně však 0,1 kg. Pokud vaše objednávky nemají hmotnost, nastavte v nastavení dopravce Výchozí hmotnost (kg).

Každá zásilka obdrží podací číslo Slovenské pošty (například EB534780848SK). Pokud je zapnuto Automaticky splnit objednávky, objednávka se splní s tímto číslem a odkazem na stránku pro sledování Slovenské pošty.

Slovenská pošta má testovací systém WebEPH, ten se ale zapíná na úrovni serveru, nikoli u jednotlivých účtů dopravce — produkční obchody komunikují vždy s ostrým API Moje zásielky a v nastavení dopravce není žádný přepínač sandboxu.

Produkty

Vyberte produkt, který odpovídá vaší dohodě se Slovenskou poštou. Všechny objednávky exportované se stejným produktem jdou na stejný hárok.

Produkt	Popis
Doporučený list	Doporučený dopis
Poistený list	Pojištěný dopis
Úradná zásielka	Úřední zásilka
Balík	Standardní balík
Expres kuriér	Expresní kurýr
EMS zásielka	Expresní zásilka EMS
EPG – obchodný balík	Obchodní balík EPG
Balík – zmluvní zákazníci	Balík pro smluvní zákazníky
Balík – zmluvní zákazníci – Consignment	Balík pro smluvní zákazníky, konsignace
Balíček	Malý balík
Easy Expres 1	Easy Expres, doručení do 1 dne
Easy Expres 10	Easy Expres, doručení do 10 dnů
Prime zásielka	Zásilka Prime
List	Obyčejný dopis

Výdejní místa vs. doručení na adresu

Typ doručení se řídí dopravní metodou zákazníka:

Výdejní místo — když zákazník při objednávce vybere výdejní místo Slovenské pošty (poštu nebo balíkomat BalíkoBOX), adresa příjemce na zásilce se nahradí adresou výdejního místa a zásilka se podá s doručovací službou na výdejní místo. Název místa se připojí k městu, aby byl vidět na štítku.
Doručení na adresu — zásilka je adresována na doručovací adresu zákazníka. Druhý řádek adresy se připojí k ulici.

Jméno, ulice, město a PSČ příjemce jsou povinné. Objednávky, kterým některý z těchto údajů chybí, jsou při exportu zamítnuty.

Rozsahy podacích čísel (smluvní zákazníci)

Pokud vám Slovenská pošta přidělila vlastní rozsah podacích čísel, vyplňte pokročilá pole Rozsah podacích čísel – od a Rozsah podacích čísel – do (například EB534780848SK). Globe pak přiděluje čísla z tohoto rozsahu a po každém exportu ukládá následující číslo do pole Příští podací číslo, které můžete také ručně opravit.

Čísla používají formát PPNNNNNNNN[C]SS — dvoupísmenná předpona, osm číslic, volitelná kontrolní číslice a dvoupísmenná přípona. Kontrolní číslici za vás vypočítá Globe. Když se rozsah vyčerpá, exporty selhávají, dokud nezadáte nový rozsah. Pokud tato pole necháte prázdná, čísla přiděluje Slovenská pošta.

Dobírka (COD)

Dobírka je podporována. Částka dobírky se přebírá z nezaplacené částky objednávky v měně objednávky a odesílá se jako bankovní vklad na IBAN pro dobírku nastavený u účtu dopravce, s variabilním symbolem odvozeným z číslic čísla objednávky. Bez platného IBAN API zásilku zamítne.

Pojištění

Pojištění se přidává, pokud je hodnota objednávky vyšší než nula a zároveň je produktem Poistený list, nebo je v nastavení dopravce zapnuto Pojištění zásilek. Pojistná částka odpovídá hodnotě objednávky v měně objednávky, případně hodnotě Výchozí hodnota pojištění, pokud ji nastavíte.

Stav doručení

Synchronizace stavů doručení není u Slovenské pošty k dispozici — stavy zásilek se nezapisují zpět do Shopify a platby na dobírku se automaticky neoznačují jako zaplacené. Podací číslo a odkaz na stránku pro sledování Slovenské pošty se k plnění připojují i tak. Podporovány nejsou ani štítky pro vrácení a zrušení již exportované zásilky z Globe; zásilky rušte v Moje zásielky.

Tisk štítků

Štítky Slovenské pošty se vracejí jako PDF a lze je tisknout v následujících formátech:

Formát	Počet štítků na archu	Počáteční pozice
A6	1 (jeden štítek na stránku)	–
A4	4 (mřížka 2×2)	1–4

Při tisku archů A4 zvolte počáteční pozici, abyste mohli opakovaně použít částečně použité archy se štítky. Výchozí formát nastavíte pomocí Výchozí formát tisku v nastavení dopravce.

Řešení problémů

Problém	Řešení
Chyba ověření	Zkontrolujte ID uživatele a API klíč a ujistěte se, že je ve vašem účtu Slovenské pošty aktivováno WebEPH API.
Chybějící povinná pole odesílatele	Název odesílatele, Ulice odesílatele, Město odesílatele a PSČ odesílatele musí být vyplněné.
Chybí jméno, adresa, město nebo PSČ příjemce	Doručovací adresa v Shopify je neúplná. U objednávek na výdejní místo zkontrolujte, zda zákazník při objednávce skutečně vybral místo.
Neplatný formát podacího čísla	V polích rozsahu podacích čísel použijte formát `PPNNNNNNNN[C]SS`, například `EB534780848SK`.
Rozsah podacích čísel vyčerpán	Všechna přidělená čísla byla použita. Vyžádejte si od Slovenské pošty nový rozsah a aktualizujte Rozsah podacích čísel – od/do a Příští podací číslo.
Chyba validace při exportu	API zamítlo hodnotu na zásilce — nejčastěji chybějící IBAN pro dobírku nebo částku pojištění či dobírky, kterou produkt nepovoluje.
V objednávkách nebyla nalezena ID zásilek	Objednávka nebyla úspěšně exportována, takže není co tisknout. Před tiskem ji exportujte znovu.
Typ štítku není k dispozici	Štítek pro danou zásilku ještě není připraven. Chvíli počkejte a tiskněte znovu.
Nepodařilo se připojit k API Slovenské pošty	WebEPH API je dočasně nedostupné. Export nebo tisk zkuste znovu později.

Přidejte výdejní místa Slovenská pošta do svého Shopify obchodu — ceny, demo a nastavení →