⚠️ We do not show states to refurbed customers. Currently, they serve as an internal management tool. E.g. if customers cancel an order you need to refund the order. Only setting the state to rejected is not sufficient
The standard state value for all orders/order items is NEW. If you want to use state filter e.g. to filter only NEW orders you need to change the state of all already processed OrderItems to e.g. ACCEPTED then SHIPPED.
We do not change the state of order items. All changes must be made by the client.
You can only change the state of the order items. But be aware that we do not allow every state transition:
- NEW: Order item was not handled yet. Next states: REJECTED, CANCELLED or ACCEPTED.
- REJECTED: Order item cannot be fulfilled. Final state.
- CANCELLED: Order item was cancelled by the customer. Is like REJECTED but was requested by the customer. Final state.
- ACCEPTED: Order item was accepted for fulfillment. Next states: CANCELLED or SHIPPED.
- SHIPPED: Order item was shipped. The parcel tracking link needs to be set for this state to be set. The item identifier should be set, if possible. Possible final state. Next possible state, if necessary: RETURNED.
- RETURNED: Order item was returned by the customer. Final state.
⚠️ Please always set the correct states for your order items in accordance to the transition rules. E.g. if your order item is still in state NEW and you try to skip ACCEPTED by directly setting state SHIPPED it will create errors.
A good practice is to set the state of an order item after a stock validation on your side and if available set the state from NEW → ACCEPTED.
The order state is calculated automatically based on the OrderItemState of one or all OrderItems. The rules are:
OrderState:
- NEW: Order was not handled yet. At least one order item has state NEW.
- REJECTED: Order was rejected (cannot be fulfilled). All order items have state REJECTED.
- CANCELLED: Order was cancelled. All order items have state CANCELLED.
- ACCEPTED: Order was accepted. At least one order item has state ACCEPTED, and none of the other items still have state NEW.
- SHIPPED: Order was fully shipped. All order items have state SHIPPED.
- RETURNED: Order was fully returned. All order items have state RETURNED.
- FULFILLED: Order was fully shipped. At least one order item has state SHIPPED and another one has state RETURNED.
- PARTIALLY_FULFILLED: Order was partially shipped. At least one order item has state SHIPPED or RETURNED and another one has state CANCELLED or REJECTED.
- UNFULFILLED: Order was not fulfilled. At least one order item has state REJECTED and another one has state CANCELLED.