来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 What is changing?
TikTok Shop is adding customer purchase limit configuration to Product APIs. This allows sellers and partners to configure product-level purchase limits through API, instead of relying only on Seller Center PC settings. The change aligns API capabilities with the existing Seller Center PC experience and helps partners such as ERP / integration platforms keep their product templates, downstream systems, and TikTok Shop product rules consistent.
§2 Which APIs are affected?
Which APIs are affected?
| API Name | Endpoint | Change Description |
|---|---|---|
| Create Product API | /product/202309/products | Request body adds the optional purchase_order_quantity_limit struct. The struct contains maximum_order_quantity and cumulative_order_quantity. |
| Edit Product API | /product/202509/products/{product_id} | Request body uses the same optional purchase_order_quantity_limit struct as Create Product API. The struct contains maximum_order_quantity and cumulative_order_quantity. |
| Get Product API | /product/202309/products/{product_id} | Response body returns the same purchase limit structure under skus[]: skus[].purchase_order_quantity_limit, with maximum_order_quantity and cumulative_order_quantity. |
§3 How does the configuration work?
How does the configuration work?
The purchase limit configuration is a product-level customer purchase setting. It should remain consistent with Seller Center PC configuration and the underlying product database.
- Order maximum quantity: controls the maximum quantity a customer can buy per order for each product variation (SKU).
- Cumulative order quantity: controls the total quantity a customer can buy across orders while the limit is active.
When both values are configured, cumulative_order_quantity must be greater than or equal to maximum_order_quantity.
For Get Product API integration, partners should parse this configuration from skus[].purchase_order_quantity_limit, not from the top-level product object.
§4 New Field and Validation Rules
New Field and Validation Rules
| Field | Type | Example | Description / Behavior |
|---|---|---|---|
purchase_order_quantity_limit | Struct | - | Optional struct used to configure customer purchase quantity limits in Create Product API and Edit Product API. In Get Product API, this struct is returned under skus[] as skus[].purchase_order_quantity_limit. |
maximum_order_quantity | Int64 | 2 | The maximum purchase quantity per order for each product variation (SKU). For example, if this value is 2 and the product has 5 variations, the customer can purchase up to 2 of each SKU, for a total of 10 items per order. |
cumulative_order_quantity | Int64 | 20 | The total quantity a customer can buy of a product's variations (SKUs) across all orders while the limit is active. Clearing the limit resets past purchases. This value must be greater than or equal to maximum_order_quantity. |
Example Create / Edit Product request structure:
{
"purchase_order_quantity_limit": {
"maximum_order_quantity": 2,
"cumulative_order_quantity": 20
}
}
Example Get Product response fragment:
{
"skus": [
{
"purchase_order_quantity_limit": {
"maximum_order_quantity": 2,
"cumulative_order_quantity": 20
}
}
]
}
§5 What action is required?
What action is required?
- Review API integration logic: If your integration creates or edits products, decide whether your product template or seller-facing UI needs to expose customer purchase limit settings.
- Add the correct request structure where needed: For Create Product and Edit Product, support the optional
purchase_order_quantity_limitstruct withmaximum_order_quantityandcumulative_order_quantity. Do not model the Create/Edit Product payload as flat customer limit fields. - Handle edits with the same payload model: For Edit Product, send
purchase_order_quantity_limitwith the updatedmaximum_order_quantityandcumulative_order_quantityvalues. Follow API Factory behavior if a seller removes the limit. - Read and sync returned values: For Get Product, consume
skus[].purchase_order_quantity_limitand keep downstream product templates or ERP systems aligned with TikTok Shop product configuration. - Check launch eligibility: Apply this feature only for sellers / markets in the supported PC scope. BR and MX are planned for full launch, while other regions follow whitelist control.
We appreciate your cooperation in keeping product purchase limit configuration consistent across TikTok Shop, Seller Center, and partner systems.