Update a supplier order item
Replaces one item of the supplier order, identified by `itemId`, and recalculates the document totals. Requires `Permissions.OrderSupplier.Update`.
BearerAuthorizationBearer <token>OAuth 2.0 client credentials. Obtain a client id/secret from Winshop support ([email protected]), then POST to the token URL.
documentId*integerint32itemId*integerint32application/json- body
id?|Row id of the item. Read-only; the server assigns it.
int32internalNumber?|Internal number of the document this item belongs to. Read-only.
int32item?|int32productId?|Id of the product this item sells or moves. Required.
int32variants?array<>|The item's size/colour breakdown. Null when the item has none.
barcode?|length <= 50batchId?|int32batchTextRawMaterial?string|nullcreatedAt?|date-timeediQuantity?|decimalexpirationDate?|date-timeforeignCurrencyId?|int32foreignExchangeRate?|decimalisCancellation?boolean|nullisPartialCancellation?boolean|nulllastModify?|date-timenote?string|nullpackagePrice?|decimalprice?|decimalpriceWoVat?|decimalquantity?|decimalquantityBeingCovered?|decimalquantityCoefficient?|decimalquantityCovered?|decimalquantityWeighed?|decimalrecyclingFee?|decimalrecyclingFeeId?|int32royalty?|decimalroyaltyId?|int32setPrice?|decimalstockPrice?|decimalunitId?|int32userId?|int32variantId?|int32vatRate?|decimalcountryOfOrigin?|int32dateOfExchangeRate?|date-timeexpirations?array<>|nullforeignPurchasePriceWoVat?|decimalpurchasePriceWoVat?|decimalpurchasePriceWoVatReceived?|decimalquantityReceived?|decimalstockIntakeItemId?|int32supplierProductCode?string|nullunitIdReceived?|int32application/json- response
id?|Row id of the item. Read-only; the server assigns it.
int32internalNumber?|Internal number of the document this item belongs to. Read-only.
int32item?|int32productId?|Id of the product this item sells or moves. Required.
int32variants?array<>|The item's size/colour breakdown. Null when the item has none.
barcode?|length <= 50batchId?|int32batchTextRawMaterial?string|nullcreatedAt?|date-timeediQuantity?|decimalexpirationDate?|date-timeforeignCurrencyId?|int32foreignExchangeRate?|decimalisCancellation?boolean|nullisPartialCancellation?boolean|nulllastModify?|date-timenote?string|nullpackagePrice?|decimalprice?|decimalpriceWoVat?|decimalquantity?|decimalquantityBeingCovered?|decimalquantityCoefficient?|decimalquantityCovered?|decimalquantityWeighed?|decimalrecyclingFee?|decimalrecyclingFeeId?|int32royalty?|decimalroyaltyId?|int32setPrice?|decimalstockPrice?|decimalunitId?|int32userId?|int32variantId?|int32vatRate?|decimalcountryOfOrigin?|int32dateOfExchangeRate?|date-timeexpirations?array<>|nullforeignPurchasePriceWoVat?|decimalpurchasePriceWoVat?|decimalpurchasePriceWoVatReceived?|decimalquantityReceived?|decimalstockIntakeItemId?|int32supplierProductCode?string|nullunitIdReceived?|int32curl -X PUT 'https://<your-instance>/api/documents/orders/supplier/0/items/0' \ -H 'Authorization: Bearer <access-token>' \ -H 'Content-Type: application/json' \ -d '{ "id": 1, "purchasePriceWoVatReceived": 100, "vatRate": 21}'{ "id": 0, "internalNumber": 0, "item": 0, "productId": 0, "variants": [ { "colorId": 0, "dimensionId": 0, "id": 0, "itemId": 0, "lengthId": 0, "quantity": 0, "sizeId": 0, "price": 0, "priceWoVat": 0, "quantityBeingCovered": 0, "quantityCovered": 0, "quantityWeighed": 0 } ], "barcode": "string", "batchId": 0, "batchTextRawMaterial": "string", "createdAt": "2019-08-24T14:15:22Z", "ediQuantity": 0, "expirationDate": "2019-08-24T14:15:22Z", "foreignCurrencyId": 0, "foreignExchangeRate": 0, "isCancellation": true, "isPartialCancellation": true, "lastModify": "2019-08-24T14:15:22Z", "note": "string", "packagePrice": 0, "price": 0, "priceWoVat": 0, "quantity": 0, "quantityBeingCovered": 0, "quantityCoefficient": 0, "quantityCovered": 0, "quantityWeighed": 0, "recyclingFee": 0, "recyclingFeeId": 0, "royalty": 0, "royaltyId": 0, "setPrice": 0, "stockPrice": 0, "unitId": 0, "userId": 0, "variantId": 0, "vatRate": 0, "countryOfOrigin": 0, "dateOfExchangeRate": "2019-08-24T14:15:22Z", "expirations": [ { "expirationDate": "2019-08-24T14:15:22Z", "id": 0, "itemId": 0, "quantityWeighed": 0, "ssccText": "string" } ], "foreignPurchasePriceWoVat": 0, "purchasePriceWoVat": 0, "purchasePriceWoVatReceived": 0, "quantityReceived": 0, "stockIntakeItemId": 0, "supplierProductCode": "string", "unitIdReceived": 0}Check whether supplier order 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.OrderSupplier.Delete`.
Delete a supplier order 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.OrderSupplier.Delete`.