快工助手跨境电商知识与商机助手

(51) Global replication status change

TikTok Shop 官方资料 · TikTok Shop Partner Center 开发者文档 · 适合开发者

stable本次发布有变化全部展示

来自 TikTok Shop 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
TikTok Shop / profile.tiktok.docs_api
语言
en-US
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/tiktok_shopaudience/developercategory/api_doctopic/compliancetopic/developer

资料正文

§1 1. Trigger scenario

This webhook is triggered when a product replication operation in another market is completed, regardless of success or failure. If the replication fails, the failure reason(s) will be included in the response. Applicable only for global sellers. Prerequisite: The "Product Basic" API scope is enabled in Partner Center. For more information, refer to Access Scope.

#

§2 2. Data business parameters

Parameter nameData typeSampleDescription
typeint51The ID of this webhook topic, which is 51.
tts_notification_idstring"7327112393057371910"The ID of this webhook notification.
shop_idstring"7494049642642441621"The shop ID.
timestampint1644412885The time when this webhook is triggered. Unix timestamp.
dataobject
└ source_product_idstring"764c6e87eedcea90399a0dafcd572b71"The ID of the product that's being replicated to other markets.
└ replicated_productobjectThe product that was replicated from the source product.
└ └ product_idstring"576486316948490000"The ID of the product created through replication. Pass this ID to the GET Product endpoint for more details about the product.
└ └ regionstring"GB"The market where the product has been replicated.
└ └ resultstring"SUCCESS"The result of replicating the product. Possible values: * SUCCESS: The product was successfully replicated to the local shop, submitted for listing, and is now under review. * DRAFT: The product was successfully replicated to the local shop but saved as a draft local product due to validation errors. You need to call GET Product to obtain the original submitted data, pass that data to POST Check Product Listing to identify the errors, then call PUT Edit Product to rectify the errors and send for review. * FAILED: Replication of the product to the local shop was unsuccessful.
└ └ fail_reasons[]objectThe list of reasons for why the replication failed.
└ └ └ messagestringThe reason for why the replication failed.

#

§3 Event example

Event example

{
    "type": 51,
    "shop_id": "7494049642642441621",
    "tts_notification_id": "7327112393057371910",
    "timestamp": 1644412885,
    "data": {
        "source_product_id": "764c6e87eedcea90399a0dafcd572b71",
        "replicated_product": {
            "product_id": "576486316948490000",
            "region": "GB",
            "result": "SUCCESS",            
            "fail_reasons": {
                "message": ""
                }
            }
        }
    }
}
#