查询退货订单
更新时间: 2021-10-18 21:17:15 访问次数:8880
接口说明
卖家或第三方平台通过该接口可查询卖家退货订单信息,返回符合查询条件下的退货订单信息列表。方便得到退货商品、数量等用于后继二次售卖出库。退货订单包含了:
1. RMA退货订单
2. 无RMA退货订单
3. 出库派送失败订单
接口名称
rma.returnGoodsOrder.queryReturnOderList
请求说明
请求内容 | 说明 |
---|---|
URL | https://openapi.winit.com.cn/openapi/service |
接口测试 | https://sandboxopenapi.winit.com.cn/openapi/service |
验证方法 | Token,md5 |
格式 | json |
字符编码 | UTF-8 |
http请求方式 | http |
请求数限制 | 默认每分钟1000,1000有需要可申请加大。 |
请求入参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
returnGoodsOrderNo | String(32) | N | WINIT订单号-退货 | RT16000013812852CN |
expressNo | String(32) | N | 退货运单号 仓库收到退货包裹扫描的运单号 (1)RMA退货:卖家填写的客户退货运单号 (2)无RMA退货:买家退货包裹的退货运单号 (3)派送失败:原出库单的运单号/某些供应商(DPD)的更换的退货运单号 |
|
outboundOrderNo | String(32) | N | 出库订单号 | |
customerOrderNo | String(32) | N | 客户订单号 | |
destroyOutboundOrder | String(32) | N | 销毁出库单号 | |
rmaNo | String(32) | N | RMA | |
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 | Object | Y | 分页参数 | |
–|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"
}
返回出参
返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。
名称 | 类型 | 必传 | 说明 | 示例 |
---|---|---|---|---|
pageParams | Object | Y | 分页信息 | |
pageNo | Integer | Y | 当前页 | |
pageSize | Integer | Y | 分页大小 | |
totalCount | Integer | Y | 总记录数 | |
list | Array | Y | 订单列表 | |
returnGoodsOrderNo | String | Y | WINIT订单号-退货 | |
expressNo | String | Y | 退货运单号 仓库扫描的跟踪号 |
|
customerExpressNo | String | Y | 客户退货运单号 卖家下RMA的跟踪号(未扫描) |
|
outboundOrderNo | String | Y | 出库订单号 | |
sellerOrderNo | String | Y | 卖家订单号 | |
destroyOutboundOrder | String | Y | 销毁出库单号 | |
qtyItemNum | Number | Y | 单品数量 | |
rmaNo | String | Y | RMA | |
isReturnLabel | String | Y | 是否ReturnLabel | |
retrunReason | String | Y | 退货原因 DF:派送失败 BR:客户退货 |
|
status | String | Y | 状态 PD:草稿 OD:已下单 LC:已抓单 RE:已收件 WP:待处理 OC:已完成 DT:已销毁 CD:已取消 |
|
warehouseCode | String | Y | 退货仓库 | |
buyername | String | Y | 买家 | |
createDate | String | Y | 创建时间(YYYY-MM-DD HH:MM:SS) | |
orderGoodsList | Array | Y | 下单商品明细 | |
merchandiseCode | String | Y | 商品编码 | |
merchandiseSerno | String | Y | 商品条码 | |
specification | String | Y | 规格 | |
originalMerchandiseCode | String | Y | 原商品编码 | |
itemSerno | String | Y | 单品条码 | |
ownerCode | String | Y | 货主编码 | |
skuCodeThird | String | Y | 第三方编码 | |
confirmQty | Integer | Y | 数量 | |
merchandiseGrade | String | Y | 商品等级(良品/不良品) GOOD:良品 DEFECTIVE:不良品 |
|
nameCn | String | Y | 中文名称 | |
nameEn | String | Y | 英文名称 | |
confirmWidth | BigDecimal | Y | 核实宽 | |
confirmLength | BigDecimal | Y | 核实长 | |
confirmHeight | BigDecimal | Y | 核实高 | |
confirmVolume | BigDecimal | Y | 核实体积 | |
confirmWeight | BigDecimal | Y | 核实重量 | |
managementType | String | Y | 商品管理方式 SI-单品管理 SKU-商品管理 |
|
handleMethod | String | Y | 处理方式 SA-直接上架 NS-新品拍照上架 DE-销毁 |
|
shelveGoodsList | Array | Y | 上架商品明细 |
返回示例
{
"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"
}
]
}
}