TikTok End Listing

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

End Listing (Delete Product)

This API supports deletion of a single product or multiple products (up to 20 at a time so we need to set a limit of maximum 20 products per call)

Delete product call shouldn’t remove images. And if we re create a product, using ““Recover“ API, we do not need to upload again the images.

API Call: DELETE /product/202309/products

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

All triggers, validations etc are as per the abstraction -

Product Listing general requirements

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:

{
  "product_ids": [
    "1749456684124612452",
    "1742456684124612451"
  ]
}

Call Mapping:

Integration Field	Integration Notes	Integration required	Hemi Mapping	Hemi Notes
`product_id`	string	Yes	`Product Account` > `Channel Item ID`

Example Response:

{
  "code": 0,
  "data": {
    "errors": [
      {
        "code": 12052003,
        "detail": {
          "product_id": "1729382588639839583"
        },
        "message": "The current product status can not be actiavted"
      }
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}

Under errors we will receive list of products that failed to update(delete). We want to store the message in Product Account > End Listing Error

Note: As we push product_ids in order to delete a product, this means the product and all its variant will be deleted too! If we would want to stop selling a variant, we need to push 0 stock to the variant we would want to stop sell.

Possible Error codes & Messages:

Code	Message
12019120	product ids exceed limit
12052048	You can't edit other sellers' products.
12052700	seller is inactived
12052703	Invalid seller tax number
12052705	seller can not manage local product.

Marketplaces / TikTok Marketplace Integration v2 / TikTok - Product management / TikTok End Listing

TikTok End Listing

End Listing (Delete Product)