API

入库订单和包裹状态变更事件

更新时间： 2023-09-14 20:09:28 访问次数：488

事件名称：EVENT_OMS_INBOUND_STATUS_CHANGE
事件说明：海外仓入库订单或入库包裹状态变更，推送给当前应用

订单状态有：已收货、已验货、运输中、部分到仓、已到仓、已上架、终止
包裹状态有：丢失、终止、已卸货、上架完成、上架异常区
字段说明
请求

名称	类型	必填	字段	说明
uuid	String(30)	Y	记录唯一ID
type	String(30)	Y	变更类型	订单状态变更：ORDER_STATUS_CHANGE 包裹状态变更：PACKAGE_STATUS_CHANGE
orderNo	String(128)	Y	入库单号
sellerOrderNo	String(128)	O	客户订单号
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此类单一商品的上架单品数量，数量等于标准件数*上架数量

注：返回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",
    "packageStatusChangeInfo": {
      "packageSerno": "B00001",
      "sellerCaseNo": "A001",
      "thirdPartyCaseNo": "XT0010101",
      "trackingNo": "E0010101",
      "status": "SCP",
      "statusTime": 1660118978433,
      "details": [
        {
          "merchandiseSerno": "M01010001",
          "merchandiseCode": "1000019",
          "specification": "01",
          "skuType": "BOX",
          "standardPartsQty": 10,
          "shelveQuantity": 1,
          "shelveItemQty": 10
        }
      ]
    }
  }
]

开发者返回的示例

success

关键词

字段说明

请求

返回

示例

解密后报文示例

开发者返回的示例