跳转到内容
返回官网

增量保存SKU,可以新增sku,也可以对存量sku修改

增量保存SKU,注意:SKU是由销售属性值来确定是否与库中数据匹配,不是根据skuId。若要新增SKU,需要传入新的SKU销售属性值组合,同理,修改时,也需要传入对应的SKU的销售属性值组合。另外,同商品下有效的sku的销售属性值维度必须统一。 注意!!!!销售属性组合变动 会引起sku删除、新增

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/jd/sku/write/updateskus

公共参数

参数名称参数类型是否必须示例值参数描述
appidString是合作伙伴AppId
timestampString是1657525936当前Unix时间戳,秒
seller_nickString是38173182京东的账号,对应蜂巢授权返回jdseller字段
signString是

业务参数

名称类型必须示例值描述
wareIdNumber是11111111111商品ID(必填)
skusjava.util.List<com.jd.pop.ware.ic.api.domain.Sku>是无增量保存sku列表(可新增sku)
— wareIdNumber是11111111111商品ID(必填)
— skuIdNumber否11111558987skuID(新增的sku可不填写)
— saleAttrsjava.util.Set<com.jd.pop.ware.ic.api.domain.Prop>是无SKU销售属性,建议最大不超过5个
—— attrValueAliasString[]否[“绿”]销售属性值别名,最大数量1
—— attrIdString是457888销售属性ID,来源于类目系统
—— attrValuesString[]是[545454, 78787, 454545]销售属性值ID,最大1个
—— attrValuesSeqNoNumber[]否[1]销售属性值排序,自定义,最大数量1
— featuresjava.util.Set<com.jd.pop.ware.ic.api.domain.Feature>否无sku特殊属性,建议最大不超过3个
—— cnString否“测试商品”cn(可不填写)
—— valueString否1特殊属性值
—— keyString否isTest特殊属性标识
— jdPriceNumber是1京东价必填 单位:元,最大值为9个9
— outerIdString否ww_4567外部ID,系统不保证唯一性,如需唯一性自行保证
— stockNumString是10总库存数
— barCodeString否45456467777SKU的条形码(UPC码),固定值
— propsjava.util.Set<com.jd.pop.ware.ic.api.domain.Prop>否无(已废弃 使用multiCateProps),建议最大不超过3个
—— attrValueAliasString[]否[“绿色”]值别名,最大不超过1个
—— attrIdString否100021属性ID,来源于类目系统
—— attrValuesString[]否1232属性值,最大1个
— multiCatePropsjava.util.Set<com.jd.pop.ware.ic.api.domain.Prop>否无多级SKU属性,最大数量建议不超过10个
—— attrValueAliasString[]否[“绿色”]值别名(此方法不使用这个字段)
—— attrIdString否1256属性ID 下沉到sku的属性ID,来源于类目系统
—— attrValuesString[]否[121212, 78778]属性值 下沉到sku属性值 单选或者多选
—— expandsString[]否[“test”]扩展字段,最大数量1
—— unitsString[]否[“kg”]单位字段,最大数量1
— capacityString否20L容量,在有特殊要求的类目下必填!最多支持6位小数。
— promiseIdNumber否123456时效模板id,来源于时效系统
— saleAttrTemplateIdString否1销售属性模板id,来源与类目系统
— enableNumber否1启用停用
— currencySpuIdNumber否1标品ID,来源于标品系统
— mappingIdString否12141映射Id,来源于入参自定义
— weightString否100sku维度的重量,单位KG。最小值0.001,最大值10000。根据配置的商家支持,目前仅支持亚马逊

二、请求示例代码

Java

请求示例代码

@Test
public void JDSkuWriteUpdateSkus() throws Exception {
String skus= "[{\"venderId\":0,\"props\":[],\"jdPrice\":96,\"stockNum\":100,\"saleAttrTemplateId\":\"POP_MODEL\",\"@type\":\"com.jd.pop.ware.ic.api.domain.Sku\"}]";
String sellerNick = Config.JDSellerNick ;
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
data.put("seller_nick", sellerNick);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("wareId", "10024650147363");
data.put("content", skus);
data.put("sign", Utils.Sign(data, Config.AppSecret));
doHttpRequest(Config.JDSkuWriteUpdateSkus, data);
}

三、返回结果

{
"code": 0,
"message": "ok",
"data": {
"---": {
"skuId": "1",
"saleAttrs": [{
"---": {
"attrValueAlias": "红色",
"attrId": "1",
"expands": "test",
"units": "kg",
"attrValues": "1001",
"attrValuesSeqNo": "1"
}
}]
}
}
}
}

说明: code为0表示成功,非0为失败,message会包含失败原因。