(37) Product audit status change

资料正文

§1 (37) Product audit status change

§2 Trigger scenario

Trigger scenario

When the product audit status changes, you'll receive this webhook. With this webhook, you can easily get the audit status information of a product instead of calling Get Product API. To receive this webhook, you must ensure the Product Basic API scope is enabled in Partner Center.

§3 Data business parameters

Data business parameters

Parameter name	Data Type	Sample	Description
type	int	`37`	The ID of the webhook type.
tts_notification_id	string	`"7327112393057371910"`	The ID of the notification.
shop_id	string	`"7494049642642441621"`	The ID of the shop.
timestamp	int	`1644412885`	The time when this webhook was triggered, represented by Unix timestamp.
data	object
└ product_id	int	`789078671231`	The ID of the product.
└ audit	object		The product audit information.
└└ status	string	`PRE_APPROVED`	The product audit status. Possible values: * NONE: The product is not applicable for audit because it has not been submitted for listing on this platform, or it is in a draft, frozen, or deactivated state. * AUDITING: The product is currently being audited. * FAILED: The product failed the audit, or the audit was cancelled. * PRE_APPROVED: The product has passed the audit but is not yet listed due to pending prerequisites. Refer to `pre_approved_reasons` for the prerequisites. * APPROVED: The product passed the audit and has been listed on the platform.
└└ pre_approved_reasons	[]string	["KYC_PENDING"]	The reason why the audit status of the product is `PRE_APPROVED`. Possible values: * KYC_PENDING: The seller's onboarding (KYC - Know Your Customer information) is incomplete or awaiting processing. * RESTRICTED_CATEGORY_PENDING: Applicable only for the US market. The product is in a restricted category, and category approval is still pending. To request access, submit an application through the Qualification Center on TikTok Shop Seller Center.
└ integrated_platform_statuses	object		The current audit status of the product on platforms that are natively integrated with TikTok Shop (e.g. TOKOPEDIA).
└└ platform	string	`TOKOPEDIA`	The integrated platform name. Possible values: * TOKOPEDIA.
└└ status	string	`AUDITING`	The product audit status. Possible values: * NONE: The product is not applicable for audit because it has not been submitted for listing on this platform, or it is in a draft, frozen, or deactivated state. * AUDITING: The product is currently being audited. * FAILED: The product failed the audit or the audit was cancelled. * APPROVED: The product passed the audit and has been listed on the platform.
└ update_time	int	`1644412885`	The time when the status changed, represented as a Unix timestamp (seconds).

§4 Event example

Event example

{
  "type": 37,
  "shop_id": "7494049642642441621",
  "tts_notification_id" : "7327112393057371910",
  "timestamp": 1644412885,
  "data": {
    "product_id": 789078671231,
    "audit": {
        "status": "PRE_APPROVED",
        "pre_approved_reason": "KYC_PENDING"
    },
    "integrated_platform_statuses": {
        "platform": "TOKOPEDIA",
        "status": "AUDITING"
    },
    "update_time": 1644412885
  }
}