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

事件名称：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
关键词