出价列表【入仓】-V2
分页查询入仓出价列表。
一、接口名称
- 接口名称:得物入仓出价列表 V2
- 接口地址:
https://kf.fw199.com/gateway/dewu/storage/bidding/list - 请求方式:
POST - Content-Type:
application/x-www-form-urlencoded
二、请求参数
公共参数
| 参数名 | 类型 | 是否必需 | 说明 |
|---|---|---|---|
| appid | string | 必需 | 开发者 appid |
| timestamp | string | 必需 | 时间戳(秒) |
| sign | string | 必需 | 参数签名 |
业务参数
| 参数名 | 类型 | 是否必需 | 说明 |
|---|---|---|---|
| seller_nick | string | 必需 | 得物店铺标识(授权回调中的 seller_nick) |
| spu_id | number | 否 | 得物 SPU ID |
| sku_ids | string | 否 | 得物 SKU ID 列表,英文逗号分隔,如 123,456 |
| bid_min_qty | number | 否 | 已出价数量下限 |
| bid_max_qty | number | 否 | 已出价数量上限 |
| no_bid_min_qty | number | 否 | 未出价数量下限 |
| no_bid_max_qty | number | 否 | 未出价数量上限 |
| start_modified | string | 否 | 修改时间起 |
| end_modified | string | 否 | 修改时间止 |
| page_no | number | 否 | 页码,默认 1 |
| page_size | number | 否 | 每页条数,默认 20 |
| sysid | string | 否 | 应用标识,可联系客服获取) |
三、请求示例代码(Java)
@Test
public void dewuStorageBiddingList() throws Exception {
String apiUrl = "https://kf.fw199.com/gateway/dewu/storage/bidding/list";
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("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": 5,
"page_no": 1,
"page_size": 20,
"pages": 0,
"list": [
{
"spu_name": "Converse All Star 百搭舒适 高帮 帆布鞋 男女同款 紫色",
"sku_id": 1090792786,
"spu_id": 43556055,
"logo_url": "https://cdn.poizon.com/pro-img/origin-img/20260320/b43396adcd6d45f59b87af3de192ab0b.jpg",
"article_number": "A16811C",
"other_numbers": "",
"brand_name": "Converse",
"not_bid_qty": 1,
"bid_qty": 0,
"props": [
{
"name": "尺码",
"value": "37.5",
"level": 2
},
{
"name": "颜色",
"value": "紫色",
"level": 1
}
],
"stock_no": "WN10146864939",
"spot_min_price": 0,
"current_channel_min_price": 0,
"my_min_price": 0,
"flash_min_price": 58900,
"campus_list": [
{
"wh_inv_no": "WN10146864939",
"campus_name": "贵阳园区",
"qty": 1
}
]
},
{
"spu_name": "Vans Authentic 棋盘格樱桃刺绣系带轻盈个性 轻便 低帮 帆布鞋 男女同款",
"sku_id": 1192157329,
"spu_id": 70366482,
"logo_url": "https://cdn.poizon.com/pro-img/origin-img/20260627/2c72b4fd3f6e481a8a23ccfafce2ec39.jpg",
"article_number": "VN000Z1BKVG",
"other_numbers": "",
"brand_name": "Vans",
"not_bid_qty": 1,
"bid_qty": 0,
"props": [
{
"name": "尺码",
"value": "40",
"level": 2
},
{
"name": "颜色",
"value": "棋盘格纹灰鸽白/棉花糖白",
"level": 1
}
],
"stock_no": "WN10147370084",
"spot_min_price": 54900,
"current_channel_min_price": 0,
"my_min_price": 0,
"flash_min_price": 0,
"campus_list": [
{
"wh_inv_no": "WN10147370084",
"campus_name": "清远龙地园区",
"qty": 1
}
]
},
{
"spu_name": "中国李宁 户外系列 休闲运动梭织长裤 男女同款 黑色",
"sku_id": 1165786553,
"spu_id": 63259891,
"logo_url": "https://cdn.poizon.com/pro-img/origin-img/20260602/fa5044676f7d4aa794c121788e3ac6d6.jpg",
"article_number": "AYKWC63-1",
"other_numbers": "",
"brand_name": "中国李宁",
"not_bid_qty": 1,
"bid_qty": 0,
"props": [
{
"name": "颜色",
"value": "黑色",
"level": 1
},
{
"name": "尺码",
"value": "L",
"level": 2
}
],
"stock_no": "WN10147824886",
"spot_min_price": 43000,
"current_channel_min_price": 0,
"my_min_price": 0,
"flash_min_price": 0,
"campus_list": [
{
"wh_inv_no": "WN10147824886",
"campus_name": "武汉园区",
"qty": 1
}
]
},
{
"spu_name": "Vans Skate Era 经典百搭 板鞋 男女同款 黑色",
"sku_id": 1172292410,
"spu_id": 64848549,
"logo_url": "https://cdn.poizon.com/pro-img/origin-img/20260607/8def948c55ea42eab77e630061e7af50.jpg",
"article_number": "VN000ECRBZW",
"other_numbers": "",
"brand_name": "Vans",
"not_bid_qty": 1,
"bid_qty": 0,
"props": [
{
"name": "尺码",
"value": "42",
"level": 2
},
{
"name": "颜色",
"value": "黑色",
"level": 1
}
],
"stock_no": "WN10147969557",
"spot_min_price": 44900,
"current_channel_min_price": 0,
"my_min_price": 0,
"flash_min_price": 0,
"campus_list": [
{
"wh_inv_no": "WN10147969557",
"campus_name": "武汉园区",
"qty": 1
}
]
},
{
"spu_name": "Converse Throwback 舒适百搭 高帮 帆布鞋 男女同款 酒红色",
"sku_id": 1207259731,
"spu_id": 74579305,
"logo_url": "https://cdn.poizon.com/pro-img/origin-img/20260714/8b2a5d6ba52c436da5f720a9e16aba1b.jpg",
"article_number": "A20071C",
"other_numbers": "",
"brand_name": "Converse",
"not_bid_qty": 1,
"bid_qty": 0,
"props": [
{
"name": "尺码",
"value": "37",
"level": 2
},
{
"name": "颜色",
"value": "酒红色",
"level": 1
}
],
"stock_no": "WN10148368477",
"spot_min_price": 0,
"current_channel_min_price": 0,
"my_min_price": 0,
"flash_min_price": 0,
"campus_list": [
{
"wh_inv_no": "WN10148368477",
"campus_name": "贵阳园区",
"qty": 1
}
]
}
]
},
"trace_id": "e81368fa-7ae4-4c78-b83f-c043aaef1674"
}4.2 data 主要字段
| 参数名 | 类型 | 说明 |
|---|---|---|
| total_results | number | 总条数 |
| page_no | number | 当前页 |
| page_size | number | 每页条数 |
| pages | number | 总页数 |
| list | array | 出价列表,见下方 |
list 元素字段:
| 参数名 | 类型 | 说明 |
|---|---|---|
| spu_name | string | 商品名称 |
| sku_id | number | 得物 SKU ID |
| spu_id | number | 得物 SPU ID |
| logo_url | string | 商品主图 |
| article_number | string | 货号 |
| other_numbers | string | 其他货号 |
| brand_name | string | 品牌名称 |
| not_bid_qty | number | 未出价数量 |
| bid_qty | number | 已出价数量 |
| props | array | 规格,见下方 |
| stock_no | string | 库存编号 |
| spot_min_price | number | 现货最低价,单位:分 |
| current_channel_min_price | number | 当前渠道最低价,单位:分 |
| my_min_price | number | 我的最低价,单位:分 |
| flash_min_price | number | 闪电最低价,单位:分 |
| campus_list | array | 园区库存,见下方 |
props 元素字段:
| 参数名 | 类型 | 说明 |
|---|---|---|
| name | string | 规格名,如尺码、颜色 |
| value | string | 规格值 |
| level | number | 规格层级 |
campus_list 元素字段:
| 参数名 | 类型 | 说明 |
|---|---|---|
| wh_inv_no | string | 仓存单号 |
| campus_name | string | 园区名称 |
| qty | number | 数量 |
4.3 失败示例
参数错误:
{
"code": 1,
"message": "参数sku_ids无效"
}文档更新时间: 2026-09-30 17:24 作者:admin