v6

latestOpenAPI 3.0.1raw.githubusercontent.com2025-12-09153208467.0 KB
shipments

Book a shipment label

ADD ENDPOINT DESCRIPTION HERE

post/shipments/book

Request body

requestUUIDstring

A unique identifier for the request. <br>Used for tracing and to prevent duplicate shipment bookings. <br>This value is optional, if not included, a random requestUUID is generated.

referencestring

A human readable reference for the request. <br>This will be included in the mail that is sent once the operation completes.<br>This value is optional, if not included, a random reference will be generated.

shippingServiceGroupIdinteger required

shipping service group from which to load the shipping services to use.

lengthMnumber

Optional length <em>(in meters)</em> of the shipment.

widthMnumber

Optional width <em>(in meters)</em> of the shipment.

heightMnumber

Optional height <em>(in meters)</em> of the shipment.

grossWeightKgnumber required

The total weight <em>(kilograms)</em> of the shipment including packaging.

sellerIdinteger required

The seller who is booking this shipment (required). <br>The booked shipment will show up in the history of this seller.

invoiceNumberstring

The invoice number to be used for customs declaration.

invoiceDatestring date

The invoice date to be used for customs declaration.

transportInsuranceAmountnumber

Optional amount which should get insured when booking the shipment. <br>Note that most shipping services already have a basic insurance included. To use the already included insurance, you must not set this field to any value other than <code>null</code>.<br>Setting this field to a non <code>null</code> value will book an additional insurance.

includeReturnLabelboolean

Optional value setting whether a return labels should be included in addition to the main label or not.

trackingEnabledboolean

Optional value setting whether to turn on/off tracking functionality for shipment. Additional charges will apply when set to true.

shipmentDatestring date

Optional future or today's date when the shipment will be handed over to the carrier. If not specified, default's to today.

termsOfTrade'DAP' | 'DDP'

Optional terms of trade. If not specified, default's <code>DAP</code>.

userIdentifierstring

The userId of a third party app who booked the shipment.

shopOrderIdentifierstring

Optional value. Identifies the order in the customer's shop.

contentDescriptionstring

Optional description of the shipment contents.

systemReferencestring

Optional system reference, can be used to trace the shipment

cashOnDeliveryAmountnumber

Optional COD total amount parameter. If the amount is greater than 0, it will be processed as a COD shipment

cashOnDeliveryCurrencystring

The currency in which COD amount is specified.

Response

successful operation

status'OK' | 'ERROR'

Indicates whether the operation was successful or not.

messagestring

Optional additional information about the operation's result. <br>When the operation failed, this field includes more information about the error.

bookedShipmentIdinteger

ID of booked shipment

trackingNumberstring

The tracking number of the booked shipment.

trackingLinkstring

The tracking link of the booked shipment. Note that some carriers do not immediately recognize shipments after they have been created

labelUrlsstring[]

List of URLs where the labels can be downloaded.

documentUrlsstring[]

List of URLs where additional documents, such as export documents, can be downloaded.