商品库存更新接口

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

1.请求参数:

请求URL:

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

基础参数

参数名 类型 必须 说明
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