# 货品上下架
事件类型说明:异步通知
事件英文名:ec_supplier_product_listing
当货品上架或下架状态发生变更时触发此事件。
注意:回调超时时间为 3 秒,超时视为失败。需在微信后台正确配置回调 URL。
相关 API 接口:
# 1. 消息参数
# 根节点参数
| 参数名 | 类型 | 说明 |
|---|---|---|
ToUserName | string | 小店 UserName |
FromUserName | string | 微信团队的 OpenID(固定值) |
CreateTime | number | 事件时间,Unix 时间戳 |
MsgType | string | 消息类型,固定为 event |
Event | string | 事件类型,固定为 ec_supplier_product_listing |
EcSupplierProductListing | object | 事件主体 |
# 事件主体(EcSupplierProductListing)
| 参数名 | 类型 | 说明 |
|---|---|---|
product_id | string | 货品 ID |
status | number | 状态。5: 上架;11: 自主下架;13: 系统下架;14: 保证金违规下架;15: 品牌到期下架;20: 封禁下架 |
reason | string | 下架原因(非必填) |
# 2. 消息返回
直接返回字符串 success 或空字符串,无需加密。
# 3. 代码示例
{
"ToUserName": "gh_*",
"FromUserName": "OPENID",
"CreateTime": 1662480000,
"MsgType": "event",
"Event": "ec_supplier_product_listing",
"EcSupplierProductListing": {
"product_id": "10000000000001",
"status": 5,
"reason": ""
}
}
# 4. 注意事项
- status=5 表示上架,其余状态均为不同原因的下架
- 平台强制下架(系统下架 13、保证金违规下架 14、品牌到期下架 15、封禁下架 20)也会触发此事件
- 自主下架(11)由供货商主动调用下架接口触发
reason字段在下架时返回具体原因