增量保存SKU,可以新增sku,也可以对存量sku修改。
增量保存SKU,注意:SKU是由销售属性值来确定是否与库中数据匹配,不是根据skuId。若要新增SKU,需要传入新的SKU销售属性值组合,同理,修改时,也需要传入对应的SKU的销售属性值组合。另外,同商品下有效的sku的销售属性值维度必须统一。 注意!!!!销售属性组合变动 会引起sku删除、新增
1.请求参数:
请求URL:
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
appid | String | 是 | 合作伙伴AppId | |
timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
seller_nick | String | 是 | 38173182 | 京东的账号,对应蜂巢授权返回jdseller字段 |
sign | String | 是 |
业务参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
wareId | Number | 是 | 11111111111 | 商品ID(必填) |
skus | java.util.List<com.jd.pop.ware.ic.api.domain.Sku> | 是 | 无 | 增量保存sku列表(可新增sku) |
— wareId | Number | 是 | 11111111111 | 商品ID(必填) |
— skuId | Number | 否 | 11111558987 | skuID(新增的sku可不填写) |
— saleAttrs | java.util.Set<com.jd.pop.ware.ic.api.domain.Prop> | 是 | 无 | SKU销售属性,建议最大不超过5个 |
—— attrValueAlias | String[] | 否 | [“绿”] | 销售属性值别名,最大数量1 |
—— attrId | String | 是 | 457888 | 销售属性ID,来源于类目系统 |
—— attrValues | String[] | 是 | [545454, 78787, 454545] | 销售属性值ID,最大1个 |
—— attrValuesSeqNo | Number[] | 否 | [1] | 销售属性值排序,自定义,最大数量1 |
— features | java.util.Set<com.jd.pop.ware.ic.api.domain.Feature> | 否 | 无 | sku特殊属性,建议最大不超过3个 |
—— cn | String | 否 | “测试商品” | cn(可不填写) |
—— value | String | 否 | 1 | 特殊属性值 |
—— key | String | 否 | isTest | 特殊属性标识 |
— jdPrice | Number | 是 | 1 | 京东价必填 单位:元,最大值为9个9 |
— outerId | String | 否 | ww_4567 | 外部ID,系统不保证唯一性,如需唯一性自行保证 |
— stockNum | String | 是 | 10 | 总库存数 |
— barCode | String | 否 | 45456467777 | SKU的条形码(UPC码),固定值 |
— props | java.util.Set<com.jd.pop.ware.ic.api.domain.Prop> | 否 | 无 | (已废弃 使用multiCateProps),建议最大不超过3个 |
—— attrValueAlias | String[] | 否 | [“绿色”] | 值别名,最大不超过1个 |
—— attrId | String | 否 | 100021 | 属性ID,来源于类目系统 |
—— attrValues | String[] | 否 | 1232 | 属性值,最大1个 |
— multiCateProps | java.util.Set<com.jd.pop.ware.ic.api.domain.Prop> | 否 | 无 | 多级SKU属性,最大数量建议不超过10个 |
—— attrValueAlias | String[] | 否 | [“绿色”] | 值别名(此方法不使用这个字段) |
—— attrId | String | 否 | 1256 | 属性ID 下沉到sku的属性ID,来源于类目系统 |
—— attrValues | String[] | 否 | [121212, 78778] | 属性值 下沉到sku属性值 单选或者多选 |
—— expands | String[] | 否 | [“test”] | 扩展字段,最大数量1 |
—— units | String[] | 否 | [“kg”] | 单位字段,最大数量1 |
— capacity | String | 否 | 20L | 容量,在有特殊要求的类目下必填!最多支持6位小数。 |
— promiseId | Number | 否 | 123456 | 时效模板id,来源于时效系统 |
— saleAttrTemplateId | String | 否 | 1 | 销售属性模板id,来源与类目系统 |
— enable | Number | 否 | 1 | 启用停用 |
— currencySpuId | Number | 否 | 1 | 标品ID,来源于标品系统 |
— mappingId | String | 否 | 12141 | 映射Id,来源于入参自定义 |
— weight | String | 否 | 100 | sku维度的重量,单位KG。最小值0.001,最大值10000。根据配置的商家支持,目前仅支持亚马逊 |
2. 请求示例代码(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);
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": {
"---": {
"skuId": "1",
"saleAttrs": [{
"---": {
"attrValueAlias": "红色",
"attrId": "1",
"expands": "test",
"units": "kg",
"attrValues": "1001",
"attrValuesSeqNo": "1"
}
}]
}
}
}
}
说明: code为0表示成功,非0为失败,message会包含失败原因。
文档更新时间: 2024-06-28 16:37 作者:JSL