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:

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.
Není možné vytvořit balík se zásilkou, kterou jste už fyzicky podali do naší sítě.
Nenašli jste, co jste hledali? Kontaktujte náš integrační tým na integrations@packeta.com.