# 获取类目信息

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

接口英文名：getcategorydetail

可通过该接口根据叶子类目ID（品类）获取类目的相关信息。

# 1. 调用方式

# HTTPS 调用

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

# 云调用

调用方法：channels.ec.category.detail
出入参和 HTTPS 调用相同，调用方式可查看云调用说明文档

# 第三方调用

本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为：85、129
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代微信小店商家进行调用，具体可查看第三方调用说明文档。

# 2. 请求参数

# 查询参数 `Query String parameters`

参数名	类型	必填	示例	说明
access_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商）

# 请求体 `Request Payload`

参数名	类型	必填	说明
cat_id	number	是	品类ID（叶子类目ID）。

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	说明
errcode	number	错误码
errmsg	string	错误信息
info	object	类目信息
attr	object	属性信息
product_qua_list	objarray	资质信息

# Res.info `Object Payload`

类目信息

参数名	类型	说明
cat_id	number	类目ID
name	string	类目名称

# Res.attr `Object Payload`

属性信息

参数名	类型	说明
shop_no_shipment	boolean	是否支持虚拟发货
access_permit_required	boolean	是否定向准入
pre_sale	boolean	是否支持预售
seven_day_return	boolean	是否必须支持7天无理由退货
brand_list	objarray	定准类目品牌
deposit	number	类目关联的保证金，单位分
product_attr_list	objarray	产品属性
sale_attr_list	objarray	销售属性
transactionfee_info	object	交易费信息
coupon_rule	object	折扣规则
floor_price	number	价格下限，单位分，商品售价不可低于此价格
confirm_receipt_days	array	收货时间选项
is_limit_brand	boolean	是否品牌定向准入，即该类目一定要有品牌
product_requirement	object	商品编辑要求
size_chart	object	尺码表
is_confidence_require_bad_must_pay	boolean	放心买必须打开坏损包赔

# Res.product_qua_list(Array) `Object Payload`

资质信息

参数名	类型	说明
qua_id	number	资质ID
need_to_apply	boolean	该类目是否需要申请才能用
tips	string	资质的描述信息
mandatory	boolean	该类目申请的时候是否一定要提交资质
name	string	资质名称

# Res.attr.brand_list(Array) `Object Payload`

定准类目品牌

参数名	类型	说明
brand_id	number	品牌ID

# Res.attr.product_attr_list(Array) `Object Payload`

产品属性

参数名	类型	说明
name	string	类目必填项名称
type	string	属性类型，string为自定义，select_one为多选一，该参数短期保留，用于兼容。将来废弃，使用type_v2替代
value	string	可选项列表，当type为：select_one/select_many时，为选项列表当type为：integer_unit/decimal4_unit时，为单位的列表
is_required	boolean	是否类目必填项
hint	string	输入提示，请填写提示语
append_allowed	boolean	允许添加选项，当type为select_one/select_many时，标识是否允许添加新选项（value中不存在的选项）
type_v2	string	属性类型v2，共7种类型 string：文本 select_one：单选，选项列表在value中 select_many：多选，选项列表在value中 integer：整数，数字必须为整数 decimal4：小数（4 位精度），小数部分最多 4 位 integer_unit：整数 + 单位，单位的选项列表在value中 decimal4_unit：小数（4 位精度） + 单位，单位的选项列表在value中

# Res.attr.sale_attr_list(Array) `Object Payload`

销售属性

参数名	类型	说明
name	string	类目必填项名称
type	string	属性类型，string为自定义，select_one为多选一，该参数短期保留，用于兼容。将来废弃，使用type_v2替代
value	string	可选项列表，当type为：select_one/select_many时，为选项列表当type为：integer_unit/decimal4_unit时，为单位的列表
is_required	boolean	是否类目必填项
hint	string	输入提示，请填写提示语
append_allowed	boolean	允许添加选项，当type为select_one/select_many时，标识是否允许添加新选项（value中不存在的选项）
type_v2	string	属性类型v2，共7种类型 string：文本 select_one：单选，选项列表在value中 select_many：多选，选项列表在value中 integer：整数，数字必须为整数 decimal4：小数（4 位精度），小数部分最多 4 位 integer_unit：整数 + 单位，单位的选项列表在value中 decimal4_unit：小数（4 位精度） + 单位，单位的选项列表在value中

# Res.attr.transactionfee_info `Object Payload`

交易费信息

参数名	类型	说明
basis_point	number	类目实收的交易佣金比例，单位万分比
original_basis_point	number	类目原始佣金比例，单位万分比
incentive_type	number	佣金激励类型，0：无激励措施，1：新店佣金减免

# Res.attr.coupon_rule `Object Payload`

折扣规则

参数名	类型	说明
discount_ratio_limit	number	最高的折扣比例，百分比, 0表示无限制
discount_limit	number	最高的折扣金额，单位分，0表示无限制

# Res.attr.product_requirement `Object Payload`

商品编辑要求

参数名	类型	说明
product_title_requirement	string	商品标题的编辑要求
product_img_requirement	string	商品主图的编辑要求
product_desc_requirement	string	商品描述的编辑要求

# Res.attr.size_chart `Object Payload`

尺码表

参数名	类型	说明
is_support	boolean	是否支持尺码表
item_list	objarray	尺码配置要求列表

# Res.attr.size_chart.item_list(Array) `Object Payload`

尺码配置要求列表

