---
title: "Create Orders"
method: POST
path: "/v1/channel/order"
tags: ["Order"]
---

# Create Orders

`POST /v1/channel/order`

Create new Orders

## Request body

- OrderList
  - `orderList` Order[], required
    - `sellerId` string, required — A unique Id identify a Seller on a specific SalesChannel. The SellerId is generated from the Channel itself during the Seller SignUp Process.
    - `orderStatus` 'UNACKED' | 'CREATED' | 'ACCEPTED' | 'SHIPPED' | 'PARTIALLY_SHIPPED' | 'CANCELED_BY_SELLER' | 'CANCELED_BY_BUYER', required — The current order status. * **UNACKED**: Order is created in Marketplace but a Seller acknowledge is required. * **CREATED**: Order is created but not yet completed. * **ACCEPTED**: Order is placed and checkout process is complete but not yet shipped. * (DEPRECATED) ~~SHIPPED~~: All items in the order have been shipped * (DEPRECATED) ~~PARTIALLY_SHIPPED~~: Some items (but not all) have been shipped. * (DEPRECATED) ~~CANCELED_BY_SELLER~~: Order is canceled by seller. * (DEPRECATED) ~~CANCELED_BY_BUYER~~: Order is canceled by buyer.
    - `orderAcceptUntil` string, date-time — When `orderStatus` is type `UNACKED` a Seller integration must confirn a Order bevor it can be proccessed. This field provides a time until when an order can be accepted. To accept an Order a Seller integration must invoke API call `PUT /v1/seller/order/accept`.
    - `paymentMethod` string
    - `paymentReference` string — Payment reference can be used to reference or identify a payment transaction
    - `orderId` string, required
    - `purchasedAt` string, date-time, required
    - `lastChangedAt` string, date-time, required
    - `currency` string, required
    - `orderItem` OrderItem[], required — List of Order Positions such as Order Items, Shipping or Payment. There must be at least on Item of Type ITEM and at least on Item of Type SHIPPING.
      - union
        - object
          - `orderItemId` string, string, required — A unique identifier to identify a order item. This ID is provided by the Channel itself an should be used to identify a order item id.
          - `type` string, required
          - `itemStatus` 'UNSHIPPED' | 'SHIPPED' | 'CANCELED_BY_SELLER' | 'CANCELED_BY_BUYER' | 'RETURNED' | 'REFUNDED' — The current for order item. * **UNSHIPPED**: Item is ready for shipping * **SHIPPED**: Item is sent to buyer * **CANCELED_BY_SELLER**: Order is canceled by seller. * **CANCELED_BY_BUYER**: Order is canceled by buyer. * **RETURNED**: Item is returned to Seller. * **REFUNDED**: Item was returned and refunded.
          - `itemPaymentStatus` 'PENDING' | 'PAID' — The current payment status * **PENDING**: Order Item is not yet paid. * **PAID**: Order Item is complete paid.
          - `grossPrice` string, required — The order item gross price The gross price is not allowed to have more than 2 decimal places.
          - `total` string, required — Overall gross price (quantity * grossPrice) The total is not allowed to have more than 2 decimal places.
          - `taxPercent` string, nullable
          - `grossFee` string, nullable — The accrued sales charge (gross), which is levied by the marketplace. This property is optional and if a marketplace does not support sales fees then this property must be null or not present. The gross fee is not allowed to have more than 2 decimal places.
          - `offerId` integer — Unique Offer Id to identify an Offer on a Sales Channel.
          - `channelOfferId` string — Channel defined unique Offer Id to identify an Offer on a Sales Channel.
          - `sku` string — Stock keeping unit is a unique Id used to identify one product.
          - `quantity` string
          - `title` string
          - `estimatedShippingDate` string, date-time
          - `estimatedDeliveryDate` string, date-time
          - `remainingQuantity` string, nullable — Includes the rest of the inventory available on the connected Marketplace. The remaining quanity can be used by a connected client implementation (such as JTL-Wawi) to manage quanity updates.
          - `additionalOrderItemData` AdditionalOrderDataGroup[] — Additional order data is a list of key value pairs. The key is a string and the value is a string or a number. The key must be unique in the list.
            - `group` string — The group name is used to group the additional order data. The group name must be unique in the list.
            - `values` AdditionalOrderDataGroupValues[]
              - …
          - `shipFromCountry` string, nullable — Ship from country (Versandland) - ISO 3 letter country code indicating the country from which the item is shipped
        - object
          - `orderItemId` string, string, required — A unique identifier to identify a order item. This ID is provided by the Channel itself an should be used to identify a order item id.
          - `type` string, required
          - `grossPrice` string, required
          - `taxPercent` string, nullable
          - `shippingGroup` string, required — The shipping group is a unique identifier about what kind of shipping method and carrier is used to fulfill a order. A shipping group can be given by the connected salesChannel or defined by the seller itself.
        - object
          - `orderItemId` string, string, required — A unique identifier to identify a order item. This ID is provided by the Channel itself an should be used to identify a order item id.
          - `type` string, required
          - `grossPrice` string, required
          - `taxPercent` string, nullable
          - `note` string, required
    - `billingAddress` Address
      - `firstName` string
      - `lastName` string, required
      - `gender` 'male' | 'female' | 'diverse'
      - `companyName` string
      - `street` string, required
      - `houseNumber` string
      - `addition` string
      - `postcode` string
      - `city` string, required
      - `phone` string
      - `country` string, required
      - `state` string, nullable
    - `shippingAddress` Address
      - `firstName` string
      - `lastName` string, required
      - `gender` 'male' | 'female' | 'diverse'
      - `companyName` string
      - `street` string, required
      - `houseNumber` string
      - `addition` string
      - `postcode` string
      - `city` string, required
      - `phone` string
      - `country` string, required
      - `state` string, nullable
    - `note` string — A optional note
    - `buyer` OrderBuyer
      - `email` string, email
      - `vatId` string
    - `weeePickup` boolean, nullable — This Order require a electrical and electronic equipment disposal service (WEEE)
    - `language` string, nullable — The language of the order as a ISO 639-1 language code
    - `invoiceDocumentTransfer` 'not-set' | 'from-seller' | 'from-channel', nullable — This field indicates whether the channel provides the invoice document or the seller has to upload it. This overwrites the default setting of the channel. Possible values are: - `from-seller`: Seller has to upload the invoice document - `from-channel`: Channel provides the invoice document - `not-set` (Default): Use the default setting of the channel or indicates that invoice transfer is not supported
    - `additionalOrderData` AdditionalOrderDataGroup[] — Additional order data is a list of key value pairs. The key is a string and the value is a string or a number. The key must be unique in the list.
      - `group` string — The group name is used to group the additional order data. The group name must be unique in the list.
      - `values` AdditionalOrderDataGroupValues[]
        - `key` string — The key is used to identify the additional order data. The key can be used multiple times in the list and we recommend to use a human readable key.
        - `value` string — The value is used to store the additional order data and must be always a string.
    - `fbc` boolean, nullable — Fulfillment by Channel - indicates if the order is fulfilled by the channel
    - `b2b` boolean, nullable — Business to Business - indicates if this is a B2B order
    - `salesChannelName` string, nullable — Sales channel name (Verkaufskanalname) - identifies the specific sales channel

## Response `200`

Call was overall successful but some items can be faulty

- ErrorResponseList
  - `errorList` object[], nullable
    - `code` string
    - `message` string
    - `severity` 'error' | 'warning' | 'info'
    - `hint` string, nullable

## Other responses

- `201` — Orders Created
- `401` — Access forbidden, invalid or unknown Token was used.
- `404` — The requested seller could not be found or is not active.
- `500` — Unexpected Server Error

---

[API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)