POST Update Inventory
Update Inventory Shop Required scope: seller.product.write 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. Version 202309
POST/product/202309/products/{product_id}/inventory/update
Request
Path
| Properties | Type | Description |
|---|---|---|
| product_id Required | string | The product ID generated by TikTok Shop. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Allowed type: application/json |
| x-tts-access-token Required | string | The seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign Required | string | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
| shop_cipher Required | string | Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return incorrect response. Get by API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| skus Required | []object | A list of Stock Keeping Units (SKUs) used to identify distinct variants of the product. |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | The success or failure status code returned in API response. |
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | Request log |
| data | object | Specific return information |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 12019022 | SKU must contain a valid warehouse. | | 12019024 | stock count is invalid | | 12019028 | Multiple warehouses detected. Include all warehouse IDs and the corresponding details and try again. | | 12052031 | Invalid product ID(s) found | | 12052032 | The product does not exist | | 12052036 | The SKU ID is necessary | | 12052037 | Couldn't update inventory. Possible causes:- 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. |
Is this content helpful?Helpful
Not Helpful
PreviousNext