stable本次发布有变化全部展示
来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§1 What is changing?
From September 1, 2026, Platform will update order and fulfillment API for in-store pickup business.
- A new parameter "instore_pickup_sla_time" will be added under the "orders" parameter in response body of Get Order Detail and Get Order List API. This API is used to get the order information data detail.
- A new enumeration for existing parameters "delivery_option_name" under Get Order Detail and Get Order List API will have a new enumeration called "In-store Pickup" to indicate the In-Store Pickup Order
- The value of "delivery_type" in request body of Update Package Delivery Status API will be DELIVERY_SUCCESS for in-store pickup business, which means that the package has been successfully delivered.
- A new parameter "verification_code" will be added into request body of Update Package Delivery Status API, which is the verification code for order pickup.
- There will be three new error codes for Update Package Delivery Status API
| Error code | Override | Error message(API Docs) |
|---|---|---|
| 21042248 | false | The maximum number of attempts has been reached. Please try again in 30 minutes. |
| 21042247 | false | The code you entered is incorrect. Please try again. |
| 21042252 | false | Abnormal order status, failed to update delivery status, please try again later. |
- For In-store Pickup, Ship Package API confirms shipment and notifies the buyer that the order is ready for pickup.
- There will be one new error code for Ship Package API
| Error code | Override | Error message(API Docs) |
|---|---|---|
| 21042251 | false | Abnormal order status, item cannot be shipped. |
- For In-store Pickup, Batch Ship Packages API confirms shipment and notifies the buyer that the order is ready for pickup.
- There will be one new error code for Batch Ship Packages API
| Error code | Override | Error message(API Docs) |
|---|---|---|
| 21042251 | false | Abnormal order status, item cannot be shipped. |
§2 Which markets are affected?
The updates of the requirements apply to local to local sellers in Singapore, Philippines, Vietnam, Thailand, Indonesia and Malaysia markets.
§3 Who is affected?
Developers with applications that use Get Order Detail, Get Order List, Update Package Delivery Status, Ship Package and Batch Ship Package.
§4 Which version is applicable?
The updates of the requirements apply to all versions of the related APIs
§5 What action is required?
Developers need to check whether to use the APIs listed above.
Note:
- For the In-store Pickup order status detail can refer to the following
UNPAID: The order has been placed, but payment has not been completed.ON_HOLD: The order has been accepted and is awaiting fulfillment. The buyer may still cancel without the seller’s approval. Iforder_type=PRE_ORDER, the product is still awaiting release so payment will only be authorized 1 day before the release, but the seller should start preparing for the release.AWAITING_SHIPMENT: The order is ready to be processed for pickup by buyersPARTIALLY_SHIPPING: Not applicable for In-store pickup ordersAWAITING_COLLECTION: Not applicable for In-store pickup ordersIN_TRANSIT: The package is ready to be picked up by buyer and waiting for the OTP to be verifiedDELIVERED: The package has been successfully picked up by buyer and OTP already verifiedCOMPLETED: The order has been completed, and no further returns or refunds are allowed.CANCELLED: The order has been cancelled.
- Buyer Data:
- Under the Get Order Detail and Get Order List API Recipient Address > phone_number and name will be desensitized for easier communication with buyer. Please proceed with care.