参数名	类型	说明
name	string	尺码属性名称
unit	string	尺码属性值的单位
type	string	尺码属性值的类型，1：字符型，2：整数型，3：小数型
format	string	尺码属性值的填写格式，1：单值填写，2：区间值填写，3：支持单值或区间值
limit	string	尺码属性值的限制
is_required	boolean	是否必填

# 4. 注意事项

type(旧)参数属性与type_v2参数属性兼容方式说明

新属性type_v2类型	兼容模式下的属性type映射	基于旧属性的输入	旧属性 -> 新属性
文本	文本	无需转换	无需转换
单选	单选	无需转换	无需转换
若存量销售属性忽略了这个类型，则兼容模式下服务商系统为String	文本转换为选项匹配	将文本和选项内容进行匹配。 ● 若当前属性不支持自定义选项，则每个文本都要和选项匹配成功，匹配不成功的报错提示选项内容 ● 若当前属性支持自定义选项，则匹配不上的部分，按自定义字段处理
多选	单选	降级为仅单选模式	无需转换（多选模式下支持仅选择一项）
整数	文本	文本输入要求输入的内容必须是数字	字符串转整数，转换失败则报错
小数（4 位精度）	文本	文本输入要求输入的内容必须是数字，可输入小数	字符串转小数，转换失败则报错
整数 + 单位	文本	文本输入要求输入的内容必须是"{数字}{空格}{单位}"	字符串正则匹配，转换失败则报错单位选项会在报错时提示
小数（4 位精度） + 单位	文本	文本输入要求输入的内容必须是"{数字}{空格}{单位}"	字符串正则匹配，转换失败则报错单位选项会在报错时提示

# 5. 代码示例

请求示例

{
    "cat_id": "6194"
}

返回示例

{
  "errcode": 0,
  "errmsg": "ok",
  "info": {
    "cat_id": "6194",
    "name": "安全座椅"
  },
  "attr": {
    "shop_no_shipment": false,
    "access_permit_required": false,
    "pre_sale": false,
    "seven_day_return": false,
    "brand_list": [
      {
        "brand_id": "10000031"
      },
      {
        "brand_id": "10003026"
      }
    ],
    "deposit": "500000",
    "product_attr_list": [
      {
    "name": "产地",
    "type": "string",
    "type_v2": "string",
    "value": "",
    "is_required": false,
    "hint": "生产地",
    "append_allowed": false,
      },
      {
    "name": "材质",
    "type": "select_one",
    "type_v2": "select_one",
    "value": "不锈钢;碳钢;金属;塑料;玻璃;硅胶;其他",
    "is_required": true
      },
      {
    "name": "适用人群",
    "type": "select_one",
    "type_v2": "select_many",
    "value": "婴儿;儿童;青年;中年;老年",
    "is_required": false,
    "hint": "请选择适用的人群",
    "append_allowed": false,
      },
      {
    "name": "数量",
    "type": "string",
    "type_v2": "integer",
    "value": "",
    "is_required": true,
    "hint": "请设置数量",
    "append_allowed": false,
      },
      {
    "name": "精度",
    "type": "string",
    "type_v2": "decimal4",
    "value": "",
    "is_required": true,
    "hint": "请设置精度，支持小数点后 4 位",
    "append_allowed": false,
      },
      {
    "name": "重量",
    "type": "string",
    "type_v2": "integer_unit",
    "value": "mg;g;kg",
    "is_required": false,
    "hint": "请设置产品重量",
    "append_allowed": false,
      },
      {
    "name": "毛重",
    "type": "string",
    "type_v2": "decimal4_unit",
    "value": "mg;g;kg",
    "is_required": false,
    "hint": "请设置产品毛重",
    "append_allowed": false,
      }
    ],
    "transactionfee_info": {
      "basis_point": 250,
      "original_basis_point": 250,
      "incentive_type": 0
    },
    "is_limit_brand": false
  },
  "product_qua_list": [
    {
      "qua_id": "1111487",
      "need_to_apply": true,
      "tips": "若涉及名人或大师作品，可提供作品授权证明/大师资质证明",
      "mandatory": false,
      "name": "作品授权证明/大师资质证明"
    },
    {
      "qua_id": "1111488",
      "need_to_apply": true,
      "tips": "若涉及名人或大师作品，可提供鉴定证书",
      "mandatory": false,
      "name": "鉴定证书"
    },
    {
      "qua_id": "1111489",
      "need_to_apply": true,
      "tips": "若涉及名人或大师作品，可提供收藏证书",
      "mandatory": false,
      "name": "收藏证书"
    }
  ]
}

# 6. 错误码

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

错误码	错误描述	解决方案
9401020	参数有误
10020063	无效的类目id
10020079	无效的三级类目id
10020105	当前账号既非企业亦非个体工商户，也许是尚未注册完成

# 7. 适用范围

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

# 获取类目信息

# 1. 调用方式

# HTTPS 调用

# 云调用

# 第三方调用

# 2. 请求参数

# 查询参数 Query String parameters

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

# Res.info Object Payload

# Res.attr Object Payload

# Res.product_qua_list(Array) Object Payload

# Res.attr.brand_list(Array) Object Payload

# Res.attr.product_attr_list(Array) Object Payload

# Res.attr.sale_attr_list(Array) Object Payload

# Res.attr.transactionfee_info Object Payload

# Res.attr.coupon_rule Object Payload

# Res.attr.product_requirement Object Payload

# Res.attr.size_chart Object Payload

# Res.attr.size_chart.item_list(Array) Object Payload