stable本次发布有变化全部展示
来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 US & UK Markets: Replacement Orders
US & UK Markets: Replacement Orders
Effective date: July 8, 2026
§2 What's changing
What's changing
TikTok buyers will have the ability to request a replacement shipment, which means they will keep the original item
in the event their order has been marked as delivered and meets one of the following criteria:
- Non-returnable item + seller fault (damaged items/packaging)
- Non-returnable item + DNR (Delivered, not received)
- Returnable item + DNR (Delivered, not received)
§3 Impact
This is a backward-compatible change and will not require a new API version. Existing integrations will continue to work without any modification. However, in order for a seller's system to properly identify that a new order was initiated due to a replacement request, the seller must leverage specific parameters within the APIs.
| Impacted Markets | * United States (US) * United Kingdom (UK) |
|---|---|
| Returns APIs | Parameter Update |
| --- | --- |
| Search Returns API Search Aftersales Request API Search Return Merchandise Authorization API Webhook Topic: Return Status Change | Added the following enumeration to the return_typefield: * REPLACEMENT Added the following enumerations to the return_status field: * REPLACEMENT_REQUEST_PENDING * REPLACEMENT_REQUEST_REJECT * REPLACEMENT_REQUEST_REFUND_SUCCESS * REPLACEMENT_REQUEST_CANCEL * REPLACEMENT_REQUEST_COMPLETE |
| Approve Return API | Added the following enumeration to the decision field: * APPROVE_REPLACEMENT |
| Reject Return API | Added the following enumeration to the decision field: * REJECT_REPLACEMENT |
| Get Decision Eligibility API | Added the following enumerations to the check_decisions and decision fields: * APPROVE_REPLACEMENT * REJECT_REPLACEMENT |
| Orders API Endpoints | Parameter Update |
| --- | --- |
| Get Order Details API Get Order List API | 1. is_replacement_order : When true, this is a replacement order that the seller must fulfill. 2. replaced_order_id: If the order is an replacement order, this field returns the original order's order ID, from which the replacement order was generated. Returned only if is_replacement_order = true Note*: This new outbound order will also have a $0.00 order value, because the payment/GMV was previously captured within the original order_id, and there are no financial transactions required, as this will always be a 1-1 sku_id replacement.* |
§4 Replacement workflow
Image
- If a buyer receives their items and the conditions meet the criteria to be eligible for a replacement, they can submit a replacement request
- Once the replacement is submitted, a return_id event is generated in TikTok. This return_id will have a type:
REPLACEMENT - The seller can either approve the request (Approve Return API), or reject the request (Reject Return API)
- If the seller has approved the replacement request, TikTok will automatically create a new outbound order. Within the Get Order Details API & Get Order Lists API, there are two parameters that identify the replacement scenario:
is_replacement_order: Booleanreplaced_order_id: Original order'sorder_id, from which the replacement order was generated. Returned only ifis_replacement_order=true.- The seller's warehouse is expected to fulfill the order with the replacement item once they receive the order.