Orders

Create order

Endpoint: POST /v10/order-channels/{publicOrderChannelId}/orders

caution

This endpoint will attempt to create an order on order channel with public ID = publicOrderChannelId. The public order channel ID is something that you should get from the brand.

You also have to consider if the brand sells in drops. If they do, and they allow to buy in multiple drops on the order channel then you have to add drop code. If the brand does not sell in drops, or if the order channel uses a fixed drop, then drop code is not necessary.

Note that depending on the products, drop and your terms the order might be rejected so be sure to implement error handling. Any error returned by the order API will follow our standard error format

Parameter	Required	Default	Description
order	Yes		Order data

Order data

Parameter	Required	Default	Description
customer_id	Yes, if no customer_number is given		Identification of the buyer
customer_number	Yes, if no customer_id is given		Identification of the buyer
drop_id	Yes, if brand requires drop and no drop_code is given		The drop of the order
drop_code	Yes, if brand requires drop and no drop_id is given		The drop of the order
lines.*	Yes		An array of object order line data

Order line data

Parameter	Required	Default	Description
sku	Yes, if no ean is given		The SKU of the line
ean	Yes, if no sku is given		The EAN of the line
quantity	Yes		The number of pieces for this line

Example

POST /v10/order-channels/sjdgt7su21/orders

{
  "order": {
    "customer_number": "38492985",
    "drop_code": "STOCK",
    "lines": [
      {
        "sku": "1000-100-XS",
        "quantity": 1
      },
      {
        "sku": "1000-100-S",
        "quantity": 1
      }
    ]
  }
}