/pb/mp/returns/v2/list{
"operation": {
"method": "POST",
"path": "/pb/mp/returns/v2/list"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 10,
"text": ""
},
"requestExample": {
"offset": 0,
"length": 20,
"time_type": "updateTime",
"start_time": "2023-01-01 00:00:00",
"end_time": "2024-07-29 20:50:00",
"sales_type": 1,
"status": [
1,
4,
5
],
"store_id": [
"127190049090011648",
"127190049090011654"
],
"wid": [
1,
578,
765
]
},
"responseExample": {
"code": 0,
"data": {
"total": "10",
"list": [
{
"reason": "产品质量问题",
"status": "已完成",
"platform": "amazon",
"site": null,
"remark": "",
"sid": "101",
"items": [
{
"sku": "mini-blue2",
"msku": "",
"quantity": 3,
"remark": "",
"stockDeductId": "0",
"platform_order_no": "1258762477858",
"product_name": "干花*2",
"return_quantity": 3,
"receiving_quantity": 3,
"handler_type": "默认不处理",
"available_quantity": 3,
"defective_quantity": null,
"destroyed_quantity": 0,
"stock_cost": null,
"pic_infos": null
}
],
"rma_order_no": "RT901406878224720384",
"sales_type": "买家退货",
"sys_wid": "1",
"w_name": "wcn测试仓库测试改名",
"delivery_w_name": null,
"delivery_w_nid": null,
"global_order_no": "103345679826100736",
"logistics_provider_name": "",
"tracking_no": "132",
"uid_name": "陈旭鹏",
"gmt_create": "2024-02-04 17:11:44",
"store_name": null,
"has_prediction": 0,
"pre_arrival_time": "1970-01-01 08:00:00",
"complete_time": "2024-02-04 17:12:19",
"gmt_modified": "2024-02-04 17:12:19",
"store_id": "127190049090011648",
"relation_order_info": {
"global_order_no": "103345679826100736",
"storage_in_order_no": "IB240204014"
}
},
{
"reason": "包裹损坏",
"status": "已完成",
"platform": "amazon",
"site": null,
"remark": "",
"sid": "101",
"items": [
{
"sku": "BAN",
"msku": "",
"quantity": 2,
"remark": "",
"stockDeductId": "0",
"platform_order_no": "test1203-110",
"product_name": "BAN",
"return_quantity": 1,
"receiving_quantity": 1,
"handler_type": "默认不处理",
"available_quantity": 0,
"defective_quantity": null,
"destroyed_quantity": 0,
"stock_cost": null,
"pic_infos": null
}
],
"rma_order_no": "RT901261790905177088",
"sales_type": "买家退货",
"sys_wid": "1",
"w_name": "wcn测试仓库测试改名",
"delivery_w_name": null,
"delivery_w_nid": null,
"global_order_no": "103255373488840704",
"logistics_provider_name": "",
"tracking_no": "",
"uid_name": "金巧玲",
"gmt_create": "2022-12-21 17:49:55",
"store_name": null,
"has_prediction": 0,
"pre_arrival_time": "1970-01-01 08:00:00",
"complete_time": "2023-11-13 15:01:23",
"gmt_modified": "2023-11-13 15:01:23",
"store_id": "127190049090011648",
"relation_order_info": {
"global_order_no": "103255373488840704",
"storage_in_order_no": "IB231113004"
}
}
]
},
"response_time": "2024-07-31 16:00:40",
"message": "操作成功",
"request_id": "aa4794a7b2c0437483966bed3e7bee75.114.17224128397332303"
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | offset | 页码 | integer | — | Required | 页码,非偏移量 offset传1,则返回第一页数据 |
| 2 | length | 每页记录数 | integer | — | Required | 每页记录数 |
| 3 | time_type | 搜索时间类型 | string | — | Optional | 搜索时间类型:updateTime 更新时间【不传默认为创建时间】 |
| 4 | start_time | 开始时间 | string | — | Required | 开始时间,格式:Y-m-d H:i:s |
| 5 | end_time | 结束时间 | string | — | Required | 结束时间,格式:Y-m-d H:i:s |
| 6 | platform_code | 平台code | array<any> | — | Optional | 平台code |
| 7 | sales_type | 退货类型 | integer | — | Optional | 退货类型:1 买家退货,2 物流商退货 |
| 8 | status | 订单状态 | array<any> | — | Optional | 订单状态: -1 异常 1 待提交 2 待审批 3 待收货 4 已作废 5 已完成 6 导入中 |
| 9 | store_id | 店铺id | array<any> | — | Optional | 店铺id |
| 10 | wid | 系统仓库id | array<any> | — | Optional | 系统仓库id |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0 成功 |
| 2 | message | 操作成功 | string | 操作成功 | Required | 操作成功 |
| 3 | request_id | 请求链路id | string | 052e20647c9c4622adb7576ae335211d.1687946868074 | Required | 请求链路id |
| 4 | response_time | 响应时间 | string | 2023-06-28 18:07:50 | Required | 响应时间 |
| 5 | data | 响应数据 | object | — | Required | 响应数据 |
| 5.1 | total | 总条数 | integer | 41 | Required | 总条数 |
| 5.2 | list | 详细列表 | array<object> | — | Required | 详细列表 |
| 5.2.1 | complete_time | 完成时间 | string | 2023-06-05 16:25:08 | Required | 完成时间 |
| 5.2.2 | global_order_no | 系统单号 | integer | 103280851812762110 | Required | 系统单号 |
| 5.2.3 | gmt_create | 创建时间 | string | 2023-06-05 16:25:08 | Required | 创建时间 |
| 5.2.4 | gmt_modified | 更新时间 | string | 2023-06-05 16:25:08 | Required | 更新时间 |
| 5.2.5 | has_prediction | 是否三方仓预报 0 否 1 是 | integer | 0 | Required | 是否三方仓预报 0 否 1 是 |
| 5.2.6 | logistics_provider_name | 物流商 | string | xx物流 | Required | 物流商 |
| 5.2.7 | platform | 平台 | string | walmart | Required | 平台 |
| 5.2.8 | pre_arrival_time | 预计到货时间 | string | 2023-06-05 16:25:08 | Required | 预计到货时间 |
| 5.2.9 | reason | 退货原因 | string | 不给换 | Required | 退货原因 |
| 5.2.10 | remark | 备注 | string | xxxx备注 | Required | 备注 |
| 5.2.11 | rma_order_no | 退货单号 | string | RT901320516537774080 | Required | 退货单号 |
| 5.2.12 | sales_type | 退货类型 | string | 买家退货 | Required | 退货类型 |
| 5.2.13 | site | 站点 | string | 美国 | Required | 站点 |
| 5.2.14 | status | 订单状态 | string | 待收货 | Required | 订单状态 |
| 5.2.15 | store_id | 多平台店铺id | integer | 110000000017008000 | Required | 多平台店铺id |
| 5.2.16 | sid | 亚马逊店铺id | integer | 17 | Required | 亚马逊店铺id |
| 5.2.17 | store_name | 店铺名称 | string | xxx店铺 | Required | 店铺名称 |
| 5.2.18 | tracking_no | 跟踪号 | string | 212 | Required | 跟踪号 |
| 5.2.19 | uid_name | 创建人名称 | string | 张三 | Required | 创建人名称 |
| 5.2.20 | sys_wid | 退货仓库id | integer | 11 | Required | 退货仓库id |
| 5.2.21 | w_name | 退货仓库名称 | string | 仓库11 | Required | 退货仓库名称 |
| 5.2.22 | relation_order_info | 关联单据 | object | — | Required | 关联单据 |
| 5.2.22.1 | global_order_no | 系统单号 | integer | 103296739036561920 | Required | 系统单号 |
| 5.2.22.2 | storage_in_order_no | 入库单号 | string | IB230520001 | Required | 入库单号 |
| 5.2.23 | items | 商品信息 | array<object> | — | Required | 商品信息 |
| 5.2.23.1 | available_quantity | 可用量 | integer | 1 | Required | 可用量 |
| 5.2.23.2 | defective_quantity | 次品量 | integer | 1 | Required | 次品量 |
| 5.2.23.3 | destroyed_quantity | 销毁量 | integer | 1 | Required | 销毁量 |
| 5.2.23.4 | quantity | 数量 | integer | 1 | Required | 数量 |
| 5.2.23.5 | receiving_quantity | 收货数量 | integer | 1 | Required | 收货数量 |
| 5.2.23.6 | return_quantity | 退货数量 | integer | 1 | Required | 退货数量 |
| 5.2.23.7 | handler_type | 处理方式 | string | 默认不处理 | Required | 处理方式: 默认不处理 重新上架 由WMS决定 暂存区 次品 销毁 |
| 5.2.23.8 | pic_infos | 售后图片信息 | array<object> | — | Required | 售后图片信息 |
| 5.2.23.8.1 | access_url | 访问地址 | string | https://xxx/xxx | Required | 访问地址 |
| 5.2.23.8.2 | file_name | 图片名 | string | file | Required | 图片名 |
| 5.2.23.9 | remark | 售后说明 | string | 实例xxxx | Required | 售后说明 |
| 5.2.23.10 | platform_order_no | 平台单号 | string | ama-test0330-ZEjHkL | Required | 平台单号 |
| 5.2.23.11 | msku | msku | string | HOLDER001 | Required | msku |
| 5.2.23.12 | sku | 本地产品sku | string | danpin2 | Required | 本地产品sku |
| 5.2.23.13 | product_name | 品名 | string | 单品2 | Required | 品名 |
| 5.2.23.14 | id | id | integer | id | Required | id |
| 5.2.23.15 | defective_whb_code | 次品仓位编码 | string | — | Required | 次品仓位编码 |
| 5.2.23.16 | available_whb_code | 可用仓位编码 | string | — | Required | 可用仓位编码 |
The 查询销售退货单列表 API (/pb/mp/returns/v2/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.