自动跟价列表

查询店铺已设置的自动跟价规则列表,可按 SPU ID 筛选。

一、接口名称

  • 接口名称:得物自动跟价列表
  • 接口地址:https://kf.fw199.com/gateway/dewu/bidding/autobiddinglist
  • 请求方式:POST
  • Content-Type:application/x-www-form-urlencoded

二、请求参数

公共参数

参数名 类型 是否必需 说明
appid string 必需 开发者 appid
timestamp string 必需 时间戳(秒)
sign string 必需 参数签名

业务参数

参数名 类型 是否必需 说明
seller_nick string 必需 得物店铺标识(授权回调中的 seller_nick)
spu_ids string 必需 SPU ID 列表,英文逗号分隔,如 1124090 或 1124090,123456;最多100个
sysid string 否 应用标识,默认 580

三、请求示例代码(Java)

@Test
public void dewuBiddingAutoBiddingList() throws Exception {

    String apiUrl = "https://kf.fw199.com/gateway/dewu/bidding/autobiddinglist";

    Map<String, String> data = new HashMap<>();
    data.put("appid", Config.AppId);
    data.put("timestamp", String.valueOf(System.currentTimeMillis() / 1000));
    data.put("seller_nick", "your_dewu_seller_nick");
    data.put("sysid", "580");
    data.put("spu_ids", "1124090"); // 多个用英文逗号分隔,如 1124090,123456
    data.put("sign", Utils.Sign(data, Config.AppSecret));

    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

四、响应说明

HTTP 状态码始终为 200,业务成败看 JSON 中的 code 字段(0 表示成功)。

4.1 成功示例

{
  "code": 0,
  "message": "ok",
  "data": [
    {
      "bidding_no": "101220045683036245",
      "spu_id": 1124090,
      "sku_id": 600874591,
      "bidding_type": 0,
      "follow_type": 3,
      "lower_limit": 70800,
      "status": true,
      "merchant_sku_code": "",
      "other_merchant_sku_codes": null
    }
  ],
  "trace_id": "b9dfba37-23d8-427d-8130-388c19ec9942"
}

4.2 data 说明

data 为数组,元素字段如下:

参数名 类型 说明
bidding_no string 出价单号
spu_id number 商品spuId
sku_id number 商品skuId
bidding_type number 出价类型,0:现货、1:预售、7:极速现货、8:极速预售、6:入仓、5:寄售、12:品牌专供现货、13:品牌专供入仓、14:品牌直发
follow_type number 跟价规则类型:3:跟随平台最低价、4:比平台最低价低1档(平台最低价>=300元时,1档10元;平台最低价<300元时,1档5元,特殊类目如书籍/影音、食品、酒水、保健品、花卉绿植300元内1档1元。
lower_limit number 跟价最低价(下限),单位:分
status boolean 自动跟价是否开启
merchant_sku_code string 商家商品编码
other_merchant_sku_codes array / null 辅助商家商品编码

4.3 失败示例

参数错误:

{
  "code": 1,
  "message": "参数spu_ids无效"
}

缺少店铺:

{
  "code": 1,
  "message": "seller_nick不能为空"
}

文档更新时间: 2026-10-25 23:02   作者:admin