Create Delivery Note

Creates a delivery note for a purchase order.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

A delivery note must contain at least one order line or at least one returnable item. A payload with neither is rejected with a 400 error. This means you can create a delivery note with only returnables (e.g. a supplier picking up empty crates with no goods delivered) by omitting order_lines entirely.

Asynchronous Order Line Processing

After the delivery note is created, the system processes the linking of order lines to their corresponding order packages asynchronously. This means the response returns immediately with the basic delivery note details, but the order line matching may take a few seconds to complete in the background.

To retrieve the fully linked order lines with their matched packages, use the Get Delivery Note Details endpoint after creation.

Path Params
string
required

The ID of the outlet

Body Params

Used for creating a delivery note

purchase_order
required

The purchase order reference. Required.

string
required

Delivery Note Number

date-time
required

Document Date/time

date-time
required

Delivery Date/time

string

Customer number

float

Delivery fee

returnables
array of objects

List of returnable items (e.g. crates, pallets) associated with the delivery note. If omitted, no returnables are created.

returnables
order_lines
array of objects

List of delivery note order lines. May be omitted or empty if at least one returnables item is provided. If provided, line_number values must start at 1, be sequential, and have no gaps or duplicates.

order_lines
Responses

400

Bad request - validation error

404

Purchase order not found

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json