# 获取所有类目

> 接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考[接口调用指南](/doc/oplatform/developers/dev/guide.md)。

接口英文名：getallcategory

可通过该接口获取全部的类目信息、类目的资质信息、商品资质信息。 

此接口新增cats_v2字段支持新类目树，详见返回参数。新旧目录树差异请参阅 [新旧类目差异说明](/doc/store/shop/guide/catalog/old_and_new_categories)

## 1. 调用方式

### HTTPS 调用

```bash
POST https://api.weixin.qq.com/shop/ec/category/all?access_token=ACCESS_TOKEN
```

### 云调用

- 本接口不支持云调用。

### 第三方调用

- 本接口支持第三方平台代微信小店商家调用。[第三方服务商调用模式介绍](/doc/store/shop/dev_before/third_party_platforms)

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

- 服务商获得其中之一权限集授权后，可通过使用 [authorizer_access_token](/doc/oplatform/developers/dev/AuthorizerAccessToken.md) 代微信小店商家进行调用，具体可查看 [第三方调用](/doc/oplatform/Third-party_Platforms/2.0/Before_Develop/call_interface.md) 说明文档。

## 2. 请求参数

### 查询参数 `Query String Parameters`

```json
[
  {
    "参数名": "access_token",
    "类型": "string",
    "必填": "是",
    "示例": "ACCESS_TOKEN",
    "说明": "接口调用凭证，可使用 [access_token](/doc/store/shop/API/apimgnt/common/api_getaccesstoken)（微信小店商家）、[authorizer_access_token](/doc/oplatform/openApi/ticket-token/api_getauthorizeraccesstoken.md)（服务商代调用）"
  }
]
```

### 请求体 `Request Payload`

无

## 3. 返回参数

### 返回体 `Response Payload`

```json
[
  {
    "参数名": "errcode",
    "类型": "number",
    "说明": "错误码"
  },
  {
    "参数名": "errmsg",
    "类型": "string",
    "说明": "错误信息"
  },
  {
    "参数名": "cats",
    "类型": "objarray",
    "说明": "旧类目信息"
  },
  {
    "参数名": "cats_v2",
    "类型": "objarray",
    "说明": "新类目信息"
  }
]
```

">

### Res.cats(Array) `Object Payload`

旧类目信息

```json
[
  {
    "参数名": "cat_and_qua",
    "类型": "objarray",
    "说明": "类目数据"
  }
]
```

">

### Res.cats_v2(Array) `Object Payload`

新类目信息

```json
[
  {
    "参数名": "cat_and_qua",
    "类型": "objarray",
    "说明": "类目数据"
  }
]
```

__cat_and_qua">

### Res.cats(Array).cat_and_qua `Object Payload`

类目数据

```json
[
  {
    "参数名": "cat",
    "类型": "object",
    "说明": "类目详情"
  },
  {
    "参数名": "qua",
    "类型": "object",
    "说明": "资质详情"
  },
  {
    "参数名": "product_qua",
    "类型": "object",
    "说明": "商品资质信息，将废弃，使用product_qua_list代替"
  },
  {
    "参数名": "brand_qua",
    "类型": "object",
    "说明": "品牌资质信息"
  },
  {
    "参数名": "product_qua_list",
    "类型": "objarray",
    "说明": "商品资质列表，替代product_qua"
  },
  {
    "参数名": "is_confidence_require_bad_must_pay",
    "类型": "boolean",
    "说明": "放心买必须打开坏损包赔"
  }
]
```

__cat_and_qua__cat">

### Res.cats(Array).cat_and_qua.cat `Object Payload`

类目详情

```json
[
  {
    "参数名": "cat_id",
    "类型": "number",
    "说明": "类目ID"
  },
  {
    "参数名": "name",
    "类型": "string",
    "说明": "类目名称"
  },
  {
    "参数名": "f_cat_id",
    "类型": "number",
    "说明": "父类目ID"
  },
  {
    "参数名": "level",
    "类型": "number",
    "说明": "类目等级"
  }
]
```

__cat_and_qua__qua">

### Res.cats(Array).cat_and_qua.qua `Object Payload`

资质详情

```json
[
  {
    "参数名": "qua_id",
    "类型": "number",
    "说明": "资质ID"
  },
  {
    "参数名": "tips",
    "类型": "string",
    "说明": "资质信息"
  },
  {
    "参数名": "mandatory",
    "类型": "boolean",
    "说明": "该类目申请的时候是否一定要提交资质"
  },
  {
    "参数名": "cert_group_list",
    "类型": "objarray",
    "说明": "证照信息"
  }
]
```

