/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}```"
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | startDate | 开始时间 | string | — | 必填 | 开始时间,格式 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss |
| 2 | endDate | 结束时间 | string | — | 必填 | 结束时间,格式 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss |
| 3 | dateType | 时间类型 | number | — | 必填 | 时间类型:1-售后时间 2-订购时间 查询时间范围不超过一年 |
| 4 | fulfilmentTypeList | 发货类型 | array<any> | — | 可选 | 发货类型:FulfillBySeller / FulfillByPlatform / FulfillByPlatformAndSeller |
| 5 | pageNum | 查询起始位置 | number | — | 可选 | 查询起始位置 |
| 6 | pageSize | 分页大小 | number | — | 可选 | 分页大小 |
| 7 | returnReasonTextList | returnReasonTextList | array<any> | — | 可选 | 售后原因列表(return_reason_text) |
| 8 | returnStatusList | 售后状态列表(TikTok接口原始状态) | array<any> | — | 可选 | 售后状态列表(TikTok接口原始状态) |
| 9 | returnTypeList | 售后类型 | array<any> | — | 可选 | 售后类型:REFUND / RETURN_AND_REFUND / REPLACEMENT |
| 10 | searchMultiValue | 批量精确搜索关键词列表(换行分隔后传入) | array<any> | — | 可选 | 批量精确搜索关键词列表(换行分隔后传入) |
| 11 | searchSingleValue | 单个模糊搜索关键词 | string | — | 可选 | 单个模糊搜索关键词 |
| 12 | searchType | 搜索字段类型 | number | — | 可选 | 搜索字段类型:1-售后单号 2-平台订单号 3-标题 4-MSKU 5-MSKU ID 6-SKU 7-品名 |
| 13 | siteCodeList | 站点列表 | array<any> | — | 可选 | 站点列表,如 10011-US |
| 14 | sortField | 排序字段 | string | — | 可选 | 排序字段:createTimeLocale / purchaseTimeLocale / updateTimeLocale,默认 createTimeLocale |
| 15 | sortType | 排序方式 | string | — | 可选 | 排序方式:asc / desc,默认 desc |
| 16 | storeIdList | 店铺ID列表 | array<any> | — | 可选 | 店铺ID列表 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | 必填 | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-07-10 12:00:00 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | current | current | integer | — | 必填 | |
| 6.2 | list | list | array<object> | — | 必填 | |
| 6.2.1 | createTimeLocale | 售后申请时间(站点本地时间) | string | — | 必填 | 售后申请时间(站点本地时间) |
| 6.2.2 | fulfilmentType | 发货类型 | string | — | 必填 | 发货类型 |
| 6.2.3 | items | 商品明细列表 | array<object> | — | 必填 | 商品明细列表 |
| 6.2.3.1 | localSku | localSku | string | — | 必填 | SKU(关联 all_product_info.local_sku) |
| 6.2.3.2 | mskuId | MSKU ID(sku_id) | string | — | 必填 | MSKU ID(sku_id) |
| 6.2.3.3 | pname | pname | string | — | 必填 | 品名(关联 all_product_info.pname) |
| 6.2.3.4 | productImageUrl | 商品图片URL | string | — | 必填 | 商品图片URL |
| 6.2.3.5 | productName | 商品标题 | string | — | 必填 | 商品标题 |
| 6.2.3.6 | quantity | 售后数量 | number | — | 必填 | 售后数量 |
| 6.2.3.7 | refundCurrency | 退款币种 | string | — | 必填 | 退款币种 |
| 6.2.3.8 | refundSymbol | 退款币种符号 | string | — | 必填 | 退款币种符号,如 $、¥ |
| 6.2.3.9 | refundTotal | 退款金额 | integer | — | 必填 | 退款金额 |
| 6.2.3.10 | sellerSku | MSKU(seller_sku) | string | — | 必填 | MSKU(seller_sku) |
| 6.2.4 | orderId | 平台订单号 | string | — | 必填 | 平台订单号 |
| 6.2.5 | purchaseTimeLocale | 原订单下单时间(站点本地时间) | string | — | 必填 | 原订单下单时间(站点本地时间) |
| 6.2.6 | returnId | 售后单号 | string | — | 必填 | 售后单号 |
| 6.2.7 | returnProviderName | 退货物流商(仅退款时为空) | string | — | 必填 | 退货物流商(仅退款时为空) |
| 6.2.8 | returnReasonText | 售后原因文本 | string | — | 必填 | 售后原因文本 |
| 6.2.9 | returnStatus | 售后状态(TikTok接口原始状态) | string | — | 必填 | 售后状态(TikTok接口原始状态) |
| 6.2.10 | returnStatusName | 售后状态中文 | string | — | 必填 | 售后状态中文 |
| 6.2.11 | returnTrackingNumber | 退货运单号(仅退款时为空) | string | — | 必填 | 退货运单号(仅退款时为空) |
| 6.2.12 | returnType | 售后类型原始值 | string | — | 必填 | 售后类型原始值:REFUND / RETURN_AND_REFUND / REPLACEMENT |
| 6.2.13 | returnTypeName | 售后类型中文 | string | — | 必填 | 售后类型中文:仅退款 / 退货退款 / 换货 |
| 6.2.14 | siteCode | 站点编码 | string | — | 必填 | 站点编码,如 10011-US |
| 6.2.15 | siteName | 站点中文名 | string | — | 必填 | 站点中文名,如 美国 |
| 6.2.16 | storeId | 店铺ID | integer | — | 必填 | 店铺ID |
| 6.2.17 | storeName | 店铺名称 | string | — | 必填 | 店铺名称 |
| 6.2.18 | updateTimeLocale | 售后更新时间(站点本地时间) | string | — | 必填 | 售后更新时间(站点本地时间) |
| 6.3 | pages | pages | integer | — | 必填 | |
| 6.4 | size | size | integer | — | 必填 | |
| 6.5 | total | total | integer | — | 必填 |
领星ERP的接口:多平台 - TikTok售后订单列表(/basicOpen/openapi/multiplatform/tiktok/returnOrder/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。