TikTok Update Price

Version	Date	Created / Updated	Notes
v1.0	20.06.2024	Hristiyan Georgiev	TikTok has new API version and updates. The scope was also updated to the latest changes

Update Price

Note: There are 2 separate APIs for price & stock update

API Call: POST /product/202309/products/{product_id}/prices/update

API Docs: https://partner.tiktokshop.com/docv2/page/650307de5a12ff0294eac8b0?external_id=650307de5a12ff0294eac8b0#Back To Top

All triggers, validations etc are as per the abstraction -

Price Update General requirements

The {product_id} is what we have stored as Product Account > Channel Item ID

We need to pass the shop_cipher as query property which was obtained with the Get Authorised Shops call found here TikTok - Authentication & Database structure

Example Call:

{
  "skus": [
    {
      "id": "1729592969712207013",
      "price": {
        "amount": "1.32",
        "currency": "USD"
      }
    }
  ]
}

Call Mapping:

Integration Field			Integration required	Hemi Mapping	Hemi Notes
`skus`			Yes
	`id`		Yes	`Product Аccount TikTok` >`SKU ID`	The SKU ID is a value, returned by TikTok , once we successfully create a product.
	`price`		Yes
		`amount`	Yes	`Product Account` > `Price`
		`currency`	Yes	`Product Account` > `Currency`

OR Account > Exchange Rate Calculator Currency | Product Account is with priority |

Example Response:

{
  "code": 0,
  "data": {},
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}

The successfull response will be with code : 0 and message : Success . If we receive a different code than 0, this means there was an error and we need to store the error. We want to store the error message as per the abstraction Product Listing general requirements

Code	Message
12019022	sku ID is invalid
12019045	price is locked
12019059	seller sku is invalid
12019113	product status invalid
12052038	Product price locked due to ongoing promotion.
12052048	You can't edit other sellers' products.
12052073	The product price is invalid
12052092	product sale price is invalid
12052097	The warehouse does not exist
12052531	warehouse status invalid
12052553	Sku id duplicate
12052570	product price exceed limit
12052572	the sale price is invalid
12052700	seller is inactived
12052703	Invalid seller tax number
12052900	System error, try again later
12052901	product status invalid
12052902	skus is invalid

Marketplaces / TikTok Marketplace Integration v2 / TikTok - Product management / TikTok Update Price

TikTok Update Price

Update Price