修改库存

宝贝/SKU库存修改

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

一、请求参数

请求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为增量更新。如果不填，默认为全量更新

二、请求示例代码

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);

    }

三、返回结果

返回更新后的库存情况

{
    "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会包含失败原因。