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

Home delivery

Home delivery packets are created by passing an ID of a home delivery carrier into the addressId field. IDs of external carriers can be obtained using our carriers list

Unlike Pick-up point packets, when creating home delivery packets, you will also have to specify the recipient's address using the street, houseNumber, city, zip, and province attributes.

For packets heading outside of the EU, you will also have to declare customs data using packetItems and packetAttributes

info

No country attribute exists in our packetAttributes, since the destination country is inferred automatically based on the specified addressId.

Home delivery without customs​


<!--request-->
<createPacket>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetAttributes>
<number>orderNumber</number>
<name>John</name>
<surname>Doe</surname>
<company>Example Company</company>
<email>example@packetatest.com</email>
<phone>+420777777777</phone>
<addressId>106</addressId> <!--carrier ID-->
<cod>123</cod>
<weight>2.5</weight>
<value>123</value>
<currency>CZK</currency>
<!--Since we are creating a home delivery packet, we need to specify an address-->
<street>Českomoravská</street>
<houseNumber>2408/1a</houseNumber>
<city>Praha</city>
<zip>19000</zip>
<note>Note</note>
<eshop>{{SENDER_INDICATION}}</eshop>
</packetAttributes>
</createPacket>


<!--response-->
<response>
<status>ok</status>
<result>
<id>4154010000</id>
<barcode>Z4154010000</barcode>
<barcodeText>Z 415 4010 000</barcodeText>
</result>
</response>


Home delivery with customs data​


<!--request-->
<createPacket>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetAttributes>
<number>orderNumber</number>
<name>John</name>
<surname>Doe</surname>
<email>example@packetatest.cz</email>
<phone>+41337237500</phone>
<addressId>3294</addressId> <!--ID of Swiss Post - requiress customs declarations-->
<currency>CZK</currency>
<cod></cod>
<value>1500</value>
<eshop>{{SENDER_INDICATION}}</eshop>
<weight>1</weight>
<adultContent>0</adultContent>
<street>Viktoriapl.</street>
<houseNumber>1</houseNumber>
<city>Bern</city>
<zip>3013</zip>
<note>Note</note>
<attributes>
<attribute>
<key>ead</key>
<value>create</value>
</attribute>
<attribute>
<key>deliveryCost</key>
<value>200</value>
</attribute>
<attribute>
<key>invoiceNumber</key>
<value>35421568</value>
</attribute>
<attribute>
<key>invoiceIssueDate</key>
<value>2021-5-10</value>
</attribute>
<attribute>
<key>invoiceFile</key>
<value>31759</value>
</attribute>
</attributes>
<items>
<item>
<attributes>
<attribute>
<key>customsCode</key>
<value>09030000</value>
</attribute>
<attribute>
<key>countryOfOrigin</key>
<value>CN</value>
</attribute>
<attribute>
<key>value</key>
<value>1500</value>
</attribute>
<attribute>
<key>productNameEn</key>
<value>Maté 1kg pack</value>
</attribute>
<attribute>
<key>unitsCount</key>
<value>1</value>
</attribute>
<attribute>
<key>weight</key>
<value>1</value>
</attribute>
</attributes>
</item>
</items>
</packetAttributes>
</createPacket>


<!--response-->
<response>
<status>ok</status>
<result>
<id>3218327000</id>
<barcode>Z3218327000</barcode>
<barcodeText>Z 321 8327 000</barcodeText>
</result>
</response>