# 商品更新

本文档描述服务器端接收的消息或事件,详细说明参见消息推送

事件英文名:product_spu_update

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

相关 API 接口:

# 1. 消息参数

# 请求体 Request Payload

参数名类型说明
ToUserNamestring小店UserName
FromUserNamestring微信团队的 OpenID(固定值)
CreateTimenumber事件时间,Unix时间戳(即格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒起至现在的总秒数)
MsgTypestring消息类型,固定为 event
Eventstring事件类型,本接口固定为 product_spu_update
ProductSpuUpdateobject事件主体

# Body.ProductSpuUpdate Object Payload

事件主体

参数名类型说明
product_idstring商品ID
statusnumber操作。0: 更新; 1: 新增; 2: 删除; 3: 彻底删除。
product_typenumber商品类型。1:小店自营商品;4:在售赠品;5:非卖商品。

# 2. 消息返回

# 返回体 Response Payload

回复 success 或空字符串(无需加密)

# 3. 注意事项

  • 回调url设置和消息推送规则需参考消息推送文档 ,如果设置的回调url无法访问,商户将无法收微信小店发送的通知;

# 4. 代码示例

请求示例

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

返回示例

success
文档变更日志(1条)
2026 年 02 月 12 日
新增 product_type 字段