商品销售属性填写规则
商品发布&编辑时，拉取销售属性填写限制
1. 请求参数
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳，秒 |
| seller_nick | String | 是 | 38173182 | 快手的店铺账号，对应蜂巢授权返回seller_nick字段 |
| sign | String | 是 |
业务参数
| 参数名 | 类型 | 必须 | 示例值 | 详情描述 |
|---|---|---|---|---|
| categoryId | Long | 是 | 1003 | 类目id |
| spuId | Long | 否 | 123456 | 如果是标品发品流程，需要传入标品id |
| itemId | Long | 否 | 1123123 | 商品id，新发时传0 |
2. 请求示例代码(Java)
@Test
public void OpenItemSalepropRuleRequest() throws Exception {
Map<String, Object> data = new HashMap<String, Object>();
data.put("appid", Config.AppId);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("seller_nick", Config.KSSellerNick);
data.put("categoryId", 1609);
// data.put("spuId",0);
// data.put("itemId",0);
data.put("sign", Sign(data,Config.AppSecret));
String resp = doHttpRequest(Config.OpenItemSalepropRuleRequestUrl, data);
System.out.println(resp);
}3. 返回结果
{
"code": 0,
"message": "ok",
"data": {
"customSalePropConfigRule": {
"customSalePropNameConfigRule": {
"maxLength": 20
},
"propValueMaxCount": 50,
"required": false,
"supportCustomPropValue": true,
"supportPropImage": true
},
"customSalePropValueConfigRule": {
"measureTemplate": [],
"remarkRule": {
"maxLength": 16,
"supportRemark": true
},
"textRule": {
"maxLength": 60,
"message": "",
"pattern": []
},
"unit": []
},
"maxSkuCount": 600,
"presetSaleProp": [
{
"customSalePropValueConfigRule": {
"measureTemplate": [],
"remarkRule": {
"maxLength": 16,
"supportRemark": true
},
"textRule": {
"maxLength": 60,
"message": "",
"pattern": []
},
"unit": []
},
"presetSalePropValueConfigRule": {
"measureTemplate": [],
"remarkRule": {
"maxLength": 16,
"supportRemark": true
},
"unit": []
},
"propId": 5119,
"propName": "颜色",
"propShowType": 1,
"propValueGroup": [
{
"propValue": [
{
"propValueId": 16070872,
"propValueName": "白色"
},
{
"propValueId": 15310519,
"propValueName": "米白色"
},
{
"propValueId": 15312019,
"propValueName": "乳白色"
}
],
"propValueGroupId": 23,
"propValueGroupName": "白色系"
},
{
"propValue": [
{
"propValueId": 15321108,
"propValueName": "灰色"
},
{
"propValueId": 15309119,
"propValueName": "深灰色"
},
{
"propValueId": 15310919,
"propValueName": "浅灰色"
}
],
"propValueGroupId": 22,
"propValueGroupName": "灰色系"
},
{
"propValue": [
{
"propValueId": 16337672,
"propValueName": "黑色"
}
],
"propValueGroupId": 21,
"propValueGroupName": "黑色系"
},
{
"propValue": [
{
"propValueId": 15308719,
"propValueName": "酒红色"
},
{
"propValueId": 15309019,
"propValueName": "西瓜红"
},
{
"propValueId": 15309619,
"propValueName": "紫红色"
},
{
"propValueId": 16071472,
"propValueName": "红色"
},
{
"propValueId": 15311219,
"propValueName": "桔红色"
},
{
"propValueId": 15311719,
"propValueName": "玫红色"
},
{
"propValueId": 15311819,
"propValueName": "粉红色"
}
],
"propValueGroupId": 20,
"propValueGroupName": "红色系"
},
{
"propValue": [
{
"propValueId": 15307619,
"propValueName": "香槟色"
},
{
"propValueId": 15308819,
"propValueName": "桔色"
},
{
"propValueId": 14588308,
"propValueName": "金色"
},
{
"propValueId": 15309519,
"propValueName": "浅黄色"
},
{
"propValueId": 15310619,
"propValueName": "柠檬黄"
},
{
"propValueId": 15310819,
"propValueName": "明黄色"
},
{
"propValueId": 15311519,
"propValueName": "荧光黄"
},
{
"propValueId": 16071072,
"propValueName": "黄色"
}
],
"propValueGroupId": 19,
"propValueGroupName": "黄色系"
},
{
"propValue": [
{
"propValueId": 15321308,
"propValueName": "绿色"
},
{
"propValueId": 16070972,
"propValueName": "翠绿色"
},
{
"propValueId": 15310319,
"propValueName": "墨绿色"
},
{
"propValueId": 15310719,
"propValueName": "军绿色"
},
{
"propValueId": 21088328,
"propValueName": "青色"
},
{
"propValueId": 15311119,
"propValueName": "浅绿色"
}
],
"propValueGroupId": 18,
"propValueGroupName": "绿色系"
},
{
"propValue": [
{
"propValueId": 15307719,
"propValueName": "天蓝色"
},
{
"propValueId": 15308119,
"propValueName": "深蓝色"
},
{
"propValueId": 15308419,
"propValueName": "浅蓝色"
},
{
"propValueId": 14588408,
"propValueName": "蓝色"
},
{
"propValueId": 15309919,
"propValueName": "湖蓝色"
},
{
"propValueId": 15310219,
"propValueName": "藏青色"
},
{
"propValueId": 15311919,
"propValueName": "宝蓝色"
}
],
"propValueGroupId": 17,
"propValueGroupName": "蓝色系"
},
{
"propValue": [
{
"propValueId": 15307819,
"propValueName": "紫罗兰"
},
{
"propValueId": 15307919,
"propValueName": "浅紫色"
},
{
"propValueId": 16070072,
"propValueName": "紫色"
},
{
"propValueId": 15311419,
"propValueName": "深紫色"
}
],
"propValueGroupId": 16,
"propValueGroupName": "紫色系"
},
{
"propValue": [
{
"propValueId": 15308019,
"propValueName": "深棕色"
},
{
"propValueId": 14589108,
"propValueName": "咖啡色"
},
{
"propValueId": 15308519,
"propValueName": "巧克力色"
},
{
"propValueId": 15310019,
"propValueName": "浅棕色"
},
{
"propValueId": 15310119,
"propValueName": "驼色"
},
{
"propValueId": 16070572,
"propValueName": "褐色"
},
{
"propValueId": 15311619,
"propValueName": "栗色"
}
],
"propValueGroupId": 15,
"propValueGroupName": "棕色系"
}
],
"salePropConfigRule": {
"propValueMaxCount": 50,
"required": false,
"supportCustomPropValue": true,
"supportPropImage": true
}
},
{
"customSalePropValueConfigRule": {
"measureTemplate": [],
"remarkRule": {
"maxLength": 16,
"supportRemark": true
},
"textRule": {
"maxLength": 60,
"message": "",
"pattern": []
},
"unit": []
},
"presetSalePropValueConfigRule": {
"measureTemplate": [],
"remarkRule": {
"maxLength": 16,
"supportRemark": true
},
"unit": []
},
"propId": 5120,
"propName": "尺码",
"propShowType": 2,
"propValueGroup": [
{
"propValue": [
{
"propValueId": 16330108,
"propValueName": "均码"
}
],
"propValueGroupId": 57,
"propValueGroupName": "均码"
},
{
"propValue": [
{
"propValueId": 50156890,
"propValueName": "145/52A"
},
{
"propValueId": 50217192,
"propValueName": "150/56A"
},
{
"propValueId": 54356537,
"propValueName": "155/60A"
},
{
"propValueId": 62954174,
"propValueName": "155/62A"
},
{
"propValueId": 54356538,
"propValueName": "160/64A"
},
{
"propValueId": 68211548,
"propValueName": "160/66A"
},
{
"propValueId": 54356536,
"propValueName": "165/68A"
},
{
"propValueId": 68211547,
"propValueName": "165/70A"
},
{
"propValueId": 15312320,
"propValueName": "165/80A"
},
{
"propValueId": 54356535,
"propValueName": "170/72A"
},
{
"propValueId": 54554745,
"propValueName": "170/74A"
},
{
"propValueId": 51370670,
"propValueName": "170/76A"
},
{
"propValueId": 53607729,
"propValueName": "170/78A"
},
{
"propValueId": 15312620,
"propValueName": "170/84A"
},
{
"propValueId": 54554743,
"propValueName": "175/80A"
},
{
"propValueId": 56902202,
"propValueName": "175/82A"
},
{
"propValueId": 51017861,
"propValueName": "175/84A"
},
{
"propValueId": 50218251,
"propValueName": "175/86A"
},
{
"propValueId": 15312820,
"propValueName": "175/88A"
},
{
"propValueId": 62268428,
"propValueName": "180/88A"
},
{
"propValueId": 62268430,
"propValueName": "180/90A"
},
{
"propValueId": 15312720,
"propValueName": "180/92A"
},
{
"propValueId": 56902204,
"propValueName": "180/94A"
},
{
"propValueId": 67419761,
"propValueName": "185/92A"
},
{
"propValueId": 15312420,
"propValueName": "185/96A"
},
{
"propValueId": 15312520,
"propValueName": "190/100A"
}
],
"propValueGroupId": 26,
"propValueGroupName": "通用"
},
{
"propValue": [
{
"propValueId": 12277455,
"propValueName": "XXS"
},
{
"propValueId": 16575708,
"propValueName": "XS"
},
{
"propValueId": 16575608,
"propValueName": "S"
},
{
"propValueId": 16575508,
"propValueName": "M"
},
{
"propValueId": 16575408,
"propValueName": "L"
},
{
"propValueId": 16575308,
"propValueName": "XL"
},
{
"propValueId": 12280355,
"propValueName": "2XL"
},
{
"propValueId": 12276355,
"propValueName": "3XL"
},
{
"propValueId": 15313320,
"propValueName": "4XL"
},
{
"propValueId": 15313420,
"propValueName": "5XL"
},
{
"propValueId": 51456867,
"propValueName": "6XL"
}
],
"propValueGroupId": 25,
"propValueGroupName": "中国码"
},
{
"propValue": [
{
"propValueId": 50330198,
"propValueName": "23"
},
{
"propValueId": 50014013,
"propValueName": "24"
},
{
"propValueId": 50007827,
"propValueName": "25"
},
{
"propValueId": 50007828,
"propValueName": "26"
},
{
"propValueId": 50192757,
"propValueName": "27"
},
{
"propValueId": 50007829,
"propValueName": "28"
},
{
"propValueId": 50111395,
"propValueName": "29"
},
{
"propValueId": 14558965,
"propValueName": "30"
},
{
"propValueId": 15316720,
"propValueName": "31"
},
{
"propValueId": 15316620,
"propValueName": "32"
},
{
"propValueId": 303,
"propValueName": "33"
},
{
"propValueId": 15316220,
"propValueName": "34"
},
{
"propValueId": 15316020,
"propValueName": "35"
},
{
"propValueId": 15315820,
"propValueName": "36"
},
{
"propValueId": 15317020,
"propValueName": "37"
},
{
"propValueId": 15317220,
"propValueName": "38"
},
{
"propValueId": 15315520,
"propValueName": "39"
},
{
"propValueId": 15315220,
"propValueName": "40"
},
{
"propValueId": 15315320,
"propValueName": "41"
},
{
"propValueId": 15314120,
"propValueName": "42"
}
],
"propValueGroupId": 24,
"propValueGroupName": "欧码"
},
{
"propValue": [
{
"propValueId": 14558965,
"propValueName": "30"
},
{
"propValueId": 15316620,
"propValueName": "32"
},
{
"propValueId": 15316220,
"propValueName": "34"
},
{
"propValueId": 15315820,
"propValueName": "36"
},
{
"propValueId": 15317220,
"propValueName": "38"
},
{
"propValueId": 15315220,
"propValueName": "40"
},
{
"propValueId": 15314120,
"propValueName": "42"
},
{
"propValueId": 403,
"propValueName": "44"
},
{
"propValueId": 15314720,
"propValueName": "46"
}
],
"propValueGroupId": 53,
"propValueGroupName": "德码"
},
{
"propValue": [
{
"propValueId": 48156111,
"propValueName": "0"
},
{
"propValueId": 37822451,
"propValueName": "2"
},
{
"propValueId": 50052728,
"propValueName": "4"
},
{
"propValueId": 50049758,
"propValueName": "6"
},
{
"propValueId": 50016466,
"propValueName": "8"
},
{
"propValueId": 14559067,
"propValueName": "10"
},
{
"propValueId": 50014011,
"propValueName": "12"
},
{
"propValueId": 50111219,
"propValueName": "14"
},
{
"propValueId": 50052950,
"propValueName": "16"
},
{
"propValueId": 50014012,
"propValueName": "18"
},
{
"propValueId": 17063719,
"propValueName": "20"
},
{
"propValueId": 702,
"propValueName": "22"
},
{
"propValueId": 50014013,
"propValueName": "24"
},
{
"propValueId": 50007828,
"propValueName": "26"
},
{
"propValueId": 50007829,
"propValueName": "28"
},
{
"propValueId": 14558965,
"propValueName": "30"
},
{
"propValueId": 15316620,
"propValueName": "32"
},
{
"propValueId": 15316220,
"propValueName": "34"
},
{
"propValueId": 15315820,
"propValueName": "36"
},
{
"propValueId": 15317220,
"propValueName": "38"
},
{
"propValueId": 15315220,
"propValueName": "40"
},
{
"propValueId": 15314120,
"propValueName": "42"
}
],
"propValueGroupId": 58,
"propValueGroupName": "美码"
},
{
"propValue": [
{
"propValueId": 50052728,
"propValueName": "4"
},
{
"propValueId": 50049758,
"propValueName": "6"
},
{
"propValueId": 50016466,
"propValueName": "8"
},
{
"propValueId": 14559067,
"propValueName": "10"
},
{
"propValueId": 50014011,
"propValueName": "12"
},
{
"propValueId": 50111219,
"propValueName": "14"
},
{
"propValueId": 50052950,
"propValueName": "16"
},
{
"propValueId": 50014012,
"propValueName": "18"
},
{
"propValueId": 17063719,
"propValueName": "20"
},
{
"propValueId": 702,
"propValueName": "22"
},
{
"propValueId": 50014013,
"propValueName": "24"
},
{
"propValueId": 50007828,
"propValueName": "26"
},
{
"propValueId": 50007829,
"propValueName": "28"
},
{
"propValueId": 14558965,
"propValueName": "30"
},
{
"propValueId": 15316620,
"propValueName": "32"
},
{
"propValueId": 15316220,
"propValueName": "34"
},
{
"propValueId": 15315820,
"propValueName": "36"
}
],
"propValueGroupId": 59,
"propValueGroupName": "英码"
}
],
"salePropConfigRule": {
"propValueMaxCount": 50,
"required": false,
"supportCustomPropValue": true,
"supportPropImage": true
}
}
],
"propMaxCount": 3,
"supportCustomSaleProp": true
},
"trace_id": ""
}4. 返回字段说明
返回 code为0时，说明成功，非0时，说明失败。message中会有失败原因。 字段详细说明见：https://open.kwaixiaodian.com/zone/new/docs/api?categoryId=44&apiName=open.item.saleprop.rule&version=1
文档更新时间: 2025-08-14 23:21 作者：admin