__cat_and_qua__qua__cert_group_list">

### Res.cats(Array).cat_and_qua.qua.cert_group_list `Object Payload`

证照信息

```json
[
  {
    "参数名": "license_group_id",
    "类型": "number",
    "说明": "证照组id，证照组内的证照选一个填写提交即可"
  },
  {
    "参数名": "is_necessary",
    "类型": "number",
    "说明": "是否必填"
  },
  {
    "参数名": "busi_license_desc",
    "类型": "string",
    "说明": "证照组说明"
  },
  {
    "参数名": "license_list",
    "类型": "objarray",
    "说明": "证照列表"
  }
]
```

__cat_and_qua__qua__cert_group_list__license_list">

### Res.cats(Array).cat_and_qua.qua.cert_group_list.license_list `Object Payload`

证照列表

```json
[
  {
    "参数名": "id",
    "类型": "number",
    "说明": "证照id"
  },
  {
    "参数名": "name",
    "类型": "string",
    "说明": "证照名称"
  },
  {
    "参数名": "is_necessary",
    "类型": "number",
    "说明": "是否必填"
  },
  {
    "参数名": "license_field_list",
    "类型": "objarray",
    "说明": "填写字段"
  }
]
```

__cat_and_qua__qua__cert_group_list__license_list__license_field_list">

### Res.cats(Array).cat_and_qua.qua.cert_group_list.license_list.license_field_list `Object Payload`

填写字段

```json
[
  {
    "参数名": "field_key",
    "类型": "string",
    "说明": "填写字段类型，详见field_key枚举"
  },
  {
    "参数名": "field_name",
    "类型": "string",
    "说明": "填写字段名称"
  },
  {
    "参数名": "info",
    "类型": "string",
    "说明": "字段正则要求"
  },
  {
    "参数名": "is_necessary",
    "类型": "number",
    "说明": "是否必填"
  }
]
```

__cat_and_qua__product_qua">

### Res.cats(Array).cat_and_qua.product_qua `Object Payload`

商品资质信息，将废弃，使用product_qua_list代替

```json
[
  {
    "参数名": "qua_id",
    "类型": "number",
    "说明": "资质ID"
  },
  {
    "参数名": "need_to_apply",
    "类型": "boolean",
    "说明": "该类目是否需要申请才能用"
  },
  {
    "参数名": "tips",
    "类型": "string",
    "说明": "资质信息"
  },
  {
    "参数名": "mandatory",
    "类型": "boolean",
    "说明": "申请此类目时是否必须提交资质证明"
  }
]
```

__cat_and_qua__brand_qua">

### Res.cats(Array).cat_and_qua.brand_qua `Object Payload`

品牌资质信息

```json
[
  {
    "参数名": "qua_id",
    "类型": "number",
    "说明": "资质ID"
  },
  {
    "参数名": "need_to_apply",
    "类型": "boolean",
    "说明": "申请此类目时是否必须提交资质证明"
  },
  {
    "参数名": "tips",
    "类型": "string",
    "说明": "资质信息"
  },
  {
    "参数名": "mandatory",
    "类型": "boolean",
    "说明": "申请此类目时是否必须提交资质证明"
  }
]
```

__cat_and_qua__product_qua_list">

### Res.cats(Array).cat_and_qua.product_qua_list `Object Payload`

商品资质列表，替代product_qua

```json
[
  {
    "参数名": "qua_id",
    "类型": "number",
    "说明": "资质ID"
  },
  {
    "参数名": "need_to_apply",
    "类型": "boolean",
    "说明": "该类目是否需要申请才能用"
  },
  {
    "参数名": "tips",
    "类型": "string",
    "说明": "资质的描述信息"
  },
  {
    "参数名": "mandatory",
    "类型": "boolean",
    "说明": "申请此类目时是否必须提交资质证明"
  },
  {
    "参数名": "name",
    "类型": "string",
    "说明": "资质名称"
  }
]
```

__cat_and_qua">

### Res.cats_v2(Array).cat_and_qua `Object Payload`

类目数据

```json
[
  {
    "参数名": "cat",
    "类型": "object",
    "说明": "类目详情"
  },
  {
    "参数名": "qua",
    "类型": "object",
    "说明": "资质详情"
  },
  {
    "参数名": "product_qua",
    "类型": "object",
    "说明": "商品资质信息，将废弃，使用product_qua_list代替"
  },
  {
    "参数名": "brand_qua",
    "类型": "object",
    "说明": "品牌资质信息"
  },
  {
    "参数名": "product_qua_list",
    "类型": "objarray",
    "说明": "商品资质列表，替代product_qua"
  },
  {
    "参数名": "is_confidence_require_bad_must_pay",
    "类型": "boolean",
    "说明": "放心买必须打开坏损包赔"
  }
]
```

