Unlock

[POST] .../v1/docpurchase/unlock

Unlocks partner receipt document for editing. Use this method to release edit locks for one or more receipt-from-partner documents after editing is finished or abandoned. It accepts an ids array, clears lock state through the persistent unlock logic and returns row_affected for the affected documents. The caller must have unlock permission and the controller validates that ids is present, non-empty and contains only positive identifiers; denied access, invalid ids, lock conflicts and storage errors are returned as HTTP 200 ErrorResult.

Request Parameters

Name Type Required Description
ids Array of Int64 Required Record IDs.

Request Example

{
  "ids": [
    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
  }
}