API
查询退货订单
更新时间: 2020-06-29 18:27:54 访问次数:2689
无标题文档
接口说明

卖家或第三方平台通过该接口可查询卖家退货订单信息,返回符合查询条件下的退货订单信息列表。
退货订单包含了:
(1)RMA退货订单
(2)无RMA退货订单
(3)出库派送失败订单

接口英文名称

rma.returnGoodsOrder.queryReturnOderList

使用场景

卖家或第三方平台查询退货订单信息后方便得到退货商品、数量等用于后继二次售卖出库

备注

请求说明
URL http://openapi.winit.com.cn/openapi/service
接口测试 http://openapi.sandbox.winit.com.cn/openapi/service
验证方法 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查询退货订单开始时间
2018-06-8
OderEndDatetime
Date(10) Y 查询退货订单截止时间
2018-06-8
pageParams
Array

分页参数,以下为子节点

-|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 Array Y 分页信息
--|pageNo Integer Y 当前页
--|pageSize Integer Y 分页大小
--|totalCount Integer Y 总记录数
list Array Y
--|returnGoodsOrderNo
String
Y
WINIT订单号-退货

--|expressNo
String
Y
客户退货运单号

--|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,
                        "nameEn": "enName_auto_sku22",
                        "confirmLength": 15,
                        "managementType": "SI",
                        "confirmHeight": 3,
                        "confirmVolume": 0.00045,
                        "handleMethod": "SA",
                        "confirmWeight": 0.025,
                        "merchandiseCode": "auto_sku22",
                        "itemSerno": "S500065000146276998",
                        "originalMerchandiseCode": null
                    }
                ],
                "sellerOrderNo": "",
                "expressNo": "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"
            }
        ]
    }
}