API
查询退货订单
更新时间: 2021-10-18 21:17:15 访问次数:9082

接口说明

卖家或第三方平台通过该接口可查询卖家退货订单信息,返回符合查询条件下的退货订单信息列表。方便得到退货商品、数量等用于后继二次售卖出库。退货订单包含了:
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

请求示例

  1. {
  2. "action": "rma.returnGoodsOrder.queryReturnOderList",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "DBA1848FA4DC3556EFA7553164AAEEB3",
  6. "data": {
  7. "returnGoodsOrderNo": "RT16000000000378CN",
  8. "expressNo": "",
  9. "outboundOrderNo": "",
  10. "rmaNo": "",
  11. "customerOrderNo": "",
  12. "destroyOutboundOrder": "",
  13. "originCode": "",
  14. "warehouseCode": "",
  15. "OderStartDatetime": "2019-11-08",
  16. "OderEndDatetime": "2019-11-20",
  17. "pageParams": {
  18. "pageSize": 20,
  19. "pageNo": 1
  20. }
  21. },
  22. "format": "json",
  23. "language": "zh_CN",
  24. "platform": "OWNERERP",
  25. "sign": "FB5A7291147134A0BBB29E6C24123F91",
  26. "sign_method": "md5",
  27. "timestamp": "2015-06-16 001926",
  28. "version": "1.0"
  29. }

返回出参

返回参数说明:正确的返回编码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 上架商品明细

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "pageParams": {
  6. "pageNo": 1,
  7. "pageSize": 20,
  8. "totalCount": 1
  9. },
  10. "list": [
  11. {
  12. "outboundOrderNo": "WO0000005033",
  13. "orderGoodsList": [
  14. {
  15. "originalMerchandiseSerno": null,
  16. "merchandiseGrade": null,
  17. "confirmQty": 1,
  18. "skuCodeThird": null,
  19. "merchandiseSerno": "M010000000001674549",
  20. "ownerCode": null,
  21. "specification": "",
  22. "nameCn": "cnName_auto_sku22",
  23. "confirmWidth": 10.00,
  24. "nameEn": "enName_auto_sku22",
  25. "confirmLength": 15.00,
  26. "managementType": "SI",
  27. "confirmHeight": 3.00,
  28. "confirmVolume": 0.000450000,
  29. "handleMethod": "SA",
  30. "confirmWeight": 0.0250,
  31. "inventoryAttribute": [],
  32. "merchandiseCode": "auto_sku22",
  33. "itemSerno": "S500065000146276998",
  34. "originalMerchandiseCode": null
  35. }
  36. ],
  37. "sellerOrderNo": "",
  38. "expressNo": "1Z68223Y0308993435",
  39. "mdImageList": null,
  40. "customerExpressNo": "1Z68223Y0308993435",
  41. "qtyItemNum": 1,
  42. "buyerName": "shane bellingham",
  43. "warehouseCode": "US0001",
  44. "returnGoodsOrderNo": "RT16000000000378CN",
  45. "destroyOutboundOrder": null,
  46. "retrunReason": "BR",
  47. "originCode": "OR",
  48. "rmaNo": "9747237",
  49. "status": "CD",
  50. "createDate": "2019-11-18 12:24:01"
  51. }
  52. ]
  53. }
  54. }