Zásilkovna (od 2024 mezinárodně Packeta) je nejpoužívanější český dopravce s 8 000+ výdejními místy v ČR a SR. Pro e-shop nad 50 zásilek měsíčně se vyplatí napojit přes API místo ručního zadávání v administraci.
Typy API
- REST API v6 — moderní, doporučené pro nové integrace.
- SOAP API — starší, stále funkční, využívá ho většina pluginů.
- Widget pro výběr výdejního místa — JavaScript snippet do košíku.
Klíčová volání
createPacket
Vytvoří zásilku v systému Packety. Vrací číslo zásilky (např. Z123456789). Povinné: API password, číslo objednávky, jméno, příjmení, e-mail, výdejní místo (addressId), váha, hodnota dobírky.
packetLabelPdf
Vrátí PDF štítku k vytištění. Formát A6 nebo A7. Pro hromadný tisk použijte packetsLabelsPdf s polem ID.
packetStatus
Vrátí aktuální stav zásilky. Pro tracking je lepší použít webhooky — Packeta volá vaši URL při každé změně stavu.
Výdejní místa v košíku
Widget se vkládá jednou řádkou JS: Packeta.Widget.pick(apiKey, callback). Vrátí ID, adresu, otevírací dobu a GPS. ID se pak posílá v createPacket jako addressId.
Tracking a notifikace
Packeta posílá SMS a e-maily zákazníkovi automaticky. Pokud chcete vlastní šablony, vypněte to v nastavení a posílejte z e-shopu přes webhook na vlastním tracking URL.
Pluginy nebo vlastní integrace?
Shoptet a Shopify mají oficiální pluginy. WooCommerce má komunitní. Pro vlastní e-shop nebo více dopravců najednou se vyplatí univerzální dispatcher (RETURO), který skrývá rozdíly mezi API jednotlivých dopravců.