Doručení na výdejní místo Zásilkovny
Pro vytvoření zásilky v rámci sítě Packeta je potřeba provést tyto kroky:
- Vybrat cílové výdejní místo
- Získat ID výdejního místa Packeta
- Vytvořit zásilku
- Stáhnout štítek
- Sledování zásilky (volitelné)
Níže projdeme každý z těchto kroků.
Výběr cíle
Abyste svým zákazníkům nabídli dostupná výdejní místa Packeta, máte dvě možnosti:
- Použít widget Packeta (mapový nástroj)
- Integrovat feedy Packeta (zdroj dat)
Integrace widgetu
Widget je mapový nástroj, který umožňuje 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, zaměřené na jednoduchost a známé uživatelské prostředí. Nejnovější verzi lze vidět na https://widget.packeta.com/v6/#/.
Implementace výdejních míst Zásilkovny přes widget je pouze 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 integrován ve svém řešení, můžete specifikovat, kteří dopravci se mají zobrazit pro každou zemi. Můžete povolit více dopravců pro jednu zemi nebo žádného. Pro zobrazení pouze výdejních míst Packeta použijte řetězec country v poli vendors.
const packetaOptions = {
vendors: [
{
country: "cz"
}
]
};
K testování různých konfiguračních možností máme k dispozici také testovací prostředí na https://codepen.io/Packeta/pen/xxNRWEN
Integrace feedu
Feed je zdroj dat (JSON), ze kterého můžete čerpat 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.
Získání ID výdejního místa Zásilkovny
ID výdejního místa můžete získat z:
Z widgetu obdržíte atribut <id> v objektu point
{
"id": "79", // ID výdejního místa Packeta
"isNew": false,
"maxWeight": 15,
"name": "Praha 4, Nusle, Na Pankráci 969/97 (Kopretina, Pražského povstání)",
"nameStreet": "Praha 4, Nusle, Na Pankráci 969/97 (Kopretina, Pražského povstání)",
...
}
Z feedu obdržíte atribut <id>
{
"id": "79", // ID výdejního místa Packeta
"name": "Praha 4, Nusle, Na Pankráci 969/97 (Kopretina, Pražského povstání)",
"place": "Výdejní místo Packeta",
"street": "Na Pankráci 969/97",
"city": "Praha",
"zip": "140 00",
"country": "cz",
"currency": "CZK",
"status": {
"statusId": "1",
"description": "V provozu"
},
"displayFrontend": "1", // respektujte tento atribut
...
}
Vytvoření zásilky
V tomto kroku vyplníte údaje od zákazníka. ID výdejního místa patří do atributu <addressId>.
Podrobnosti o vytvoření zásilky naleznete zde.
Request bude vypadat následovně:
<!--request-->
<createPacket>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetAttributes>
<number>orderNumber</number>
<name>Joe</name>
<surname>Doe</surname>
<company>Company</company>
<email>example@packetatest.com</email>
<phone>+420777777777</phone>
<addressId>79</addressId> <!-- ID výdejního místa -->
<cod>0</cod>
<value>115</value>
<currency>CZK</currency>
<weight>2.5</weight>
<eshop>{{INDICATION}}</eshop> <!-- Pole z Klientské sekce/Odesílatel/Indikace -->
</packetAttributes>
</createPacket>
<!--response-->
<response>
<status>ok</status>
<result>
<id>4665757012</id>
<barcode>Z4665757012</barcode>
<barcodeText>Z 466 5757 012</barcodeText>
</result>
</response>
Stažení štítku
Jakmile úspěšně vytvoříte zásilku, je potřeba vygenerovat štítek. Protože zásilku budete posílat přes síť Zásilkovny, můžete pokračovat jednou z dostupných metod generování štítků.
V tomto příkladu použijeme <packetLabelPdf>.
<!--request-->
<packetLabelPdf>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetId>Z4665757012</packetId>
<format>A6 on A6</format>
<offset>0</offset>
</packetLabelPdf>
<!--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 můžete štítek zobrazit například takto:

Sledování zásilky
Pro sledování vaší zásilky po předání do sítě Zásilkovny můžete použít packetTracking(). Zobrazíte tak chronologický přehled stavů, kterými zásilka prošla i její současný stav.
Zde naleznete seznam dostupných stavů.
Příklad:
<!--request-->
<packetTracking>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetId>Z4665757012</packetId>
</packetTracking>
<!--response-->
<?xml version="1.0" encoding="utf-8"?>
<response>
<status>ok</status>
<result>
<record>
<dateTime>2025-06-30T11:28:59</dateTime>
<statusCode>1</statusCode>
<codeText>data přijata</codeText>
<statusText>O zásilce víme a čekáme, až ji vám odesílatel předá.</statusText>
<branchId>0</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-06-30T12:20:32</dateTime>
<statusCode>2</statusCode>
<codeText>dorazilo</codeText>
<statusText>Zásilka dorazila do Praha 9, Libeň, Ocelářská 1018/3.</statusText>
<branchId>8993</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-06-30T12:22:14</dateTime>
<statusCode>3</statusCode>
<codeText>připraveno k odeslání</codeText>
<statusText>Zásilka byla připravena k odeslání z Praha 9, Libeň, Ocelářská 1018/3 do DEPO, Praha - Štěrboholy, K Hrušovu 292/4.</statusText>
<branchId>8993</branchId>
<destinationBranchId>13497</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-06-30T17:54:05</dateTime>
<statusCode>2</statusCode>
<codeText>dorazilo</codeText>
<statusText>Zásilka dorazila do depa Praha-Štěrboholy, K Hrušovu 292/4.</statusText>
<branchId>13497</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-07-01T04:59:58</dateTime>
<statusCode>3</statusCode>
<codeText>připraveno k odeslání</codeText>
<statusText>Zásilka byla připravena k odeslání z DEPO, Praha - Štěrboholy, K Hrušovu 292/4 do výdejny Na Pankráci 969/97 (Kopretina, Pražského povstání).</statusText>
<branchId>13497</branchId>
<destinationBranchId>79</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-07-01T12:09:15</dateTime>
<statusCode>4</statusCode>
<codeText>odesláno</codeText>
<statusText>Zásilka byla odeslána do výdejny Na Pankráci 969/97 (Kopretina, Pražského povstání).</statusText>
<branchId>13497</branchId>
<destinationBranchId>79</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-07-01T13:11:26</dateTime>
<statusCode>5</statusCode>
<codeText>připraveno k vyzvednutí</codeText>
<statusText>Zásilka dorazila na konečné místo určení.</statusText>
<branchId>79</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
<record>
<dateTime>2025-07-01T14:34:42</dateTime>
<statusCode>7</statusCode>
<codeText>doručeno</codeText>
<statusText>Zásilka je u vás. Děkujeme a těšíme se na další spolupráci.</statusText>
<branchId>79</branchId>
<destinationBranchId>0</destinationBranchId>
<externalTrackingCode></externalTrackingCode>
</record>
</result>
</response>
Nenašli jste, co hledáte? Kontaktujte náš integrační support na integrations@packeta.com.