# 机构商品变更通知
本文档描述服务器端接收的消息或事件，详细说明参见消息推送。
事件英文名：head_supplier_item_update
微信小店将通过此接口向机构发送商品变更的通知。
# 1. 消息参数
# 请求体 Request Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| ToUserName | string | 机构UserName |
| FromUserName | string | 微信团队的OpenID(固定值) |
| CreateTime | number | 事件时间,Unix时间戳 |
| MsgType | string | 消息类型,固定为 event |
| Event | string | 事件类型,本接口固定为 head_supplier_item_update |
| item_info | object | 事件主体，结构体详情请参考ItemInfo |
# Body.item_info Object Payload
事件主体，结构体详情请参考ItemInfo
| 参数名 | 类型 | 说明 |
|---|---|---|
| event_type | number | 商品变更类型，1：新增商品；2：更新商品 |
| appid | string | 机构商品所属小店appid |
| product_id | string(uint64) | 商品id |
| version | string | 商品版本号 |
| update_fields | string array | 商品更新字段，当event_type = 2时有值。commission_ratio、service_ratio、status、active_time分别表示佣金、服务费、商品状态和合作生效时间有变更 |
# 2. 消息返回
# 返回体 Response Payload
回复 success 或空字符串（无需加密）
# 3. 注意事项
- 回调url设置和消息推送规则需参考消息推送文档 ，如果设置的回调url无法访问，机构将无法收到通知；
# 4. 代码示例
请求示例
{
"ToUserName": "gh_*",
"FromUserName": "OPENID",
"CreateTime": 1662480000,
"MsgType": "event",
"Event": "head_supplier_item_update",
"item_info": {
"event_type": 2,
"appid": "APPID",
"product_id": "12345",
"version": "1677488955",
"update_fields": ["commission_ratio","service_ratio","status","active_time"]
}
}
返回示例
success