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