获取类目信息 | 微信开放文档

# 获取类目信息

# 接口说明

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

# 注意事项

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

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

# 接口调用请求说明

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

# 请求参数说明

参数	类型	是否必填	描述
cat_id	string(uint64)	是	品类ID（叶子类目ID）

# 请求参数示例

{
    "cat_id": "6194"
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
info.cat_id	string(uint64)	类目ID
info.name	string	类目名称
attr.shop_no_shipment	bool	是否支持虚拟发货
attr.access_permit_required	bool	是否定向准入
attr.pre_sale	bool	是否支持预售
attr.seven_day_return	bool	是否必须支持7天无理由退货
attr.brand_list[].brand_id	string(uint64)	定准类目的品牌ID
attr.deposit	string(uint64)	类目关联的保证金，单位分
attr.product_attr_list	obj	产品属性
attr.product_attr_list[].name	string	类目必填项名称
attr.product_attr_list[].type	string	属性类型，string为自定义，select_one为多选一，该参数短期保留，用于兼容。将来废弃，使用type_v2替代
attr.product_attr_list[].type_v2	string	属性类型v2，共7种类型 string：文本 select_one：单选，选项列表在value中 select_many：多选，选项列表在value中 integer：整数，数字必须为整数 decimal4：小数（4 位精度），小数部分最多 4 位 integer_unit：整数 + 单位，单位的选项列表在value中 decimal4_unit：小数（4 位精度） + 单位，单位的选项列表在value中
attr.product_attr_list[].value	string	可选项列表，当type为：select_one/select_many时，为选项列表当type为：integer_unit/decimal4_unit时，为单位的列表
attr.product_attr_list[].is_required	bool	是否类目必填项
attr.product_attr_list[].hint	string	输入提示，请填写提示语
attr.product_attr_list[].append_allowed	bool	允许添加选项，当type为select_one/select_many时，标识是否允许添加新选项（value中不存在的选项）
attr.sale_attr_list	obj	销售属性
attr.sale_attr_list[].name	string	类目必填项名称
attr.sale_attr_list[].type	string	属性类型，string为自定义，select_one为多选一，该参数短期保留，用于兼容。将来废弃，使用type_v2替代
attr.sale_attr_list[].type_v2	string	属性类型v2，共7种类型 string：文本 select_one：单选，选项列表在value中 select_many：多选，选项列表在value中 integer：整数，数字必须为整数 decimal4：小数（4 位精度），小数部分最多 4 位 integer_unit：整数 + 单位，单位的选项列表在value中 decimal4_unit：小数（4 位精度） + 单位，单位的选项列表在value中
attr.sale_attr_list[].value	string	可选项列表，当type为：select_one/select_many时，为选项列表当type为：integer_unit/decimal4_unit时，为单位的列表
attr.sale_attr_list[].is_required	bool	是否类目必填项
attr.sale_attr_list[].hint	string	输入提示，请填写提示语
attr.sale_attr_list[].append_allowed	bool	允许添加选项，当type为select_one/select_many时，标识是否允许添加新选项（value中不存在的选项）
attr.transactionfee_info.basis_point	string(uint64)	类目实收的交易佣金比例，单位万分比
attr.transactionfee_info.original_basis_point	uint32	类目原始佣金比例，单位万分比
attr.transactionfee_info.incentive_type	uint32	佣金激励类型，0：无激励措施，1：新店佣金减免
attr.coupon_rule.discount_ratio_limit	uint32	最高的折扣比例，百分比, 0表示无限制
attr.coupon_rule.discount_limit	uint32	最高的折扣金额，单位分，0表示无限制
attr.floor_price	string(uint64)	价格下限，单位分，商品售价不可低于此价格
attr.confirm_receipt_days	array string(uint64)	收货时间选项
attr.is_limit_brand	bool	是否品牌定向准入，即该类目一定要有品牌
attr.product_requirement.product_title_requirement	string	商品标题的编辑要求
attr.product_requirement.product_img_requirement	string	商品主图的编辑要求
attr.product_requirement.product_desc_requirement	string	商品描述的编辑要求
attr.size_chart.is_support	bool	是否支持尺码表
attr.size_chart.item_list	obj	尺码配置要求列表
attr.size_chart.item_list[].name	string	尺码属性名称
attr.size_chart.item_list[].unit	string	尺码属性值的单位
attr.size_chart.item_list[].type	string	尺码属性值的类型，1：字符型，2：整数型，3：小数型
attr.size_chart.item_list[].format	string	尺码属性值的填写格式，1：单值填写，2：区间值填写，3：支持单值或区间值
attr.size_chart.item_list[].limit	string	尺码属性值的限制
attr.size_chart.item_list[].is_required	bool	是否必填
product_qua_list[]	array	商品资质列表
product_qua_list[].qua_id	string(uint64)	资质ID
product_qua_list[].need_to_apply	bool	该类目是否需要申请才能用
product_qua_list[].tips	string	资质的描述信息
product_qua_list[].mandatory	bool	该类目申请的时候是否一定要提交资质
product_qua_list[].name	string	资质名称

# 返回参数示例

{
  "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": "收藏证书"
    }
  ]
}

# 错误码

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