# 获取类目信息

接口应在服务器端调用,不可在前端(小程序、网页、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_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_tokenauthorizer_access_token

# 请求体 Request Payload

参数名类型必填说明
cat_idnumber品类ID(叶子类目ID)。

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
infoobject类目信息
attrobject属性信息
product_qua_listobjarray资质信息

# Res.info Object Payload

类目信息

参数名类型说明
cat_idnumber类目ID
namestring类目名称

# Res.attr Object Payload

属性信息

参数名类型说明
shop_no_shipmentboolean是否支持虚拟发货
access_permit_requiredboolean是否定向准入
pre_saleboolean是否支持预售
seven_day_returnboolean是否必须支持7天无理由退货
brand_listobjarray定准类目品牌
depositnumber类目关联的保证金,单位分
product_attr_listobjarray产品属性
sale_attr_listobjarray销售属性
transactionfee_infoobject交易费信息
coupon_ruleobject折扣规则
floor_pricenumber价格下限,单位分,商品售价不可低于此价格
confirm_receipt_daysarray收货时间选项
is_limit_brandboolean是否品牌定向准入,即该类目一定要有品牌
product_requirementobject商品编辑要求
size_chartobject尺码表
is_confidence_require_bad_must_payboolean放心买必须打开坏损包赔

# Res.product_qua_list(Array) Object Payload

资质信息

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

# Res.attr.brand_list(Array) Object Payload

定准类目品牌

参数名类型说明
brand_idnumber品牌ID

# Res.attr.product_attr_list(Array) Object Payload

产品属性

参数名类型说明
namestring类目必填项名称
typestring属性类型,string为自定义,select_one为多选一,该参数短期保留,用于兼容。将来废弃,使用type_v2替代
valuestring可选项列表,当type为:select_one/select_many时,为选项列表 当type为:integer_unit/decimal4_unit时,为单位的列表
is_requiredboolean是否类目必填项
hintstring输入提示,请填写提示语
append_allowedboolean允许添加选项,当type为select_one/select_many时,标识是否允许添加新选项(value中不存在的选项)
type_v2string属性类型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

销售属性

参数名类型说明
namestring类目必填项名称
typestring属性类型,string为自定义,select_one为多选一, 该参数短期保留,用于兼容。将来废弃,使用type_v2替代
valuestring可选项列表,当type为:select_one/select_many时,为选项列表 当type为:integer_unit/decimal4_unit时,为单位的列表
is_requiredboolean是否类目必填项
hintstring输入提示,请填写提示语
append_allowedboolean允许添加选项,当type为select_one/select_many时,标识是否允许添加新选项(value中不存在的选项)
type_v2string属性类型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_pointnumber类目实收的交易佣金比例,单位万分比
original_basis_pointnumber类目原始佣金比例,单位万分比
incentive_typenumber佣金激励类型,0:无激励措施,1:新店佣金减免

# Res.attr.coupon_rule Object Payload

折扣规则

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

# Res.attr.product_requirement Object Payload

商品编辑要求

参数名类型说明
product_title_requirementstring商品标题的编辑要求
product_img_requirementstring商品主图的编辑要求
product_desc_requirementstring商品描述的编辑要求

# Res.attr.size_chart Object Payload

尺码表

参数名类型说明
is_supportboolean是否支持尺码表
item_listobjarray尺码配置要求列表

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

尺码配置要求列表

参数名类型说明
namestring尺码属性名称
unitstring尺码属性值的单位
typestring尺码属性值的类型,1:字符型,2:整数型,3:小数型
formatstring尺码属性值的填写格式,1:单值填写,2:区间值填写,3:支持单值或区间值
limitstring尺码属性值的限制
is_requiredboolean是否必填

# 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. 适用范围

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