Přeskočit na hlavní obsah
For any questions, feel free to contact our integrations team at integrations@packeta.com

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:

  1. Výdejní místa Zásilkovny - obsahují všechna výdejní místa Zásilkovny
  2. Z-BOX feed - obsahují všechny Z-BOXy
  3. Seznam dopravců - seznam všech dostupných dopravců
  4. 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ů.

duležité

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).

important

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í:

tip

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:

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í:

info

Potřebujete poradit s integrací? Kontaktujte náš integrační tým na integrations@packeta.com.