微信小店
取消
中文
中文
EN
取消
  • 联盟带货机构

    • # 订阅商品计划信息变更通知

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

    事件英文名：head_supplier_subscribe_product_planinfo_update

    通过该接口将订阅商品计划变更的消息通知给带货机构

    # 1. 消息参数

    # 请求体 Request Payload

    参数名类型说明
    ToUserNamestring带货机构UserName, 机构原始ID, 可在「微信小店·联盟带货机构管理平台 - 设置 - 基础信息」中获得。
    FromUserNamestring微信团队的 OpenID（固定值）
    CreateTimenumber事件时间,Unix时间戳。即格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数
    MsgTypestring消息类型,固定为 event
    Eventstring事件类型,本接口固定为 head_supplier_subscribe_product_planinfo_update
    item_infoobject事件主体，结构体详情请参考ItemInfo

    # Body.item_info Object Payload

    事件主体，结构体详情请参考ItemInfo

    参数名类型说明
    event_typeint32事件类型：1计划新增、2计划变更、3添加合作、4结束合作
    appidstring商品所属店铺
    product_idstring商品id
    plan_typeint32计划类型
    参考这里的定义：https://developers.weixin.qq.com/doc/store/leagueheadsupplier/API/promotion/product/getpromoteproductdetail.html
    plan_idstring计划ID
    plan_statusint32计划当前状态【是否在架】, 0:失效 1:生效
    head_supplier_item_linkstring计划短链
    versionstring数据版本号，用于最后判断
    service_ratiouint32服务费率
    commission_ratiouint32佣金率
    start_timeuint64开始时间
    end_timeuint64结束时间

    # 2. 消息返回

    # 返回体 Response Payload

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

    # 3. 注意事项

    • 回调url设置和消息推送规则需参考消息推送文档 ，如果设置的回调url无法访问，机构将无法收到通知；

    # 4. 代码示例

    请求示例

    {
    "ToUserName": "gh_*",
    "FromUserName": "OpenID",
    "CreateTime": 1662480000,
    "MsgType": "event",
    "Event": "head_supplier_subscribe_product_planinfo_update",
    "item_info": {
        "event_type": 2,
        "appid": "wxc5b627dfd7c390f4",
        "product_id": "10000155286989",
        "plan_type": 3,
        "plan_id": "2000000002630025",
        "plan_status": 1,
        "head_supplier_item_link": "weixinstorehs/14016124036143",
        "version": "5",
        "service_ratio": 10000,
        "commission_ratio": 200000,
        "start_time": 1747293120,
        "end_time": 1748620800
    }
}

    返回示例

    success