轻易云
注册体验

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

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

多平台 - Walmart售后订单列表

POST/basicOpen/openapi/multiplatform/walmart/returnOrder/list
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/openapi/multiplatform/walmart/returnOrder/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/openapi/multiplatform/walmart/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\":1,\"pageSize\":20,\"returnReasonList\":[],\"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\"customerOrderId\":\"\",\n\t\t\t\t\"items\":[\n\t\t\t\t\t{\n\t\t\t\t\t\t\"carrierName\":\"\",\n\t\t\t\t\t\t\"currentDeliveryStatus\":\"\",\n\t\t\t\t\t\t\"currentRefundStatus\":\"\",\n\t\t\t\t\t\t\"fulfilmentType\":\"\",\n\t\t\t\t\t\t\"lineTotalAmount\":0,\n\t\t\t\t\t\t\"lineTotalCurrency\":\"\",\n\t\t\t\t\t\t\"lineTotalSymbol\":\"\",\n\t\t\t\t\t\t\"localSku\":\"\",\n\t\t\t\t\t\t\"msku\":\"\",\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\"purchaseOrderId\":\"\",\n\t\t\t\t\t\t\"purchaseTimeLocale\":\"\",\n\t\t\t\t\t\t\"quantityDisplay\":\"\",\n\t\t\t\t\t\t\"returnDescription\":\"\",\n\t\t\t\t\t\t\"returnReason\":\"\",\n\t\t\t\t\t\t\"status\":\"\",\n\t\t\t\t\t\t\"statusTime\":\"\",\n\t\t\t\t\t\t\"trackingNo\":\"\"\n\t\t\t\t\t}\n\t\t\t\t],\n\t\t\t\t\"purchaseTimeLocale\":\"\",\n\t\t\t\t\"replacementCustomerOrderId\":\"\",\n\t\t\t\t\"returnByDate\":\"\",\n\t\t\t\t\"returnOrderDate\":\"\",\n\t\t\t\t\"returnOrderId\":\"\",\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}\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-售后时间(returnOrderDate) 2-截止时间(returnByDate) 3-订购时间(purchaseTimeLocale) 查询时间范围不超过一年
4fulfilmentTypeList发货类型array<any>—可选发货类型:FulfillBySeller / FulfillByPlatform / FulfillByPlatformAndSeller
5pageNum页码integer—可选页码,默认 1
6pageSize每页条数integer—可选每页条数,默认 20
7returnReasonList售后原因列表(明细维度array<any>—可选售后原因列表(明细维度,return_reason 原始代码)
8returnStatusList售后状态列表(明细维度)array<any>—可选售后状态列表(明细维度):INITIATED / DELIVERED / COMPLETED
9returnTypeList售后类型array<any>—可选售后类型:REPLACEMENT / PREORDER / REFUND
10searchMultiValue批量精确搜索关键词列表(换行分隔后传入)array<any>—可选批量精确搜索关键词列表(换行分隔后传入)
11searchSingleValue单个模糊搜索关键词string—可选单个模糊搜索关键词
12searchType搜索字段类型number—可选搜索字段类型:1-售后单号 2-买家订单号 3-换货订单号 4-平台订单号 5-标题 6-MSKU 7-SKU 8-品名
13siteCodeList站点列表array<any>—可选站点列表,如 10008-US
14sortField排序字段string—可选排序字段:returnOrderDate / returnByDate / purchaseTimeLocale,默认 returnOrderDate
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.1customerOrderId买家订单号string—必填买家订单号
6.2.2items商品明细列表array<object>—必填商品明细列表
6.2.2.1carrierName物流商名称string—必填物流商名称
6.2.2.2currentDeliveryStatus配送状态string—必填配送状态
6.2.2.3currentRefundStatus退款状态string—必填退款状态
6.2.2.4fulfilmentType发货类型string—必填发货类型
6.2.2.5lineTotalAmount退款金额integer—必填退款金额
6.2.2.6lineTotalCurrency退款币种string—必填退款币种
6.2.2.7lineTotalSymbol退款币种符号string—必填退款币种符号,如 $
6.2.2.8localSkulocalSkustring—必填SKU(关联 all_product_info.local_sku)
6.2.2.9mskumskustring—必填MSKU
6.2.2.10pnamepnamestring—必填品名(关联 all_product_info.pname)
6.2.2.11productImageUrl商品图片URL(TODOstring—必填商品图片URL(TODO: feign 实时查)
6.2.2.12productName商品标题string—必填商品标题
6.2.2.13purchaseOrderId平台订单号string—必填平台订单号
6.2.2.14purchaseTimeLocale原订单下单时间(站点本地时间)string—必填原订单下单时间(站点本地时间)
6.2.2.15quantityDisplay售后数量(整数则去小数位string—必填售后数量(整数则去小数位,如 2.0→2)
6.2.2.16returnDescription售后原因描述string—必填售后原因描述
6.2.2.17returnReason售后原因代码string—必填售后原因代码
6.2.2.18status售后状态string—必填售后状态:INITIATED / DELIVERED / COMPLETED
6.2.2.19statusTime状态时间(站点本地时间)string—必填状态时间(站点本地时间)
6.2.2.20trackingNo退货运单号string—必填退货运单号
6.2.3purchaseTimeLocale原订单下单时间(站点本地时间)string—必填原订单下单时间(站点本地时间)
6.2.4replacementCustomerOrderIdreplacementCustomerOrderIdstring—必填换货订单号(仅 REPLACEMENT 类型有值)
6.2.5returnByDate售后截止时间(站点本地时间)string—必填售后截止时间(站点本地时间)
6.2.6returnOrderDate售后申请时间(站点本地时间)string—必填售后申请时间(站点本地时间)
6.2.7returnOrderId售后单号(平台 RMA 编号)string—必填售后单号(平台 RMA 编号)
6.2.8returnType售后类型string—必填售后类型:REPLACEMENT / PREORDER / REFUND
6.2.9returnTypeName售后类型中文string—必填售后类型中文:换货 / 预购订单退货 / 退货退款
6.2.10siteCode站点编码string—必填站点编码,如 10008-US
6.2.11siteName站点中文名string—必填站点中文名,如 美国
6.2.12storeId店铺IDinteger—必填店铺ID
6.2.13storeName店铺名称string—必填店铺名称
6.3pagespagesinteger—必填
6.4sizesizeinteger—必填
6.5totaltotalinteger—必填

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

需要对接这个接口?

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