# 上传类目资质

# 接口说明

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

# 注意事项

  • 请求成功后将会创建一个审核单,单号将在返回参数中给出;
  • 审核完成后会进行回调,告知审核结果;
  • 使用到资质图片的地方,必须使用 file_id通过上传图片接口获取,即上传图片资质(https://api.weixin.qq.com/channels/ec/basics/qualification/upload?access_token=ACCESS_TOKEN);
  • 普通类目只需要传certificate信息,如果是定向准入类目,还需要传一些附加信息。

启用新多级类目树提示:旧的类目树固定为三级类目结构,新的类目树为多级类目结构,过渡期间,新旧类目树兼容使用,请开发者尽快切换到新多级类目树。其中差异请参阅“新旧类目树差异”。 此接口新增 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 string(uint64) 一级类目ID
category_info.level2 string(uint64) 二级类目ID
category_info.level3 string(uint64) 三级类目ID
category_info.cats_v2[].cat_id uint64 新类目树类目ID
category_info.certificate string array 资质材料,图片fileid,图片类型,最多不超过10张
category_info.baobeihan string array 报备函,图片fileid,图片类型,最多不超过10张
category_info.jingyingzhengming string array 经营证明,图片fileid,图片类型,最多不超过10张
category_info.daihuokoubei string array 带货口碑,图片fileid,图片类型,最多不超过10张
category_info.ruzhuzhizhi string array 入住资质,图片fileid,图片类型,最多不超过10张
category_info.jingyingliushui string array 经营流水,图片fileid,图片类型,最多不超过10张
category_info.buchongcailiao string array 补充材料,图片fileid,图片类型,最多不超过10张
category_info.jingyingpingtai string 经营平台,仅支持taobao,jd,douyin,kuaishou,pdd,other这些取值
category_info.zhanghaomingcheng string 账号名称
category_info.brand_list object array 品牌列表,获取类目信息中的attr.is_limit_brand为true时必传
category_info.brand_list[].brand_id string(uint64) 品牌ID,是店铺申请且已审核通过的品牌ID

# 请求参数示例

{
    "category_info": {
        //"level1": 7419,
        //"level2": 7439,
        //"level3": 7448,
        "cats_v2":[
          {
            "cat_id": 6033
          },
          {
            "cat_id": 6057
          },
          {
            "cat_id": 6091
          },
          {
            "cat_id": 6093
          }
        ],
        "certificate": [
            "THE_FILE_ID_1",
            "THE_FILE_ID_2"
        ],
        "brand_list" : [
            { "brand_id": 1001 },
            { "brand_id": 1002 }
        ]
    }
}

# 返回参数说明

参数 类型 描述
errcode number 错误码
errmsg string 错误信息
audit_id string(uint64) 审核单id

# 返回参数示例

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

# 错误码

错误码 错误描述
公共错误码 -
10020062 资质材料超限,最多不能超过10张
10020063 不合法的类目ID
10020064 该类目审核中,无需重复提交
10020087 不合法的fileid
10020094 必须使用上传资质接口获取fileid
10020232 当前填写的经营品牌,其品牌力不满足准入要求
10020233 当前填写的经营品牌,平台正在对其进行品牌力评定,请稍后再发起类目申请