[POST] .../v1/docinvoice/lock
Locks invoice documents for editing. Use this method before editing an invoice header or InvoiceOperation lines, posting, canceling posting, sending, changing status or recording external EDI data. The request body must contain an ids array with at least one positive invoice ID and the response returns UpdateResult with row_affected for documents locked for the current request user. This method only changes lock ownership and does not edit invoice data; the current API does not perform the disabled invoice lock permission check here, but persistent tariff and lock errors still apply. Missing body, missing or invalid ids, tariff restriction, lock conflicts, database or persistence failures are returned as HTTP 200 ErrorResult business errors.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| ids | Array of Int64 | Required | Invoice IDs. The array must contain at least one positive ID. |
Request Example
{
"ids": [
9101
]
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
| result | Update | Update operation result. |
Response Example
{
"ok": true,
"result": {
"row_affected": 1
}
}