WinShopAPI docs
ReferenceDocumentsStock takingStock takings

Update a stock taking item

Replaces one item of the stock taking, identified by `itemId`, and recalculates the document totals. Requires `Permissions.StockTakings.Update`.

PUT
/api/documents/stock-taking/stock-takings/{documentId}/items/{itemId}

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
itemId*integer
Formatint32

Request Body

application/json
  1. body
id?|

Row id of the item. Read-only; the server assigns it.

Formatint32
internalNumber?|

Internal number of the document this item belongs to. Read-only.

Formatint32
item?|
Formatint32
productId?|

Id of the product this item sells or moves. Required.

Formatint32
variants?array<>|

The item's size/colour breakdown. Null when the item has none.

barcode?|
Lengthlength <= 50
batchId?|
Formatint32
createdAt?|
Formatdate-time
lastModify?|
Formatdate-time
locationId?|
Formatint32
note?string|null
packagePrice?|
Formatdecimal
price?|
Formatdecimal
priceWoVat?|
Formatdecimal
priceWoVatIssued?|
Formatdecimal
quantity?|
Formatdecimal
quantityCoefficient?|
Formatdecimal
quantityIssued?|
Formatdecimal
recyclingFee?|
Formatdecimal
recyclingFeeId?|
Formatint32
royalty?|
Formatdecimal
royaltyId?|
Formatint32
setPrice?|
Formatdecimal
stockPrice?|
Formatdecimal
unitId?|
Formatint32
unitIdIssued?|
Formatint32
userId?|
Formatint32
variantId?|
Formatint32
vatRate?|
Formatdecimal

Response Body

response?unknownapplication/octet-stream
curl -X PUT 'https://<your-instance>/api/documents/stock-taking/stock-takings/0/items/0' \  -H 'Authorization: Bearer <access-token>' \  -H 'Content-Type: application/json' \  -d '{}'
null

Check whether stock taking items can be deleted GET

Advisory pre-flight for `DELETE {documentId}/items`. `blockingReasons` holds `ITEMS_BLOCKED` when at least one id in `itemIds` is still referenced elsewhere. At most 1000 ids per call. Requires `Permissions.StockTakings.Delete`.

Delete a stock taking item variant DELETE

Deletes one variant row (a size/colour breakdown) of an item and recalculates the document totals. Call the matching `check-delete` endpoint first to find out whether the delete is allowed. Requires `Permissions.StockTakings.Delete`.