快工助手跨境电商知识与商机助手

For SEA market: Order and Fulfillment API will be changed for In-Store Pickup Business

TikTok Shop 官方资料 · TikTok Shop Partner Center 开发者文档 · 适合开发者

stable本次发布有变化全部展示

来自 TikTok Shop 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
TikTok Shop / profile.tiktok.docs_api
语言
en-US
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/tiktok_shopaudience/developercategory/api_doctopic/compliancetopic/developer

资料正文

§1 What is changing?

From September 1, 2026, Platform will update order and fulfillment API for in-store pickup business.

  1. 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.
  2. 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
  3. 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.
  4. 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.
  5. There will be three new error codes for Update Package Delivery Status API
Error codeOverrideError message(API Docs)
21042248falseThe maximum number of attempts has been reached. Please try again in 30 minutes.
21042247falseThe code you entered is incorrect. Please try again.
21042252falseAbnormal order status, failed to update delivery status, please try again later.
  1. For In-store Pickup, Ship Package API confirms shipment and notifies the buyer that the order is ready for pickup.
  2. There will be one new error code for Ship Package API
Error codeOverrideError message(API Docs)
21042251falseAbnormal order status, item cannot be shipped.
  1. For In-store Pickup, Batch Ship Packages API confirms shipment and notifies the buyer that the order is ready for pickup.
  2. There will be one new error code for Batch Ship Packages API
Error codeOverrideError message(API Docs)
21042251falseAbnormal 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?

#

§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:

  1. 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. If order_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 buyers
  • PARTIALLY_SHIPPING: Not applicable for In-store pickup orders
  • AWAITING_COLLECTION: Not applicable for In-store pickup orders
  • IN_TRANSIT: The package is ready to be picked up by buyer and waiting for the OTP to be verified
  • DELIVERED: The package has been successfully picked up by buyer and OTP already verified
  • COMPLETED: The order has been completed, and no further returns or refunds are allowed.
  • CANCELLED: The order has been cancelled.
  1. Buyer Data:
  2. 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.
#