商家出价列表(支持按出价类型查询)
分页查询商家当前出价列表,可按出价类型、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