Základy API integrace
Tento průvodce poskytuje přehled klíčových kroků potřebných pro integraci vašeho systému s API Zásilkovny.
Pro základní integraci implementujte:
Většina integrátorů implementuje také tyto doplňkové funkce:
Výběr výdejního místa
Zákazník si během objednávky vybírá preferované výdejní místo z mapy. Mapu lze ve vašem košíku zobrazovat dvěma způsoby.
Widget
Nejjednodušší způsob implementace výběru výdejního místa je widget Zásilkovny. Jedná se o připravené řešení, které lze snadno vložit do vašeho košíku.
Výhody:
- rychlá implementace
- minimální potřeba přizpůsobení
Podrobnosti implementace naleznete v dokumentaci widgetu.
Datové feedy
Pokud si chcete vytvořit vlastní mapu s výdejními místy, můžete využít naše datové feedy a pracovat přímo s daty jednotlivých lokalit.
Poskytujeme čtyři samostatné zdroje dat:
- Výdejní místa Zásilkovny - obsahují všechna výdejní místa Zásilkovny
- Z-BOX feed - obsahují všechny Z-BOXy
- Seznam dopravců - seznam všech dostupných dopravců
- Feed externích výdejních míst - obsahuje výdejní místa provozovaná externími dopravci
Datové feedy poskytují přímý přístup k datům prostřednictvím API.
Datové feedy použijte, pokud:
- chcete mít plnou kontrolu nad uživatelským rozhraním
- vytváříte vlastní frontendové řešení
- potřebujete přizpůsobit způsob zobrazení nebo filtrování lokalit
Podrobnosti implementace naleznete v přehledu datových feedů.
Feedy nejsou určeny k použití společně s Widgetem. Neporovnávejte ani nekombinujte data z Widgetu a datových feedů.
Vytvoření zásilky
Vytvoření zásilky znamená odeslání dat objednávky do Zásilkovny. Po jejich zpracování vznikne zásilka s unikátním ID (Z 123 4567 890).
Zásilku nelze vytvořit bez platného způsobu doručení a ID výdejního místa nebo adresy.
Použijte odpovídající integrační návod podle zvoleného způsobu doručení:
- Výdejní místa Zásilkovny (CZ, SK, RO, HU)
- Z-BOXy (CZ, SK, RO)
- Doručení na adresu (ve všech zemích, kde Zásilkovna doručuje)
- Doručení na výdejní místo externího dopravce (výdejní místa a boxy v síti externích dopravců)
Pro další zpracování ve vlastních systémech použijte API metodu packetInfo(). Poskytuje důležité informace o zásilce využívané pro sledování, ověřování a synchronizaci do dalšch systémů.
Validace externích dopravců
Externí dopravci používají vlastní validační pravidla. V závislosti na konkrétním dopravci může validace kontrolovat adresu, hmotnost, rozměry nebo telefonní číslo.
Tisk štítku
Štítky slouží k identifikaci zásilek v logistické síti. Obsahují informace o příjemci i další údaje důležité pro dopravce, například směrovací kód.
K dispozici jsou dva typy štítků:
Štítek Zásilkovny
Štítek Zásilkovny použijte pro zásilky směřující na výdejní místa Zásilkovny. Je dostupný v různých rozměrech (A6–A8).
Štítek dopravce
Štítek dopravce se používá pro doručení na adresu a pro výdejní místa dopravců. Je dostupný pouze ve formátu A6.
Požadavky jednotlivých dopravců na štítky najdete na stránce příslušného dopravce.
Trasování zásilky
Informace o sledování lze získat pomocí následujících API metod:
packetStatus- aktuální status zásilkypacketTracking- historie stavů zásilkypacketCourierTracking– historie stavů zásilky v síti dopravce
Seznam stavových kódů naleznete na stránce se stavy zásilek.
Dodací list (balík)
Balík slouží ke hromadnému předání více zásilek do logistické sítě Zásilkovny. Kurýr naskenuje čárový kód balíku místo toho, aby skenoval každou zásilku samostatně.
Pro integraci dodacích listů postupujte podle tohoto návodu.
Vratky
Pro vrácení doručené zásilky můžete využít jednu z následujících možností:
Potřebujete poradit s integrací? Kontaktujte náš integrační tým na integrations@packeta.com.