API
查询退货订单
更新时间: 2021-10-18 21:17:15 访问次数:6226
接口说明
卖家或第三方平台通过该接口可查询卖家退货订单信息,返回符合查询条件下的退货订单信息列表。方便得到退货商品、数量等用于后继二次售卖出库。退货订单包含了:
(1)RMA退货订单
(2)无RMA退货订单
(3)出库派送失败订单
请求说明
URL | https://openapi.winit.com.cn/openapi/service |
接口测试 | https://sandboxopenapi.winit.com.cn/openapi/service |
接口名 | rma.returnGoodsOrder.queryReturnOderList |
验证方法 | Token,md5 |
格式 | json |
字符编码 | UTF-8 |
http请求方式 | http |
请求数限制 | 默认每分钟1000,有需要可申请加大。 |
请求入参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
returnGoodsOrderNo |
String(32) | N | WINIT订单号-退货 |
RT16000013812852CN |
expressNo |
String(32) | N | 退货运单号
仓库收到退货包裹扫描的运单号 (1)RMA退货:卖家填写的客户退货运单号 (2)无RMA退货:买家退货包裹的退货运单号 (3)派送失败:原出库单的运单号/某些供应商(DPD)的更换的退货运单号 |
|
outboundOrderNo | String(32) | N | 出库订单号 | |
rmaNo |
String(32) | N | RMA | |
customerOrderNo | String(32) | N | 客户订单号 |
|
destroyOutboundOrder |
String(32) |
N | 销毁出库单号 |
|
originCode |
String(32) |
N |
创建分类
NR-仓库创建 OR-出库单启动退货 |
|
warehouseCode |
String() |
N |
退货仓库 |
|
OderStartDatetime |
Date(10) | Y | 退货订单创建时间(From) |
2018-06-8 |
OderEndDatetime |
Date(10) | Y | 退货订单创建时间(To) |
2018-06-8 |
pageParams |
分页参数 |
|||
pageSize | Integer(11) | Y | 每页显示数量,最大值200 | |
pageNo | Integer(11) | Y | 页码,默认1 |
请求示例
{ "action": "rma.returnGoodsOrder.queryReturnOderList", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "client_sign": "DBA1848FA4DC3556EFA7553164AAEEB3", "data": { "returnGoodsOrderNo": "RT16000000000378CN", "expressNo": "", "outboundOrderNo": "", "rmaNo": "", "customerOrderNo": "", "destroyOutboundOrder": "", "originCode": "", "warehouseCode": "", "OderStartDatetime": "2019-11-08", "OderEndDatetime": "2019-11-20", "pageParams": { "pageSize": 20, "pageNo": 1 } }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "FB5A7291147134A0BBB29E6C24123F91", "sign_method": "md5", "timestamp": "2015-06-16 001926", "version": "1.0" }
返回出参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
pageParams | 分页信息 | |||
pageNo | Integer | Y | 当前页 | |
pageSize | Integer | Y | 分页大小 | |
totalCount | Integer | Y | 总记录数 | |
list | ||||
returnGoodsOrderNo | String | Y | WINIT订单号-退货 | |
expressNo | String | Y | 退货运单号
仓库扫描的跟踪号 | |
customerExpressNo | String | Y | 客户退货运单号 卖家下RMA的跟踪号(未扫描) | |
originCode | String | Y | 来源 | |
qtyItemNum | Number | Y | 单品数量 |
|
rmaNo | String | Y | RMA | |
outboundOrderNo | String | Y | 出库订单号 |
|
sellerOrderNo | String | Y | 卖家订单号 | |
destroyOutboundOrder | String | Y | 销毁出库单号 |
|
buyername | String | Y | 买家 |
|
retrunReason | String |
Y | 退货原因 DF:派送失败 BR:客户退货 |
|
warehouseCode | String |
Y | 退货仓库 |
|
createDate | String |
Y | 创建时间(YYYY-MM-DD HH:MM:SS) |
|
status | String |
Y | 状态
草稿-PD 已下单-OD 已收件-RE 待处理-WP 已完成-OC 已销毁-DT 已取消-CD |
|
orderGoodsList | String |
Y | 下单商品明细 | |
shelveGoodsList | String |
Y | 上架商品明细 | |
merchandiseGrade | String |
Y | 商品等级(良品/不良品)
GOOD:良品 DEFECTIVE:不良品 |
|
confirmQty | Integer |
Y | 数量 | |
skuCodeThird | String |
Y | 第三方编码 | |
merchandiseSerno | String |
Y | 商品条码 | |
ownerCode | String |
Y | 货主编码 | |
specification | String |
Y | 规格 | |
nameCn | String |
Y | 中文名称 | |
nameEn | String |
Y | 英文名称 | |
confirmWidth | BigDecimal |
核实宽 | ||
confirmLength | BigDecimal |
核实长 | ||
confirmHeight | BigDecimal |
核实高 | ||
confirmVolume | BigDecimal |
核实体积 | ||
confirmWeight | BigDecimal |
核实重量 | ||
managementType | String |
商品管理方式
SI-单品管理 SKU-商品管理 |
||
handleMethod | String |
处理方式
SA-直接上架 NS-新品拍照上架 DE-销毁 |
||
merchandiseCode | String |
商品编码 | ||
itemSerno | String |
单品条码 | ||
originalMerchandiseCode | String |
原商品编码 |
返回示例
{ "code": "0", "msg": "操作成功", "data": { "pageParams": { "pageNo": 1, "pageSize": 20, "totalCount": 1 }, "list": [ { "outboundOrderNo": "WO0000005033", "orderGoodsList": [ { "originalMerchandiseSerno": null, "merchandiseGrade": null, "confirmQty": 1, "skuCodeThird": null, "merchandiseSerno": "M010000000001674549", "ownerCode": null, "specification": "", "nameCn": "cnName_auto_sku22", "confirmWidth": 10.00, "nameEn": "enName_auto_sku22", "confirmLength": 15.00, "managementType": "SI", "confirmHeight": 3.00, "confirmVolume": 0.000450000, "handleMethod": "SA", "confirmWeight": 0.0250, "inventoryAttribute": [], "merchandiseCode": "auto_sku22", "itemSerno": "S500065000146276998", "originalMerchandiseCode": null } ], "sellerOrderNo": "", "expressNo": "1Z68223Y0308993435", "mdImageList": null, "customerExpressNo": "1Z68223Y0308993435", "qtyItemNum": 1, "buyerName": "shane bellingham", "warehouseCode": "US0001", "returnGoodsOrderNo": "RT16000000000378CN", "destroyOutboundOrder": null, "retrunReason": "BR", "originCode": "OR", "rmaNo": "9747237", "status": "CD", "createDate": "2019-11-18 12:24:01" } ] } }