API
海外仓组织库存变更事件
更新时间: 2026-10-26 10:34:15 访问次数:66

事件名称:EVENT_IMS_SALE_INVENTORY_CHANGE_V1

事件说明:库存增减变化信息,推送给事件订阅的开发者

字段说明

请求

名称 类型 必填 字段 说明
customerCode String(20) Y 客户编码 Winit客户编码
docDate Date Y 变更时间 变更时间戳(毫秒),eg: 1622638202000
docType String(30) Y 单据类型 单据类型,见下方枚举说明
orderNo String(128) Y 订单号
merchandiseCode String100) Y 商品编码 Winit商品编码/SKU
specification String100) N 商品规格
merchandiseSerno String(20) Y 商品条码 WINIT商品唯一标识
originalMerchandiseSerno String(20) N 商品条码 当merchandiseSerno为RM条码时,这里是关联的M条码
countryCode String(10) Y 国家编码 eg: US
warehouseCode String(30) Y 仓库编码
mainWarehouseCode String(20) Y 主仓库编码
operationType String(30) Y 库存操作类型 库存操作类型,见下方枚举说明
salesChannelCode String Y 组织库存编码 销售渠道平台/组织编码,eg: organization-1、PUBLIC
inventoryType String() Y 库存类型 USABLE:可用
IN_STOCK:在库
FROZEN:冻结
ON_ORDER:在途
qty int Y 库存变更数量 正数是加,负数是减
uuid String(30) Y ID 记录唯一ID,供消费端幂等去重

docType 单据类型枚举

枚举值 说明 枚举值 说明
INBOUND 标准入库 INVENTORY_FROZEN 库存冻结
INBOUND_RETURN 退货入库 INVENTORY_UNFROZEN 库存解冻
INBOUND_DOMESTIC 国内验入库 INVENTORY_ADJUSTMENT 库存调整
INBOUND_OVERSEAS 海外直发入库 INV_TYPE_ADJ 库存分类调整
INBOUND_ALLOCATION 调拨入库 ABNORMAL_PICKING 拣选异常
OUTBOUND 标准出库 ABNORMAL_PICKING_SECOND 二次分拣异常
OUTBOUND_TAKE_THEIR 自提出库 ABNORMAL_PACKING 打包异常
OUTBOUND_DESTRUCTION 销毁出库 ABNORMAL_STOCKTAKING 盘点异常
OUTBOUND_ALLOCATION 调拨出库 ABNORMAL_MOVEDOWN 库内下架异常
RETURN_INVENTORY 回退库存(退货) TRANSFER_WHAREHOUSE 搬仓
INV_SALES_TRANSFER 销售库存调整(组织库存调整单)

operationType 库存操作类型枚举

枚举值 说明 枚举值 说明
INSPECTION 验货 LOST_CONFIRMING 丢失确认中
SHELVES 上架 LOST 已丢失
SHELVES_SUPPLY 补上架 RESHELVES 重新上架
SUBMIT_ORDER 提交订单 ALLOCATION_INBOUND 调拨入库
CANCEL_ORDER 取消订单 RETURN_INVENTORY 回退库存(退货用)
SHIPMENTS 发货 INBOUND_LOST 入库丢失
INVENTORY_PROFIT 盘盈 TRANSFER_WHAREHOUSE_IN 搬仓搬入
INVENTORY_LOSS 盘亏 TRANSFER_WHAREHOUSE_OUT 搬仓搬出
FROZEN 冻结 TRANSFORM 转换
UNFROZEN 解冻 ADJUST 调整库存
TRANSFER_IN 转入(销售库存/组织渠道转入) CANCEL 取消
TRANSFER_OUT 转出(销售库存/组织渠道转出)

返回

注:返回success即可,无需加引号逗号等其他信息

名称 类型 字段 说明
success String(7) 接收成功 消息接收成功
fail String(4) 接收失败 消息接收失败

示例

解密后报文示例

  1. [
  2. {
  3. "countryCode": "DE",
  4. "customerCode": "1000019",
  5. "docDate": 1792980504192,
  6. "docType": "OUTBOUND",
  7. "inventoryType": "USABLE",
  8. "merchandiseCode": "CH5419",
  9. "merchandiseSerno": "M010000000009513022",
  10. "operationType": "SUBMIT_ORDER",
  11. "orderNo": "WO12384792728",
  12. "qty": -2,
  13. "salesChannelCode": "002",
  14. "specification": "",
  15. "uuid": "76c2d3a5",
  16. "warehouseCode": "DEBR2"
  17. },
  18. {
  19. "countryCode": "DE",
  20. "customerCode": "1000019",
  21. "docDate": 1792980504192,
  22. "docType": "OUTBOUND",
  23. "inventoryType": "FROZEN",
  24. "merchandiseCode": "CH5419",
  25. "merchandiseSerno": "M010000000009513022",
  26. "operationType": "SUBMIT_ORDER",
  27. "orderNo": "WO12384792728",
  28. "qty": 2,
  29. "salesChannelCode": "002",
  30. "specification": "",
  31. "uuid": "76c2d3a5",
  32. "warehouseCode": "DEBR2"
  33. }
  34. ]

开发者返回的示例

  1. success

#

关键词