May 6, 2026
New shippingDetails.id field for pre-agreed ship-to locations, and support for up to four line references per order line.
Orders
Shipping
A new id field has been added to shippingDetails. This field may be used when pre-agreed ship-to locations have been established with your sales representative.
When a value is provided for shippingDetails.id, validation of the remaining shippingDetails fields is bypassed. However, the provided ID is validated against the specified legal entity (invoiceDetails.id). Only pre-agreed ship-to IDs are accepted.
If shippingDetails.id is not provided (e.g., null), the standard validation rules apply, and all required shippingDetails fields must be populated and valid.
The shippingDetails property in the payload remains required; however, its child properties are conditionally required as of this change.
Order Lines
You may now include up to four line references per order line. These values are returned in all order events that include line items. For additional details, refer to the Events documentation.
The API specification has been updated to reflect these changes. Example payloads are also available for reference.