Update Inventory

Update the inventory quantity of SKUs belonging to a product. The SKU ID must belong to a product that is not in FREEZE or DELETED status.

---

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

Note:

• The SKU ID must belong to a product that is not in FREEZE or DELETED status.
• If you are updating multiple SKUs, all the SKU IDs must belong to the same product. | ^inventory |[]object |Y | |SKU inventory information. Note: You must include all warehouse IDs assigned to this SKU, along with the respective quantity. Do not omit any or add unrelated warehouses. | ^^warehouse_id |string |N |7068517275539719942 |The ID of the warehouse where the SKU is stored. Retrieve this value from the Get Product API.

Note: Optional if there is only 1 warehouse. Otherwise, please provide this ID. | ^^quantity |int |Y |999 |The total SKU quantity available in the warehouse. Valid range: [1, 99,999] Note: This quantity specifically refers to the in-stock inventory that can be shipped immediately. | ^^backorder_quantity |int |N |888 |The backorder_quantity will automatically be converted to quantity once in-stock inventory is sold out. The fulfillment of this inventory follows the handling_time specified below. Note: Any existing backorder_quantity will persist if no update is provided during API call. | ^^handling_time |int |N |5 |The estimated number of working days needed for a backorder to be shipped. Currently, different warehouses for the same SKU are not allowed to have different handling_time |

Query

https://open-api.tiktokglobalshop.com/product/202309/products/1729382561353664372/inventory/update?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY

Body

{"skus":[{"id":"1729592969712207013","inventory":[{"warehouse_id":"7068517275539719942","quantity":999,"backorder_quantity":888,"handling_time":5}]}]}

{"code":0,"data":{"errors":[{"code":12052990,"message":"Check failed","detail":{"sku_id":"1729592969712207013","extra_errors":[{"warehouse_id":"7068517275539719942","code":12052097,"message":"The warehouse does not exist"}]}}]},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code

• Inventory is automatically allocated and cannot be modified manually
• Warehouse IDs provided are incorrect
• Missing warehouse IDs (all warehouses that stock the product must be included) | 12052048 |You cannot edit the specified product(s) as it isn't listed in your account or shop. | 12052050 |A single product cannot have more than 100 different SKUs | 12052055 |The SKU inventory quantity for the warehouse must be within allowed limits. | 12052094 |No multiple warehouse permission | 12052096 |Unable to update the price for SKUs with no warehouse. Assign a warehouse and try again. | 12052097 |The warehouse does not exist | 12052115 |seller has no warehouse | 12052141 |please edit stock from global | 12052160 |sku count must be one and disable variables | 12052207 |receipt brand not support warehouse | 12052260 |The product ID does not exist | 12052308 |There's an ongoing appeal. If you wish to edit product details, please revoke the appeal first. | 12052364 |The warehouse is unavailable because this product cannot be shipped to the target market from this warehouse. | 12052371 |Auction product is bidding when it is not supported to change product info | 12052393 |Product locked for Promotion and stock can't be updated below current stock | 12052403 |The warehouse does not support fulfillment for the current shop. | 12052465 |warehouse is unavailable for eu gpr product | 12052530 |The warehouse ' {{warehouse ID}} ' does not belong to this shop/seller. | 12052531 |The warehouse is disabled. | 12052532 |the warehouse not delivery warehouse | 12052533 |Removal, addition, and change of warehouses are not permitted. Please specify the original warehouses for the SKUs. | 12052535 |Couldn't publish this product as you haven't set the return warehouse for your shop. Add the return warehouse information on TikTok Shop Seller Center first and try again. | 12052553 |Sku id duplicate | 12052556 |The SKU id not exist. | 12052700 |The seller is inactive. | 12052703 |Invalid seller tax number | 12052704 |seller id not exist | 12052849 |You don't have the permission to operate combo. | 12052850 |The stock of combo does not support being edited. | 36009003 |Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | 12052901 |The product in its current status is not available for this operation. Change the product status and try again. | 12052902 |The SKU list is empty. Either omit the list entirely, or provide all required details. | 12052921 |Couldn't edit the inventory quantity because this product shares the inventory with the source shop | 12052990 |The check failed. |