Doručení na externí výdejní místo
Pro vytvoření zásilky v rámci Zásilkovny je potřeba provést tyto kroky:
Níže projdeme každý z těchto kroků podrobně.
Výběr cíle
Aby vaši zákazníci viděli externí výdejní místa, musíte implementovat Zásilkovnu, pomocí jedné z možností:
- Widget Zásilkovny (mapový nástroj)
- Feedy Zásilkovny (zdroj dat)
Integrace widgetu
Widget je mapový nástroj, který umožní vašim zákazníkům snadno vybrat cílové výdejní místo přímo na mapě. Jedná se o hotové řešení od Packeta se zaměřením na jednoduchost a známé uživatelské prostředí. Nejnovější verzi lze vidět na https://widget.packeta.com/v6/#/.
Implementace PUDO externích dopravců přes widget je otázkou konfigurace.
Můžete použít náš konfigurátor widgetu na https://configurator.widget.packeta.com/. Jednoduše vyplňte požadované nastavení do polí a implementujte vygenerovaný kód do svého řešení.
Jakmile máte widget v integrován ve svém řešení, můžete specifikovat, kteří dopravci se mají pro každou zemi zobrazit. Můžete povolit více dopravců pro jednu zemi nebo žádného. Pro zobrazení externích pick-up pointů dopravců použijte řetězec carrierId v poli vendors. V tomto příkladu používáme PL Paczkomaty Box.
const packetaOptions = {
vendors: [
{
group: "pl-paczkomaty",
carrierId: "3060"
}
]
};
K testování různých konfiguračních možností máme k dispozici také sandbox prostředí na https://codepen.io/Packeta/pen/xxNRWEN
Integrace feedu
Feed je zdroj dat (JSON), který můžete čerpat, abyste získali informace o výdejních místech. Je ideální pro ty, kdo chtějí mít plnou kontrolu nad integrací a přijmout za ni odpovědnost.
V zásadě vše, co je potřeba pro získání informací o externích výdejních místech, je volání: https://pickup-point.api.packeta.com/v5/__API_KEY__/carrier_point/json?ids[]=3060 kde 3060 je ID dopravce.
Seznam všech dopravců naleznete zde: https://pickup-point.api.packeta.com/v5/__API_KEY__/carrier/json
Nahraďte __API_KEY__ vlastním API klíčem z Klientské sekce na https://client.packeta.com/support/
Po obdržení dat dbejte na atribut "displayFrontend": 1. Ten říká, zda je je výdejní místo dostupné pro koncového zákazníka. Hodnota 1 znamená, že může zákazník vybrat výdejní místo.
Nepravidelná aktualizace dat Výdejních míst vašich dopravců může způsobit problémy při vytváření zásilky nebo při doručování. Doporučená frekvence aktualizace dat Výdejních míst dopravců je jednou denně po 6:00.
Volání feedu provádějte v časech „mezi“, například 6:13 | 6:28 | 6:47, místo přes celé hodiny. Volat feed častěji než jednou denně není nutné, protože data jsou aktualizována denně před 6:00.
Klientská sekce
Aby se v widgetu mohly zobrazovat externí výdejní místa, musíte v klientské sekci povolit externí výdejní místa. Viz. návod zde.
Vytvoření zásilky
V tomto kroku vyplníte informace, které poskytl zákazník. ID dopravce se zadává do atributu <addressId>. Carrier PUDO se specifikuje v <carrierPickupPoint>.
Podrobnosti o vytváření zásilky naleznete zde.
ID výdejního místa dopravce se může shodovat s výdejním místem Zásilkovny. Proto je potřeba rozlišovat mezi <addressId>, kam vyplňujete ID dopravce nebo ID výdejních míst Zásilkovny a Z-BOXů.
U výdejních míst externích dopravců je potřeba ID výdejního místa vyplnit do <carrierPickupPoint>. V dokumentaci najdete příklad spránvého podání.
Žádost bude vypadat následovně:
<!--request-->
<createPacket>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetAttributes>
<id></id>
<number>orderNumber</number>
<name>Joe</name>
<surname>Doe</surname>
<company>Company</company>
<email>>example@packetatest.com</email>
<phone>48528732145</phone>
<addressId>3060</addressId> <!-- ID Dopravce -->
<currency></currency>
<cod>80</cod>
<value>80</value>
<weight>5</weight>
<eshop>{{SENDER_INDICATION}}</eshop> <!-- Označení odesílatele z klientské sekce -->
<adultContent></adultContent>
<note></note>
<street>Laskowice</street>
<houseNumber>42</houseNumber>
<city>Łódź</city>
<province></province>
<zip>93-460</zip>
<carrierService></carrierService>
<carrierPickupPoint>ALK01A</carrierPickupPoint> <!-- ID externího výdejního místa -->
<size>
<length>300</length>
<width>300</width>
<height>300</height>
</size>
</packetAttributes>
</createPacket>
<!--response-->
<response>
<status>ok</status>
<result>
<id>3337546653</id>
<barcode>Z3337546653</barcode>
<barcodeText>Z 333 7546 653</barcodeText>
</result>
</response>
Volání dopravce
Po vytvoření zásilky na externí výdejní místo je nutné zavolat dopravce a vytvořit tak trasovací číslo.
K tomu používáme packetCourierNumber().
<!-- request-->
<packetCourierNumber>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetId>Z3337546653</packetId>
</packetCourierNumber>
<!-- response -->
<response>
<status>ok</status>
<result>2369886144</result>
</response>
Stažení štítku
Pro stažení štítku je potřeba použít jednu z metod volání štítku dopravce: https://docs.packeta.com/docs/label-printing/carrier-label. V tomto příkladu použijeme <packetCourierLabelPdf()>.
<!--request-->
<packetCourierLabelPdf>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetId>Z3337546653</packetId>
<courierNumber>2369886144</courierNumber>
</packetCourierLabelPdf>
<!--response-->
<response>
<status>ok</status>
<result>JVBERi0xLjcKJeLjz9MKNyAwIG9iago8P.....NDU1PiBdID4+CnN0YXJ0eHJlZgo4ODE1NwolJUVPRgo=</result>
</response>
V odpovědi obdržíte štítek ve formátu .xml. Po jeho dekódování do .pdf uvidíte štítek takto.

