# 申请类目

# 接口说明

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

# 注意事项

• 请求成功后将会创建一个审核单，单号将在返回参数中给出；
• 审核完成后会进行回调，告知审核结果；
• 使用到图片的地方，必须使用 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提交。
  • 每个类目会有几个证照组要求，商家需提交所有证照组的资料；每个证照组内，会有多个证照要求，商家只需要选择一个证照提交资料即可。
  • 类目的证照组要求，在获取所有类目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 级类目（即最后一级叶子类目）。

# 接口调用请求说明

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

# 请求参数说明

# 请求参数示例

{
    "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"
}

# 错误码