跳转到内容
返回官网

修改库存

商品库存更新接口

修改商品sku库存,在资源位上的商品不能减少库存。

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/pdd/goods/quantity/update

基础参数

参数名类型必须说明
appidString必填合作伙伴AppId
timestampString必填当前时间戳
tb_seller_nickString必填拼多多账号, 非店铺名称
signString必填如何计算生成见示例代码

业务参数

参数接口参数类型是否必填说明
goods_idLONG必填商品id
quantityLONG必填库存修改值。当全量更新库存时,quantity必须为大于等于0的正整数;当增量更新库存时,quantity为整数,可小于等于0。若增量更新时传入的库存为负数,则负数与实际库存之和不能小于0。比如当前实际库存为1,传入增量更新quantity=-1,库存改为0
sku_idLONG非必填sku_id和outer_id必填一个,优先使用sku_id
outer_idSTRING非必填sku商家编码,如果sku_id未填,则使用outer_id
update_typeINTEGER非必填库存更新方式,可选。1为全量更新,2为增量更新。如果不填,默认为全量更新

二、请求示例代码

Java

@Test
public void PddGoodsQuantityUpdate() throws Exception {
String seller_nick = Config.PddSellerNick; // 拼多多卖家账号
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
data.put("seller_nick", seller_nick);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("goods_id", "725122171818");
data.put("sku_id", "1715113267921");
data.put("quantity", "99");
data.put("update_type", "1");
// 参数签名
data.put("sign", Utils.Sign(data, Config.AppSecret));
doHttpRequest(Config.PddGoodsQuantityUpdateUrl, data);

三、返回结果

返回结果如下

三(一)、成功的情况

{"code":0,"message":"ok","data":{"is_success":true,"request_id":"17448853076376183"}}

三(二)、失败的情况

{"code":30000,"message":"拼多多调用远程接口出错:外部编码错误,","data":""}

说明: code为0表示成功,非0为失败,message会包含失败原因。业务上更新成功以data.is_success为准。true表示更新成功,false表示更新失败。