商家出价详情(支持部分出价类型)

按出价单号查询商家出价详情(支持部分出价类型)。

一、接口名称

  • 接口名称:得物商家出价详情
  • 接口地址: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