入库订单和包裹状态变更事件
更新时间: 2024-11-15 16:07:26 访问次数:1276
事件名称:EVENT_OMS_INBOUND_STATUS_CHANGE
事件说明:海外仓入库订单状态、入库包裹状态、以及预约状态变更时,推送给当前应用
- 订单状态有:已收货、已验货、运输中、部分到仓、已到仓、已上架、终止
- 包裹状态有:丢失、终止、已卸货、上架完成、上架异常区
- 预约状态有:
- Winit承运,入库单状态变更为已下单
- 卖家直发无需预约,入库单状态变更为已下单
- 卖家直发需要预约:当入库单验货类型=客户自验货,入库单状态变更为已下单、验货完成、运输中 或 预约单状态变更为待预约、待审批、预约成功、已到仓、已取消;当入库单验货类型=海外验,入库单状态变更为已下单、运输中 或 预约单状态变更为待预约、待审批、预约成功、已到仓、已取消
字段说明
请求
名称 | 类型 | 必填 | 字段 | 说明 |
---|---|---|---|---|
uuid | String(30) | Y | 记录唯一ID | |
type | String(30) | Y | 变更类型 | 订单状态变更:ORDER_STATUS_CHANGE 包裹状态变更:PACKAGE_STATUS_CHANGE 预约状态变更:BOOKING_STATUS_CHANGE” |
orderNo | String(128) | Y | 入库单号 | |
sellerOrderNo | String(128) | O | 客户订单号 | |
warehouseCode | String(128) | Y | 上架仓库编码 | |
warehouseCode | String(128) | Y | 仓库编码 | |
orderStatusChangeInfo | Object | O | 订单状态变更信息 | 当变更类型为ORDER_STATUS_CHANGE时,有值。 |
– status | String(20) | Y | 订单状态 | RE:已收货 IC:已验货 TS:运输中 PEWC:部分到仓 EWC:已到仓 SHD:已上架 STOP:终止 |
– statusTime | DateTime | Y | 状态时间 | 时间戳 |
packageStatusChangeInfo | Object | O | 包裹状态变更信息。 | 当变更类型为ORDER_STATUS_CHANGE时,有值。 |
– packageSerno | String(25) | Y | 包裹条码 | |
– sellerCaseNo | String(20) | Y | 卖家箱号(自定义箱号) | |
– thirdPartyCaseNo | String(128) | N | 自定义包裹编号(第三方箱号) | 注意:贴在实物包裹上的非Winit箱号,需全局唯一性,保证海外仓可扫描识别。 |
– trackingNo | String(128) | N | 快递单号 | |
– status | String(30) | Y | 包裹状态 | UD:已卸货 STOP:终止 LOST:丢失 SCP:已上架 SAA:上架异常区 PS:部分上架 |
– statusTime | Date | Y | 状态时间 | 时间戳 |
– details | Array | Y | 包裹明细列表 | |
– – merchandiseSerno | String(30) | Y | 商品条码 | WINIT商品唯一标识M码 |
– – merchandiseCode | String100) | Y | Winit商品编码 | |
– – specification | String100) | N | 规格 | |
– – skuType | String(30) | Y | SKU类型 | BOX:箱商品 SUITE:套装商品 SINGILE:单一商品 |
– – standardPartsQty | Integer | Y | 标准件数 | |
– – shelveQuantity | Integer | Y | 上架数量 | 库存单元数(个\套\箱) |
– – shelveItemQty | Integer | Y | 上架总SI数 | 即该SKU单一商品的上架单品数量,数量等于标准件数*上架数量 |
– – inventoryClassificationInfo | List | N | 分类库存信息 | 若商品有下述分类库存信息,则会回传。 |
– – – quality | String | N | 商品品质 | GOOD:良品 DEFECTIVE:不良品 |
– – – batchType | String | N | 批次管理类型 | SHELF_LIFE_MANAGEMENT:保质期管理 PRODUCTION_BATCH_MANAGEMENT:生产批次管理, INBOUND_BATCH_MANAGEMENT:入库批次管理 |
– – – batchAttrType | String | N | 批次属性类型 | PD:生产日期 ID:入库日期 PDPB:生产日期+包装批号 ED:失效日期 EDPB:失效日期+产品批次号 |
– – – batchDate | String | N | 批次日期 | |
– – – productionBatch | String | N | 产品批次号 | |
– – – winitBatchNo | String | N | Winit批次号 | |
– – – barcodeValue | String | N | 条码值 | |
– – – qty | String | N | 该类库存上架数量 | 库存单元数(个\套\箱) |
– – – itemQty | String | N | 该类库存上架总SI数 | 即该SKU此类单一商品的上架单品数量,数量等于标准件数*上架数量 |
bookingStatusChangeInfo | Object | O | 订单预约状态变更 | 当变更类型为BOOKING_STATUS_CHANGE时,有值。 |
– status | String | Y | 预约状态 | UN_BOOKING 无需预约 NOT_ARRIVE_BOOKING_NODE 未到预约节点 WAIT_CREATE_BOOKING_ORDER 待创建预约单 WAIT_BOOKING_SEND_WAREHOUSE 待预约送仓 BOOKING 已预约 ARRIVED_WAREHOUSE 已到仓 NOT_BOOKING_ARRIVED_WAREHOUSE 未预约到仓 |
– changeDate | String | N | 预约状态变更时间 | 时间戳 |
– bookingNo | String | N | 预约单号 | |
– bookingCode | String | N | 预约码 | |
– warehouseCode | String | N | 预约仓库 | |
– deliveryWayType | String | N | 预约送仓方式 | FCL:整柜 LCL:散货 |
– bookingSendWarehouseDate | String | N | 预约送仓时间 |
返回
注:返回success即可,无需加引号逗号等其他信息
名称 | 类型 | 字段 | 说明 |
---|---|---|---|
success | String(7) | 接收成功 | 消息接收成功 |
fail | String(4) | 接收失败 | 消息接收失败 |
示例
解密后报文示例
订单状态变更
[
{
"uuid": "bd5b028b-369d-494f-bf73-58514ca80a08",
"type": "ORDER_STATUS_CHANGE",
"orderNo": "W010001",
"orderStatusChangeInfo": {
"status": "SHD",
"statusTime": 1660118978433
}
}
]
包裹状态变更
[
{
"uuid": "bd5b028b-369d-494f-bf73-58514ca80a08",
"type": "PACKAGE_STATUS_CHANGE",
"orderNo": "W010001",
"warehouseCode": "US0001",
"packageStatusChangeInfo": {
"packageSerno": "B00001",
"caseNo": "A001",
"thirdPartyCaseNo": "XT0010101",
"trackingNo": "E0010101",
"status": "SCP",
"statusTime": 1660118978433,
"details": [
{
"merchandiseSerno": "M01010001",
"merchandiseCode": "1000019",
"specification": "01",
"skuType": "BOX",
"standardPartsQty": 10,
"shelveQuantity" : 1,
"shelveItemQty" : 10,
"itemInfoList":[
{
"itemSerno":"S000000001", //有分类库存信息时
"qty":"1",
"batchType":"INBOUND_BATCH_MANAGEMENT",
"batchAttrType":"ID",
"productionBatch":"201307180001",
"batchDate":"2023-07-01",
"winitBatchNo":"ad5c028b",
"barcodeValue":"THD001",
"quality":"GOOD"
},
{
"itemSerno":"S000000002", //没有有分类库存信息时
}
],
"inventoryClassificationInfo":[
{ "qty":"1",
"itemQty":"10",
"batchType":"INBOUND_BATCH_MANAGEMENT",
"batchAttrType":"ID",
"productionBatch":"201307180001",
"batchDate":"2023-07-01",
"winitBatchNo":"ad5c028b",
"barcodeValue":"THD001",
"quality":"GOOD"
}
]
}
]
}
}
]
预约状态变更
[
{
"uuid": "bd5b028b-369d-494f-bf73-58514ca80a08",
"type": "BOOKING_STATUS_CHANGE",
"orderNo": "W010001",
"warehouseCode": "US0001",
"bookingStatusChangeInfo":{
"status":"BOOKING",
"bookingNo":"Y00001",
"bookingCode":"Q0B0C0J6L7M8",
"warehouseCode":"US0001",
"changeDate":1726205280333,
"deliveryWayType":"LCL",
"bookingSendWarehouseDate":"2024-09-09 9:00-10:00"
}
}
]
开发者返回的示例
success