宝贝/SKU库存修改

提供按照全量或增量形式修改宝贝/SKU库存的功能

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/taobao/item/updatestock

参数名 类型 说明 示例
appid String 合作伙伴AppId uwkahf@jfs92
timestamp String 当前时间戳
tb_seller_nick String 淘宝卖家店铺登录账号,非店铺名称 kingdo
sign String 接口签名 如何计算生成见示例代码
num_iid number 必填, 商品数字ID
sku_id number 可选, 要操作的SKU的数字ID, 如果不填默认修改宝贝的库存,如果填上则修改该SKU的库存
outer_id String 可选, SKU的商家编码, 如果不填则默认修改宝贝的库存,如果填了则按照商家编码搜索出对应的SKU并修改库存。当sku_id和本字段都填写时以sku_id为准搜索对应SKU
quantity number 必填 , 库存修改值, 当全量更新库存时,quantity必须为大于等于0的正整数;当增量更新库存时,quantity为整数,可小于等于0。若增量更新时传入的库存为负数,则负数与实际库存之和不能小于0。比如当前实际库存为1,传入增量更新quantity=-1,库存改为0
type number 可选 , 库存更新方式, 1为全量更新,2为增量更新。如果不填,默认为全量更新

2. 请求示例代码(Java)

      @Test
    public void  itemUpdateStock() throws Exception {

        String tb_seller_nick = Config.TBSellerNick ;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        data.put("tb_seller_nick", tb_seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        //  商品Id , 必填
        data.put("num_iid", "544876335798");

        //  要操作的SKU的数字ID,可选。如果不填默认修改宝贝的库存,如果填上则修改该SKU的库存
       //  data.put("sku_id", "22222");

        // SKU的商家编码,可选参数。如果不填则默认修改宝贝的库存,如果填了则按照商家编码搜索出对应的SKU并修改库存。当sku_id和本字段都填写时以sku_id为准搜索对应SKU
        //data.put("outer_id", "white35");

        // 库存修改值,必选。当全量更新库存时,quantity必须为大于等于0的正整数;当增量更新库存时,quantity为整数,
        // 可小于等于0。若增量更新时传入的库存为负数,则负数与实际库存之和不能小于0。比如当前实际库存为1,传入增量更新quantity=-1,库存改为0
        data.put("quantity", "100");

        // 库存更新方式,可选。1为全量更新,2为增量更新。如果不填,默认为全量更新
        data.put("type", "1");

        // 签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.TaoBaoItemUpdateStockUrl ,data);

    }

3. 返回结果如下:

返回更新后的库存情况

{
    "code": 0,
    "message": "ok",
    "data": {
        "item": {
            "iid": "544876335798",
            "modified": "2020-12-22 14:54:49",
            "num": 4470, // 总数量
            "num_iid": 544876335798, // 商品Id
            "skus": {
                "sku": [
                    {
                        "modified": "2019-09-20 14:38:55",
                        "quantity": 0,   // 当前库存数量
                        "sku_id": 3977338583164   // SKU的数字ID
                    },
                    {
                        "modified": "2020-12-22 14:55:52",
                        "quantity": 200,
                        "sku_id": 3977338583166
                    },
                    {
                        "modified": "2019-07-05 17:12:49",
                        "quantity": 40,
                        "sku_id": 3977338583163
                    },
                    {
                        "modified": "2019-07-05 17:12:49",
                        "quantity": 4230,
                        "sku_id": 3977338583165
                    }
                ]
            }
        },
        "request_id": "xsq6dwsuuzwv"
    }
}

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

文档更新时间: 2024-04-02 18:53   作者:admin