Create one paid ship-only order

post

https://{merchantHost}/{connectBasePath}/orders

Merchant-hosted endpoint called by SKUU after routing one or more order
lines to the selected shipper. One request creates exactly one paid order
and may contain multiple lines. The order carries the exact skuu_ship
tag so a resulting order.created webhook is acknowledged without being
routed back into the network.

external_ref is the order idempotency key. An identical retry must return
the original exact receipt and must not create another order. Reusing the
reference with a different body returns 409. SKUU signs the exact UTF-8
JSON bytes and preserves those bytes across retries.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

One paid, standard-carrier order. Destination countries in Connect v1
are NL, BE and DE. Line external_ref values must be unique within the
request and at least one of variant_id or barcode is required per line.

One paid ship-only order; one request may contain multiple lines.

external_ref

string

required

length between 1 and 255

^\S(?:[^\u0000-\u001F\u007F]*\S)?$

Non-empty string without surrounding whitespace or ASCII control characters.

tag

const

enum

required

Allowed:

payment_status

const

enum

required

Allowed:

currency

string

required

^[A-Z]{3}$

Uppercase ISO-4217 code agreed for the customer environment.

ship_to

object

required

shipping_method

object

required

line_items

array of objects

required

length between 1 and 1000

external_ref values must be unique within this order.

line_items*

Responses

Language

Credentials

URL

Loading…

Response

Choose an example:

application/json

200Created, or an identical idempotent replay. The body has exactly five fields. external_ref must echo the request and order_id is a stable opaque string. Any other 2xx status or response shape is a contract failure to the SKUU client.

400Invalid request. A missing or empty external_ref uses the stable invalid_external_ref error code. Permanent and not retried by SKUU.

401Missing or invalid bearer credential or request signature; permanent until configuration changes.

403Authenticated credential is forbidden from creating orders; permanent until access policy changes.

409external_ref was already used with a different request body. No new order may be created. Permanent and not retried automatically.

429Rate limited. SKUU retries the identical signed request, up to three total attempts, honoring a numeric-seconds Retry-After header.

5XXTransient merchant failure. SKUU retries the identical signed request, up to three total attempts, with exponential backoff and jitter.