---
title: "Update the stock qty of an article"
method: POST
path: "/api/v1/products/updatestock"
tags: ["Products"]
---

# Update the stock qty of an article

`POST /api/v1/products/updatestock`

The article is specified by sku. You have to send the absolute value for the current stock

## Request body

- BillbeeInterfacesBillbeeAPIModelUpdateStockApiModel
  - `BillbeeId` integer — Optional the ID of the Billbee product to update
  - `Sku` string — The SKU of the product to update
  - `StockId` integer — Optional the stock id if the feature multi stock is activated
  - `Reason` string — Optional a reason text for the stock update
  - `OldQuantity` number, double — This parameter is currently ignored
  - `NewQuantity` number, double — The new absolute stock quantity for the product you want to set
  - `DeltaQuantity` number, double — This parameter is currently ignored
  - `ForceSendStockToShops` boolean — If true, every sent stockchange is stored and transmitted to the connected shop, even if the value has not changed
  - `AutosubtractReservedAmount` boolean — Automatically reduce the NewQuantity by the currently not fulfilled amount

## Response `200`

OK

- RechnungsdruckWebAppControllersApiApiResultOfBillbeeInterfacesBillbeeAPIModelUpdateStockResponseData
  - `ErrorMessage` string
  - `ErrorCode` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31
  - `ErrorDescription` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31
  - `Data` BillbeeInterfacesBillbeeAPIModelUpdateStockResponseData
    - `SKU` string — The SKU of the article to update the current stock
    - `OldStock` number, double — The old value for current stock before the update
    - `CurrentStock` number, double — The new value for current stock after the update
    - `UnfulfilledAmount` number, double — The value of the unfulfilled amount (reserved) of the article
    - `Message` string — A human readable message that explains the result of the operation

---

[API](https://skmtc.dev/billbee/apis/billbee-api.md) · [All operations](https://skmtc.dev/billbee/apis/billbee-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/billbee/billbee-api/revisions/e64f07f4f526/schema)