# 商品更新

> 本文档描述服务器端接收的消息或事件，详细说明参见[消息推送](/miniprogram/dev/framework/server-ability/message-push.md)。

事件英文名：product_spu_update

微信小店会通过该接口将更新商品信息数据操作消息通知给商户

相关 API 接口：
- [添加商品](/doc/store/shop/API/channels-shop-product/shop/api_addproduct)
- [删除商品](/doc/store/shop/API/channels-shop-product/shop/api_deleteproduct)
- [更新商品](/doc/store/shop/API/channels-shop-product/shop/api_updateproduct)
- [免审更新商品](/doc/store/shop/API/channels-shop-product/shop/api_updateproductauditfree)

## 1. 消息参数

### 请求体 `Request Payload`

```json
[
  {
    "参数名": "ToUserName",
    "类型": "string",
    "说明": "小店UserName"
  },
  {
    "参数名": "FromUserName",
    "类型": "string",
    "说明": "微信团队的 OpenID(固定值)"
  },
  {
    "参数名": "CreateTime",
    "类型": "number",
    "说明": "事件时间,Unix时间戳(即格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒起至现在的总秒数)"
  },
  {
    "参数名": "MsgType",
    "类型": "string",
    "说明": "消息类型,固定为 event"
  },
  {
    "参数名": "Event",
    "类型": "string",
    "说明": "事件类型,本接口固定为 product_spu_update"
  },
  {
    "参数名": "ProductSpuUpdate",
    "类型": "object",
    "说明": "事件主体"
  }
]
```

### Body.ProductSpuUpdate `Object Payload`

事件主体

```json
[
  {
    "参数名": "product_id",
    "类型": "string",
    "说明": "商品ID"
  },
  {
    "参数名": "status",
    "类型": "number",
    "说明": "操作。0: 更新; 1: 新增; 2: 删除; 3: 彻底删除。"
  },
  {
    "参数名": "product_type",
    "类型": "number",
    "说明": "商品类型。1:小店自营商品；4:在售赠品；5:非卖商品。"
  }
]
```

## 2. 消息返回

### 返回体 `Response Payload`

回复 `success` 或空字符串（无需加密）

## 3. 注意事项

- 回调url设置和消息推送规则需参考[消息推送文档](/doc/store/shop/dev_before/message_push) ，如果设置的回调url无法访问，商户将无法收微信小店发送的通知；

## 4. 代码示例

请求示例

```json
{
    "ToUserName":"gh_*",
    "FromUserName":"OPENID",
    "CreateTime":1662480000,
    "MsgType":"event",
    "Event":"product_spu_update",
    "ProductSpuUpdate": {
        "product_id":"12345678",
        "status":0,
        "product_type":1
    }
}
```

返回示例

```
success
```

![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)文档变更日志（1条）
2026 年 02 月 12 日新增  `product_type`  字段