Skip to main content

POST Update Price

Update Price Shop Required scope: seller.product.write Update the price of multiple SKUs belonging to a product in the ACTIVATE status and not included in any ongoing promotions. Note: The data response field is always empty as there is no additional response data. Version 202309

POST/product/202309/products/{product_id}/prices/update

Request

Path

PropertiesTypeDescription
product_id RequiredstringThe product ID generated by TikTok Shop.

Header

PropertiesTypeDescription
content-type RequiredstringAllowed type: application/json
x-tts-access-token RequiredstringThe seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token.

Query

PropertiesTypeDescription
app_key RequiredstringEvery single app will have a unique key. Please use the specific key assigned to your app.
sign RequiredstringSignature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders.
timestamp RequiredintUnix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time.
shop_cipher RequiredstringUse 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

PropertiesTypeDescription
skus Required[]objectA list of Stock Keeping Units (SKUs) used to identify distinct variants of the product.

Example

CurlGoNode.jsJavaEnable word wrap

Response Parameters

PropertiesTypeDescription
codeintThe success or failure status code returned in API response.
messagestringThe success or failure messages returned in API response. Reasons of failure will be described in the message.
request_idstringRequest log
dataobjectSpecific return information

Example

JSONEnable word wrap

Error Code

View common error codes

| Code | Message | | --- | --- | | 12019022 | SKU must contain a valid warehouse. | | 12019045 | price is locked | | 12019059 | seller sku is invalid | | 12019113 | product status is invalid | | 12052012 | Incorrect price format | | 12052023 | Category does not exist | | 12052032 | The product does not exist | | 12052038 | Product price locked due to ongoing promotion. | | 12052048 | You cannot edit the specified product(s) as it isn't listed in your account or shop. | | 12052073 | The product price is invalid | | 12052084 | The provided currency is not available for this shop/region. | | 12052092 | product sale price is invalid | | 12052096 | Unable to update the price for SKUs with no warehouse. Assign a warehouse and try again. | | 12052097 | The warehouse does not exist | | 12052163 | The gift product are not allowed to be edited | | 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. | | 12052371 | Auction product is bidding when it is not supported to change product info | | 12052376 | list price not support | | 12052383 | product list price exceed limit | | 12052424 | Missing 'sale price' value | | 12052531 | The warehouse is disabled. | | 12052553 | Sku id duplicate | | 12052557 | The SKU ID does not belong to the product. | | 12052570 | product price exceed limit | | 12052572 | the sale price is invalid | | 12052700 | The seller is inactive. | | 12052703 | Invalid seller tax number | | 12052704 | seller id not exist | | 12052861 | The price of combined SKU cannot exceed the sum of the prices of the sub-SKUs. | | 12052881 | identity internal error | | 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. | | 12052910 | Invalid input parameters. Refer to the API documentation for details. |

Is this content helpful?Helpful

Not Helpful

PreviousNext