API
入库订单和包裹状态变更事件
更新时间: 2024-11-15 16:07:26 访问次数:1276

事件名称:EVENT_OMS_INBOUND_STATUS_CHANGE

事件说明:海外仓入库订单状态、入库包裹状态、以及预约状态变更时,推送给当前应用

  1. 订单状态有:已收货、已验货、运输中、部分到仓、已到仓、已上架、终止
  2. 包裹状态有:丢失、终止、已卸货、上架完成、上架异常区
  3. 预约状态有:
    1. Winit承运,入库单状态变更为已下单
    2. 卖家直发无需预约,入库单状态变更为已下单
    3. 卖家直发需要预约:当入库单验货类型=客户自验货,入库单状态变更为已下单、验货完成、运输中 或 预约单状态变更为待预约、待审批、预约成功、已到仓、已取消;当入库单验货类型=海外验,入库单状态变更为已下单、运输中 或 预约单状态变更为待预约、待审批、预约成功、已到仓、已取消

字段说明

请求

名称 类型 必填 字段 说明
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) 接收失败 消息接收失败

示例

解密后报文示例

订单状态变更

  1. [
  2. {
  3. "uuid": "bd5b028b-369d-494f-bf73-58514ca80a08",
  4. "type": "ORDER_STATUS_CHANGE",
  5. "orderNo": "W010001",
  6. "orderStatusChangeInfo": {
  7. "status": "SHD",
  8. "statusTime": 1660118978433
  9. }
  10. }
  11. ]

包裹状态变更

  1. [
  2. {
  3. "uuid": "bd5b028b-369d-494f-bf73-58514ca80a08",
  4. "type": "PACKAGE_STATUS_CHANGE",
  5. "orderNo": "W010001",
  6. "warehouseCode": "US0001",
  7. "packageStatusChangeInfo": {
  8. "packageSerno": "B00001",
  9. "caseNo": "A001",
  10. "thirdPartyCaseNo": "XT0010101",
  11. "trackingNo": "E0010101",
  12. "status": "SCP",
  13. "statusTime": 1660118978433,
  14. "details": [
  15. {
  16. "merchandiseSerno": "M01010001",
  17. "merchandiseCode": "1000019",
  18. "specification": "01",
  19. "skuType": "BOX",
  20. "standardPartsQty": 10,
  21. "shelveQuantity" : 1,
  22. "shelveItemQty" : 10,
  23. "itemInfoList":[
  24. {
  25. "itemSerno":"S000000001" //有分类库存信息时
  26. "qty":"1",
  27. "batchType":"INBOUND_BATCH_MANAGEMENT",
  28. "batchAttrType":"ID",
  29. "productionBatch":"201307180001",
  30. "batchDate":"2023-07-01",
  31. "winitBatchNo":"ad5c028b",
  32. "barcodeValue":"THD001",
  33. "quality":"GOOD"
  34. },
  35. {
  36. "itemSerno":"S000000002" //没有有分类库存信息时
  37. }
  38. ],
  39. "inventoryClassificationInfo":[
  40. { "qty":"1",
  41. "itemQty":"10",
  42. "batchType":"INBOUND_BATCH_MANAGEMENT",
  43. "batchAttrType":"ID",
  44. "productionBatch":"201307180001",
  45. "batchDate":"2023-07-01",
  46. "winitBatchNo":"ad5c028b",
  47. "barcodeValue":"THD001",
  48. "quality":"GOOD"
  49. }
  50. ]
  51. }
  52. ]
  53. }
  54. }
  55. ]

预约状态变更

  1. [
  2. {
  3. "uuid": "bd5b028b-369d-494f-bf73-58514ca80a08",
  4. "type": "BOOKING_STATUS_CHANGE",
  5. "orderNo": "W010001",
  6. "warehouseCode": "US0001",
  7. "bookingStatusChangeInfo":{
  8. "status":"BOOKING",
  9. "bookingNo":"Y00001",
  10. "bookingCode":"Q0B0C0J6L7M8",
  11. "warehouseCode":"US0001",
  12. "changeDate":1726205280333,
  13. "deliveryWayType":"LCL",
  14. "bookingSendWarehouseDate":"2024-09-09 9:00-10:00"
  15. }
  16. }
  17. ]

开发者返回的示例

  1. success
关键词