Trasování zásilky
Pro sledování zásilky mimo síť Zásilkovny můžete použít packetCourierTracking().
Ve spojení s packetTracking() získáte chronologický přehled stavů, kterými zásilka prošla uvnitř i mimo síť Zásilkovny, včetně jejího aktuálního stavu.
Zde naleznete seznam trasovacích stavů Zásilkovny.
Časy v podrobnostech zásilky ve webovém trasování se zobrazují ve středoevropském časovém pásmu (CET/CEST). Dopravce zobrazuje časy ve svém lokálním čase. Údaje se proto můžou lišit.
V API trasování se časový záznam v packetTracking() může lišit od packetCourierTracking(). Packeta používá v packetTracking() středoevropské časové pásmo (CET/CEST), zatímco dopravci obvykle používají své lokální časové pásmo.
Příklad:
Trasování Zásilkovny
<!--request-->
<packetTracking>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetId>Z3337546653</packetId>
</packetTracking>
<!--response-->
<response>
<status>ok</status>
<result>
<record>
<dateTime>2025-10-13T18:41:35</dateTime>
<statusCode>1</statusCode>
<codeText>received data</codeText>
<statusText>O vaší zásilce už víme a čekáme, až nám ji odesílatel předá.</statusText>
<branchId>0</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-10-13T18:41:37</dateTime>
<statusCode>1</statusCode>
<codeText>received data</codeText>
<statusText>Zásilka byla připravena k předání externímu dopravci PL InPost Paczkomaty Box, sledovací kód 2369886144.</statusText>
<branchId>0</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode>2369886144</externalTrackingCode>
</record>
<record>
<dateTime>2025-10-13T19:54:05</dateTime>
<statusCode>2</statusCode>
<codeText>arrived</codeText>
<statusText>Příjem zásilky na výdejním místě VM DEPO, Praha 15, Štěrboholy, K Hrušovu 292/4.</statusText>
<branchId>13832</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-10-13T20:01:17</dateTime>
<statusCode>3</statusCode>
<codeText>prepared for departure</codeText>
<statusText>Zásilka byla připravena k odeslání z VM DEPO, Praha 15, Štěrboholy, K Hrušovu 292/4 do DEPO, Praha - Štěrboholy, K Hrušovu 292/4.</statusText>
<branchId>13832</branchId>
<destinationBranchId>13497</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-10-13T20:41:44</dateTime>
<statusCode>2</statusCode>
<codeText>arrived</codeText>
<statusText>Zásilka dorazila na depo. Praha-Štěrboholy, K Hrušovu 292/4</statusText>
<branchId>13497</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-10-13T21:05:25</dateTime>
<statusCode>2</statusCode>
<codeText>arrived</codeText>
<statusText>Zásilka dorazila na depo. Praha-Štěrboholy, K Hrušovu 292/4</statusText>
<branchId>13497</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-10-13T21:05:26</dateTime>
<statusCode>3</statusCode>
<codeText>prepared for departure</codeText>
<statusText>Zásilka byla připravena k odeslání z DEPO, Praha - Štěrboholy, K Hrušovu 292/4 do Depo Bielsko-Biała, Księdza Józefa Londzina 106.</statusText>
<branchId>13497</branchId>
<destinationBranchId>27630</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-10-14T06:45:52</dateTime>
<statusCode>2</statusCode>
<codeText>arrived</codeText>
<statusText>Zásilka dorazila na depo. Bielsko-Biała, Księdza Józefa Londzina 106</statusText>
<branchId>27630</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-10-14T07:41:08</dateTime>
<statusCode>6</statusCode>
<codeText>handed to carrier</codeText>
<statusText>Zásilku jsme předali dopravci PL InPost Paczkomaty Box. Trasovací číslo: 2369886144</statusText>
<branchId>0</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode>2369886144</externalTrackingCode>
</record>
<record>
<dateTime>2025-10-14T07:44:12</dateTime>
<statusCode>6</statusCode> <!-- zásilka byle předána externímu dopravci -->
<codeText>handed to carrier</codeText>
<statusText>Zásilku jsme předali dopravci PL InPost Paczkomaty Box. Trasovací číslo: 2369886144. </statusText>
<branchId>0</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode>2369886144</externalTrackingCode>
</record>
<record>
<dateTime>2025-10-15T04:07:18</dateTime>
<statusCode>4</statusCode>
<codeText>departed</codeText>
<statusText>Zásilka byla odeslána na pobočku Depo Bielsko-Biała, Księdza Józefa Londzina 106.</statusText>
<branchId>13497</branchId>
<destinationBranchId>27630</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-10-15T10:14:40</dateTime>
<statusCode>7</statusCode>
<codeText>delivered</codeText>
<statusText>Zásilka je u vás. Děkujeme a těšíme se na příště.</statusText>
<branchId>3060</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
</result>
</response>
Trasování dopravce
<!--request-->
<packetCourierTracking>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetId>Z1436939952</packetId>
</packetCourierTracking>
<!--response-->
<?xml version="1.0" encoding="utf-8"?>
<response>
<status>ok</status>
<result>
<record>
<dateTime>2025-10-13T16:41:36</dateTime>
<carrierClass>plpaczkomaty</carrierClass>
<statusCode>confirmed</statusCode>
<externalStatusName>Potvrzeno.</externalStatusName>
<externalNote></externalNote>
<externalTrackingCode>2369886144</externalTrackingCode>
</record>
<record>
<dateTime>2025-10-14T14:19:09</dateTime>
<carrierClass>plpaczkomaty</carrierClass>
<statusCode>sent_from_source_branch</statusCode>
<externalStatusName>Odesláno z podací pobočky.</externalStatusName>
<externalNote></externalNote>
<externalTrackingCode>2369886144</externalTrackingCode>
</record>
<record>
<dateTime>2025-10-14T22:03:50</dateTime>
<carrierClass>plpaczkomaty</carrierClass>
<statusCode>sent_from_source_branch</statusCode>
<externalStatusName>Odesláno z podací pobočky.</externalStatusName>
<externalNote></externalNote>
<externalTrackingCode>2369886144</externalTrackingCode>
</record>
<record>
<dateTime>2025-10-15T04:42:21</dateTime>
<carrierClass>plpaczkomaty</carrierClass>
<statusCode>out_for_delivery</statusCode>
<externalStatusName>Vydáno k doručení.</externalStatusName>
<externalNote></externalNote>
<externalTrackingCode>2369886144</externalTrackingCode>
</record>
<record>
<dateTime>2025-10-15T07:14:36</dateTime>
<carrierClass>plpaczkomaty</carrierClass>
<statusCode>ready_to_pickup</statusCode>
<externalStatusName>Připraveno k vyzvednutí.</externalStatusName>
<externalNote></externalNote>
<externalTrackingCode>2369886144</externalTrackingCode>
</record>
</result>
</response>
Nenašli jste, co hledáte? Kontaktujte náš integrační support na integrations@packeta.com.