WinShopAPI docs
ReferenceDocumentsExpeditionWrite offs

Add items to a write-off

Appends the items in the body to an existing write-off and recalculates the document totals. Requires `Permissions.WriteOffs.Create`.

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

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

Request Body

application/json
  1. body
[index: integer]?

Response Body

response?unknownapplication/octet-stream
curl -X POST 'https://<your-instance>/api/documents/expedition/write-offs/0/items' \  -H 'Authorization: Bearer <access-token>' \  -H 'Content-Type: application/json' \  -d '{  "customerId": 1,  "items": [    {      "price": 302.5,      "priceWoVat": 250,      "productId": 5,      "quantityIssued": 100,      "unitIdIssued": 1,      "vatRate": 21    }  ],  "warehouseId": 2}'
null

Process a write-off (deprecated) POST

**Deprecated.** Use `POST {documentId}/process` instead — this alias behaves identically and will be removed. Requires `Permissions.WriteOffs.Update`.

Delete write-off items DELETE

Deletes the items listed in `itemIds` and recalculates the document totals. Call `GET {documentId}/items/check-delete` first to find out whether the delete is allowed. Requires `Permissions.WriteOffs.Delete`.