# 获取品牌资质申请详情
接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。
接口英文名：getbrandlogic
通过该接口可以获取指定品牌资质申请单的详情。
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/brand/get?access_token=ACCESS_TOKEN
# 云调用
调用方法：channels.ec.brand.get
出入参和 HTTPS 调用相同，调用方式可查看 云调用 说明文档。
# 第三方调用
本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为：85、129、192
服务商获得其中之一权限集授权后，可通过使用 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 | 0 | 错误码 |
| errmsg | string | ok | 错误信息 |
| 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 | 品牌资质申请单状态 | 枚举值 |
| create_time | number | 创建时间 | - |
| update_time | number | 更新时间 | - |
| audit_result | object | 审核结果 | - |
# Res.brand.register_details Object Payload
注册信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| registrant | string | 商标注册人 |
| register_no | string | 商标注册号 |
| start_time | number | 商标注册有效期开始时间 |
| end_time | number | 商标注册有效期结束时间 |
| is_permanent | boolean | 是否长期有效 |
| register_certifications | array | 商标注册证的 file_id |
| renew_certifications | array | 变更 / 续展证明的 file_id |
# Res.brand.application_details Object Payload
申请信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| acceptance_time | number | 商标申请受理时间 |
| acceptance_certification | array | 商标注册申请受理书 file_id |
| acceptance_no | string | 商标申请号 |
# Res.brand.grant_details Object Payload
品牌信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| grant_certifications | array | （旧结构）品牌销售授权书的 file_id |
| grant_level | number | 授权级数，取值 1-3 |
| start_time | number | （旧结构）授权有效期开始时间 |
| end_time | number | （旧结构）授权有效期结束时间 |
| is_permanent | boolean | （旧结构）是否长期有效 |
| brand_owner_id_photos | array | 品牌权利人证件照的 file_id |
| 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 | 联系方式类型，如联系电话 |
| value | string | 联系方式内容 |
# Res.brand.audit_result Object Payload
审核结果
| 参数名 | 类型 | 说明 |
|---|---|---|
| audit_id | number | 审核单 ID |
| reject_reason | string | 审核不通过原因 |
# 4. 枚举信息
# Res.brand.status Enum
品牌资质申请单状态
| 枚举值 | 描述 |
|---|---|
| 1 | 审核中 |
| 2 | 审核失败 |
| 3 | 已生效 |
| 4 | 已撤回 |
| 5 | 即将过期(不影响商品售卖) |
| 6 | 已过期 |
# 5. 注意事项
- 该接口返回的资质文件为 file_id 格式，开发者需自己维护 file_id 和文件的映射关系；
- 审核失败时可通过 audit_result.reject_reason 查看不通过原因。
# 6. 代码示例
请求示例
{
"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": 3,
"create_time": 1667191896,
"update_time": 1667191937,
"audit_result": {
"audit_id": 12345678,
"reject_reason": ""
}
}
}
# 7. 错误码
以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 10020050 | 无权限调用该 api | 检查 access_token 与权限集授权 |
| 10020055 | 参数有误 | 检查请求参数格式 |
| 10020081 | 品牌的申请记录不存在，请调用新增品牌接口 | 确认 brand_id 是否正确 |
# 8. 适用范围
本接口在不同账号类型下的可调用情况：
| 微信小店 | 小店供货商 |
|---|---|
| ✔ | ✔ |
- ✔：该账号可调用此接口。
- 其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。