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

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

    # 接口说明

    通过该接口将订阅商品基础信息变更的消息通知给带货机构。

    # 注意事项

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

    # 请求参数说明

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

    # 请求参数示例（解密后的明文JSON）

    {
    "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

    # 返回参数示例

    success

    # 结构体

    # ItemInfo

    事件主体

    # ItemInfo 消息结构

    参数 类型 字段描述
    appid string 商品所属店铺
    product_id string 商品 id
    version string 数据版本号，用于最后判断
    status int32 商品当前状态【是否在架】
    product_info ProductInfo 商品基本信息
    sku_list Array of SkuInfo 商品 SKU 信息列表
    desc_info DescInfo 商品描述信息

    # ProductInfo 消息结构

    参数 类型 字段描述
    title string 商品标题
    sub_title string 商品副标题
    head_imgs Array of string 商品头部图片列表

    # SkuInfo 消息结构

    参数 类型 字段描述
    sku_id uint64 sku id
    sale_price uint32 销售价格
    stock_num uint64 库存数量
    thumb_img string 缩略图

    # DescInfo 消息结构

    参数 类型 字段描述
    imgs Array of string 商品描述图片列表
    desc string 商品描述文本