/basicOpen/openapi/multiplatform/tiktok/returnOrder/list{
"operation": {
"method": "POST",
"path": "/basicOpen/openapi/multiplatform/tiktok/returnOrder/list"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/openapi/multiplatform/tiktok/returnOrder/list?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\"dateType\":0.0,\"endDate\":\"\",\"fulfilmentTypeList\":[],\"pageNum\":0.0,\"pageSize\":0.0,\"returnReasonTextList\":[],\"returnStatusList\":[],\"returnTypeList\":[],\"searchMultiValue\":[],\"searchSingleValue\":\"\",\"searchType\":0.0,\"siteCodeList\":[],\"sortField\":\"\",\"sortType\":\"\",\"startDate\":\"\",\"storeIdList\":[]}'",
"responseExample": "{\n\t\"code\":0,\n\t\"message\":\"success\",\n\t\"error_details\":[],\n\t\"request_id\":\"a0d54debf93140f3b58d1ed81e8e3583\",\n\t\"response_time\":\"2026-07-10 12:00:00\",\n\t\"data\":{\n\t\t\"current\":0,\n\t\t\"list\":[\n\t\t\t{\n\t\t\t\t\"createTimeLocale\":\"\",\n\t\t\t\t\"fulfilmentType\":\"\",\n\t\t\t\t\"items\":[\n\t\t\t\t\t{\n\t\t\t\t\t\t\"localSku\":\"\",\n\t\t\t\t\t\t\"mskuId\":\"\",\n\t\t\t\t\t\t\"pname\":\"\",\n\t\t\t\t\t\t\"productImageUrl\":\"\",\n\t\t\t\t\t\t\"productName\":\"\",\n\t\t\t\t\t\t\"quantity\":0.0,\n\t\t\t\t\t\t\"refundCurrency\":\"\",\n\t\t\t\t\t\t\"refundSymbol\":\"\",\n\t\t\t\t\t\t\"refundTotal\":0,\n\t\t\t\t\t\t\"sellerSku\":\"\"\n\t\t\t\t\t}\n\t\t\t\t],\n\t\t\t\t\"orderId\":\"\",\n\t\t\t\t\"purchaseTimeLocale\":\"\",\n\t\t\t\t\"returnId\":\"\",\n\t\t\t\t\"returnProviderName\":\"\",\n\t\t\t\t\"returnReasonText\":\"\",\n\t\t\t\t\"returnStatus\":\"\",\n\t\t\t\t\"returnStatusName\":\"\",\n\t\t\t\t\"returnTrackingNumber\":\"\",\n\t\t\t\t\"returnType\":\"\",\n\t\t\t\t\"returnTypeName\":\"\",\n\t\t\t\t\"siteCode\":\"\",\n\t\t\t\t\"siteName\":\"\",\n\t\t\t\t\"storeId\":0,\n\t\t\t\t\"storeName\":\"\",\n\t\t\t\t\"updateTimeLocale\":\"\"\n\t\t\t}\n\t\t],\n\t\t\"pages\":0,\n\t\t\"size\":0,\n\t\t\"total\":0\n\t}\n}```"
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | startDate | 开始时间 | string | — | Required | 开始时间,格式 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss |
| 2 | endDate | 结束时间 | string | — | Required | 结束时间,格式 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss |
| 3 | dateType | 时间类型 | number | — | Required | 时间类型:1-售后时间 2-订购时间 查询时间范围不超过一年 |
| 4 | fulfilmentTypeList | 发货类型 | array<any> | — | Optional | 发货类型:FulfillBySeller / FulfillByPlatform / FulfillByPlatformAndSeller |
| 5 | pageNum | 查询起始位置 | number | — | Optional | 查询起始位置 |
| 6 | pageSize | 分页大小 | number | — | Optional | 分页大小 |
| 7 | returnReasonTextList | returnReasonTextList | array<any> | — | Optional | 售后原因列表(return_reason_text) |
| 8 | returnStatusList | 售后状态列表(TikTok接口原始状态) | array<any> | — | Optional | 售后状态列表(TikTok接口原始状态) |
| 9 | returnTypeList | 售后类型 | array<any> | — | Optional | 售后类型:REFUND / RETURN_AND_REFUND / REPLACEMENT |
| 10 | searchMultiValue | 批量精确搜索关键词列表(换行分隔后传入) | array<any> | — | Optional | 批量精确搜索关键词列表(换行分隔后传入) |
| 11 | searchSingleValue | 单个模糊搜索关键词 | string | — | Optional | 单个模糊搜索关键词 |
| 12 | searchType | 搜索字段类型 | number | — | Optional | 搜索字段类型:1-售后单号 2-平台订单号 3-标题 4-MSKU 5-MSKU ID 6-SKU 7-品名 |
| 13 | siteCodeList | 站点列表 | array<any> | — | Optional | 站点列表,如 10011-US |
| 14 | sortField | 排序字段 | string | — | Optional | 排序字段:createTimeLocale / purchaseTimeLocale / updateTimeLocale,默认 createTimeLocale |
| 15 | sortType | 排序方式 | string | — | Optional | 排序方式:asc / desc,默认 desc |
| 16 | storeIdList | 店铺ID列表 | array<any> | — | Optional | 店铺ID列表 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | Required | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-07-10 12:00:00 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | current | current | integer | — | Required | |
| 6.2 | list | list | array<object> | — | Required | |
| 6.2.1 | createTimeLocale | 售后申请时间(站点本地时间) | string | — | Required | 售后申请时间(站点本地时间) |
| 6.2.2 | fulfilmentType | 发货类型 | string | — | Required | 发货类型 |
| 6.2.3 | items | 商品明细列表 | array<object> | — | Required | 商品明细列表 |
| 6.2.3.1 | localSku | localSku | string | — | Required | SKU(关联 all_product_info.local_sku) |
| 6.2.3.2 | mskuId | MSKU ID(sku_id) | string | — | Required | MSKU ID(sku_id) |
| 6.2.3.3 | pname | pname | string | — | Required | 品名(关联 all_product_info.pname) |
| 6.2.3.4 | productImageUrl | 商品图片URL | string | — | Required | 商品图片URL |
| 6.2.3.5 | productName | 商品标题 | string | — | Required | 商品标题 |
| 6.2.3.6 | quantity | 售后数量 | number | — | Required | 售后数量 |
| 6.2.3.7 | refundCurrency | 退款币种 | string | — | Required | 退款币种 |
| 6.2.3.8 | refundSymbol | 退款币种符号 | string | — | Required | 退款币种符号,如 $、¥ |
| 6.2.3.9 | refundTotal | 退款金额 | integer | — | Required | 退款金额 |
| 6.2.3.10 | sellerSku | MSKU(seller_sku) | string | — | Required | MSKU(seller_sku) |
| 6.2.4 | orderId | 平台订单号 | string | — | Required | 平台订单号 |
| 6.2.5 | purchaseTimeLocale | 原订单下单时间(站点本地时间) | string | — | Required | 原订单下单时间(站点本地时间) |
| 6.2.6 | returnId | 售后单号 | string | — | Required | 售后单号 |
| 6.2.7 | returnProviderName | 退货物流商(仅退款时为空) | string | — | Required | 退货物流商(仅退款时为空) |
| 6.2.8 | returnReasonText | 售后原因文本 | string | — | Required | 售后原因文本 |
| 6.2.9 | returnStatus | 售后状态(TikTok接口原始状态) | string | — | Required | 售后状态(TikTok接口原始状态) |
| 6.2.10 | returnStatusName | 售后状态中文 | string | — | Required | 售后状态中文 |
| 6.2.11 | returnTrackingNumber | 退货运单号(仅退款时为空) | string | — | Required | 退货运单号(仅退款时为空) |
| 6.2.12 | returnType | 售后类型原始值 | string | — | Required | 售后类型原始值:REFUND / RETURN_AND_REFUND / REPLACEMENT |
| 6.2.13 | returnTypeName | 售后类型中文 | string | — | Required | 售后类型中文:仅退款 / 退货退款 / 换货 |
| 6.2.14 | siteCode | 站点编码 | string | — | Required | 站点编码,如 10011-US |
| 6.2.15 | siteName | 站点中文名 | string | — | Required | 站点中文名,如 美国 |
| 6.2.16 | storeId | 店铺ID | integer | — | Required | 店铺ID |
| 6.2.17 | storeName | 店铺名称 | string | — | Required | 店铺名称 |
| 6.2.18 | updateTimeLocale | 售后更新时间(站点本地时间) | string | — | Required | 售后更新时间(站点本地时间) |
| 6.3 | pages | pages | integer | — | Required | |
| 6.4 | size | size | integer | — | Required | |
| 6.5 | total | total | integer | — | Required |
The 多平台 - TikTok售后订单列表 API (/basicOpen/openapi/multiplatform/tiktok/returnOrder/list) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.