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

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

1.请求参数:

请求URL:

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

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
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