商品库存更新接口
修改商品sku库存,在资源位上的商品不能减少库存。
1.请求参数:
请求URL:
基础参数
参数名 | 类型 | 必须 | 说明 |
---|---|---|---|
appid | String | 必填 | 合作伙伴AppId |
timestamp | String | 必填 | 当前时间戳 |
tb_seller_nick | String | 必填 | 拼多多账号, 非店铺名称 |
sign | String | 必填 | 如何计算生成见示例代码 |
业务参数
参数接口 | 参数类型 | 是否必填 | 说明 |
---|---|---|---|
goods_id | LONG | 必填 | 商品id |
quantity | LONG | 必填 | 库存修改值。当全量更新库存时,quantity必须为大于等于0的正整数;当增量更新库存时,quantity为整数,可小于等于0。若增量更新时传入的库存为负数,则负数与实际库存之和不能小于0。比如当前实际库存为1,传入增量更新quantity=-1,库存改为0 |
sku_id | LONG | 非必填 | sku_id和outer_id必填一个,优先使用sku_id |
outer_id | STRING | 非必填 | sku商家编码,如果sku_id未填,则使用outer_id |
update_type | INTEGER | 非必填 | 库存更新方式,可选。1为全量更新,2为增量更新。如果不填,默认为全量更新 |
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);
3. 返回结果
返回结果如下
3.1 成功的情况
{"code":0,"message":"ok","data":{"is_success":true,"request_id":"17448853076376183"}}
3.2 失败的情况
{"code":30000,"message":"拼多多调用远程接口出错:外部编码错误,","data":""}
说明: code为0表示成功,非0为失败,message会包含失败原因。业务上更新成功以data.is_success为准。true表示更新成功,false表示更新失败。
文档更新时间: 2025-04-17 18:31 作者:admin