Qeasy Cloud
Get Started

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

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
多平台 / 售后订单 · POST · 请求参数 16 个(必填 3) · 响应参数 39 个 · 限流令牌桶容量 1
Updated At
2026-11-21

多平台 - TikTok售后订单列表

POST/basicOpen/openapi/multiplatform/tiktok/returnOrder/list
Factory
{
  "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}```"
}

Request Parameters

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

Response Parameters

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

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.