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

Doručení na adresu

Pro vytvoření zásilky v rámci Zásilkovny je potřeba provést tyto kroky:

  1. Vybrat cílovou adresu zásilky
  2. Získat ID dopravce
  3. Vytvořit zásilku
  4. Zavolat dopravce
  5. Stáhnout štítek
  6. Sledování zásilky (volitelné)

Níže projdeme každý z těchto kroků.

Výběr cíle​

Pro možnost doručení na adresu je potřeba získat adresu zákazníka. Mějte na paměti, že dopravci provádějí validaci údajů. Telefonní číslo musí být místní mobilní číslo a hmotnost zásilky musí být větší než 0. Někteří dopravci také validují rozměry. Podrobný seznam validací naleznete zde.

Získání ID dopravce​

ID dopravce získáte v seznamu dopravců: https://pickup-point.api.packeta.com/v5/__API_KEY__/carrier/json?lang=__LANGUAGE__


Vytvoření zásilky​

V tomto kroku vyplníte údaje, které poskytl zákazník. ID dopravce se zadává do atributu <addressId>.
Podrobný návod k vytvoření zásilky naleznete zde.

Request 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>421000000000</phone>
<addressId>131</addressId> <!-- ID dopravce -->
<currency></currency>
<cod></cod>
<value>80</value>
<weight>5</weight>
<eshop>{{SENDER_INDICATION}}</eshop> <!-- Označení odesílatele z klientské sekce -->
<adultContent></adultContent>
<note></note>
<street>Kutlíkova</street>
<houseNumber>17</houseNumber>
<city>Bratislava</city>
<province></province>
<zip>85102</zip>
<size>
<length>300</length>
<width>300</width>
<height>300</height>
</size>
</packetAttributes>
</createPacket>

<!--response-->
<response>
<status>ok</status>
<result>
<id>3886977734</id>
<barcode>Z3886977734</barcode>
<barcodeText>Z 388 6977 734</barcodeText>
</result>
</response>

Volání dopravce​

Po vytvoření zásilky k doručení na adresu je nutné zavolat dopravce a vytvořit tak trasovací číslo.
K tomu používáme packetCourierNumber().

<!-- request-->
<packetCourierNumber>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetId>Z3886977734</packetId>
</packetCourierNumber>

<!-- response -->
<response>
<status>ok</status>
<result>0286929453</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>Z3886977734</packetId>
<courierNumber>0286929453</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.

HD Direct label


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.

info

Č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>Z1436939952</packetId>
</packetTracking>

<!--response-->
<response>
<status>ok</status>
<result>
<record>
<dateTime>2025-10-01T23:59:57</dateTime>
<statusCode>1</statusCode>
<codeText>received data</codeText>
<statusText>O vašej zásielke už vieme. Čakáme, kedy nám ju odosielateľ dodá.</statusText>
<branchId>0</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-10-02T00:00:08</dateTime>
<statusCode>1</statusCode>
<codeText>received data</codeText>
<statusText>Zásielka bola pripravená na odovzdanie externému dopravcovi SK Packeta Home HD, sledovací kód 0286929453.</statusText>
<branchId>0</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode>0286929453</externalTrackingCode>
</record>
<record>
<dateTime>2025-10-02T00:00:09</dateTime>
<statusCode>1</statusCode>
<codeText>received data</codeText>
<statusText>Zásielka bola pripravená na odovzdanie externému dopravcovi SK Packeta Home HD, sledovací kód 0286929453.</statusText>
<branchId>0</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode>0286929453</externalTrackingCode>
</record>
<record>
<dateTime>2025-10-08T16:28:27</dateTime>
<statusCode>2</statusCode>
<codeText>arrived</codeText>
<statusText>Zásielka dorazila na depo. Zavar, Prílohy 699/87</statusText>
<branchId>14256</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-10-08T16:43:17</dateTime>
<statusCode>6</statusCode>
<codeText>handed to carrier</codeText>
<statusText>Zásielku sme odovzdali dopravcovi SK Packeta Home HD. Sledovacie číslo: 0286929453.</statusText>
<branchId>0</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode>0286929453</externalTrackingCode>
</record>
<record>
<dateTime>2025-10-08T16:43:41</dateTime>
<statusCode>6</statusCode> <!-- Zásilka byla předána externímu dopravci -->
<codeText>handed to carrier</codeText>
<statusText>Zásielku sme odovzdali dopravcovi SK Packeta Home HD. Sledovacie číslo: 0286929453.</statusText>
<branchId>0</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode>0286929453</externalTrackingCode>
</record>
<record>
<dateTime>2025-10-09T14:58:00</dateTime>
<statusCode>7</statusCode>
<codeText>delivered</codeText>
<statusText>Zásielka je doručená. Ďakujeme a tešíme sa na vašu ďalšiu zásielku.</statusText>
<branchId>131</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-08T16:28:44</dateTime>
<carrierClass>skremaxhome</carrierClass>
<statusCode>1</statusCode> <!-- Zásilka byla přijata externím dopravcem-->
<externalStatusName>Zásielku sme v poriadku prijali do prepravy a budeme ju doručovať nasledujúci pracovný deň.</externalStatusName>
<externalNote></externalNote>
<externalTrackingCode>51892669</externalTrackingCode>
</record>
<record>
<dateTime>2025-10-09T08:07:37</dateTime>
<carrierClass>skremaxhome</carrierClass>
<statusCode>4</statusCode>
<externalStatusName>Kuriér vyrazil na cestu a zásielka bude dnes doručovaná.</externalStatusName>
<externalNote></externalNote>
<externalTrackingCode>51892669</externalTrackingCode>
</record>
<record>
<dateTime>2025-10-09T14:58:00</dateTime>
<carrierClass>skremaxhome</carrierClass>
<statusCode>5</statusCode>
<externalStatusName>Zásielka je doručená. Ďakujeme a tešíme sa na vašu ďalšiu zásielku.</externalStatusName>
<externalNote></externalNote>
<externalTrackingCode>51892669</externalTrackingCode>
</record>
</result>
</response>
info

Nenašli jste, co hledáte? Kontaktujte náš integrační support na integrations@packeta.com.