推送说明#
当商品库存发生变更时,会推送该商品库存变更通知,该通知以sku + 发货区域 维度推送
事件类型标识#
eventName:openapi.inventory.update
推送主体内容#
| 参数 | 类型 | 是否必填 | 描述说明 |
|---|
| payload | object | 必填 | 事件的具体数据 |
| - data | array | 非必填 | 冗余商品数据 |
| - list | array | 必填 | 商品库存数据 |
| -- sku | string | 必填 | 商品sku |
| -- productSkuId | int | 必填 | 商品skuId |
| -- productId | int | 必填 | 商品 |
| -- deliveryRegionId | int | 必填 | 商品发货区域ID |
| -- depotId | int | 必填 | 发货区域仓库ID |
| -- depotName | string | 必填 | 发货区域仓库名称 |
| -- qty | int | 必填 | 商品库存 |
| -- updatedAt | string | 必填 | 更新时间 |
| ctx | object | 非必填 | 事件的上下文,例:订单创建事件,对应创建订单的用户信息 |
| eventId | string | 必填 | 事件id |
| entityId | string | 必填 | 实体id,即业务事件的实体对应的id |
| eventHash | string | 必填 | 事件hash值,由事件生产者生成,作为唯一标识 |
| eventName | string | 必填 | 事件名,作为不同业务订阅类型标识 |
| sourceSystem | string | 必填 | 事件的来源系统 |
| eventVersion | string | 必填 | 事件的版本号,版本号应与事件的数据结构做绑定,方便下游系统做业务区分 |
| eventAt | string | 必填 | 事件的触发时间,格式:2025-06-08 12:30:00 |
推送内容示例#
{
"payload": {
"data": [
],
"list": [
{
"sku": "EAA03-A015-30-BK1",
"productSkuId": 9138,
"productId": 4568,
"deliveryRegionId": 5,
"depotId": 40,
"depotName": "中国义乌仓",
"qty": 0,
"updatedAt": "2025-09-09 14:30:32"
}
]
},
"ctx": "[]",
"eventId": "823926769866027008",
"entityId": "74f84964-b803-49a3-b4df-da4499afd4b1",
"eventHash": "809a5c551a3a1ca371254959712bd977",
"eventType": "source",
"eventName": "openapi.inventory.update",
"sourceSystem": "westmonth.westmonth",
"eventVersion": "1.0.0",
"eventAt": "2025-09-09 14:30:49",
"app_id": "10033",
"timestamp": 1757399449,
"signature": "910abe10e8d1510da211eef37932baf36b00af6cb179e6b516f1b9e251e8bccc",
"nonce": "634767da0c5abfaa092e6a9906fa2995"
}