TikTok Activate Product
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 |
v1.1 | 30.09.2024 | Hristiyan | Added trigger logic for activation |
v1.2 | 24.06.2025 | Bogomil | Set limit |
Activate Product
This API is for sellers to activate a currently deactive product (off-shelf). It does not apply to deleted, frozen, or draft products. TTS will send the product to the TTS Marketplace team for auditing. The product will enter PENDING state, pending approval. Usage requirements - Products need to be in deactive status.
API Call: POST /product/202309/products/activate
<v1.1> The triggers and validations for this call will be :
Positive Quantity is a must !
Product Account
> List/Update the whole Item
= Pending OR Product Account
> Update Quantity
= Pending
Product Account
TikTok
> TikTok Product Status
= Deactivated (new field)
Product Account
> Listing Status
= Inactive
Product Account
> Product Status
= Product Published
Product Account
> Item Closed
= No (for all variants)
Product Account
> Protect Quantity
= No (for all variatns)
After successfully activating the products, we want to leave List/Update the whole item
OR Update Quantity
on Pending (whichever was used for the activation) and set Product Account
TikTok
> TikTok Product Status
= Activated
</v1.1>
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
When the seller activates the product via this API ,after API gets the information successfully , the product system side will send the product to audit team. (so product will pending for audit and waiting for the result).
Example Call:
{
"product_ids": [
"1729592969712207008",
"1729592969712207021"
]
}
Mappigng :
Integration Field | Integration Notes | Integration required | Hemi Mapping | Hemi Notes |
---|---|---|---|---|
product_ids |
string | Yes | Product Account > Channel Item ID |
<v1.2> |
Please note we can send at most 20 ids in the payload </1.2> |
Example Response:
{
"code": 0,
"data": {
"errors": [
{
"code": 12052990,
"detail": {
"extra_errors": [
{
"code": 12052003,
"message": "The current product status can not be actiavted"
}
],
"product_id": "1729382588639839583"
},
"message": "Batch activate business error."
}
]
},
"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 |
---|---|
12019120 | product ids exceed limit |
12052048 | You can't edit other sellers' products. |
12052093 | seller create product over limit |
12052700 | seller is inactived |
12052900 | System error, try again later |
12052901 | product status invalid |