ShippyPro API

Globe Pickup Points integruje se ShippyPro, multi-dopravcovou přepravní platformou, přes kterou můžete odesílat se smlouvami dopravců, jež už máte připojené ve svém vlastním účtu ShippyPro. S touto integrací můžete:

Exportovat objednávky do ShippyPro přímo ze Shopify
Tisknout přepravní štítky přímo v Shopify
Doručovat na výdejní místa nebo na adresu zákazníka, podle zvolené služby dopravce
Podporovat dobírku (COD) a celní prohlášení (CN22) u přeshraničních zásilek

Objednávky lze exportovat do 33 cílových zemí — EU, Velké Británie, Švýcarska, Norska, USA, Kanady a Austrálie.

Aktivace integrace ShippyPro 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 ShippyPro.
Zadejte API klíč — najdete ho ve svém účtu ShippyPro. Je to jediný povinný přihlašovací údaj.
Klikněte na Fetch carriers. Globe ověří klíč a stáhne všechny dopravce a služby připojené k vašemu účtu ShippyPro, abyste je mohli namapovat na Shopify dopravní metody.
Vyplňte údaje o odesílateli tištěné na štítku: Název odesílatele, Název firmy odesílatele, Ulice odesílatele, Město odesílatele, PSČ odesílatele, Země odesílatele (dvoupísmenný kód jako CZ, SK, HU), Telefon odesílatele a Email odesílatele.
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 stažené služby dopravců.

V Globe není samostatný sandbox ShippyPro — API klíč, který zadáte, vytváří na vašem účtu skutečné zásilky.

Export a tisk štítků

Objednávky lze exportovat do ShippyPro 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ý export vytvoří zásilku a vrátí sledovací číslo i štítek v jednom volání, takže štítky jsou připraveny k tisku okamžitě. Název vaší Shopify objednávky se odesílá jako reference a poznámka zásilky. Po exportu se sledovací číslo používá pro sledování v plnění — dopravce nahlášený službou ShippyPro se do Shopify zapíše jako přepravní společnost.

Dopravci a služby

ShippyPro nemá vlastní síť. Dopravci, služby i ceníky pocházejí z vašeho účtu ShippyPro, takže seznam, který při exportu vidíte, přesně odpovídá tomu, co tam máte připojené. Pokud v ShippyPro přidáte nového dopravce, klikněte v nastavení dopravce v Globe znovu na Fetch carriers a načtěte ho.

Pokud váš účet nevrátí žádný seznam dopravců (například když je API ShippyPro dočasně nedostupné), Globe přejde na ruční zadání a umožní vám vložit definici dopravce jako JSON. Očekávaný formát získáte tlačítkem Copy sample.

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

Pokud objednávka nese výdejní místo vybrané při objednávce a exportujete ji se službou pro výdejní místa, Globe odešle ID místa do ShippyPro jako volbu dopravce, takže je zásilka směrována na dané místo.
Služby, jejichž název je označuje jako doručení na adresu, odesílají vždy na doručovací adresu zákazníka, i když je k objednávce připojené výdejní místo.

Samotná výdejní místa mohou pocházet od kteréhokoli poskytovatele, kterého v checkoutu používáte, nebo od poskytovatele ShippyPro PUDO, který se živě dotazuje na výdejní místa dopravců ve vašem účtu ShippyPro. Viz Přidání výdejních míst.

Při exportu vás Globe upozorní bannerem Type selection mismatch, pokud vybraný dopravce ShippyPro nevypadá jako dopravce, kterému výdejní místo na objednávce patří — například když se místo Zásilkovny exportuje na službu GLS. Export se neblokuje, takže si banner před pokračováním přečtěte.

Hmotnost a rozměry balíku

ShippyPro vyžaduje skutečnou hmotnost. Globe si ji nikdy nevymýšlí: pokud objednávka nemá v Shopify nastavenou hmotnost, export se zamítne. Doplňte hmotnosti produktů v Shopify a exportujte znovu.

Rozměry balíku jsou volitelné. Délka balíku (cm), Šířka balíku (cm) a Výška balíku (cm) jsou pokročilé možnosti, nikoli nastavení dopravce, a pokud není nastavena žádná hodnota, odesílá se u každého rozměru 1 cm. Pokud vybraná služba dopravce nabízí možnost pojištění, je zásilka pojištěna na celkovou hodnotu objednávky.

