微信小店
取消
中文
中文
EN
取消
  • 微信小店

    • # 更新品牌资质

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

    接口英文名：updatebrandlogic

    通过该接口可以更新品牌资质

    相关事件通知：品牌资质事件通知

    # 1. 调用方式

    # HTTPS 调用

    POST https://api.weixin.qq.com/channels/ec/brand/update?access_token=ACCESS_TOKEN

    # 云调用

    • 本接口不支持云调用

    # 第三方调用

    • 本接口支持第三方平台代商家调用。

    • 该接口所属的权限集 id 为：85、129

    • 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

    # 2. 请求参数

    # 查询参数 Query String parameters

    参数名类型必填示例说明
    access_tokenstring是ACCESS_TOKEN接口调用凭证，可使用 access_token、authorizer_access_token

    # 请求体 Request Payload

    参数名类型必填说明
    brandobject是品牌详情

    # Body.brand Object Payload

    品牌详情

    参数名类型必填说明
    brand_idnumber是品牌库中的品牌编号
    ch_namestring否品牌商标中文名, 从品牌库获取
    en_namestring否品牌商标英文名, 从品牌库获取
    classification_nostring是商标分类号, 取值范围1-45
    trade_mark_symbolnumber是商标类型, 取值1:R标; 2: TM标
    register_detailsobject否注册信息
    application_detailsobject否申请信息
    grant_typenumber否商标授权信息, 取值1:自有品牌; 2: 授权品牌
    grant_detailsobject否品牌信息

    # Body.brand.register_details Object Payload

    注册信息

    参数名类型必填说明
    registrantstring是商标注册人, R标时必填
    register_nostring是商标注册号, R标时必填
    start_timenumber否商标注册有效期, 开始时间, 长期有效可不填
    end_timenumber否商标注册有效期, 结束时间, 长期有效可不填
    is_permanentboolean是是否长期有效
    register_certificationsarray否商标注册证的file_id, R标时必填, 限制最多传1张, 需要先调用上传资质图片接口上传资质图片
    renew_certificationsarray否变更/续展证明的file_id, 限制最多传5张, 需要先调用上传资质图片接口上传资质图片

    # Body.brand.application_details Object Payload

    申请信息

    参数名类型必填说明
    acceptance_timenumber是商标申请受理时间, TM标时必填
    acceptance_certificationarray否商标注册申请受理书file_id, TM标时必填, 限制最多传1张, 需要先调用上传资质图片接口上传资质图片
    acceptance_nostring是商标申请号, TM标时必填

    # Body.brand.grant_details Object Payload

    品牌信息

    参数名类型必填说明
    grant_certificationsarray否(旧结构)品牌销售授权书的file_id, 授权品牌必填, 限制最多传9张, 需要先调用上传资质图片接口上传资质图片
    grant_levelnumber否授权级数, 授权品牌必填, 取值1-3
    start_timenumber否(旧结构)授权有效期, 开始时间, 长期有效可不填
    end_timenumber否(旧结构)授权有效期, 结束时间, 长期有效可不填
    is_permanentboolean否(旧结构)是否长期有效
    brand_owner_id_photosarray否品牌权利人证件照的file_id, 限制最多传2张, 需要先调用上传资质图片接口上传资质图片
    use_split_grant_infonumber否是否使用分级授权书结构，大于0即使用。如果使用分级结构，也会兼容填充到旧结构
    grant_info_lv1object否一级结构
    grant_info_lv2object否二级结构
    grant_info_lv3object否三级结构
    contact_info_listobjarray否联系方式

    # Body.brand.grant_details.grant_info_lv1 Object Payload

    一级结构

    参数名类型必填说明
    grant_certificationsarray否(分级结构)品牌销售授权书的file_id, 多于一级授权时必填, 需要先调用上传资质图片接口上传资质图片
    start_timenumber否(分级结构)授权有效期, 开始时间, 长期有效可不填
    end_timenumber否(分级结构)授权有效期, 结束时间, 长期有效可不填
    is_permanentboolean否(分级结构)是否长期有效

    # Body.brand.grant_details.grant_info_lv2 Object Payload

    二级结构

    参数名类型必填说明
    grant_certificationsarray否(分级结构)品牌销售授权书的file_id, 多于一级授权时必填, 需要先调用上传资质图片接口上传资质图片
    start_timenumber否(分级结构)授权有效期, 开始时间, 长期有效可不填
    end_timenumber否(分级结构)授权有效期, 结束时间, 长期有效可不填
    is_permanentboolean否(分级结构)是否长期有效

    # Body.brand.grant_details.grant_info_lv3 Object Payload

    三级结构

    参数名类型必填说明
    grant_certificationsarray否(分级结构)品牌销售授权书的file_id, 多于一级授权时必填, 需要先调用上传资质图片接口上传资质图片
    start_timenumber否(分级结构)授权有效期, 开始时间, 长期有效可不填
    end_timenumber否(分级结构)授权有效期, 结束时间, 长期有效可不填
    is_permanentboolean否(分级结构)是否长期有效

    # Body.brand.grant_details.contact_info_list(Array) Object Payload

    联系方式

    参数名类型必填说明
    keystring否联系方式key
    valuestring否联系方式value

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber错误码
    errmsgstring错误信息
    audit_idnumber审核单ID, 提交审核成功后返回

    # 4. 注意事项

    • 调用该接口会进行提交审核，处于“审核中”状态的品牌不可重复提交，需要先调用撤回品牌资质审核接口撤销审核；
    • 所有资质文件需要先调用上传资质图片接口上传资质图片。
    • 授权品牌建议使用分级结构，通过use_split_grant_info字段区分，新旧结构区别详见结构中（旧结构）、（分级结构）标记。

    # 5. 代码示例

    请求示例

    {
    "brand":
    {
        "brand_id": "10000531",
        "ch_name": "尼康",
        "en_name": "Nikon",
        "classification_no": "2",
        "trade_mark_symbol": 1,
        "register_details":
        {
            "registrant": "注册人",
            "register_no": "注册号",
            "start_time": 1665417600,
            "end_time": 1666281600,
            "is_permanent": false,
            "register_certifications": [
                "file_id_XXXX"
            ],
            "renew_certifications": [
                "file_id_XXXX"
            ]
        },
        "application_details": {},
        "grant_type": 2,
        "grant_details":
        {
            "grant_certifications": [
                "file_id_XXXX"
            ],
            "grant_level": 3,
            "start_time": 1664985600,
            "end_time": 1678896000,
            "is_permanent": false,
            "brand_owner_id_photos": [
                "file_id_XXXX",
                "file_id_XXXX"
            ],
            "use_split_grant_info": 1,
            "grant_info_lv1": {
                "grant_certifications": [
                    "file_id_XXXX"
                ],
                "start_time": 1664985600,
                "end_time": 1678896000
            },
            "grant_info_lv2": {
                "grant_certifications": [
                    "file_id_XXXX"
                ],
                "start_time": 1664985600,
                "end_time": 1678896000
            },
            "grant_info_lv3": {
                "grant_certifications": [
                    "file_id_XXXX"
                ],
                "start_time": 1664985600,
                "end_time": 1678896000
            },
            "contact_info_list" : [
                {
                    "key" : "联系电话",
                    "value" : "xxxx"
                }
            ]
        }
    }
}

    返回示例

    {
    "errcode": 0,
    "errmsg": "ok",
    "audit_id": "12345678"
}

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码

    错误码错误描述解决方案
    10020050无权限调用该api
    10020055参数有误
    10020080提交的资质数量超出限制
    10020081品牌的申请记录不存在，请调用新增品牌接口
    10020084品牌名称与品牌库ID不匹配
    10020085该品牌申请正在审核中，请不要重复提交
    10020086品牌资质文件的file_id无效
    10020602品牌授权类型错误
    10020603品牌商标类型错误
    10020604品牌状态错误
    10020605品牌授权等级错误
    10020606品牌不支持非R标
    10020607品牌商标注册号错误
    10020608品牌授权信息错误
    10020609品牌商标分类号错误
    10020610品牌申请已存在
    10020611已存在相同品牌入库中

    # 7. 适用范围

    本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。