商家出价列表(支持按出价类型查询)

分页查询商家当前出价列表,可按出价类型、SPU/SKU、货号、数量区间、修改时间等条件筛选。

一、接口名称

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

二、请求参数

公共参数

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

业务参数

参数名 类型 是否必需 说明
seller_nick string 必需 得物店铺标识(授权回调中的 seller_nick)
bidding_type number 否 出价类型
spu_id number 否 得物 SPU ID
sku_ids string 否 得物 SKU ID 列表,英文逗号分隔,如 123,456
merchant_sku_code string 否 商家货号
other_merchant_sku_code string 否 其他商家货号
bid_min_qty number 否 已出价数量下限
bid_max_qty number 否 已出价数量上限
no_bid_min_qty number 否 未出价数量下限
no_bid_max_qty number 否 未出价数量上限
start_modified string 否 修改时间起
end_modified string 否 修改时间止
campus_code string 否 园区编码
query_type number 否 查询类型,默认 0
page_no number 否 页码,默认 1
page_size number 否 每页条数,默认 20
sysid string 否

三、请求示例代码(Java)

@Test
public void dewuBiddingGenericList() throws Exception {

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

    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("bidding_type", "0");
    data.put("page_no", "1");
    data.put("page_size", "20");
    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": {
    "total_results": 5495,
    "page_no": 1,
    "page_size": 20,
    "pages": 0,
    "list": [
      {
        "bidding_no": "101220043916650904",
        "bidding_type": 0,
        "price": 54000,
        "qty": 0,
        "qty_sold": 0,
        "qty_remain": 3,
        "spu_name": "Vans Knu Skool 舒适百搭 美式复古面包鞋 板鞋 男女同款 黑色",
        "sku_id": 1053305114,
        "merchant_sku_code": "",
        "other_merchant_sku_codes": null,
        "spu_id": 34699618,
        "logo_url": "https://cdn.poizon.com/pro-img/origin-img/20260118/b5a6c3cbb75d49d7839517b63c164b2b.jpg",
        "article_number": "VN000E9XYY6",
        "other_numbers": "",
        "brand_name": "Vans",
        "not_bid_qty": 0,
        "bid_qty": 3,
        "pre_sell_deliver_day": 0,
        "props": [
          {
            "name": "尺码",
            "value": "36",
            "level": 2
          },
          {
            "name": "颜色",
            "value": "黑色",
            "level": 1
          }
        ],
        "stock_no": "",
        "spot_min_price": 0,
        "current_channel_min_price": 0,
        "my_min_price": 0,
        "flash_min_price": 0,
        "campus_list": [],
        "lock_info_list": null,
        "support_cancel_to_warehouse": false,
        "delivery_address": "",
        "sellable_area": null,
        "pre_sell_end_time": "",
        "first_bidding_time": "2026-06-09 14:37:28",
        "new_bidding_time": "2026-06-23 21:32:23",
        "suit_flag": null,
        "custom_biz_attr": null
      }
    ]
  },
  "trace_id": "e475aa81-491b-4ffa-a252-80cf0bf8d925"
}

4.2 data 主要字段

参数名 类型 说明
total_results number 总条数
page_no number 当前页码
page_size number 每页条数
pages number 总页数
list array 出价记录列表,见下方

list[] 主要字段

参数名 类型 说明
bidding_no string 出价单号
bidding_type number 出价类型
price number 出价金额,单位:分
qty number 数量
qty_sold number 已售数量
qty_remain number 剩余数量
spu_name string 商品名称
sku_id number SKU ID
spu_id number SPU ID
merchant_sku_code string 商家货号
article_number string 货号
brand_name string 品牌名
logo_url string 商品图
bid_qty number 已出价数量
not_bid_qty number 未出价数量
props array 销售属性(如颜色、尺码)
support_cancel_to_warehouse boolean 是否支持取消转入仓
first_bidding_time string 首次出价时间
new_bidding_time string 最近出价时间

4.3 失败示例

参数错误:

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

文档更新时间: 2026-09-29 18:50   作者:admin