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

Jak vytvořit balík

Balík (nebo virtuální balík) představuje skupinu jednotlivých zásilek, které jsou odesílány společně. Tuto službu využívají především e-shopy při předávání zásilek kurýrovi, nebo při předání na depu. Stačí přidat všechny vaše zásilky do balíku, aby je kurýr mohl naskenovat najednou, což urychluje předání i doručení.

Jak vytvořit balík​

Pro vytvoření balíku použijte metodu createShipment(). Odpověď obsahuje <barcode> balíku, který budete potřebovat později.

Příklad​

Request

<createShipment>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetIds>
<id>Z3692111615</id>
<id>Z4541958561</id>
<id>Z1885286407</id>
</packetIds>
</createShipment>

Response

<response>
<status>ok</status>
<result>
<id>200542356</id>
<checksum></checksum>
<barcode>D-***-XM-200542356</barcode>
<barcodeText>D-***-XM-200542356</barcodeText>
</result>
</response>

Barcode​

Po vytvoření balíku budete chtít vytisknout štítek s čárovým kódem pro naskenování kurýrem. Čárový kód vygenerujte pomocí metody barcodePng().

Příklad​

Request

<barcodePng>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<barcode>D-***-XM-200542356</barcode>
</barcodePng>

Response

<response>
<status>ok</status>
<result>
/9j/4AAQSkBl//ggZyB2MS4wI....
</result>
</response>

Váš barcode bude vypadat takto:

barcode

Seznam zásilek​

Pokud chcete vylistovat seznam zásilek, které jste přidali do balíku, použijte metodu shipmentPackets().

Příklad​

Request

<shipmentPackets>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<shipmentId>D-***-XM-200542356</shipmentId>
</shipmentPackets>

Response

<response>
<status>ok</status>
<result>
<packets>
<packet>
<id>3692111615</id>
<barcode>Z3692111615</barcode>
<barcodeText>Z 369 2111 615</barcodeText>
</packet>
<packet>
<id>1885286407</id>
<barcode>Z1885286407</barcode>
<barcodeText>Z 188 5286 407</barcodeText>
</packet>
<packet>
<id>4541958561</id>
<barcode>Z4541958561</barcode>
<barcodeText>Z 454 1958 561</barcodeText>
</packet>
</packets>
</result>
</response>

Možné chyby​

Při pokusu o vytvoření balíku můžete narazit na chybu PacketIdsFault. Nejčastější příčinou je, že je jedna ze zásilek, kterou se snažíte přidat do balíku, fyzicky už v naší síti. Pokud se pokusíte do balíku přidat zásilku reklamačního asistenta, balík se nevytvoří a dostanete chybu.

DŮLEŽITÉ

Není možné vytvořit balík se zásilkou, kterou jste už fyzicky podali do naší sítě.

KONTAKTUJTE NÁS

Nenašli jste, co jste hledali? Kontaktujte náš integrační tým na integrations@packeta.com.