# 品牌资质

# 开发前准备

• 功能了解：开发前建议先阅读以下运营文档了解品牌管理的完整业务流程：
  • 微信小店「品牌管理」使用指南
  • 微信小店「品牌认证」管理规则
• 权限与凭证：商家自研可直接调用，使用小店 access_token；第三方服务商需获得商家对权限集 ID：85或权限集 ID：129的授权，使用 authorizer_access_token
• 消息推送配置：需配置消息推送回调 URL，本模块涉及的事件：[事件] 品牌资质事件通知 / channels_ec_brand。详见 消息通知（回调）说明
• 资质图片上传：新增或更新品牌资质前，需先调用 [API] 上传资质图片 接口获取 file_id，作为商标注册证、授权书等资质文件的引用凭证

# 核心概念

# 品牌库 vs 品牌资质

品牌资质的管理涉及两个层面：

• 品牌库：微信小店维护的全局品牌列表，包含品牌编号（brand_id）、中文名、英文名。通过 [API] 获取品牌库列表 / getallbrandslogic 查询
• 品牌资质：商家针对某个品牌提交的资质申请记录，包含商标注册信息、授权信息、审核状态等。通过 [API] 获取品牌资质申请列表 / getbrandlistlogic 或 [API] 获取生效中的品牌资质列表 / getvalidbrandlistlogic 查询

# 品牌资质与店铺、商品的关联

品牌资质是店铺级别的资源，建立了店铺与商品品牌之间的归属关系：

• 店铺维度：品牌资质绑定在店铺上，企业店才可提交品牌资质申请。本模块所有接口（新增、更新、删除、撤回、查询）均使用小店 access_token 调用，操作的是当前店铺下的品牌资质数据。品牌库是全局共享的，但品牌资质是店铺级隔离的——同一品牌（如"耐克"），店铺A和店铺B需要分别提交各自的商标/授权材料，独立走审核流程，互不影响
• 商品维度：部分类目属于品牌定向准入，需先完成对应品牌的品牌资质认证，才能在该品牌下发布商品；品牌资质过期后，关联该品牌的商品将被系统下架
• 调用关系：调用 [API] 添加商品 / addproduct 或 [API] 更新商品 / updateproduct 时，通过 brand_id 字段指定商品所属品牌：
  • brand_id 取值来自品牌库（通过 [API] 获取品牌库列表 / getallbrandslogic 查询）
  • 该品牌必须已完成品牌资质审核且处于生效状态，否则添加/更新商品接口会返回错误码
  • 若商品无特定品牌，填写固定值 "2100000000"
  • 部分类目还需在 product_qua_infos 中上传品牌授权书等资质文件

# 商标类型

# 授权类型

# 接入流程

# 1. 品牌资质申请流程

流程说明：

1. 查询品牌库：调用 [API] 获取品牌库列表 / getallbrandslogic，获取待申请品牌的 brand_id
2. 上传资质文件：调用 [API] 上传资质图片，上传商标注册证、授权书等文件，获取 file_id
3. 新增品牌资质：调用 [API] 新增品牌资质 / addbrandlogic，提交品牌资质申请。提交后收到 [事件] 品牌资质事件通知 / channels_ec_brand（status=1 新增品牌）
4. 等待审核：通过事件通知接收审核结果，status=4 表示审核成功，status=5 表示审核失败
5. 审核失败处理：调用 [API] 更新品牌资质 / updatebrandlogic 修改资质信息后重新提交（触发 status=2 更新品牌）

# 2. 品牌资质管理流程

管理说明：

• 撤回审核：调用 [API] 撤回品牌资质审核 / cancelauditbrandlogic，触发事件通知 status=3（撤回品牌审核），撤回后可调用更新接口修改并重新提交
• 删除品牌资质：调用 [API] 删除品牌资质 / deletebrandlogic，触发事件通知 status=6（删除品牌），删除后对应品牌关联的商品将会被下架

# 3. 品牌资质生命周期（含全部事件通知状态）

以上流程图体现了 [事件] 品牌资质事件通知 / channels_ec_brand 的全部 8 个状态值。

# 接口全览

# API 接口

# 事件通知

# 常见问题 FAQ

Q：新增品牌资质和更新品牌资质有什么区别？ A：每个品牌只能调用一次 [API] 新增品牌资质 / addbrandlogic。如果该品牌已有申请记录（无论审核状态如何），需使用 [API] 更新品牌资质 / updatebrandlogic 修改并重新提交。

Q：获取品牌资质申请列表和获取生效中的品牌资质列表有什么区别？ A：[API] 获取品牌资质申请列表 / getbrandlistlogic 返回商家所有品牌资质申请记录（含审核中、审核失败、已撤回等各种状态）；[API] 获取生效中的品牌资质列表 / getvalidbrandlistlogic 仅返回状态为"已生效"和"即将过期"的品牌资质。

Q：品牌资质过期后会有什么影响？ A：品牌资质过期后，关联该品牌的商品会被系统下架。建议关注 [事件] 品牌资质事件通知 / channels_ec_brand 中 status=8（品牌资质过期）的推送，提前续期。也可定期调用 [API] 获取生效中的品牌资质列表 / getvalidbrandlistlogic 主动轮询，注意此处返回的 status=5 表示「即将过期」（与事件通知中的 status=5 含义不同，事件通知中 status=5 表示审核失败），发现即将过期的记录时及时续期，不要依赖事件通知做过期预警。

Q：审核中的品牌资质可以直接更新吗？ A：不可以。处于审核中状态的品牌资质不支持直接更新，需先调用 [API] 撤回品牌资质审核 / cancelauditbrandlogic 撤回审核，再调用 [API] 更新品牌资质 / updatebrandlogic 修改并重新提交。