# 获取所有类目

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

接口英文名:getallcategory

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

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

# 新旧类目树差异

  • 旧类目树为固定的三级类目结构,如“酒类(7339) -- 洋酒(7344) -- 国产白兰地(545301)”。 新类目树为多级类目结构,不再固定三级,如“酒类(10000201) -- 洋酒(10000204) -- 白兰地/干邑(10000454) -- 国产白兰地(545301)”。
  • 对于叶子类目(也称品类),在新旧类目树中,都是一一映射的,也就是说,在旧类目树中的叶子类目,必定在新类目树中也会存在一个一摸一样的叶子类目,名称和ID都是相同的;对于非叶子类目,在新旧类目树中,不存在任何映射关系。
  • 目前小店B端、C端都已更换为新类目树,API调用仍同时兼容新旧类目树,请开发者尽快迁移到新类目树开发。

# 1. 调用方式

# HTTPS 调用

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

# 云调用

  • 调用方法:channels.ec.category.all

  • 出入参和 HTTPS 调用相同,调用方式可查看 云调用 说明文档

# 第三方调用

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

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

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

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_tokenauthorizer_access_token

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
catsobjarray旧类目信息
cats_v2objarray新类目信息

# Res.cats(Array) Object Payload

旧类目信息

参数名类型说明
cat_and_quaobjarray类目数据

# Res.cats_v2(Array) Object Payload

新类目信息

参数名类型说明
cat_and_quaobjarray类目数据

# Res.cats(Array).cat_and_quaObject Payload

类目数据

参数名类型说明
catobject类目详情
quaobject资质详情
product_quaobject商品资质信息,将废弃,使用product_qua_list代替
brand_quaobject品牌资质信息
product_qua_listobjarray商品资质列表,替代product_qua
is_confidence_require_bad_must_payboolean放心买必须打开坏损包赔

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

类目详情

参数名类型说明
cat_idnumber类目ID
namestring类目名称
f_cat_idnumber父类目ID
levelnumber类目等级

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

资质详情

参数名类型说明
qua_idnumber资质ID
need_to_applyboolean该类目是否需要申请才能用
tipsstring资质信息
mandatoryboolean该类目申请的时候是否一定要提交资质
cert_group_listobjarray证照信息

# Res.cats(Array).cat_and_qua.qua.cert_group_listObject Payload

证照信息

参数名类型说明
license_group_idnumber证照组id,证照组内的证照选一个填写提交即可
is_necessarynumber是否必填
busi_license_descstring证照组说明
license_listobjarray证照列表

# Res.cats(Array).cat_and_qua.qua.cert_group_list.license_listObject Payload

证照列表

参数名类型说明
idnumber证照id
namestring证照名称
is_necessarynumber是否必填
license_field_listobjarray填写字段

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

填写字段

参数名类型说明
field_keystring填写字段类型,详见field_key枚举
field_namestring填写字段名称
infostring字段正则要求
is_necessarynumber是否必填

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

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

参数名类型说明
qua_idnumber资质ID
need_to_applyboolean该类目是否需要申请才能用
tipsstring资质信息
mandatoryboolean申请此类目时是否必须提交资质证明

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

品牌资质信息

参数名类型说明
qua_idnumber资质ID
need_to_applyboolean申请此类目时是否必须提交资质证明
tipsstring资质信息
mandatoryboolean申请此类目时是否必须提交资质证明

# Res.cats(Array).cat_and_qua.product_qua_listObject Payload

商品资质列表,替代product_qua

参数名类型说明
qua_idnumber资质ID
need_to_applyboolean该类目是否需要申请才能用
tipsstring资质的描述信息
mandatoryboolean申请此类目时是否必须提交资质证明
namestring资质名称

# Res.cats_v2(Array).cat_and_quaObject Payload

类目数据

参数名类型说明
catobject类目详情
quaobject资质详情
product_quaobject商品资质信息,将废弃,使用product_qua_list代替
brand_quaobject品牌资质信息
product_qua_listobjarray商品资质列表,替代product_qua
is_confidence_require_bad_must_payboolean放心买必须打开坏损包赔

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

类目详情

参数名类型说明
cat_idnumber类目ID
namestring类目名称
f_cat_idnumber父类目ID
levelnumber类目等级
leafboolean是否为叶子类目(品类)

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

资质详情

参数名类型说明
qua_idnumber资质ID
need_to_applyboolean该类目是否需要申请才能用
tipsstring资质信息
mandatoryboolean该类目申请的时候是否一定要提交资质

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

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

参数名类型说明
qua_idnumber资质ID
need_to_applyboolean该类目是否需要申请才能用
tipsstring资质信息
mandatoryboolean申请此类目时是否必须提交资质证明

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

品牌资质信息

参数名类型说明
qua_idnumber资质ID
need_to_applyboolean申请此类目时是否必须提交资质证明
tipsstring资质信息
mandatoryboolean申请此类目时是否必须提交资质证明

# Res.cats_v2(Array).cat_and_qua.product_qua_listObject Payload

商品资质列表,替代product_qua

参数名类型说明
qua_idnumber资质ID
need_to_applyboolean该类目是否需要申请才能用
tipsstring资质的描述信息
mandatoryboolean申请此类目时是否必须提交资质证明
namestring资质名称

# 4. 注意事项

field_key枚举

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

# 5. 代码示例

请求示例

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

返回示例

{
    "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. 错误码

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

错误码错误描述解决方案
9401020非法参数非法参数

# 7. 适用范围

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