SPS API

Globe Pickup Points integruje s SPS (Slovak Parcel Service) přes SOAP API WebShip, 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 SPS WebShip přímo ze Shopify
Tisknout přepravní štítky přímo v Shopify
Doručovat na výdejní místa Balíkovo, do balíkových terminálů SPS nebo na adresu zákazníka
Podporovat dobírku (COD) s výplatou na váš bankovní účet

Aktivace integrace SPS 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 SPS.
Zadejte Uživatelské jméno a Heslo — jsou to vaše přihlašovací údaje k WebShip. O přístup k webové službě požádejte svého obchodního zástupce SPS.
Pokud používáte dobírku, zadejte IBAN pro dobírku a SWIFT/BIC pro dobírku bankovního účtu, na který má SPS vybrané peníze posílat.
Volitelně nastavte Výchozí pojistná hodnota, která se použije u všech zásilek. Pokud ji necháte prázdnou, použije se celková hodnota objednávky.
Podle potřeby nakonfigurujte možnosti plnění a označování objednávek — Automaticky splnit objednávky, Automaticky označit objednávky číslem sledování a Vlastní tag po exportu.
Namapujte vaše Shopify dopravní metody na služby SPS, které máte sjednané s dopravcem.

SPS nemá testovací prostředí — WebShip má jediný produkční endpoint, takže přihlašovací údaje, které zadáte, vytvářejí skutečné zásilky.

Export a tisk štítků

Objednávky lze exportovat do SPS a tisknout přepravní štítky přímo ze Shopify, ať už hromadně nebo jednotlivě. Kompletní postup najdete v průvodci Vytváření přepravních štítků.

Každá zásilka se vytvoří a její štítek se vygeneruje v jediném volání API, takže štítky jsou připraveny k tisku ihned po exportu. Jako reference zásilky se do SPS posílá název vaší objednávky v Shopify bez úvodního #, v případě potřeby zkrácený na 35 znaků.

Po exportu obdrží zásilka číslo zásilky SPS, které se používá pro sledování v plnění a lze jej vyhledat na stránce pro sledování SPS. Pokud má objednávka e-mailovou adresu zákazníka, Globe navíc požádá SPS o e-mailové upozornění příjemce.

Typy služeb

Při mapování dopravních metod nebo exportu objednávky vyberte službu SPS odpovídající vaší dohodě:

Služba	Popis
SPS Standard	Standardní doručení na adresu nebo do firmy
SPS Express	Expresní doručení
SPS 9:00	Garantované doručení do 9:00
SPS 12:00	Garantované doručení do 12:00
SPS Saturday Delivery	Doručení v sobotu
SPS Balíkovo	Doručení na výdejní místo Balíkovo
SPS Parcel Terminal	Doručení do balíkového terminálu SPS (boxu)

Objednávky lze exportovat do 11 cílových zemí: Slovensko, Česko, Rakousko, Maďarsko, Německo, Polsko, Rumunsko, Chorvatsko, Slovinsko, Bulharsko a Srbsko.

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

SPS Balíkovo a SPS Parcel Terminal posílají zásilku na výdejní místo, které zákazník vybral při objednávce. Globe předá ID místa do SPS a jméno zákazníka uvede na štítku jako kontaktní osobu.
Všechny ostatní služby doručují na doručovací adresu zákazníka.

Pokud je použita služba Balíkovo nebo Parcel Terminal, ale objednávka nenese žádné výdejní místo, zásilka se vytvoří na adresu zákazníka místo na výdejní místo. Ujistěte se, že vaše dopravní metody pro výdejní místa jsou namapované na službu Balíkovo nebo Parcel Terminal a že je výběr míst při objednávce aktivní — viz Přidání výdejních míst.

Pojistná hodnota

SPS vyžaduje pojistnou hodnotu u každé zásilky. Globe ji určuje v tomto pořadí:

Pojistná hodnota nastavená u jednotlivé zásilky při exportu
Výchozí pojistná hodnota z nastavení dopravce
Celková hodnota objednávky, pokud není nastavena ani jedna z předchozích

Dobírka (COD)

SPS podporuje dobírku. Pokud u objednávky zbývá částka k vybrání, Globe odešle částku dobírky spolu s měnou objednávky a údaji IBAN pro dobírku a SWIFT/BIC pro dobírku z nastavení dopravce, aby SPS věděla, kam peníze poslat. Objednávky, u kterých není co vybírat, se exportují jako běžné zásilky.

Stav doručení

Synchronizace stavů doručení není u SPS k dispozici — stavy zásilek se nezapisují zpět do Shopify, takže průběh je nutné kontrolovat na stránce pro sledování SPS nebo ve vašem portálu SPS. Číslo zásilky a odkaz pro sledování se k plnění připojují i tak. Podporovány nejsou ani štítky pro vrácení; vratky si domluvte přímo se SPS.

Tisk štítků

Štítky SPS se generují jako PDF při exportu a lze je tisknout v následujících formátech:

Formát	Počet štítků na archu
A6	1
A6 na A4	4 (mřížka 2×2)

Při tisku A6 na A4 můžete vybrat počáteční pozici na archu (pozice 1–4) a opakovaně tak použít částečně použité archy se štítky.

Řešení problémů

Problém	Řešení
„Username or password is not configured“	Uživatelské jméno i heslo k WebShip jsou povinné. Vyplňte je u účtu dopravce a uložte.
Chyba ověření z WebShip	Ověřte své přihlašovací údaje k WebShip a potvrďte se svým obchodním zástupcem SPS, že je pro účet povolen přístup k webové službě.
Export zamítnut s chybovou zprávou SPS	WebShip zásilku validuje a vrátí důvod — obvykle neúplnou adresu, nepodporované cílové PSČ nebo službu, kterou nemáte na účtu povolenou. Opravte objednávku a exportujte znovu.
„SPS did not return a tracking number“	SPS požadavek přijala, ale neposlala číslo zásilky. Než exportujete znovu, zkontrolujte v portálu SPS, zda nevznikl duplicitní záznam.
Zásilka odeslána na adresu místo na výdejní místo	Objednávka byla exportována na službu Balíkovo nebo Parcel Terminal bez připojeného výdejního místa. Zkontrolujte, že zákazník při objednávce vybral místo a že je mapování dopravní metody správné.
„No label URLs found for these SPS orders“	Štítky pro danou dávku již nejsou dostupné. Exportujte objednávky znovu a vygenerujte nové štítky.
Štítky nelze získat z SPS WebShip	PDF se štítky se nepodařilo z SPS stáhnout. Chvíli počkejte a dávku vytiskněte znovu.

Přidejte výdejní místa SPS do svého Shopify obchodu — ceny, demo a nastavení →