Qeasy Cloud
Get Started

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

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

多平台 - Walmart售后订单列表

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

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

The 多平台 - Walmart售后订单列表 API (/basicOpen/openapi/multiplatform/walmart/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.