商家出价详情(支持部分出价类型)
按出价单号查询商家出价详情(支持部分出价类型)。
一、接口名称
- 接口名称:得物商家出价详情
- 接口地址:
https://kf.fw199.com/gateway/dewu/bidding/genericdetail - 请求方式:
POST - Content-Type:
application/x-www-form-urlencoded
二、请求参数
公共参数
| 参数名 | 类型 | 是否必需 | 说明 |
|---|---|---|---|
| appid | string | 必需 | 开发者 appid |
| timestamp | string | 必需 | 时间戳(秒) |
| sign | string | 必需 | 参数签名 |
业务参数
| 参数名 | 类型 | 是否必需 | 说明 |
|---|---|---|---|
| seller_nick | string | 必需 | 得物店铺标识(授权回调中的 seller_nick) |
| bidding_no | string | 必需 | 出价单号 |
| sysid | string | 否 | 应用标识 |
三、请求示例代码(Java)
@Test
public void dewuBiddingGenericDetail() throws Exception {
String apiUrl = "https://kf.fw199.com/gateway/dewu/bidding/genericdetail";
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_no", "101220043916650904");
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": "101220043916650904",
"bidding_type": 0,
"price": 54000,
"qty": 3,
"qty_sold": 0,
"qty_remain": 3,
"status": 1,
"spu_id": 34699618,
"sku_id": 1053305114,
"merchant_sku_code": "",
"other_merchant_sku_codes": null,
"article_number": "",
"other_numbers": "",
"bidding_time": "2026-06-23 21:32:23",
"pre_sell_deliver_day": 0,
"pre_sell_end_time": "",
"campus_list": [
{
"warehouse_inventory_no": "",
"campus_name": "",
"qty": 3,
"bid_qty": 0
}
],
"lock_info_list": null,
"support_cancel_to_warehouse": false,
"delivery_address": "",
"sellable_area": null,
"first_bidding_time": "2026-06-09 14:37:28",
"new_bidding_time": "2026-06-23 21:32:23"
},
"trace_id": "77f3bb32-4c2b-43f0-b80b-91c724eb832b"
}4.2 data 主要字段
| 参数名 | 类型 | 说明 |
|---|---|---|
| bidding_no | string | 出价单号 |
| bidding_type | number | 出价类型 |
| price | number | 出价金额,单位:分 |
| qty | number | 出价数量 |
| qty_sold | number | 已售数量 |
| qty_remain | number | 剩余数量 |
| status | number | 出价状态 |
| spu_id | number | 得物 SPU ID |
| sku_id | number | 得物 SKU ID |
| merchant_sku_code | string | 商家货号 |
| other_merchant_sku_codes | array | 其他商家货号列表 |
| article_number | string | 货号 |
| other_numbers | string | 其他货号 |
| bidding_time | string | 出价时间 |
| pre_sell_deliver_day | number | 预售发货天数 |
| pre_sell_end_time | string | 预售结束时间 |
| campus_list | array | 仓 / 园区库存明细,见下方 |
| lock_info_list | array | 锁定信息列表 |
| support_cancel_to_warehouse | boolean | 是否支持取消转入仓 |
| delivery_address | string | 发货地址 |
| sellable_area | object | 可售区域信息 |
| first_bidding_time | string | 首次出价时间 |
| new_bidding_time | string | 最近出价时间 |
campus_list 元素字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| warehouse_inventory_no | string | 仓存单号 |
| campus_name | string | 园区名称 |
| qty | number | 数量 |
| bid_qty | number | 已出价数量 |
完整字段以上游得物开放平台返回为准;蜂巢将上游
data对象原样放入响应data。
4.3 失败示例
参数错误:
{
"code": 1,
"message": "参数bidding_no不能为空"
}文档更新时间: 2026-09-30 14:46 作者:admin