__cat_and_qua__cat">

### Res.cats_v2(Array).cat_and_qua.cat `Object Payload`

类目详情

```json
[
  {
    "参数名": "cat_id",
    "类型": "number",
    "说明": "类目ID"
  },
  {
    "参数名": "name",
    "类型": "string",
    "说明": "类目名称"
  },
  {
    "参数名": "f_cat_id",
    "类型": "number",
    "说明": "父类目ID"
  },
  {
    "参数名": "level",
    "类型": "number",
    "说明": "类目等级"
  },
  {
    "参数名": "leaf",
    "类型": "boolean",
    "说明": "是否为叶子类目（品类）"
  }
]
```

__cat_and_qua__qua">

### Res.cats_v2(Array).cat_and_qua.qua `Object Payload`

资质详情

```json
[
  {
    "参数名": "qua_id",
    "类型": "number",
    "说明": "资质ID"
  },
  {
    "参数名": "need_to_apply",
    "类型": "boolean",
    "说明": "该类目是否需要申请才能用"
  },
  {
    "参数名": "tips",
    "类型": "string",
    "说明": "资质信息"
  },
  {
    "参数名": "mandatory",
    "类型": "boolean",
    "说明": "该类目申请的时候是否一定要提交资质"
  }
]
```

__cat_and_qua__product_qua">

### Res.cats_v2(Array).cat_and_qua.product_qua `Object Payload`

商品资质信息，将废弃，使用product_qua_list代替

```json
[
  {
    "参数名": "qua_id",
    "类型": "number",
    "说明": "资质ID"
  },
  {
    "参数名": "need_to_apply",
    "类型": "boolean",
    "说明": "该类目是否需要申请才能用"
  },
  {
    "参数名": "tips",
    "类型": "string",
    "说明": "资质信息"
  },
  {
    "参数名": "mandatory",
    "类型": "boolean",
    "说明": "申请此类目时是否必须提交资质证明"
  }
]
```

__cat_and_qua__brand_qua">

### Res.cats_v2(Array).cat_and_qua.brand_qua `Object Payload`

品牌资质信息

```json
[
  {
    "参数名": "qua_id",
    "类型": "number",
    "说明": "资质ID"
  },
  {
    "参数名": "need_to_apply",
    "类型": "boolean",
    "说明": "申请此类目时是否必须提交资质证明"
  },
  {
    "参数名": "tips",
    "类型": "string",
    "说明": "资质信息"
  },
  {
    "参数名": "mandatory",
    "类型": "boolean",
    "说明": "申请此类目时是否必须提交资质证明"
  }
]
```

__cat_and_qua__product_qua_list">

### Res.cats_v2(Array).cat_and_qua.product_qua_list `Object Payload`

商品资质列表，替代product_qua

```json
[
  {
    "参数名": "qua_id",
    "类型": "number",
    "说明": "资质ID"
  },
  {
    "参数名": "need_to_apply",
    "类型": "boolean",
    "说明": "该类目是否需要申请才能用"
  },
  {
    "参数名": "tips",
    "类型": "string",
    "说明": "资质的描述信息"
  },
  {
    "参数名": "mandatory",
    "类型": "boolean",
    "说明": "申请此类目时是否必须提交资质证明"
  },
  {
    "参数名": "name",
    "类型": "string",
    "说明": "资质名称"
  }
]
```

## 4. 注意事项

field_key枚举

``` json
[
    {
        "name": "许可证编号",
        "key": "audit_license_no"
    },
    {
        "name": "备案编号",
        "key": "audit_license_registration_no"
    },
    {
        "name": "有效期",
        "key": "audit_license_validty_period"
    }
]
```

## 5. 代码示例

请求示例

``` bash
GET https://api.weixin.qq.com/shop/ec/category/all?access_token=ACCESS_TOKEN
```

返回示例

