退货订单状态变更事件
更新时间: 2025-09-01 19:08:23 访问次数:1443
事件名称:EVENT_OMS_RMA_STATUS_CHANGE
事件说明:退货订单状态变更时,触发事件。订单状态有:已下单、已抓单、已揽收、已收件、客户待处理、仓库处理中、已完成、已取消、已作废
字段说明
请求
| 名称 | 类型 | 必填 | 字段 | 说明 |
|---|---|---|---|---|
| uuid | String(30) | Y | 记录唯一ID | |
| orderNo | String | Y | WINIT退货订单号 | |
| sellerOrderNo | String | N | 客户订单号 | 非WINIT出库:下单时填写的客户订单号 WINIT出库取原出库单对应客户订单号 |
| outboundOrderNo | String | Y | WINIT出库订单号 | |
| rmaNo | String | Y | RMA号 | RMA退货单的唯一ID |
| returnType | String | Y | 退货类型 DF :派送失败 【供应商妥投失败】 NO_RMA :无RMA退货 【买家退回到仓,客户未创建预报单】 RMA:有RMA退货 【客户创建预报单】 |
|
| status | String | Y | 状态 OD:已下单 LC:已抓单 PC:已揽收 RE:已收件 WP:客户待处理 HI:仓库处理中 OC:已完成 CD:已取消 VO:已作废 |
|
| statusTime | DateTime | Y | 状态时间(时间戳) | 时间戳 |
| isReturnLabel | String | Y | 是否ReturnLabel订单 Y-是,N-否 |
|
| expressNo | String | Y | 退货运单号 仓库扫描的实际跟踪号 |
|
| customerExpressNo | String | Y | 客户退货运单号 当非returnLabel退货时,表示客户下单时录入的跟踪号。 当returnLabel退货时,表示系统生成的跟踪号。 |
|
| returnReason | String | Y | 退货原因 DF:派送失败 BR:客户退货 |
|
| warehouseCode | String | Y | 退货仓库 | |
| estimateSkuList | String | Y | 下单商品明细 | **** |
| – merchandiseSerno | String | Y | 商品条码 | |
| – merchandiseCode | String | Y | 商品编码 | |
| – specification | String | Y | 规格 | |
| – skuCodeThird | String | N | 第三方编码 | |
| – merchandiseGrade | String | Y | 商品等级 GOOD:良品 DEFECTIVE:不良品 |
|
| – originalMerchandiseCode | String | N | 原商品编码 | |
| – ownerCode | String | Y | 货主编码 | |
| – managementType | String | Y | 商品管理方式 SI:单品管理 SKU:商品管理 |
|
| – handleMethod | String | Y | 处理方式 SA:直接上架 NS:新品拍照上架 DE:销毁 |
|
| – quantity | Integer | Y | 数量 | |
| – length | BigDecimal | Y | 长(CM) | |
| – width | BigDecimal | Y | 宽(CM) | |
| – height | BigDecimal | Y | 高(CM) | |
| – volume | BigDecimal | Y | 体积(CBM) | |
| – weight | BigDecimal | Y | 重量(KG) | |
| – itemList | Array | N | 单品条码集合 | |
| – – itemSerno | String | N | 单品条码 | |
| actualSkuList | String | Y | 实际上架商品明细 | **** |
| – merchandiseSerno | String | Y | 商品条码 | |
| – merchandiseCode | String | Y | 商品编码 | |
| – specification | String | Y | 规格 | |
| – skuCodeThird | String | N | 第三方编码 | |
| – merchandiseGrade | String | Y | 商品等级(良品/不良品) GOOD:良品 DEFECTIVE:不良品 |
|
| – originalMerchandiseCode | String | N | 原商品编码 | |
| – ownerCode | String | Y | 货主编码 | |
| – managementType | String | Y | 商品管理方式 SI:单品管理 SK:商品管理 |
|
| – handleMethod | String | Y | 退货策略: SA:直接上架 NS:新品拍照上架 DE:销毁 兼容历史对接,后续弃用:GOOD_SA:良品上架,DEFECTIVE_SA:不良品上架 |
|
| – shelveMethod | String | 0 | 处理方式: GOOD_SA:良品上架 DEFECTIVE_SA:不良品上架 DE:销毁 |
|
| – quantity | Integer | Y | 数量 | |
| – length | BigDecimal | Y | 长(CM) | |
| – width | BigDecimal | Y | 宽(CM) | |
| – height | BigDecimal | Y | 高(CM) | |
| – volume | BigDecimal | Y | 体积(CBM) | |
| – weight | BigDecimal | Y | 重量(KG) | |
| – itemList | Array | N | 单品条码集合 | |
| – – itemSerno | String | N | 单品条码 |
返回
注:返回success即可,无需加引号逗号等其他信息
| 名称 | 类型 | 字段 | 说明 |
|---|---|---|---|
| success | String(7) | 接收成功 | 消息接收成功 |
| fail | String(4) | 接收失败 | 消息接收失败 |
示例
解密后报文示例
[{"uuid": "bd5b028b-369d-494f-bf73-58514ca80a08","orderNo": "W010001","status": "OC","statusTime": 1660118978433,"warehouseCode": "US0001","isReturnLabel": "Y","expressNo": "1112121","customerExpressNo": "1121212","rmaNo": "12121212","outboundOrderNo": "WO001010","destroyOutboundOrderNo": "WO001010","returnReason": "DF","estimateSkuList": [{"merchandiseSerno": "M0001","merchandiseCode": "auto0001","merchandiseGrade": "GOOD","originalMerchandiseCode": "auto0002","ownerCode": "99991","managementType": "SI","handleMethod": "SA","quantity": "1","length": "10","width": "7","height": "6","volume": "0.06","weight": "0.5","itemList": [{"itemSerno": "S0001001"}]}],"actualSkuList": [{"merchandiseSerno": "M0001","merchandiseCode": "auto0001","merchandiseGrade": "GOOD","originalMerchandiseCode": "auto0002","ownerCode": "99991","managementType": "SI","handleMethod": "SA","quantity": "1","length": "10","width": "7","height": "6","volume": "0.06","weight": "0.5","itemList": [{"itemSerno": "S0001001"}]}]}]
开发者返回的示例
success
#
