# 类目管理

# 开发前准备

• 权限与凭证：商家自研可直接调用，使用小店 access_token；第三方服务商需获得商家对权限集 ID：85或权限集 ID：129的授权，使用 authorizer_access_token
• 消息推送配置：需配置消息推送回调 URL，本模块涉及的事件：[事件] 类目审核结果通知 / product_category_audit。详见 消息通知（回调）说明

# 核心概念

类目管理模块的核心围绕三个实体：

• 类目（Category）：微信小店的商品分类体系，采用多级树状结构。目前存在新版类目树（cats_v2）和旧版类目树（cats）两套体系，新版中使用 cat_id 标识叶子类目（品类）
• 类目资质（Qualification）：部分类目需要商家提交经营资质后才能获得售卖权限，资质包含证照组、品牌等材料
• 审核单（Audit）：商家通过 [API] 申请类目 / addcategory 提交类目申请后，平台会创建审核单并返回 audit_id，商家可查询审核进度或撤销审核

新旧类目树差异：目前小店后台（B 端）和前台（C 端）已全部切换为新类目树，API 调用仍同时兼容新旧类目树，但建议尽快切换到新版。详见 新旧类目差异说明。

涉及的 API：[API] 获取所有类目 / getallcategory 同时返回 cats 和 cats_v2 两个字段；[API] 申请类目 / addcategory 推荐使用 cats_v2 参数而非旧版 level1/level2/level3。

# 接入流程

# 1. 查询类目体系

商家接入类目管理的第一步是获取完整的类目树，了解可经营的品类范围和对应的资质要求。

• [API] 获取所有类目 / getallcategory：返回完整类目树，包含每个类目的资质要求（qua）、品牌资质（brand_qua）和商品资质（product_qua_list）。cats_v2 字段中 leaf=true 的节点即为叶子类目（品类）
• [API] 获取类目信息 / getcategorydetail：传入叶子类目 cat_id，获取该类目的详细属性规则，包括保证金（deposit）、产品属性（product_attr_list）、销售属性（sale_attr_list）、佣金比例（transactionfee_info）、尺码表（size_chart）等

# 2. 申请类目权限

确定目标类目后，商家需提交申请才能上架该类目的商品。部分类目需要提交资质材料，经平台审核通过后才能获得权限；大部分类目申请后免审快速通过。

• [API] 申请类目 / addcategory：提交类目资质申请。推荐使用新版证照组模式（设置 is_new_apply_cat=true，传 cats_v2 + license_group_list）。成功后返回 audit_id
• [事件] 类目审核结果通知 / product_category_audit：审核完成后，平台通过回调通知审核结果（status=3 通过，status=2 驳回）。驳回时 reason 字段包含具体原因

# 3. 审核单管理

提交类目申请后，可通过以下接口跟踪审核进度。

• [API] 获取店铺的类目审核单列表 / getbizcatflowlist：分页查询审核单列表，支持按状态过滤（1=审核中、2=驳回、3=成功、4=已取消）
• [API] 获取店铺的类目审核单详情 / getbizcatflowdetail：通过 audit_id 查询审核单详情，包含提交的材料信息和驳回原因
• [API] 撤销类目审核 / cancelauditcategory：通过 audit_id 撤销正在审核中的申请单

# 4. 类目权限查询

审核通过后，商家可随时查询已获得的类目权限状态。类目权限可能因平台调整而失效（如类目下线、拆分等）。

• [API] 获取店铺的类目权限列表 / getcategoryrelationlist：查询店铺当前拥有的所有类目权限，支持按状态过滤（1=生效中、2=已失效）
• [API] 获取店铺的类目权限详情 / getcategoryrelationdetail：通过 category_id 查询单个类目的权限详情，包含审核材料、生效/失效时间和失效原因

# 5. 查询类目规则

获得类目权限后，发品前还需了解该类目的经营规则：保证金要求、支持的发货方式、商品发布属性规则等。

• [API] 获取保证金类目规则 / get_category_rule：查询指定类目的保证金金额（deposit，单位分）。请求时 rule_id 固定填 1
• [API] 获取发货方式类目规则 / get_delivery_method_category_rule：查询指定类目支持的发货方式（快递、卡券类、同城配送等）。请求时 rule_id 固定填 2
• [API] 获取类目下商品发布规则 / getcategoryproductrule：查询指定类目的商品发布规则，包括产品属性（product_attr_list）、销售属性（sale_attr_list）、资质要求（product_qua_list）、价格下限（floor_price）、尺码表（size_chart）、预售规则（presale_rule）等。支持通过 release_mode 区分普通模式和极简模式

# 接口全览

# API 接口

# 事件通知

# 全量接口文档

• 类目管理 API 接口列表：https://developers.weixin.qq.com/doc/store/shop/API/channels-shop-category/
• 类目规则 API 接口列表：https://developers.weixin.qq.com/doc/store/shop/API/category-rule/

# 相关运营文档

• 详见成长中心：微信小店「类目资质」使用指南

# 常见问题 FAQ

Q：类目权限为什么会突然失效？ A：平台会定期调整类目树结构（如类目合并、拆分、下线），原类目权限可能随之失效。通过 [API] 获取店铺的类目权限列表 / getcategoryrelationlist 可查看失效原因（uneffective_reason 字段），需按新类目重新申请。

Q：申请类目时品牌列表什么情况下必传？ A：当目标类目的 [API] 获取类目信息 / getcategorydetail 返回 attr.is_limit_brand=true 时，表示该类目为品牌定向准入，申请时必须传 brand_list（使用店铺已审核通过的品牌 ID）。