API
入库订单和包裹状态变更事件
更新时间: 2023-09-14 20:09:28 访问次数:547

事件名称: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) 接收失败 消息接收失败

示例

解密后报文示例

订单状态变更

  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. "packageStatusChangeInfo": {
  7. "packageSerno": "B00001",
  8. "sellerCaseNo": "A001",
  9. "thirdPartyCaseNo": "XT0010101",
  10. "trackingNo": "E0010101",
  11. "status": "SCP",
  12. "statusTime": 1660118978433,
  13. "details": [
  14. {
  15. "merchandiseSerno": "M01010001",
  16. "merchandiseCode": "1000019",
  17. "specification": "01",
  18. "skuType": "BOX",
  19. "standardPartsQty": 10,
  20. "shelveQuantity": 1,
  21. "shelveItemQty": 10
  22. }
  23. ]
  24. }
  25. }
  26. ]

开发者返回的示例

  1. success
关键词