``` json
{
    "errcode": 0,
    "errmsg": "ok",
    "cats": [
        {
            "cat_and_qua": [
                {
                    "cat": {
                        "cat_id": "1003",
                        "name": "假牙清洁",
                        "f_cat_id": "1002",
                        "level": 3
                    },
                    "qua": {
                        "qua_id": "xxx",
                        "need_to_apply": true,
                        "tips": "",
                        "mandatory": true
                    },
                    "product_qua": {
                        "qua_id": "xxx",
                        "need_to_apply": true,
                        "tips": "",
                        "mandatory": true
                    },
                    "brand_qua": {
                        "qua_id": "xxx",
                        "need_to_apply": true,
                        "tips": "",
                        "mandatory": true
                    },
                    "product_qua_list": [
                        {
                            "qua_id": "1111487",
                            "need_to_apply": true,
                            "tips": "若涉及名人或大师作品，可提供作品授权证明/大师资质证明",
                            "mandatory": true,
                            "name": "作品授权证明/大师资质证明"
                        },
                        {
                            "qua_id": "1111488",
                            "need_to_apply": true,
                            "tips": "若涉及名人或大师作品，可提供鉴定证书",
                            "mandatory": false,
                            "name": "鉴定证书"
                        },
                        {
                            "qua_id": "1111489",
                            "need_to_apply": true,
                            "tips": "若涉及名人或大师作品，可提供收藏证书",
                            "mandatory": false,
                            "name": "收藏证书"
                        }
                    ]
                },
                {
                    "cat": {
                        "cat_id": "1002",
                        "name": "口腔护理",
                        "f_cat_id": "1001",
                        "level": 2
                    }
                },
                {
                    "cat": {
                        "cat_id": "1001",
                        "name": "个人护理",
                        "f_cat_id": "0",
                        "level": 1
                    }
                }
            ]
        }
    ],
    "cats_v2": [
        {
            "cat_and_qua": [
                {
                    "cat": {
                        "cat_id": "545709",
                        "name": "公路电子收费/ETC/OBU",
                        "f_cat_id": "10000131",
                        "level": 3,
                        "leaf": true
                    },
                    "qua": {
                        "qua_id": "1111608",
                        "need_to_apply": true,
                        "tips": "1、主体要求\n（1）入驻主体类型仅限于企业。\n（2）开店主体公司注册资本不低于100万，注册时间不少于1年。\n\n2、行业资质\n（1）交通运输部指定全国各省份的ETC发行机构或合作机构。需提交交通部或交通厅关于ETC发行服务机构的信息公开单位证明截图，或同等效力的证明材料；参考示例：《证明材料示例》https://docs.qq.com/doc/DVXBuUHpPSFdmYmJW\n（2）需提交关于合法合规经营产品的承诺函。承诺函模板：https://docs.qq.com/doc/p/68313cd4ca24c6f0577d5ed3578c906ae9d67c91",
                        "mandatory": true
                    },
                    "brand_qua": {
                        "qua_id": "1111609",
                        "need_to_apply": true,
                        "tips": "1、属于品牌商标权利人/一级授权经销商。\n2、品牌须在京东有开设自营旗舰店/自营官方旗舰店或在天猫有开设官方旗舰店店铺；\n3、品牌须在在京东开设的自营旗舰店/自营官方旗舰店或在天猫开设的官方旗舰店店铺主营类目需和申请视频号橱窗定向准入的类目一致，请提供相应截图。\n4、品牌商标注册证需包含所申请范围",
                        "mandatory": true
                    },
                    "product_qua_list": [

                    ]
                },
                {
                    "cat": {
                        "cat_id": "10000131",
                        "name": "车载电器",
                        "f_cat_id": "10000126",
                        "level": 2,
                        "leaf": false
                    },
                    "product_qua_list": [

                    ]
                },
                {
                    "cat": {
                        "cat_id": "10000126",
                        "name": "汽车",
                        "f_cat_id": "0",
                        "level": 1,
                        "leaf": false
                    },
                    "product_qua_list": [

                    ]
                }
            ]
        }
    ]
}
```

## 6. 错误码

以下是本接口的错误码列表，其他错误码可参考 [通用错误码](/doc/store/shop/dev_before/commErrCode)；调用接口遇到报错，可使用官方提供的 [API 诊断工具](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_errcode) 辅助定位和分析问题。

```json
[
  {
    "错误码": "9401020",
    "错误描述": "非法参数",
    "解决方案": "非法参数"
  }
]
```

## 7. 适用范围

本接口在不同账号类型下的可调用情况：

```json
[
  {
    "微信小店": "✔",
    "小店供货商": "✔"
  }
]
```

- ✔：该账号可调用此接口。
- 其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。

![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)接口变更日志（2条）
2026 年 09 月 15 日HTTPS 调用由「GET」改为「POST」
2026 年 04 月 08 日去除类目申请的need_to_apply字段