新增商品
商家每天创建商品的个数上限为500个，超过当天商品铺货上限时请勿重试
1. 请求参数
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳，秒 |
| seller_nick | String | 是 | 38173182 | 快手的店铺账号，对应蜂巢授权返回seller_nick字段 |
| sign | String | 是 |
业务参数
| 参数名 | 类型 | 必须 | 示例值 | 详情描述 |
|---|---|---|---|---|
| productData | JSON | 是 | 见示例 | 要发布的商品数据 |
| supplyData | JSON | 是 | 见示例 | 商品来源上报数据 |
1.1 商品字段productData
下面是 发布商品的示例，productData字段内容，字段定义见文档：https://open.kwaixiaodian.com/zone/new/docs/api?name=open.item.new&version=1
{
"title": "美式复古醋酸缎面豹纹包臀鱼尾裙夏季新款小众高腰抽绳垂感半身裙",
"relItemId": 806919644519,
"categoryId": 1609,
"imageUrls": [
"https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-2589256601-14be4b6ec86e46bc95c3bef22ae34b99.jpg",
"https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-921977914-c9ee5a3af2ba4aedb189fff851d6abc7.jpg",
"https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-921977914-ed2e008ee41f4e85938c45dc6f97c3e1.jpg"
],
"skuList": [
{
"relSkuId": 5486984697299,
"skuStock": 100,
"skuSalePrice": 3990,
"skuProps": [
{
"propName": "颜色",
"propValueName": "白色",
"imageUrl": "https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-2589256601-14be4b6ec86e46bc95c3bef22ae34b99.jpg",
"isMainProp": 1,
"propVersion": 1
}
]
}
],
"itemPropValues": [
{
"propId": 102,
"radioPropValue": {
"propValueId": 2654018,
"propValue": "穆之宜"
},
"sortNum": 22,
"propName": "品牌"
},
{
"propId": 690,
"radioPropValue": {
"propValueId": 50034082,
"propValue": "鱼尾裙"
},
"sortNum": 9,
"propName": "裙型"
},
{
"propId": 3767,
"radioPropValue": {
"propValueId": 16324749,
"propValue": "中裙"
},
"sortNum": 18,
"propName": "裙长"
},
{
"propId": 5544,
"checkBoxPropValuesList": [
{
"propValueId": 16787287,
"propValue": "维纶"
}
],
"sortNum": 21,
"propName": "面料材质"
},
{
"propId": 5551,
"radioPropValue": {
"propValueId": 783740358,
"propValue": "2025年夏季"
},
"sortNum": 12,
"propName": "上市年份季节"
},
{
"propId": 5587,
"radioPropValue": {
"propValueId": 16328187,
"propValue": "中腰"
},
"sortNum": 17,
"propName": "腰型"
}
],
"details": "新款夏季新款小众高腰抽绳垂感半身裙",
"detailImageUrls": [
"https://p4-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-2589256601-4da1772e9e8f42eeaac34631de1963f4.jpg",
"https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-2589256601-14be4b6ec86e46bc95c3bef22ae34b99.jpg",
"https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-2589256601-ea6eb959032a42d693ea760563fa0652.jpg"
],
"serviceRule": {
"refundRule": "1",
"immediatelyOnOfflineFlag": 1,
"servicePromise": {
"brokenRefund": true
}
},
"expressTemplateId": 236980092814
}1.2 商品来源数据上报 supplyData
{
"seller": {
"name": "红玫瑰1688",
"platformName": "1688",
"platform": 1
},
"title": "美式复古醋酸缎面豹纹包臀鱼尾裙夏季新款小众高腰抽绳垂感半身裙",
"priceMin": 3900,
"scene": 1, // 场景，取值范围1，2，3,见下面文档
"categoryId": 1609,
"itemId": "806919644519",
"imageUrl": "https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-2589256601-14be4b6ec86e46bc95c3bef22ae34b99.jpg",
"originItemUrl": "https://detail.1688.com/offer/806919644519.html",
"kwaiItemId": 24903576380914,
"priceMax": 3900
}主述来源数据上报完整的字段见：https://open.kwaixiaodian.com/zone/new/docs/api?name=open.supply.item.sync&version=1
发布商品时，要向平台上传发布商品的背后信息，使用时先通过scene标识商品背后的供应来源，枚举值及其背后对应的含义如下：
1-分销铺货：开放SAAS应用，帮助商家上架其他货主的货品到自己店铺进行售卖，如：发布1688、产业带等渠道货源到快手
2-商品搬家：商家将自己在其他平台店铺的商品搬运到快手
3-其他发品类型：其他类型的发品场景，如：商家在三方系统管理自己全渠道的商品，然后将商品发布到快手店铺
| 场景scene | 场景说明 |
|---|---|
| 1-分销铺货 | 必填： 1、originItemUrl：搬家来源商品的公开可访问的链接 2、itemId：搬家商品的原始ID 3、kwaiItemId：发布到快手的商品ID 5、platform：平台枚举：1、1688货源，货源来自于1688平台。2、自有货源平台 ，ISV提供铺货工具的同时，也充当供应链公司的角色，自行组织相关货源在工具提供给商家选货。3、货源来自于其他非1688的货源平台&渠道，选择该枚举项时候，需要在“platformName“提供具体的供货信息 6、platformName：货品来源的平台渠道名称：1688、xxx自有货源 7、title：货品的标题信息，原始货品的标题信息 8、priceMax：价格最大值，如商品有多个SKU，取价格最大的SKU的价格，如只有一个SKU，填唯一SKU价格即可 9、priceMin：价格最小值，如商品有多个SKU，取价格最小的SKU的价格，如只有一个SKU，填唯一SKU价格即可 10、imageUrl：货品主图列表第一张图，仅支持https的上传格式 11、categoryId：类目id，货品铺设到快手后，对应铺设对应的快手类目ID 12、seller-name：供货货主的企业、店铺名称 13、seller-platformName：如果platform=3时，需要传入供货的来源渠道具体情况，如“xxx供货平台“、”xxx产业带货源“ |
| 2-商品搬家 | 必填： 1、originItemUrl：搬家来源商品的公开可访问的链接 2、itemId：搬家商品的原始ID 3、kwaiItemId：发布到快手的商品ID 4、platform：商家搬家场景下，该枚举值请默认填入3 5、platformName：商品来源的平台渠道：淘宝、拼多多、小红书 |
| 3-其他发品类型 | 必填： 1、itemId：原始商品ID 2、kwaiItemId：发布到快手的商品ID 3、UploadMethod[新增]：商品的发布方式1-资料包上传 2-系统上传 |
需要真实上报商品的来源信息。
2. 请求示例代码(Java)
2.1 通过url方式上传图片的示例代码
@Test
public void KsItemAdd() 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);
// 产品数据
String productData = "{\n" + " \"title\": \"美式复古醋酸缎面豹纹包臀鱼尾裙夏季新款小众高腰抽绳垂感半身裙\",\n" + " \"relItemId\": 806919644519,\n" + " \"categoryId\": 1609,\n" + " \"imageUrls\": [\n" + " \"https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-2589256601-14be4b6ec86e46bc95c3bef22ae34b99.jpg\",\n" + " \"https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-921977914-c9ee5a3af2ba4aedb189fff851d6abc7.jpg\",\n" + " \"https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-921977914-ed2e008ee41f4e85938c45dc6f97c3e1.jpg\"\n" + " ],\n" + " \"skuList\": [\n" + " {\n" + " \"relSkuId\": 5486984697299,\n" + " \"skuStock\": 100,\n" + " \"skuSalePrice\": 3990,\n" + " \"skuProps\": [\n" + " {\n" + " \"propName\": \"颜色\",\n" + " \"propValueName\": \"白色\",\n" + " \"imageUrl\": \"https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-2589256601-14be4b6ec86e46bc95c3bef22ae34b99.jpg\",\n" + " \"isMainProp\": 1,\n" + " \"propVersion\": 1\n" + " }\n" + " ]\n" + " }\n" + " ],\n" + " \"itemPropValues\": [\n" + " {\n" + " \"propId\": 102,\n" + " \"radioPropValue\": {\n" + " \"propValueId\": 2654018,\n" + " \"propValue\": \"穆之宜\"\n" + " },\n" + " \"sortNum\": 22,\n" + " \"propName\": \"品牌\"\n" + " },\n" + " {\n" + " \"propId\": 690,\n" + " \"radioPropValue\": {\n" + " \"propValueId\": 50034082,\n" + " \"propValue\": \"鱼尾裙\"\n" + " },\n" + " \"sortNum\": 9,\n" + " \"propName\": \"裙型\"\n" + " },\n" + " {\n" + " \"propId\": 3767,\n" + " \"radioPropValue\": {\n" + " \"propValueId\": 16324749,\n" + " \"propValue\": \"中裙\"\n" + " },\n" + " \"sortNum\": 18,\n" + " \"propName\": \"裙长\"\n" + " },\n" + " {\n" + " \"propId\": 5544,\n" + " \"checkBoxPropValuesList\": [\n" + " {\n" + " \"propValueId\": 16787287,\n" + " \"propValue\": \"维纶\"\n" + " }\n" + " ],\n" + " \"sortNum\": 21,\n" + " \"propName\": \"面料材质\"\n" + " },\n" + " {\n" + " \"propId\": 5551,\n" + " \"radioPropValue\": {\n" + " \"propValueId\": 783740358,\n" + " \"propValue\": \"2025年夏季\"\n" + " },\n" + " \"sortNum\": 12,\n" + " \"propName\": \"上市年份季节\"\n" + " },\n" + " {\n" + " \"propId\": 5587,\n" + " \"radioPropValue\": {\n" + " \"propValueId\": 16328187,\n" + " \"propValue\": \"中腰\"\n" + " },\n" + " \"sortNum\": 17,\n" + " \"propName\": \"腰型\"\n" + " }\n" + " ],\n" + " \"details\": \"新款夏季新款小众高腰抽绳垂感半身裙\",\n" + " \"detailImageUrls\": [\n" + " \"https://p4-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-2589256601-4da1772e9e8f42eeaac34631de1963f4.jpg\",\n" + " \"https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-2589256601-14be4b6ec86e46bc95c3bef22ae34b99.jpg\",\n" + " \"https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-2589256601-ea6eb959032a42d693ea760563fa0652.jpg\"\n" + " ],\n" + " \"serviceRule\": {\n" + " \"refundRule\": \"1\",\n" + " \"immediatelyOnOfflineFlag\": 1,\n" + " \"servicePromise\": {\n" + " \"brokenRefund\": true\n" + " }\n" + " },\n" + " \"expressTemplateId\": 236980092814\n" + "}";
data.put("productData", productData);
// 报备数据
String supplyData = "{\n" + " \"seller\": {\n" + " \"name\": \"红玫瑰1688\",\n" + " \"platformName\": \"1688\",\n" + " \"platform\": 1\n" + " },\n" + " \"title\": \"美式复古醋酸缎面豹纹包臀鱼尾裙夏季新款小众高腰抽绳垂感半身裙\",\n" + " \"priceMin\": 3900,\n" + " \"scene\": 1,\n" + " \"categoryId\": 1609,\n" + " \"itemId\": \"806919644519\",\n" + " \"imageUrl\": \"https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-2589256601-14be4b6ec86e46bc95c3bef22ae34b99.jpg\",\n" + " \"originItemUrl\": \"https://detail.1688.com/offer/806919644519.html\",\n" + " \"kwaiItemId\": 24903576380914,\n" + " \"priceMax\": 3900\n" + " \n" + "}";
data.put("supplyData", supplyData);
data.put("sign", Sign(data,Config.AppSecret));
String resp = doHttpRequest(Config.KsItemAddUrl, data);
System.out.println(resp);
}
3. 返回结果
{
"code": 0,
"message": "ok",
"data": {
"kwaiItemId": 24904424073914,
"relItemId": 806919644519,
"skuIdMapping": [
{
"kwaiSkuId": 158419190357914,
"relSkuId": 5486984697299,
"skuNick": ""
}
]
},
"trace_id": ""
}4. 返回字段说明
返回 code为0时，说明成功，非0时，说明失败。message中会有失败原因。 其他字段说明见:https://open.kwaixiaodian.com/zone/new/docs/api?name=open.item.new&version=1
文档更新时间: 2025-07-29 10:58 作者：admin
