/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×tamp=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}```"
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | startDate | 开始时间 | string | — | Required | 开始时间,格式 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss |
| 2 | endDate | 结束时间 | string | — | Required | 结束时间,格式 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss |
| 3 | dateType | 时间类型 | number | — | Required | 时间类型:1-售后时间(returnOrderDate) 2-截止时间(returnByDate) 3-订购时间(purchaseTimeLocale) 查询时间范围不超过一年 |
| 4 | fulfilmentTypeList | 发货类型 | array<any> | — | Optional | 发货类型:FulfillBySeller / FulfillByPlatform / FulfillByPlatformAndSeller |
| 5 | pageNum | 页码 | integer | — | Optional | 页码,默认 1 |
| 6 | pageSize | 每页条数 | integer | — | Optional | 每页条数,默认 20 |
| 7 | returnReasonList | 售后原因列表(明细维度 | array<any> | — | Optional | 售后原因列表(明细维度,return_reason 原始代码) |
| 8 | returnStatusList | 售后状态列表(明细维度) | array<any> | — | Optional | 售后状态列表(明细维度):INITIATED / DELIVERED / COMPLETED |
| 9 | returnTypeList | 售后类型 | array<any> | — | Optional | 售后类型:REPLACEMENT / PREORDER / REFUND |
| 10 | searchMultiValue | 批量精确搜索关键词列表(换行分隔后传入) | array<any> | — | Optional | 批量精确搜索关键词列表(换行分隔后传入) |
| 11 | searchSingleValue | 单个模糊搜索关键词 | string | — | Optional | 单个模糊搜索关键词 |
| 12 | searchType | 搜索字段类型 | number | — | Optional | 搜索字段类型:1-售后单号 2-买家订单号 3-换货订单号 4-平台订单号 5-标题 6-MSKU 7-SKU 8-品名 |
| 13 | siteCodeList | 站点列表 | array<any> | — | Optional | 站点列表,如 10008-US |
| 14 | sortField | 排序字段 | string | — | Optional | 排序字段:returnOrderDate / returnByDate / purchaseTimeLocale,默认 returnOrderDate |
| 15 | sortType | 排序方式 | string | — | Optional | 排序方式:asc / desc,默认 desc |
| 16 | storeIdList | 店铺ID列表 | array<any> | — | Optional | 店铺ID列表 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | Required | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-07-10 12:00:00 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | current | current | integer | — | Required | |
| 6.2 | list | list | array<object> | — | Required | |
| 6.2.1 | customerOrderId | 买家订单号 | string | — | Required | 买家订单号 |
| 6.2.2 | items | 商品明细列表 | array<object> | — | Required | 商品明细列表 |
| 6.2.2.1 | carrierName | 物流商名称 | string | — | Required | 物流商名称 |
| 6.2.2.2 | currentDeliveryStatus | 配送状态 | string | — | Required | 配送状态 |
| 6.2.2.3 | currentRefundStatus | 退款状态 | string | — | Required | 退款状态 |
| 6.2.2.4 | fulfilmentType | 发货类型 | string | — | Required | 发货类型 |
| 6.2.2.5 | lineTotalAmount | 退款金额 | integer | — | Required | 退款金额 |
| 6.2.2.6 | lineTotalCurrency | 退款币种 | string | — | Required | 退款币种 |
| 6.2.2.7 | lineTotalSymbol | 退款币种符号 | string | — | Required | 退款币种符号,如 $ |
| 6.2.2.8 | localSku | localSku | string | — | Required | SKU(关联 all_product_info.local_sku) |
| 6.2.2.9 | msku | msku | string | — | Required | MSKU |
| 6.2.2.10 | pname | pname | string | — | Required | 品名(关联 all_product_info.pname) |
| 6.2.2.11 | productImageUrl | 商品图片URL(TODO | string | — | Required | 商品图片URL(TODO: feign 实时查) |
| 6.2.2.12 | productName | 商品标题 | string | — | Required | 商品标题 |
| 6.2.2.13 | purchaseOrderId | 平台订单号 | string | — | Required | 平台订单号 |
| 6.2.2.14 | purchaseTimeLocale | 原订单下单时间(站点本地时间) | string | — | Required | 原订单下单时间(站点本地时间) |
| 6.2.2.15 | quantityDisplay | 售后数量(整数则去小数位 | string | — | Required | 售后数量(整数则去小数位,如 2.0→2) |
| 6.2.2.16 | returnDescription | 售后原因描述 | string | — | Required | 售后原因描述 |
| 6.2.2.17 | returnReason | 售后原因代码 | string | — | Required | 售后原因代码 |
| 6.2.2.18 | status | 售后状态 | string | — | Required | 售后状态:INITIATED / DELIVERED / COMPLETED |
| 6.2.2.19 | statusTime | 状态时间(站点本地时间) | string | — | Required | 状态时间(站点本地时间) |
| 6.2.2.20 | trackingNo | 退货运单号 | string | — | Required | 退货运单号 |
| 6.2.3 | purchaseTimeLocale | 原订单下单时间(站点本地时间) | string | — | Required | 原订单下单时间(站点本地时间) |
| 6.2.4 | replacementCustomerOrderId | replacementCustomerOrderId | string | — | Required | 换货订单号(仅 REPLACEMENT 类型有值) |
| 6.2.5 | returnByDate | 售后截止时间(站点本地时间) | string | — | Required | 售后截止时间(站点本地时间) |
| 6.2.6 | returnOrderDate | 售后申请时间(站点本地时间) | string | — | Required | 售后申请时间(站点本地时间) |
| 6.2.7 | returnOrderId | 售后单号(平台 RMA 编号) | string | — | Required | 售后单号(平台 RMA 编号) |
| 6.2.8 | returnType | 售后类型 | string | — | Required | 售后类型:REPLACEMENT / PREORDER / REFUND |
| 6.2.9 | returnTypeName | 售后类型中文 | string | — | Required | 售后类型中文:换货 / 预购订单退货 / 退货退款 |
| 6.2.10 | siteCode | 站点编码 | string | — | Required | 站点编码,如 10008-US |
| 6.2.11 | siteName | 站点中文名 | string | — | Required | 站点中文名,如 美国 |
| 6.2.12 | storeId | 店铺ID | integer | — | Required | 店铺ID |
| 6.2.13 | storeName | 店铺名称 | string | — | Required | 店铺名称 |
| 6.3 | pages | pages | integer | — | Required | |
| 6.4 | size | size | integer | — | Required | |
| 6.5 | total | total | integer | — | 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.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.