Skip to content

Submit Customs Clearance Information

POST
/fulfillment/202607/orders/customs_info/submit

This API is used to submit extra customs clearance information for discrepancies between declared information and physical goods.

Media typeapplication/json
object
order_list

List of orders for which to submit customs clearance information. Maximum: 100 orders per request.

Array<object>
object
order_id
required

TikTok Shop order ID

string
item_list

List of customs clearance entries for order lines. Within the same order, explicit order_line_id values must be unique.

Array<object>
object
order_line_id

Sub order ID; order_line_id and sku_id should not be both empty.

string
sku_id

SKU ID; order_line_id and sku_id should not be both empty.

string
item_detail

List of SKU-level customs clearance details for the order line.

Array<object>
object
sku_id
required

The SKU ID for this customs clearance detail.

string
qty
required

Quantity of this SKU in the customs clearance detail. Must be greater than 0.

integer format: int64
price_percent
required

Percentage assigned to this SKU within the order line. Each value must be non-negative, and the price_percent values in item_detail must total 100. For example, 10 means 10%.

integer format: int64
Example
{
"order_list": [
{
"order_id": "584882846571463232",
"item_list": [
{
"order_line_id": "584882846571423334",
"sku_id": "1735885807280883357",
"item_detail": [
{
"sku_id": "1735885807280883357",
"qty": 2,
"price_percent": 10
}
]
}
]
}
]
}

Success

Media typeapplication/json
object
code

Status code; 0 means success.

integer format: int64
message

Success or failure message.

string
request_id

Request log ID.

string
data
object
Example
{
"code": 0,
"data": {},
"message": "Success",
"request_id": "202203070749000101890810281E8C70B7"
}