Actualize
[POST] .../v1/docorderdelivery/actualize
Refreshes retail order data. Actualize a retail order after sale-side changes by replacing its operation list with the supplied actual rows. The request requires document_id and a data array of one to 250 rows; each row must contain item_id, positive quantity, non-negative price and values within quantity, price and amount limits. The method requires the retail order operation edit permission, locks the document by document_id, requires the order to be in Processing status, deletes current operations, bulk-inserts the supplied operation snapshot, moves the order to Finished, sends the actualized webhook and returns row_affected. Errors such as a missing request body, invalid document_id, empty or too-large data array, invalid item, quantity, price or amount values, denied access, missing order, invalid status, missing active operations, storage errors are returned as HTTP 200 ErrorResult.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| data | Array of DocOrderDeliveryActualizeData | Required | Order data. |
| document_id | Int64 | Required | Retail order document ID. |
Request Example
{
"data": [
{
"deleted": true,
"id": 1,
"item_id": 1,
"price": 1.0,
"quantity": 1.0
}
],
"document_id": 1
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
| result | Update | Update operation result. |
Response Example
{
"ok": true,
"result": {
"ids": [
null
],
"row_affected": 1
}
}