/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"
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | offset | 页码 | integer | — | 必填 | 页码,非偏移量 offset传1,则返回第一页数据 |
| 2 | length | 每页记录数 | integer | — | 必填 | 每页记录数 |
| 3 | time_type | 搜索时间类型 | string | — | 可选 | 搜索时间类型:updateTime 更新时间【不传默认为创建时间】 |
| 4 | start_time | 开始时间 | string | — | 必填 | 开始时间,格式:Y-m-d H:i:s |
| 5 | end_time | 结束时间 | string | — | 必填 | 结束时间,格式:Y-m-d H:i:s |
| 6 | platform_code | 平台code | array<any> | — | 可选 | 平台code |
| 7 | sales_type | 退货类型 | integer | — | 可选 | 退货类型:1 买家退货,2 物流商退货 |
| 8 | status | 订单状态 | array<any> | — | 可选 | 订单状态: -1 异常 1 待提交 2 待审批 3 待收货 4 已作废 5 已完成 6 导入中 |
| 9 | store_id | 店铺id | array<any> | — | 可选 | 店铺id |
| 10 | wid | 系统仓库id | array<any> | — | 可选 | 系统仓库id |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0 成功 |
| 2 | message | 操作成功 | string | 操作成功 | 必填 | 操作成功 |
| 3 | request_id | 请求链路id | string | 052e20647c9c4622adb7576ae335211d.1687946868074 | 必填 | 请求链路id |
| 4 | response_time | 响应时间 | string | 2023-06-28 18:07:50 | 必填 | 响应时间 |
| 5 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 5.1 | total | 总条数 | integer | 41 | 必填 | 总条数 |
| 5.2 | list | 详细列表 | array<object> | — | 必填 | 详细列表 |
| 5.2.1 | complete_time | 完成时间 | string | 2023-06-05 16:25:08 | 必填 | 完成时间 |
| 5.2.2 | global_order_no | 系统单号 | integer | 103280851812762110 | 必填 | 系统单号 |
| 5.2.3 | gmt_create | 创建时间 | string | 2023-06-05 16:25:08 | 必填 | 创建时间 |
| 5.2.4 | gmt_modified | 更新时间 | string | 2023-06-05 16:25:08 | 必填 | 更新时间 |
| 5.2.5 | has_prediction | 是否三方仓预报 0 否 1 是 | integer | 0 | 必填 | 是否三方仓预报 0 否 1 是 |
| 5.2.6 | logistics_provider_name | 物流商 | string | xx物流 | 必填 | 物流商 |
| 5.2.7 | platform | 平台 | string | walmart | 必填 | 平台 |
| 5.2.8 | pre_arrival_time | 预计到货时间 | string | 2023-06-05 16:25:08 | 必填 | 预计到货时间 |
| 5.2.9 | reason | 退货原因 | string | 不给换 | 必填 | 退货原因 |
| 5.2.10 | remark | 备注 | string | xxxx备注 | 必填 | 备注 |
| 5.2.11 | rma_order_no | 退货单号 | string | RT901320516537774080 | 必填 | 退货单号 |
| 5.2.12 | sales_type | 退货类型 | string | 买家退货 | 必填 | 退货类型 |
| 5.2.13 | site | 站点 | string | 美国 | 必填 | 站点 |
| 5.2.14 | status | 订单状态 | string | 待收货 | 必填 | 订单状态 |
| 5.2.15 | store_id | 多平台店铺id | integer | 110000000017008000 | 必填 | 多平台店铺id |
| 5.2.16 | sid | 亚马逊店铺id | integer | 17 | 必填 | 亚马逊店铺id |
| 5.2.17 | store_name | 店铺名称 | string | xxx店铺 | 必填 | 店铺名称 |
| 5.2.18 | tracking_no | 跟踪号 | string | 212 | 必填 | 跟踪号 |
| 5.2.19 | uid_name | 创建人名称 | string | 张三 | 必填 | 创建人名称 |
| 5.2.20 | sys_wid | 退货仓库id | integer | 11 | 必填 | 退货仓库id |
| 5.2.21 | w_name | 退货仓库名称 | string | 仓库11 | 必填 | 退货仓库名称 |
| 5.2.22 | relation_order_info | 关联单据 | object | — | 必填 | 关联单据 |
| 5.2.22.1 | global_order_no | 系统单号 | integer | 103296739036561920 | 必填 | 系统单号 |
| 5.2.22.2 | storage_in_order_no | 入库单号 | string | IB230520001 | 必填 | 入库单号 |
| 5.2.23 | items | 商品信息 | array<object> | — | 必填 | 商品信息 |
| 5.2.23.1 | available_quantity | 可用量 | integer | 1 | 必填 | 可用量 |
| 5.2.23.2 | defective_quantity | 次品量 | integer | 1 | 必填 | 次品量 |
| 5.2.23.3 | destroyed_quantity | 销毁量 | integer | 1 | 必填 | 销毁量 |
| 5.2.23.4 | quantity | 数量 | integer | 1 | 必填 | 数量 |
| 5.2.23.5 | receiving_quantity | 收货数量 | integer | 1 | 必填 | 收货数量 |
| 5.2.23.6 | return_quantity | 退货数量 | integer | 1 | 必填 | 退货数量 |
| 5.2.23.7 | handler_type | 处理方式 | string | 默认不处理 | 必填 | 处理方式: 默认不处理 重新上架 由WMS决定 暂存区 次品 销毁 |
| 5.2.23.8 | pic_infos | 售后图片信息 | array<object> | — | 必填 | 售后图片信息 |
| 5.2.23.8.1 | access_url | 访问地址 | string | https://xxx/xxx | 必填 | 访问地址 |
| 5.2.23.8.2 | file_name | 图片名 | string | file | 必填 | 图片名 |
| 5.2.23.9 | remark | 售后说明 | string | 实例xxxx | 必填 | 售后说明 |
| 5.2.23.10 | platform_order_no | 平台单号 | string | ama-test0330-ZEjHkL | 必填 | 平台单号 |
| 5.2.23.11 | msku | msku | string | HOLDER001 | 必填 | msku |
| 5.2.23.12 | sku | 本地产品sku | string | danpin2 | 必填 | 本地产品sku |
| 5.2.23.13 | product_name | 品名 | string | 单品2 | 必填 | 品名 |
| 5.2.23.14 | id | id | integer | id | 必填 | id |
| 5.2.23.15 | defective_whb_code | 次品仓位编码 | string | — | 必填 | 次品仓位编码 |
| 5.2.23.16 | available_whb_code | 可用仓位编码 | string | — | 必填 | 可用仓位编码 |
领星ERP的接口:查询销售退货单列表(/pb/mp/returns/v2/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。