万邑通开发者网站 - 查询退货订单

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

请求示例

Json
XML

{
    "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		原商品编码

返回示例

Json
XML

{
    "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"
            }
        ]
    }
}

关键词

查询退货订单列表
rma.returnGoodsOrder.queryReturnOderList