API Reference
  1. SKUU Connect API
  2. Orders

Create a shipping order

post
https://{customer_host}/skuu/v1/orders

Create one paid, ship-only order for the items SKUU routed to the shipping shop.

  • Idempotency: external_ref. The same reference must always return the same order; different data under the same reference is 409.
  • Response: HTTP 200 with the required receipt fields; an optional message and extra response fields do not affect success. 201, missing required fields or incorrect references are failures.
  • Retries: SKUU retries a network failure, 429 and any 5xx; the schedule is on Errors and retries. Any other 4xx stops the flow and alerts SKUU customer service.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

A paid, ship-only order SKUU asks the shipping shop to create.

string
required
length between 1 and 255

SKUU's stable order reference and the idempotency key. The same reference must always return the same order.

const
enum
required

Always skuu_ship. It marks the order so the store's platform does not send it back to SKUU as a seller order.

Allowed:
const
enum
required

Always paid. The customer has paid the selling shop; SKUU settles with the shipping shop. Collect nothing.

Allowed:
string
required
^[A-Z]{3}$

ISO 4217 code of the amounts in this request.

ship_to
object
required

Complete delivery address of the customer.

shipping_method
object
required

How to ship. Only standard exists in v1.

line_items
array of objects
required
length between 1 and 1000

external_ref values must be unique within the order.

line_items*
Responses

Updated 27 days ago

Did this page help you?
Language
Credentials
URL
LoadingLoading…
Response
Choose an example:
application/json

Updated 27 days ago

Did this page help you?