# 申请类目

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

接口英文名：addcategory

可通过该接口上传类目资质

相关事件通知：类目审核结果通知

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/category/add?access_token=ACCESS_TOKEN

# 云调用

• 本接口不支持云调用

# 第三方调用

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

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

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

# 2. 请求参数

# 查询参数 Query String parameters

# 请求体 Request Payload

# Body.category_info Object Payload

category_info

# Body.category_info.cats_v2(Array) Object Payload

类目树

# Body.category_info.brand_list(Array) Object Payload

品牌列表，获取类目信息中的attr.is_limit_brand为true时必传

# Body.category_info.license_group_list(Array) Object Payload

证照组

# Body.category_info.license_group_list(Array).license Object Payload

证照信息

# Body.category_info.license_group_list(Array).license.license_field_listObject Payload

证照详情

# 3. 返回参数

# 返回体 Response Payload

# 4. 注意事项

• 请求成功后将会创建一个审核单，单号将在返回参数中给出； -审核完成后会进行回调，告知审核结果； -使用到图片的地方，必须使用 file_id通过上传图片接口获取，即上传图片资质(https://api.weixin.qq.com/channels/ec/basics/qualification/upload?access_token=ACCESS_TOKEN)；
• is_new_apply_cat请设置为true，并且使用证照组license_group_list提交资料，不再使用certificate提交。 1、每个类目会有几个证照组要求，商家需提交所有证照组的资料；每个证照组内，会有多个证照要求，商家只需要选择一个证照提交资料即可。 2、类目的证照组要求，在获取所有类目API里获取。 **平台已启用证照组license_group_list要求提交，过渡期内，将兼容旧资质certificate提交，当is_new_apply_cat不存在或为false时，视为旧资质certificate提交，为true时，视为证照组license_group_list提交，请开发者尽快改造。

启用新多级类目树提示：旧的类目树固定为三级类目结构，新的类目树为多级类目结构，过渡期间，新旧类目树兼容使用，请开发者尽快切换到新多级类目树。其中差异请参阅“新旧类目树差异”。 此接口新增 cats_v2 字段支持新类目树，详见参数。**

• 如果商户设置了 cats_v2 的信息，会优先读取 cats_v2，作为类目信息，说明商户请求使用新的类目结构（多级类目结构）。
• 如果商户未设置 cats_v2 字段，使用 level1 / level2 / levle3 作为类目信息，说明商户请求使用旧的类目结构（三级类目结构）。
• cats_v2 字段填写类目信息（与 level1 / level2 / levle3 字段同级），顺序与一，二，三，...，N 级类目严格一致，即数组下标为 0 的是一级类目，数组下标为 1 的是二级类目，数组下标 length - 1 的是 N 级类目（即最后一级叶子类目）。

# 5. 代码示例

请求示例

{
    "category_info": {
        //"level1": 7419,
        //"level2": 7439,
        //"level3": 7448,
        "cats_v2":[
          {
            "cat_id": 6033
          },
          {
            "cat_id": 6057
          },
          {
            "cat_id": 6091
          },
          {
            "cat_id": 6093
          }
        ],
        "is_new_apply_cat": true, // 兼容期间，需设置为 true
        "license_group_list": [{ // 新的资质证照列表
          "license_group_id": "", // 证照组id
          "license": {
            "license_id": "", // 	证照id
            "file_id_list": ["THE_FILE_ID_1"],
            "license_field_list": [{
                "key": "",
                "value": ""
            }]
          }
        }],
        "brand_list" : [
            { "brand_id": 1001 }
        ]
    }
}

返回示例

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

# 6. 错误码

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

# 7. 适用范围

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