Clo

U přeshraničních zásilek sestavuje Globe celní prohlášení CN22 z položek objednávky — popis, množství, jednotková hodnota, hmotnost, HS kód a země původu převzatá ze skladové položky produktu. Tam, kde jsou data produktu neúplná, mezery vyplní tato nastavení dopravce:

Nastavení	Použito pro
Země odesílatele	Zemi původu, když ji produkt nemá
Contents type	Typ zboží deklarovaný na CN22 (Merchandise, Gift, Documents, Commercial Sample, Returned Goods)
DDP země	Cílové země odesílané jako DDP (clo platíte vy); všechny ostatní destinace se odesílají jako DDU

Popis obsahu (popis obsahu zásilky, ve výchozím stavu Goods) a HS kód (celní kód použitý, když jej produkt nemá) nejsou nastavení dopravce — jsou to pokročilé možnosti, které vyplňujete u jednotlivé zásilky v dialogu exportu.

Dobírka (COD)

ShippyPro 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 ShippyPro ji předá koncovému dopravci. Objednávky, u kterých není co vybírat, se exportují jako běžné zásilky. Zda je dobírka skutečně dostupná — a v jakých měnách — závisí na smlouvě dopravce za vybranou službou ve vašem účtu ShippyPro.

Stav doručení

Synchronizace stavů doručení není u ShippyPro k dispozici — stavy zásilek se nezapisují zpět do Shopify, takže průběh je nutné sledovat v ShippyPro nebo na stránce pro sledování koncového dopravce. Sledovací číslo a odkaz pro sledování se k plnění připojují i tak. Podporovány nejsou ani štítky pro vrácení; vytvářejte je přímo v ShippyPro.

Tisk štítků

Štítky se ze ShippyPro vyžádají až při tisku ve zvolené velikosti a všechny štítky v dávce se sloučí do jednoho vícestránkového PDF:

Formát	Popis
A6	Štítek vykreslený v 10,5 × 14,8 cm
A4 (4-up)	Štítek vykreslený v 21 × 29,7 cm

Protože si štítek vykresluje samo ShippyPro, přesné rozvržení na stránce pochází ze šablony štítku koncového dopravce. Štítky lze kdykoli vytisknout znovu — Globe pro každou zásilku načte novou URL ke stažení a záložně použije URL štítku uloženou při exportu.

Řešení problémů

Problém	Řešení
„Invalid API key — please check your ShippyPro credentials“	Klíč byl ShippyPro odmítnut. Zkopírujte jej znovu ze svého účtu ShippyPro a dopravce uložte.
„ShippyPro API key is not configured“	Pole s API klíčem je u účtu dopravce prázdné. Vyplňte jej a uložte.
„No carriers configured. Use the ‘Fetch carriers’ button“	Seznam dopravců nebyl nikdy stažen. Otevřete nastavení dopravce a klikněte na Fetch carriers.
„Please select a carrier before exporting.“	Služba zvolená pro objednávku není ve staženém seznamu — obvykle poté, co se seznam změnil. Načtěte dopravce znovu a namapujte dopravní metodu.
„Order has no weight set.“	ShippyPro vyžaduje nenulovou hmotnost. Doplňte hmotnosti produktů v Shopify a exportujte znovu.
Export zamítnut s chybovou zprávou dopravce	ShippyPro předává validační chybu koncového dopravce i s jeho navrženým řešením — typicky jde o neúplnou adresu, nepodporovanou destinaci nebo službu nepovolenou na vašem účtu.
Zásilka odeslána na adresu místo na výdejní místo	Služba dopravce nemá uloženou možnost pro výdejní místa. Klikněte znovu na Fetch carriers, obnovte volby dopravce a exportujte znovu.
„Could not retrieve label for order …“	Nepodařilo se stáhnout ani novou, ani uloženou URL štítku. Chvíli počkejte a dávku vytiskněte znovu; pokud selhává opakovaně, objednávku exportujte znovu.

Prohlédněte si všechny podporované dopravce v Globe pro Shopify — výdejní místa a tisk štítků →