# 货品上下架

事件类型说明:异步通知

事件英文名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 字段在下架时返回具体原因

# 参考资料