WinShopAPI docs
ReferenceDocumentsExpeditionWrite offs

Lock a write-off

Locks the write-off for the calling user so other users cannot edit or process it. Returns 400 when it is already locked. Release it with `DELETE {documentId}/lock`. Requires `Permissions.WriteOffs.Update`.

POST
/api/documents/expedition/write-offs/{documentId}/lock

Authorization

Bearer
headerAuthorizationBearer <token>

OAuth 2.0 client credentials. Obtain a client id/secret from Winshop support ([email protected]), then POST to the token URL.

Path Parameters

documentId*integer
Formatint32

Response Body

response?unknownapplication/octet-stream
curl -X POST 'https://<your-instance>/api/documents/expedition/write-offs/0/lock' \  -H 'Authorization: Bearer <access-token>'
null

Get the lock state of a write-off GET

Returns whether the write-off is locked against concurrent edits and, when it is, the name of the user holding the lock. Requires `Permissions.WriteOffs.View`.

Unlock a write-off DELETE

Releases the lock on the write-off. Returns 400 when the lock belongs to another user. Requires `Permissions.WriteOffs.Update`.