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

    • # 订阅商品基础信息变更通知

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

    事件英文名：head_supplier_subscribe_product_baseinfo_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_baseinfo_update
    item_infoobject事件主体，结构体详情请参考ItemInfo

    # Body.item_info Object Payload

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

    参数名类型说明
    appidstring商品所属店铺
    product_idstring商品id
    versionstring数据版本号，用于最后判断
    statusint32商品当前状态【是否在架】
    product_infoobject商品基本信息
    sku_listobject商品SKU信息列表
    desc_infoobject商品描述信息

    # Body.item_info.product_info Object Payload

    商品基本信息

    参数名类型说明
    titlestring商品标题
    sub_titlestring商品副标题
    head_imgsArray of string商品头部图片列表

    # Body.item_info.sku_list Object Payload

    商品SKU信息列表

    参数名类型说明
    sku_iduint64sku id
    sale_priceuint32销售价格
    stock_numuint64库存数量
    thumb_imgstring缩略图

    # Body.item_info.desc_info Object Payload

    商品描述信息

    参数名类型说明
    imgsArray of string商品描述图片列表
    descstring商品描述文本

    # 2. 消息返回

    # 返回体 Response Payload

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

    # 3. 注意事项

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

    # 4. 代码示例

    请求示例

    {
    "ToUserName": "gh_*",
    "FromUserName": "OpenID",
    "CreateTime": 1662480000,
    "MsgType": "event",
    "Event": "head_supplier_subscribe_product_baseinfo_update",
    "item_info": {
        "appid": "wx2b255582a7b4bfd0",
        "product_id": "10000186383677",
        "version": "21",
        "status": 5,
        "product_info": {
            "title": "精选商品组合11",
            "sub_title": "推荐商品",
            "head_imgs": [
                "https://wst.wxapp.tc.qq.com/161/20304/snscosdownload/SZ/reserved/67cfdc890005246c2e9793ed55918e0b000000a000004f50",
                "https://wst.wxapp.tc.qq.com/161/20304/snscosdownload/SZ/reserved/67cfdc8900069fd60dae50ecd84a8809000000a000004f50",
                "https://wst.wxapp.tc.qq.com/161/20304/snscosdownload/SZ/reserved/67cfdc89000b9e920f8987349cfc0115000000a000004f50",
            ]
        },
        "sku_list": [
            {
                "sku_id": 42367433222,
                "sale_price": 2,
                "stock_num": 993,
                "thumb_img": ""
            },
            {
                "sku_id": 798234686428,
                "sale_price": 2,
                "stock_num": 998,
                "thumb_img": ""
            }
        ],
        "desc_info": {
            "imgs": [
                "https://wst.wxapp.tc.qq.com/161/20304/snscosdownload/SZ/reserved/67cfdccc0005fd912d7619d823485415000000a000004f50",
                "https://wst.wxapp.tc.qq.com/161/20304/snscosdownload/SZ/reserved/67cfdcd3000d980a03249aaedef01515000000a000004f50",
                "https://wst.wxapp.tc.qq.com/161/20304/snscosdownload/SZ/reserved/67cfdcd400013bfa086dc1f27865bc1e000000a000004f50"
            ],
            "desc": "精选商品组合111"
        }
    }
}

    返回示例

    success