通用出价

对指定 SKU 发起通用出价。

一、接口名称

• 接口名称：得物通用出价
• 接口地址：https://kf.fw199.com/gateway/dewu/bidding/general/create
• 请求方式：POST
• Content-Type：application/x-www-form-urlencoded

二、请求参数

公共参数

业务参数

inventory_request_list 示例（寄售 / 分仓库存场景）：

[
  {"wh_inv_no": "WH001", "qty": 1, "old_qty": 0}
]

说明：

• 调用前店铺须已完成得物授权，否则返回「没有找到商家授权信息」或「access_token 为空」
• price 单位为分，例如 76800 表示 768.00 元
• 可选 bool 参数请传字符串 true / false

三、请求示例代码（Java）

@Test
public void dewuBiddingGeneralCreate() throws Exception {

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

    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("sku_id", "600874591");
    data.put("price", "76800"); // 单位：分
    data.put("qty", "1");
    data.put("bidding_type", "0");
    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": "101220045272371569",
    "risk_toast": "",
    "bid_status": 0,
    "trans_biz_no": "",
    "user_id": "",
    "trade_status": 0
  },
  "trace_id": "e475aa81-491b-4ffa-a252-80cf0bf8d925"
}

4.2 data 主要字段

完整字段以上游得物开放平台返回为准；蜂巢将上游 data 对象原样放入响应 data。

4.3 失败示例

参数错误：

{
  "code": 1,
  "message": "参数sku_id不能为空或无效"
}