Update Status

Sets an order's status. Send one of the valid status values below in status.

Body

Valid statuses

• new
• needs_review
• in_process
• pick_up_ready
• pick_up_confirmed
• closed
• pending
• canceled

Example

Set order 101769 to in_process:

{{api_url}}/shop/order/101769/status

{"status": "in_process"}

Response

{"orderid": "101769", "status": "in_process", "updated_records": 1}

Before you build

• orderid is the InfiPlex order ID (shop_orderid), not the marketplace order number. To find an order from its marketplace order number, use Order Search with text_search.
• To find orders in a status, use Order Search with order_status_eq.
• To flag an order as handled without changing its status, use Processed.
• Your API key needs Order write permission. A key without it gets 403 Forbidden.

Related guides:

• Order Management for 3PL Fulfillment
• Cancel or Delete a Shop Order in InfiPlex
• InfiPlex OMS REST API Overview

{
    "status": "new"
}

curl --location --request PUT '{{api_url}}/shop/order/{{orderid}}/status' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{auth_token}}' \
--data '{
    "status": "new"
}'

curl --location --request PUT 'https://example.com/api/admin/shop/order/101769/status' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "status": "new"
}'

{
    "orderid": "101769",
    "status": "new",
    "updated_records": 1
}