1. 订阅通知
西之月开放接口(openapi)
  • 西之月开放平台介绍
  • 西之月接入流程
  • 西之月开放API
  • 西之月订阅通知
  • 公共错误码
  • 货盘页面接入说明
  • openapi
    • 商品
      • 📖商品能力
      • SKU
        • SKU列表
        • SKU信息
        • SKU信息及价格
        • SKU查询客户价格
        • SKU查询英代欧代美代协议
        • SKU一体化标签
        • SKU一体化标签平台
        • SKU证书
        • SKU六面图
        • SKU商品图包
        • SKU视频
        • SKU商品标签【国内】
        • SKU产品文案
        • SKU实拍图附带一体化标签
        • SKU图包资料
      • 库存
        • 商品总库存列表
        • 商品分仓库存列表
        • 指定商品分仓库存
        • 圈货、备货库存查询
        • SKU实时库存【国内】
      • 商品列表
      • 商品详情
      • 商品价格
      • 个性化商品价格列表
      • 商品所有档位价格
      • 商品分类
      • 商品分类-获取子分类
      • 商品品牌
      • 商品证书
      • 商品使用说明书
    • 订单
      • 📖订单能力
      • 交接单
        • 交接单列表
        • 验证订单允许上传交接单
        • 上传交接单文件
        • 保存交接单
      • 创建订单
      • 订单预计算
      • 订单列表
      • 订单详情
      • 订单详情列表
      • 订单取消
      • 订单状态
      • 订单支付状态
      • 订单物流轨迹
    • 支付
      • 📖支付能力
      • 订单支付页面
      • 发起支付
      • 获取支付方式
      • 获取订单支付信息
    • 售后
      • 📖售后能力
      • 获取发起售后配置数据
      • 订单发起售后
      • 撤销售后
    • 账期
      • 📖账期能力
      • 已结清账期-账单列表
      • 未结清账期-账单列表
      • 未结清账单-销售订单列表
      • 未结清账单-售后订单列表
    • 品牌授权
      • 📖品牌授权能力
      • 获取授权平台列表
      • 获取模板类型列表
      • 获取授权品牌列表
      • 获取执照列表信息
      • 品牌授权申请
      • 品牌授权记录
      • 品牌授权作废
    • 其他
      • 📖其它能力
      • 仓库
        • 仓库列表信息
        • 发货区域列表
      • 物流
        • 物流公司列表
        • 获取运费接口
      • 平台
        • 获取授权码
        • 平台列表信息-新
        • 平台列表信息
      • 用户
        • 根据token获取用户信息
    • 订阅通知
      • 商品信息变更
      • 商品上下架状态变更
      • 商品库存变更
      • 商品价格变更
      • 商品删除
  1. 订阅通知

商品库存变更

推送说明#

当商品库存发生变更时,会推送该商品库存变更通知,该通知以sku + 发货区域 维度推送

事件类型标识#

eventName:openapi.inventory.update

推送主体内容#

参数类型是否必填描述说明
payloadobject必填事件的具体数据
- dataarray非必填冗余商品数据
- listarray必填商品库存数据
-- skustring必填商品sku
-- productSkuIdint必填商品skuId
-- productIdint必填商品
-- deliveryRegionIdint必填商品发货区域ID
-- depotIdint必填发货区域仓库ID
-- depotNamestring必填发货区域仓库名称
-- qtyint必填商品库存
-- updatedAtstring必填更新时间
ctxobject非必填事件的上下文,例:订单创建事件,对应创建订单的用户信息
eventIdstring必填事件id
entityIdstring必填实体id,即业务事件的实体对应的id
eventHashstring必填事件hash值,由事件生产者生成,作为唯一标识
eventNamestring必填事件名,作为不同业务订阅类型标识
sourceSystemstring必填事件的来源系统
eventVersionstring必填事件的版本号,版本号应与事件的数据结构做绑定,方便下游系统做业务区分
eventAtstring必填事件的触发时间,格式: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"
}
修改于 2026-01-27 10:24:25
上一页
商品上下架状态变更
下一页
商品价格变更
Built with