US only: Order cancellation workflow updates

资料正文

§1 What is changing?

Sellers can reject the buyer's cancel requests by shipping the packages. Previously, when the seller tried to ship the package, the following APIs would return an error: Ship Package, Batch Ship Package, Mark Package As Shipped with the message {"fail_code":21011007,"fail_reason":"Package item has after-sale request"}. The parameters and responses of these APIs are not changed. See [below](#API Changes) for the endpoints that have changed. After this change:

When there is a customer cancellation request pending process, we allow sellers to ship the package instead of previously returning API errors.
When sellers successfully ship the package, the cancellation request will be rejected automatically by TikTok Shop. Previously, sellers had to go to Seller Center to reject the cancellation request manually.

§2 API Changes

API Changes

§3 Get Order List

Get Order List

Type	Changes	Notes
Request Body	Added `is_buyer_request_cancel` parameter	Set this to `TRUE` to retrieve orders that have a buyer cancel request.
Response	New property `is_buyer_request_cancel`	Returns `TRUE` if buyer has requested cancellation
	New property `request_cancel_time`	The time when buyer requested cancellation

§4 Get Order Detail

Get Order Detail

Type	Changes	Notes
Response	New property `is_buyer_request_cancel`	Returns `TRUE` if buyer has requested cancellation
	New property `request_cancel_time`	The time when buyer requested cancellation

§5 Which markets are affected?

This backend logic change is only for the US Market.

§6 Who is affected?

Local and cross-border sellers in the US Market are affected.

§7 Which version is applicable?

These changes are only for v202309.

§8 What action is required?

§9 Integration suggestions

Integration suggestions

Let sellers know they can reject the buyer's cancel requests by shipping the packages
Show sellers the orders that are attached with cancel requests
Use is_buyer_request_cancel in Orders API to let sellers know which orders have pending cancel requests from buyers (the Search Cancellation API also works in this case)
Use fulfillment APIs to ship packages and reject cancel requests
Stop using the Reject Cancellation endpoint before March 31, 2024.