Update handling details for an order

Update handling details for an order

Required permissions: SALES_ORDER,RETURN_ORDER

put

/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/handlings/{orderHandlingUid}

Authorizations

AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

orderUidstringRequired

Reference to an Order.

Pattern: ^[A-Za-z0-9-_]+

orderHandlingUidstringRequired

Reference to an orderhandling id.

Pattern: ^[A-Za-z0-9-_]+

Body

statestring · enumRequired

ENUM	Description
NOT_STARTED	Handling has not been started.
IN_PROGRESS	Handling is in progress.
ON_HOLD	Handling is paused (on hold).
COMPLETE	Handling is complete.

Possible values:

commentstringOptional

Responses

200

Example response

application/json

orderUidstringRequiredPattern: ^[A-Za-z0-9-_]+

activebooleanRequired

createdAtstring · date-timeRequired

createdBystringRequired

descriptionstringRequired

handlingUidstringRequiredPattern: ^[A-Za-z0-9-_]+

lastModifiedAtstring · date-timeRequired

lastModifiedBystringRequired

namestring · max: 20Required

orderHandlingUidstringRequiredPattern: ^[A-Za-z0-9-_]+

statestring · enumRequired

ENUM	Description
NOT_STARTED	Handling has not been started.
IN_PROGRESS	Handling is in progress.
ON_HOLD	Handling is paused (on hold).
COMPLETE	Handling is complete.

Possible values:

put/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/handlings/{orderHandlingUid}

PUT /v2/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/handlings/{orderHandlingUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "state": "NOT_STARTED",
  "comment": "text"
}

200

Example response

{
  "orderUid": "text",
  "active": true,
  "createdAt": "2026-01-01T00:00:00.000Z",
  "createdBy": "text",
  "description": "text",
  "handlingUid": "text",
  "lastModifiedAt": "2026-01-01T00:00:00.000Z",
  "lastModifiedBy": "text",
  "name": "text",
  "orderHandlingUid": "text",
  "state": "NOT_STARTED"
}