# 新增品牌资质
接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。
接口英文名：addbrandlogic
通过该接口可以新增品牌资质。调用该接口会自动提交审核，审核结果通过品牌资质事件通知推送。
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/shop/ec/brand/add?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用。
# 第三方调用
本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为：85、129、192
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代微信小店商家进行调用，具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商代调用） |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| brand | object | 是 | 品牌详情 |
# Body.brand Object Payload
品牌详情
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| brand_id | number | 是 | 品牌库中的品牌编号 |
| ch_name | string | 否 | 品牌商标中文名，从品牌库获取 |
| en_name | string | 否 | 品牌商标英文名，从品牌库获取 |
| classification_no | string | 是 | 商标分类号，取值范围 1-45 |
| trade_mark_symbol | number | 是 | 商标类型。1=R 标，2=TM 标 |
| register_details | object | 否 | 注册信息 |
| application_details | object | 否 | 申请信息 |
| grant_type | number | 否 | 商标授权类型。1=自有品牌，2=授权品牌 |
| grant_details | object | 否 | 品牌信息 |
# Body.brand.register_details Object Payload
注册信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| registrant | string | 是 | 商标注册人，R 标时必填 |
| register_no | string | 是 | 商标注册号，R 标时必填 |
| start_time | number | 否 | 商标注册有效期开始时间，长期有效可不填 |
| end_time | number | 否 | 商标注册有效期结束时间，长期有效可不填 |
| is_permanent | boolean | 是 | 是否长期有效 |
| register_certifications | array | 否 | 商标注册证的 file_id，R 标时必填，限制最多传 1 张，需要先调用 [API] 上传资质图片 / qualificationupload 接口上传 |
| renew_certifications | array | 否 | 变更 / 续展证明的 file_id，限制最多传 5 张，需要先调用 [API] 上传资质图片 / qualificationupload 接口上传 |
# Body.brand.application_details Object Payload
申请信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| acceptance_time | number | 是 | 商标申请受理时间，TM 标时必填 |
| acceptance_certification | array | 否 | 商标注册申请受理书 file_id，TM 标时必填，限制最多传 1 张，需要先调用 [API] 上传资质图片 / qualificationupload 接口上传 |
| acceptance_no | string | 是 | 商标申请号，TM 标时必填 |
# Body.brand.grant_details Object Payload
品牌信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| grant_certifications | array | 否 | （旧结构）品牌销售授权书的 file_id，授权品牌必填，限制最多传 9 张，需要先调用 [API] 上传资质图片 / qualificationupload 接口上传 |
| grant_level | number | 否 | 授权级数，授权品牌必填，取值 1-3 |
| start_time | number | 否 | （旧结构）授权有效期开始时间，长期有效可不填 |
| end_time | number | 否 | （旧结构）授权有效期结束时间，长期有效可不填 |
| is_permanent | boolean | 否 | （旧结构）是否长期有效 |
| brand_owner_id_photos | array | 否 | 品牌权利人证件照的 file_id，限制最多传 2 张，需要先调用 [API] 上传资质图片 / qualificationupload 接口上传 |
| use_split_grant_info | number | 否 | 是否使用分级授权书结构，大于 0 即使用。如果使用分级结构，也会兼容填充到旧结构 |
| grant_info_lv1 | object | 否 | 一级结构 |
| grant_info_lv2 | object | 否 | 二级结构 |
| grant_info_lv3 | object | 否 | 三级结构 |
| contact_info_list | objarray | 否 | 联系方式 |
# Body.brand.grant_details.grant_info_lv1 Object Payload
一级结构
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| grant_certifications | array | 否 | （分级结构）品牌销售授权书的 file_id，多于一级授权时必填，需要先调用 [API] 上传资质图片 / qualificationupload 接口上传 |
| start_time | number | 否 | （分级结构）授权有效期开始时间，长期有效可不填 |
| end_time | number | 否 | （分级结构）授权有效期结束时间，长期有效可不填 |
| is_permanent | boolean | 否 | （分级结构）是否长期有效 |
# Body.brand.grant_details.grant_info_lv2 Object Payload
二级结构
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| grant_certifications | array | 否 | （分级结构）品牌销售授权书的 file_id，多于二级授权时必填，需要先调用 [API] 上传资质图片 / qualificationupload 接口上传 |
| start_time | number | 否 | （分级结构）授权有效期开始时间，长期有效可不填 |
| end_time | number | 否 | （分级结构）授权有效期结束时间，长期有效可不填 |
| is_permanent | boolean | 否 | （分级结构）是否长期有效 |
# Body.brand.grant_details.grant_info_lv3 Object Payload
三级结构
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| grant_certifications | array | 否 | （分级结构）品牌销售授权书的 file_id，三级授权时必填，需要先调用 [API] 上传资质图片 / qualificationupload 接口上传 |
| start_time | number | 否 | （分级结构）授权有效期开始时间，长期有效可不填 |
| end_time | number | 否 | （分级结构）授权有效期结束时间，长期有效可不填 |
| is_permanent | boolean | 否 | （分级结构）是否长期有效 |
# Body.brand.grant_details.contact_info_list(Array) Object Payload
联系方式
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 否 | 联系方式类型，如联系电话 |
| value | string | 否 | 联系方式内容 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| errcode | number | 0 | 错误码 |
| errmsg | string | ok | 错误信息 |
| audit_id | number | 12345678 | 审核单 ID，提交审核成功后返回 |
# 4. 注意事项
- 每个品牌只能调用一次新增接口，对于已存在申请记录的品牌，请使用 [API] 更新品牌资质 / updatebrandlogic 接口更新资质；
- 新增品牌前，需要先通过 [API] 获取品牌库列表 / getallbrandslogic 接口获取品牌库中的品牌及其编号，所有资质文件需要先调用 [API] 上传资质图片 / qualificationupload 接口上传；
- 授权品牌建议使用分级结构，通过 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": "13012345678"
}
]
}
}
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"audit_id": "12345678"
}
# 6. 错误码
以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 10020050 | 无权限调用该 api | 检查 access_token 与权限集授权 |
| 10020055 | 参数有误 | 检查请求参数格式 |
| 10020080 | 提交的资质数量超出限制 | 减少资质文件数量至限制范围内 |
| 10020081 | 品牌的申请记录不存在，请调用新增品牌接口 | 确认 brand_id 是否正确 |
| 10020084 | 品牌名称与品牌库 ID 不匹配 | 确认 ch_name / en_name 与 brand_id 对应的品牌库信息一致 |
| 10020085 | 该品牌申请正在审核中，请不要重复提交 | 先调用 [API] 撤回品牌资质审核 / cancelauditbrandlogic 接口后再提交 |
| 10020086 | 品牌资质文件的 file_id 无效 | 重新调用 [API] 上传资质图片 / qualificationupload 接口获取有效 file_id |
| 10020602 | 品牌授权类型错误 | 检查 grant_type 取值 |
| 10020603 | 品牌商标类型错误 | 检查 trade_mark_symbol 取值 |
| 10020604 | 品牌状态错误 | |
| 10020605 | 品牌授权等级错误 | 检查 grant_details.grant_level 取值范围 1-3 |
| 10020606 | 品牌不支持非 R 标 | 该品牌仅支持 R 标资质 |
| 10020607 | 品牌商标注册号错误 | 检查 register_details.register_no |
| 10020608 | 品牌授权信息错误 | 检查 grant_details 授权信息 |
| 10020609 | 品牌商标分类号错误 | 检查 classification_no 取值范围 1-45 |
| 10020610 | 品牌申请已存在 | 该品牌已有申请记录，请改用 [API] 更新品牌资质 / updatebrandlogic |
| 10020611 | 已存在相同品牌入库中 |
# 7. 适用范围
本接口在不同账号类型下的可调用情况：
| 微信小店 | 小店供货商 |
|---|---|
| ✔ | ✔ |
- ✔：该账号可调用此接口。
- 其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。