API
创建退货订单
更新时间: 2021-09-28 01:01:53 访问次数:6149
接口说明
通过该接口可创建退货订单,得到退货订单号。
1.RMA退货:买家提出退货时,卖家或第三方平台创建退货订,提交退货运单号、退货目的仓、退货商品的sku和数量等信息,万邑通返回退货订单号。
2.无RMA退货,卖家可参考快速退货的操作流程进行。
请求说明
URL | https://openapi.winit.com.cn/openapi/service |
接口测试 | https://sandboxopenapi.winit.com.cn/openapi/service |
接口名 | rma.returnGoodsOrder.createReturnGoodsOrder |
验证方法 | Token,md5 |
格式 | json |
字符编码 | UTF-8 |
http请求方式 | http |
请求数限制 | 默认每分钟1000,有需要可申请加大。 |
请求入参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
expressNo |
String() | N | 买家退货运单号 |
|
outboundOrderNo |
String() | Y | 出库单号 | |
customerOrderNo |
String() | N | 客户订单号 |
|
warehouseCode |
String() | Y | 退货目的仓库 |
|
VATNo | String() | N | 退货到英国时需要填写 | |
ReturnGoodsList | Array | 退货商品列表 | ||
-|productCode | String() | Y | 商品编码,sku | |
-|productNum | Number | Y | 商品数量 | |
-|specification | String() | N | 规格 | |
-|handleMethod | String() | Y | 批处理方式 SA:直接上架 NS:新品拍照上架 DE:销毁 | |
-|itemCodeList | Array | 退货单品条码列表 | ||
-|-|itemCode | String() | N | 退货单品条码 | |
-|-|handleMethod | N | 处理方式 SA:直接上架 NS:新品拍照上架 DE:销毁 | ||
winitProductCode |
N | 退货渠道PSC 特殊客户入参,一般不入参 |
||
ownerCode |
N | 退货货主编码 特殊客户入参,一般不入参 |
||
userInfoSource |
O | 发件人地址来源
ORI: 使用出库单的收件人信息 IRI: 录入退货人信息 |
||
name |
Y | 退货人名字
UserInfoSource为IRI时必填 |
||
email |
N | 退货人Email
UserInfoSource为IRI时必填 |
||
phone |
N | 退货人电话
UserInfoSource为IRI时必填 |
||
country |
Y | 退货人国家 UserInfoSource为IRI时必填 |
||
state |
N | 退货人州省
UserInfoSource为IRI时必填 |
||
city |
Y | 退货人城市
UserInfoSource为IRI时必填 |
||
postcode |
Y | 退货人邮编
UserInfoSource为IRI时必填 |
||
houseNo |
Y | 退货人门牌号
UserInfoSource为IRI时必填 |
||
address1 |
Y | 退货人地址
UserInfoSource为IRI时必填 |
||
address2 |
N | 退货人地址2
UserInfoSource为IRI时必填 |
请求示例
{ "action":" rma.returnGoodsOrder.createReturnGoodsOrder", "app_key":"rebecca", "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "client_sign":"4C84981DF6E4E012479FC6675DD3BFAF", "data":{ "expressNo":"1Z31AE0830987653983", "outboundOrderNo":"WO0000003291", "customerOrderNo":"", "warehouseCode":"US0001", "ReturnGoodsList":[ { "productCode":"auto_sku22", "itemCodeList":[ { "itemCode":"S500006000146276977", "handleMethod":"SA" } ], "productNum":"1", "specification":"", "handleMethod":"NS" } ] }, "format":"json", "language":"zh_CN", "platform":"OWNERERP", "sign":"2C2AFDD6807AC7635A0018A13F10A2C7", "sign_method":"md5", "timestamp":"2015-06-16 001926", "version":"1.0" }
返回出参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
returnGoodsOrderNo |
String() | Y | WINIT订单号-退货订单号 |
|
rmaNo |
String() |
Y | RMA号 | |
returnAddress |
String() |
Y | 退货地址 |
返回示例
下单成功示例 { "code": "0", "msg": "操作成功", "data": { "returnAddress": "Winit AU Trade Pty Ltd. Block A2, 391 Park Road #38977601 Regents Park New South Wales 2143 AU ", "rmaNo": "9742208", "returnGoodsOrderNo": "RT16000000000211CN" } }
错误code
下单失败示例 { "code": "02050240094", "msg": "当前出库订单[WO0969339140]已生成退货订单,可退货商品数量不足", "data": "" } { "code": "02050240099", "msg": "若填写单品列表,列表内单品数量须等于退货数量", "data": "" } { "code": "02050240097", "msg": "出库单号:[WO1033768582]状态不支持作废", "data": "" } { "code": "02050240098", "msg": "存在已退货单品,创建退货订单失败", "data": "" } { "code": "02050240124", "msg": "商品编码不存在", "data": "" } { "code": "02010250344", "msg": "退货单品的处理方式不能为空", "data": "" }