---
title: "Status Update"
method: PUT
path: "/v1/channel/order/status"
tags: ["Order"]
---

# Status Update

`PUT /v1/channel/order/status`

Update status for an existing order

## Request body

- OrderStatusList
  - `orderList` OrderStatus[], 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.
    - `orderId` string, required
    - `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.
    - `orderItems` 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.
      - `itemStatus` 'UNSHIPPED' | 'SHIPPED' | 'CANCELED_BY_SELLER' | 'CANCELED_BY_BUYER' | 'RETURNED' | 'REFUNDED', required — 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.
      - `paymentStatus` 'PENDING' | 'PAID', required — The current payment status * **PENDING**: Order Item is not yet paid. * **PAID**: Order Item is complete paid.
      - `shipFromCountry` string, nullable — Ship from country (Versandland) - ISO 3 letter country code indicating the country from which the item is shipped

## 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` — Status updated sucessful
- `401` — Access forbidden, invalid or unknown Token was used.
- `404` — Requested resource not found.
- `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)