来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Overview
This response-only enhancement is available to apps that retrieve order data through the Get Order List and Get Order Detail APIs. It does not change API requests or existing order workflows.
| Item | Details |
|---|---|
| Availability | All markets, since July 30, 2026 |
| Change type | Non-breaking, additive response field |
| Affected apps | Order management, shipping, warehouse management, and other apps that need to distinguish temporary listing SKUs |
| Developer action | Read the new field and route temporary listing SKUs to the appropriate shipping workflow |
§2 What is changing
Previously, Order API responses did not indicate whether an order line item came from a temporary listing. Apps could not reliably separate temporary listing SKUs from other SKUs when preparing fulfillment or shipping interfaces.
| Area | Before July 30, 2026 | Current behavior |
|---|---|---|
| Order line item response | No listing-type indicator | Returns product_listing_type |
| Temporary listing detection | Apps could not identify it from Order API data | Apps can detect TEMPORARY_LISTING |
| Shipping workflow | Apps used the same routing logic for all SKUs | Apps can apply a separate workflow for temporary listing SKUs |
§3 Affected APIs
Affected APIs
| API | Method and path | Response field |
|---|---|---|
| Get Order List | POST /order/202309/orders/search | data.orders[].line_items[].product_listing_type |
| Get Order Detail | GET /order/202309/orders | data.orders[].line_items[].product_listing_type |
| Get Order Detail | GET /order/202507/orders | data.orders[].line_items[].product_listing_type |
§4 New field
New field
| Field | Type | Value | Description |
|---|---|---|---|
product_listing_type | string | TEMPORARY_LISTING | Indicates that the SKU was created as a temporary listing. The field is returned at the order line item level. |
Your app must tolerate other values and a missing field. Do not fail order ingestion when the value is unknown or absent.
§5 Response example
Response example
{
"data": {
"orders": [
{
"id": "576461413038785752",
"line_items": [
{
"id": "577086512123755123",
"sku_id": "2729382476852921560",
"product_listing_type": "TEMPORARY_LISTING"
}
]
}
]
}
}
§6 How to integrate
- Update your response model. Add the optional string field
product_listing_typeunder each object indata.orders[].line_items[]. - Detect temporary listing SKUs. When the field equals
TEMPORARY_LISTING, classify that line item as a temporary listing. - Route the line item. Apply the shipping interface or fulfillment workflow that your app uses for temporary listings.
- Preserve a fallback. Keep your existing workflow when the field contains another value, is empty, or is not returned.
- Test both paths. Validate at least one temporary listing line item and one non-temporary line item before enabling automated routing.
§7 Timeline and enforcement
| Date | What happened |
|---|---|
| July 30, 2026 | The field became available in all markets on the affected Order APIs. |
This is a non-breaking response enhancement. TikTok Shop does not require a new request format or introduce new error codes for this change. Existing integrations can continue to process orders, but apps that ignore the field cannot distinguish temporary listing SKUs for separate workflow routing.
§8 FAQ
#§9 Do I need to upgrade to a new API version?
Do I need to upgrade to a new API version?
No. The field is available in the listed v202309 and v202507 endpoints.
§10 Does this change any request parameters?
Does this change any request parameters?
No. This update adds a response field at the order line item level.
§11 Does this apply to every market?
Does this apply to every market?
Yes. The field has been available in all markets since July 30, 2026.