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

(21) Inbound FBT order 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 (21) Inbound FBT order status change

#

§2 Trigger scenario

Trigger scenario

This webhook is triggered when the status of an FBT inbound order changes.

Prerequisite: The Fulfilled by TikTok(FBT) Info API scope is enabled in Partner Center. For more information, refer to Access Scope.

#

§3 Data business parameters

Data business parameters

Parameter Name Data TypeSampleDescription
typeint21The ID of this webhook topic, which is 21.
tts_notification_idstring"7327112393057371910"The ID of this webhook notification.
seller_open_idstring"VIyStQAAAADCBQ40s4TzOSSOEIW-bM5O9cod3vK8OytW8m-bnBYlXw"The open_id of the seller. For more information, refer to Authorization overview.
timestampint1644412885The time when this webhook is triggered. Unix timestamp.
dataobject
└ inbound_order_idstring"IBR577087614418520388"FBT inbound order ID.
└ order_statusstring"CANCELLED"Inbound order status. Possible enumerations: - TO_BE_RECEIVED - ARRIVE_HUB, - RECEIVING, - PARTIALLY_RECEIVED, - RECEIVED, - CANCELLED
└ update_timeint1644412845The time when the change occurred. Unix timestamp.
#

§4 Event example

Event example

{
  "type": 21,
  "seller_open_id": "VIyStQAAAADCBQ40s4TzOSSOEIW-bM5O9cod3vK8OytW8m-bnBYlXw",
  "tts_notification_id" : "7327112393057371910",
  "timestamp": 1644412885,
  "data": {
    "inbound_order_id": "IBR577087614418520388",
    "order_status": "CANCELLED",
    "update_time": 1644412845
  }
}
#