轻易云
注册体验

领星ERP多平台 - TikTok售后订单列表接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
多平台 / 售后订单 · POST · 请求参数 16 个(必填 3) · 响应参数 39 个 · 限流令牌桶容量 1
更新日期
2026-11-21

多平台 - TikTok售后订单列表

POST/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&timestamp=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}```"
}

接口请求参数

序号字段名称类型默认值必填描述
1startDate开始时间string—必填开始时间,格式 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss
2endDate结束时间string—必填结束时间,格式 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss
3dateType时间类型number—必填时间类型:1-售后时间 2-订购时间 查询时间范围不超过一年
4fulfilmentTypeList发货类型array<any>—可选发货类型:FulfillBySeller / FulfillByPlatform / FulfillByPlatformAndSeller
5pageNum查询起始位置number—可选查询起始位置
6pageSize分页大小number—可选分页大小
7returnReasonTextListreturnReasonTextListarray<any>—可选售后原因列表(return_reason_text)
8returnStatusList售后状态列表(TikTok接口原始状态)array<any>—可选售后状态列表(TikTok接口原始状态)
9returnTypeList售后类型array<any>—可选售后类型:REFUND / RETURN_AND_REFUND / REPLACEMENT
10searchMultiValue批量精确搜索关键词列表(换行分隔后传入)array<any>—可选批量精确搜索关键词列表(换行分隔后传入)
11searchSingleValue单个模糊搜索关键词string—可选单个模糊搜索关键词
12searchType搜索字段类型number—可选搜索字段类型:1-售后单号 2-平台订单号 3-标题 4-MSKU 5-MSKU ID 6-SKU 7-品名
13siteCodeList站点列表array<any>—可选站点列表,如 10011-US
14sortField排序字段string—可选排序字段:createTimeLocale / purchaseTimeLocale / updateTimeLocale,默认 createTimeLocale
15sortType排序方式string—可选排序方式:asc / desc,默认 desc
16storeIdList店铺ID列表array<any>—可选店铺ID列表

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>—必填数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583必填请求链路id
5response_time响应时间string2026-07-10 12:00:00必填响应时间
6data响应数据object—必填响应数据
6.1currentcurrentinteger—必填
6.2listlistarray<object>—必填
6.2.1createTimeLocale售后申请时间(站点本地时间)string—必填售后申请时间(站点本地时间)
6.2.2fulfilmentType发货类型string—必填发货类型
6.2.3items商品明细列表array<object>—必填商品明细列表
6.2.3.1localSkulocalSkustring—必填SKU(关联 all_product_info.local_sku)
6.2.3.2mskuIdMSKU ID(sku_id)string—必填MSKU ID(sku_id)
6.2.3.3pnamepnamestring—必填品名(关联 all_product_info.pname)
6.2.3.4productImageUrl商品图片URLstring—必填商品图片URL
6.2.3.5productName商品标题string—必填商品标题
6.2.3.6quantity售后数量number—必填售后数量
6.2.3.7refundCurrency退款币种string—必填退款币种
6.2.3.8refundSymbol退款币种符号string—必填退款币种符号,如 $、¥
6.2.3.9refundTotal退款金额integer—必填退款金额
6.2.3.10sellerSkuMSKU(seller_sku)string—必填MSKU(seller_sku)
6.2.4orderId平台订单号string—必填平台订单号
6.2.5purchaseTimeLocale原订单下单时间(站点本地时间)string—必填原订单下单时间(站点本地时间)
6.2.6returnId售后单号string—必填售后单号
6.2.7returnProviderName退货物流商(仅退款时为空)string—必填退货物流商(仅退款时为空)
6.2.8returnReasonText售后原因文本string—必填售后原因文本
6.2.9returnStatus售后状态(TikTok接口原始状态)string—必填售后状态(TikTok接口原始状态)
6.2.10returnStatusName售后状态中文string—必填售后状态中文
6.2.11returnTrackingNumber退货运单号(仅退款时为空)string—必填退货运单号(仅退款时为空)
6.2.12returnType售后类型原始值string—必填售后类型原始值:REFUND / RETURN_AND_REFUND / REPLACEMENT
6.2.13returnTypeName售后类型中文string—必填售后类型中文:仅退款 / 退货退款 / 换货
6.2.14siteCode站点编码string—必填站点编码,如 10011-US
6.2.15siteName站点中文名string—必填站点中文名,如 美国
6.2.16storeId店铺IDinteger—必填店铺ID
6.2.17storeName店铺名称string—必填店铺名称
6.2.18updateTimeLocale售后更新时间(站点本地时间)string—必填售后更新时间(站点本地时间)
6.3pagespagesinteger—必填
6.4sizesizeinteger—必填
6.5totaltotalinteger—必填

领星ERP的接口:多平台 - TikTok售后订单列表(/basicOpen/openapi/multiplatform/tiktok/returnOrder/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。