# 设置展示在店铺主页的商品分类

# 接口说明

通过该接口可设置展示在店铺主页的商品分类

# 注意事项

  • 商品分类由2部分数据组成,分别是分类树和分类商品。这个接口是对分类树进行操作,不影响分类节点跟商品的关联关系。
  • 分类树目前支持2级树结构。每一级分类支持设置最多20个分类。分类名字不能超过20个字符。
  • 每一个分类节点可以设置是否隐藏。如果一级分类隐藏,那么所有子分类都必须设置为隐藏。
  • 平台会对分类名字进行审核。

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/store/classification/tree/set?access_token=ACCESS_TOKEN

# 请求参数说明

参数 类型 是否必填 描述
req.tree.level_1.id number 一级分类id。在这颗树里必须全局唯一,不能重复。
req.tree.level_1.name string 一级分类名字
req.tree.level_1.is_displayed number 是否在用户端展示该分类。1为是,0为否
req.tree.level_1.level_2.id string 二级分类名字
req.tree.level_1.level_2.name string 二级分类名字
req.tree.level_1.level_2.is_displayed number 是否在用户端展示该分类.1为是,0为否
req.version number 版本号。通过获取商品分类树或者本接口得到
req.classification_id_deleted string 表示有哪一些分类ID清空关联得商品,如果不清空,那么分类ID和商品得关联关系会一直存在。如果是一级分类,就填"1"。如果是二级分类,就填"1.2"。

# 请求示例

{
	"req": {
		"version": 121,
		"classification_id_deleted": [
			"1.2"
		],
		"tree": {
			"level_1": [
				{
					"id": 4,
					"name": "测试7",
					"level_2": [
						{
							"id": 5,
							"name": "1",
							"is_displayed": 1
						}
					],
					"is_displayed": 1
				},
				{
					"id": 6,
					"name": "测试8",
					"level_2": [
						{
							"id": 7,
							"name": "1",
							"is_displayed": 1
						},
						{
							"id": 8,
							"name": "2",
							"is_displayed": 1
						}
					],
					"is_displayed": 1
				}
			]
		}
	}
}

# 返回参数说明

参数 类型 描述
errcode number 错误码
errmsg string 错误信息
resp.version number 版本号。设置分类树的接口会用到
resp.audit_results.level_id number 该分类ID的审核结果
resp.audit_results.result_code number 审核结果枚举。1:不通过;2:通过

# 返回参数示例

{
	"errcode": 0,
	"errmsg": "ok",
	"resp": {
		"version": 123,
		"audit_results": [
			{
				"level_id": 4,
				"result_code": 2
			},
			{
				"level_id": 5,
				"result_code": 2
			},
			{
				"level_id": 6,
				"result_code": 2
			},
			{
				"level_id": 7,
				"result_code": 2
			},
			{
				"level_id": 8,
				"result_code": 2
			}
		]
	}
}

# 错误码

错误码 错误描述
公共错误码 -
1721111580 参数错误
1721111581 版本号不对
1721111583 太多分类节点
1721111590 分类ID重复
1721111588 父子分类的隐藏配置有冲突
1721111589 存在审核失败的分类名