Lock

[POST] .../v1/docmovement/lock

Locks document movement for editing. Use this method before editing a movement document or its MovementOperation rows so other users cannot change the same document concurrently. The request body must contain a non-empty ids array of positive movement document ids and the lock result returns row_affected for documents whose lock state changed. The current controller path validates the body and delegates to the document lock service without a separate controller-level RBAC permission check; unavailable tariff, invalid ids, existing locks, storage failures or lock-service errors are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
ids Array of Int64 Required Movement document IDs. The array must contain at least one positive ID.

Request Example

{
  "ids": [
    4201
  ]
}

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
  }
}