# 获取品牌资质申请详情
接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南
接口英文名：getbrandlogic
通过该接口可以获取品牌资质申请详情
相关事件通知：品牌资质事件通知
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/brand/get?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用
# 第三方调用
本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为：85、129
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证，可使用 access_token、authorizer_access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| brand_id | string | 是 | 10000531 | 品牌库中的品牌编号 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| brand | object | 品牌资质申请信息 |
# Res.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 | 品牌信息 |
| status | number | 申请单状态，枚举值详情可参考下文status |
| create_time | number | 创建时间 |
| update_time | number | 更新时间 |
| audit_result | object | 审核结果 |
# Res.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张, 需要先调用上传资质图片接口上传资质图片 |
| renew_certifications | array | 变更/续展证明的file_id, 限制最多传5张, 需要先调用上传资质图片接口上传资质图片 |
# Res.brand.application_details Object Payload
申请信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| acceptance_time | number | 商标申请受理时间, TM标时必填 |
| acceptance_certification | array | 商标注册申请受理书file_id, TM标时必填, 限制最多传1张，需要先调用上传资质图片接口上传资质图片 |
| acceptance_no | string | 商标申请号, TM标时必填 |
# Res.brand.grant_details Object Payload
品牌信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| grant_certifications | array | 品牌销售授权书的file_id, 授权品牌必填, 限制最多传9张, 需要先调用上传资质图片接口上传资质图片 |
| grant_level | number | 授权级数, 授权品牌必填, 取值1-3 |
| start_time | number | (旧结构)授权有效期, 开始时间, 长期有效可不填 |
| end_time | number | (旧结构)授权有效期, 结束时间, 长期有效可不填 |
| is_permanent | boolean | (旧结构)是否长期有效 |
| brand_owner_id_photos | array | 品牌权利人证件照的file_id, 限制最多传2张, 需要先调用上传资质图片接口上传资质图片 |
| use_split_grant_info | number | 是否使用分级授权书结构，大于0即使用。如果使用分级结构，也会兼容填充到旧结构 |
| grant_info_lv1 | object | 一级结构 |
| grant_info_lv2 | object | 二级结构 |
| grant_info_lv3 | object | 三级结构 |
| contact_info_list | objarray | 联系方式 |
# Res.brand.grant_details.grant_info_lv1 Object Payload
一级结构
| 参数名 | 类型 | 说明 |
|---|---|---|
| grant_certifications | array | (分级结构)品牌销售授权书的file_id, 多于一级授权时必填, 需要先调用上传资质图片接口上传资质图片 |
| start_time | number | (分级结构)授权有效期, 开始时间, 长期有效可不填 |
| end_time | number | (分级结构)授权有效期, 结束时间, 长期有效可不填 |
| is_permanent | boolean | (分级结构)是否长期有效 |
# Res.brand.grant_details.grant_info_lv2 Object Payload
二级结构
| 参数名 | 类型 | 说明 |
|---|---|---|
| grant_certifications | array | (分级结构)品牌销售授权书的file_id, 多于一级授权时必填, 需要先调用上传资质图片接口上传资质图片 |
| start_time | number | (分级结构)授权有效期, 开始时间, 长期有效可不填 |
| end_time | number | (分级结构)授权有效期, 结束时间, 长期有效可不填 |
| is_permanent | boolean | (分级结构)是否长期有效 |
# Res.brand.grant_details.grant_info_lv3 Object Payload
三级结构
| 参数名 | 类型 | 说明 |
|---|---|---|
| grant_certifications | array | (分级结构)品牌销售授权书的file_id, 多于一级授权时必填, 需要先调用上传资质图片接口上传资质图片 |
| start_time | number | (分级结构)授权有效期, 开始时间, 长期有效可不填 |
| end_time | number | (分级结构)授权有效期, 结束时间, 长期有效可不填 |
| is_permanent | boolean | (分级结构)是否长期有效 |
# Res.brand.grant_details.contact_info_list(Array) Object Payload
联系方式
| 参数名 | 类型 | 说明 |
|---|---|---|
| key | string | 联系方式key |
| value | string | 联系方式value |
# Res.brand.audit_result Object Payload
审核结果
| 参数名 | 类型 | 说明 |
|---|---|---|
| audit_id | number | 提审的审核单ID |
| reject_reason | string | 审核不通过的原因, 审核成功不返回 |
# 4. 注意事项
该接口返回的资质文件为file_id格式，开发者需自己维护file_id和文件的映射关系。
status 申请单状态
| 枚举值 | 描述 |
|---|---|
| 1 | 审核中 |
| 2 | 审核失败 |
| 3 | 已生效 |
| 4 | 已撤回 |
| 5 | 即将过期(不影响商品售卖) |
| 6 | 已过期 |
# 5. 代码示例
请求示例
{
"brand_id": "10000531"
}
返回示例
"errcode": 0,
"errmsg": "ok",
"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"
]
},
"status": 1,
"create_time": 1667191896,
"update_time": 1667191937
}
}
# 6. 错误码
以下是本接口的错误码列表，其他错误码可参考 通用错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 10020050 | 无权限调用该api | |
| 10020055 | 参数有误 | |
| 10020081 | 品牌的申请记录不存在 |
# 7. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。