API
查询退货订单
更新时间: 2018-07-31 11:10:50 访问次数:1277
接口说明

卖家或第三方平台通过该接口可查询卖家退货订单信息,返回符合查询条件下的退货订单信息列表。

使用场景

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

备注

请求说明
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() N WINIT订单号-退货
RT16000013812852CN
expressNo
String() N 客户退货运单号

outboundOrderNo String() N 出库订单号
rmaNo
String() N RMA
customerOrderNo
String()
N
客户订单号

destroyOutboundOrder
String()
N
销毁出库单号

originCode
String()
N

NR-仓库创建

OR-出库单启动退货

warehouseCode
String()
N
退货仓库

OderStartDatetime
DateY查询退货订单开始时间
2018-06-8
OderEndDatetime
DateY查询退货订单截止时间
2018-06-8
pageParams
Array

分页参数,以下为子节点

-|pageSize Integer Y 每页显示数量,最大值200
-|pageNo Integer Y 页码,默认1
请求示例
{
    "action":"rma.returnGoodsOrder.queryReturnOderList",
    "app_key":"rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"38B87482C92FFEF0F10292B7AFA44087",
    "data":{
        "returnGoodsOrderNo":"RT16000000000374CN",
        "expressNo":"",
        "outboundOrderNo":"WO0887030857",
        "rmaNo":"9490437",
        "customerOrderNo":"252727722489-1495123873517",
        "destroyOutboundOrder":"",
        "originCode":"OR",
        "warehouseCode":"US0001",
        "OderStartDatetime":"2018-06-8",
        "OderEndDatetime":"2018-06-08",
        "pageParams":{
            "pageSize":20,
            "pageNo":1
        }
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"SELLERERP",
    "sign":"00000000000000000000000000000000",
    "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 退货原因
--|warehouseCode String
Y 退货仓库
--|createDate String
Y 创建时间(YYYY-MM-DD HH:MM:SS)
--|status String
Y 状态

草稿-PD

已下单-OD

已收件-RE

待处理-WP

已完成-OC

已销毁-DT

已取消-CD

返回示例
{
    "code":"0",
    "msg":"操作成功",
    "data":{
        "list":[
            {
                "status":"RE",
                "originCode":"OR",
                "rmaNo":"9490437",
                "sellerOrderNo":"252727722489-1495123873517",
                "buyerName":"shane bellingham",
                "warehouseCode":"US0001",
                "retrunReason":"BR",
                "outboundOrderNo":"WO0887030857",
                "expressNo":"",
                "returnGoodsOrderNo":"RT16000000000374CN",
                "createDate":"2018-06-08 15:19:37",
                "qtyItemNum":0,
                "destroyOutboundOrder":null
            }
        ],
        "pageParams":{
            "totalCount":1,
            "pageNo":1,
            "pageSize":20
        }
    }
}