Page tree
Skip to end of metadata
Go to start of metadata

Warning!

Resource available only in the following countries: PL

The functionality allows for generating manifests for shipments whether or not they have dispatch orders.

2 methods are available:

  • Method for generating a manifest for the dispatch order (printout)
  • Method for generating a manifest for the indicated shipment IDs (printouts)



On this page

 

Structure

  • In case of one shipment a single *.pdf  file is returned
  • In case of multiple shipments
    - In case shipments are of the same service a single *.pdf file with all the shipments is included
    - In case shipments are from multiple services a single *.zip file containing *.pdf files is returned (seperate *.pdf file for each service)
  • Maximum of 100 manifests for shipments can be downloaded at once



Authentication

Access to the resource requires a valid access token.



Printing a Dispatch Order

(info) To print a dispatch order the user has to be the sender of the shipment.

GET /v1/dispatch_orders/:id/printout

Parameters 

Parameter

Type

Description

Validation

Default value

Availability

format

string

Label format

Available formats: Pdf 

Pdf

PL

Example request

curl -X GET "https://api-shipx-pl.easypack24.net/v1/dispatch_orders/1/printout?format=Pdf" -H "Content-Type: application/json" -H "Authorization: Bearer token"

Response

File in a given format

Error Information

  • resource_not_found - Dispatch Order does not exist
  • token_invalid - Token does not allow for printing dispatch orders for the given organisation

  • printout_generation_failed - An error occured while communicating with the logistics system

  • invalid_status - Shipment is in an incorrect status



Printing multiple Dispatch Orders

(info) To print a dispatch order the user has to be the sender of the shipment.

GET /v1/organizations/:organization_id/dispatch_orders/printouts

Parameters 

Parameter

Type

Description

Validation

Default value

Availability

format

string

Label format

Available formats: Pdf 

Pdf

PL

dispatch_order_id

Integer

Dispatch order IDs



PL

shipment_ids

Array[Integer]

Shipment IDs

Required if no dispatch_order_id are provided

  • Printing dispatch orders for shipments with and without dispatch orders is not possible.
  • Shipments need to have the confirmed status
  • At least one shipment ID has to be provided

PL

Example request

curl -X GET "https://api-shipx-pl.easypack24.net/v1/organizations/1/dispatch_orders/printouts?shipment_ids[]=123&shipment_ids[]=124&shipment_ids[]=125&format=Pdf" -H "Authorization: Bearer token" -H "Content-Type: application/json" -o test.zip

Response

Zip file with labels in the given format

Error Information

  • resource_not_found - Organisation does not exist,
  • token_invalid - Token does not allow for printing dispatch orders for the given organisation

  • printout_generation_failed - An error occured while communicating with the logistics system

  • cannot_mix_shipments_with_and_without_dispatch_order - Cannot download shipments with and without a dispatch order in one request.

  • invalid_status - Shipment is in an incorrect status.


  • No labels