# 类目管理 ## 开发前准备 - **权限与凭证**：商家自研可直接调用，使用小店 access_token；第三方服务商需获得商家对`权限集 ID：85`或`权限集 ID：129`的授权，使用 authorizer_access_token - **消息推送配置**：需配置消息推送回调 URL，本模块涉及的事件：[事件] [类目审核结果通知 / product_category_audit](/doc/store/shop/notify/category_callback/ProductCategoryAudit)。详见 [消息通知（回调）说明](/doc/store/shop/dev_before/message_push) ## 核心概念 类目管理模块的核心围绕三个实体： - **类目（Category）**：微信小店的商品分类体系，采用多级树状结构。目前存在新版类目树（`cats_v2`）和旧版类目树（`cats`）两套体系，新版中使用 `cat_id` 标识叶子类目（品类） - **类目资质（Qualification）**：部分类目需要商家提交经营资质后才能获得售卖权限，资质包含证照组、品牌等材料 - **审核单（Audit）**：商家通过 [API] [申请类目 / addcategory](/doc/store/shop/API/channels-shop-category/api_addcategory) 提交类目申请后，平台会创建审核单并返回 `audit_id`，商家可查询审核进度或撤销审核 **新旧类目树差异**：目前小店后台（B 端）和前台（C 端）已全部切换为新类目树，API 调用仍同时兼容新旧类目树，但建议尽快切换到新版。 | 对比项 | 旧类目树（`cats`） | 新类目树（`cats_v2`） | |-------|-------------------|---------------------| | 层级结构 | 固定三级 | 多级（不再固定三级） | | 字段标识 | `level1` / `level2` / `level3` | `cat_id` + `leaf` 标识叶子类目 | | 示例 | 酒类(7339) → 洋酒(7344) → 国产白兰地(545301) | 酒类(10000201) → 洋酒(10000204) → 白兰地/干邑(10000454) → 国产白兰地(545301) | | 叶子类目映射 | 与新类目树一一映射，ID 和名称相同 | 与旧类目树一一映射，ID 和名称相同 | | 非叶子类目映射 | 与新类目树无映射关系 | 与旧类目树无映射关系 | 涉及的 API：[API] [获取所有类目 / getallcategory](/doc/store/shop/API/channels-shop-category/api_getallcategory) 同时返回 `cats` 和 `cats_v2` 两个字段；[API] [申请类目 / addcategory](/doc/store/shop/API/channels-shop-category/api_addcategory) 推荐使用 `cats_v2` 参数而非旧版 `level1/level2/level3`。 ## 接入流程 ### 1. 查询类目体系 商家接入类目管理的第一步是获取完整的类目树，了解可经营的品类范围和对应的资质要求。 ![](https://res8.wxqcloud.qq.com.cn/wxdoc/196dab66-b5bb-4b6a-9103-7df515be19c7.png) - [API] [获取所有类目 / getallcategory](/doc/store/shop/API/channels-shop-category/api_getallcategory)：返回完整类目树，包含每个类目的资质要求（`qua`）、品牌资质（`brand_qua`）和商品资质（`product_qua_list`）。`cats_v2` 字段中 `leaf=true` 的节点即为叶子类目（品类） - [API] [获取类目信息 / getcategorydetail](/doc/store/shop/API/channels-shop-category/api_getcategorydetail)：传入叶子类目 `cat_id`，获取该类目的详细属性规则，包括保证金（`deposit`）、产品属性（`product_attr_list`）、销售属性（`sale_attr_list`）、佣金比例（`transactionfee_info`）、尺码表（`size_chart`）等 ### 2. 申请类目权限 确定目标类目后，商家需提交申请才能上架该类目的商品。部分类目需要提交资质材料，经平台审核通过后才能获得权限；大部分类目申请后免审快速通过。 ![](https://res8.wxqcloud.qq.com.cn/wxdoc/0f296251-1d39-4ea9-ba32-5033351c4887.png) - [API] [申请类目 / addcategory](/doc/store/shop/API/channels-shop-category/api_addcategory)：提交类目资质申请。推荐使用新版证照组模式（设置 `is_new_apply_cat=true`，传 `cats_v2` + `license_group_list`）。成功后返回 `audit_id` - [事件] [类目审核结果通知 / product_category_audit](/doc/store/shop/notify/category_callback/ProductCategoryAudit)：审核完成后，平台通过回调通知审核结果（status=3 通过，status=2 驳回）。驳回时 `reason` 字段包含具体原因 ### 3. 审核单管理 提交类目申请后，可通过以下接口跟踪审核进度。 ![](https://res8.wxqcloud.qq.com.cn/wxdoc/4b184d79-cac7-4960-a105-ebbfbbcc6479.png) - [API] [获取店铺的类目审核单列表 / getbizcatflowlist](/doc/store/shop/API/channels-shop-category/api_getbizcatflowlist)：分页查询审核单列表，支持按状态过滤（1=审核中、2=驳回、3=成功、4=已取消） - [API] [获取店铺的类目审核单详情 / getbizcatflowdetail](/doc/store/shop/API/channels-shop-category/api_getbizcatflowdetail)：通过 `audit_id` 查询审核单详情，包含提交的材料信息和驳回原因 - [API] [撤销类目审核 / cancelauditcategory](/doc/store/shop/API/channels-shop-category/api_cancelauditcategory)：通过 `audit_id` 撤销正在审核中的申请单 ### 4. 类目权限查询 审核通过后，商家可随时查询已获得的类目权限状态。类目权限可能因平台调整而失效（如类目下线、拆分等）。 ![](https://res8.wxqcloud.qq.com.cn/wxdoc/a07780ae-7e40-4469-a4ac-8f207c15ab27.png) - [API] [获取店铺的类目权限列表 / getcategoryrelationlist](/doc/store/shop/API/channels-shop-category/api_getcategoryrelationlist)：查询店铺当前拥有的所有类目权限，支持按状态过滤（1=生效中、2=已失效） - [API] [获取店铺的类目权限详情 / getcategoryrelationdetail](/doc/store/shop/API/channels-shop-category/api_getcategoryrelationdetail)：通过 `category_id` 查询单个类目的权限详情，包含审核材料、生效/失效时间和失效原因 ### 5. 查询类目规则 获得类目权限后，发品前还需了解该类目的经营规则：保证金要求、支持的发货方式、商品发布属性规则等。 ![](https://res8.wxqcloud.qq.com.cn/wxdoc/db685cd8-339c-464b-ab25-769d063bdb2e.png) - [API] [获取保证金类目规则 / get_category_rule](/doc/store/shop/API/category-rule/api_get_category_rule)：查询指定类目的保证金金额（`deposit`，单位分）。请求时 `rule_id` 固定填 `1` - [API] [获取发货方式类目规则 / get_delivery_method_category_rule](/doc/store/shop/API/category-rule/api_get_delivery_method_category_rule)：查询指定类目支持的发货方式（快递、卡券类、同城配送等）。请求时 `rule_id` 固定填 `2` - [API] [获取类目下商品发布规则 / getcategoryproductrule](/doc/store/shop/API/category-rule/api_getcategoryproductrule)：查询指定类目的商品发布规则，包括产品属性（`product_attr_list`）、销售属性（`sale_attr_list`）、资质要求（`product_qua_list`）、价格下限（`floor_price`）、尺码表（`size_chart`）、预售规则（`presale_rule`）等。支持通过 `release_mode` 区分普通模式和极简模式 ## 接口全览 ### API 接口 | 中文名 / 英文名 | 请求方式 | 功能说明 | |----------------|---------|---------| | [获取所有类目](/doc/store/shop/API/channels-shop-category/api_getallcategory) / getallcategory | `GET /shop/ec/category/all` | 获取完整类目树及资质要求 | | [获取类目信息](/doc/store/shop/API/channels-shop-category/api_getcategorydetail) / getcategorydetail | `POST /shop/ec/category/detail` | 根据叶子类目ID获取详细属性规则 | | [申请类目](/doc/store/shop/API/channels-shop-category/api_addcategory) / addcategory | `POST /channels/ec/category/add` | 提交类目资质申请 | | [获取店铺的类目审核单列表](/doc/store/shop/API/channels-shop-category/api_getbizcatflowlist) / getbizcatflowlist | `POST /shop/ec/category/getbizcatflowlist` | 分页查询类目审核单 | | [获取店铺的类目审核单详情](/doc/store/shop/API/channels-shop-category/api_getbizcatflowdetail) / getbizcatflowdetail | `POST /shop/ec/category/getbizcatflowdetail` | 查询审核单详情及驳回原因 | | [获取店铺的类目权限列表](/doc/store/shop/API/channels-shop-category/api_getcategoryrelationlist) / getcategoryrelationlist | `POST /shop/ec/category/get_category_relation_list` | 查询已有类目权限 | | [获取店铺的类目权限详情](/doc/store/shop/API/channels-shop-category/api_getcategoryrelationdetail) / getcategoryrelationdetail | `POST /shop/ec/category/get_category_relation_detail` | 查询单个类目权限详情 | | [撤销类目审核](/doc/store/shop/API/channels-shop-category/api_cancelauditcategory) / cancelauditcategory | `POST /shop/ec/category/audit/cancel` | 撤销审核中的类目申请 | | [获取保证金类目规则](/doc/store/shop/API/category-rule/api_get_category_rule) / get_category_rule | `POST /shop/ec/category/getcategoryrule` | 查询类目保证金金额 | | [获取发货方式类目规则](/doc/store/shop/API/category-rule/api_get_delivery_method_category_rule) / get_delivery_method_category_rule | `POST /shop/ec/category/getcategoryrule` | 查询类目支持的发货方式 | | [获取类目下商品发布规则](/doc/store/shop/API/category-rule/api_getcategoryproductrule) / getcategoryproductrule | `POST /shop/ec/category/getcategoryproductrule` | 查询类目商品发布属性规则 | ### 事件通知 | 中文名 / 英文名 | 事件标识 | 功能说明 | |----------------|---------|---------| | [类目审核结果通知](/doc/store/shop/notify/category_callback/ProductCategoryAudit) / product_category_audit | `Event: product_category_audit` | 类目申请审核结果回调 | ### 全量接口文档 - 类目管理 API 接口列表：/doc/store/shop/API/channels-shop-category/README.md - 类目规则 API 接口列表：/doc/store/shop/API/category-rule/README.md ## 相关运营文档 - 详见成长中心：[微信小店「类目资质」使用指南](https://store.weixin.qq.com/chengzhang/webdoc/wiki/628/0f0fa4c22d07c550/growth_center_manual_for_store) ## 常见问题 FAQ **Q：类目权限为什么会突然失效？** A：平台会定期调整类目树结构（如类目合并、拆分、下线），原类目权限可能随之失效。通过 [API] [获取店铺的类目权限列表 / getcategoryrelationlist](/doc/store/shop/API/channels-shop-category/api_getcategoryrelationlist) 可查看失效原因（`uneffective_reason` 字段），需按新类目重新申请。 **Q：申请类目时品牌列表什么情况下必传？** A：当目标类目的 [API] [获取类目信息 / getcategorydetail](/doc/store/shop/API/channels-shop-category/api_getcategorydetail) 返回 `attr.is_limit_brand=true` 时，表示该类目为品牌定向准入，申请时必须传 `brand_list`（使用店铺已审核通过的品牌 ID）。 ![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)文档变更日志（1条） 2026 年 04 月 09 日新增 类目管理 开发指南