新增出价【入仓】-V2

对指定入仓库存发起出价。

一、接口名称

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

二、请求参数

公共参数

参数名 类型 是否必需 说明
appid string 必需 开发者 appid
timestamp string 必需 时间戳（秒）
sign string 必需 参数签名

业务参数

参数名 类型 是否必需 说明
seller_nick string 必需 得物店铺标识（授权回调中的 seller_nick）
sku_id number 必需 得物 SKU ID
price number 必需 出价金额，单位：分
inventory_list string 必需 库存明细 JSON 数组字符串，见下方说明
request_id string 否 请求幂等号
sysid string 否 应用标识,可联系客服获取）

inventory_list 示例：

[
  {"wh_inv_no": "WN10146864939", "qty": 1}
]
字段 类型 说明
wh_inv_no string 仓存单号
qty number 数量
old_qty number 旧数量（修改场景使用）

三、请求示例代码（Java）

@Test
public void dewuStorageBiddingCreate() throws Exception {

    String apiUrl = "https://kf.fw199.com/gateway/dewu/storage/bidding/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", "1090792786");
    data.put("price", "60000"); // 单位：分
    data.put("inventory_list", "[{\"wh_inv_no\":\"WN10146864939\",\"qty\":1}]");
    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": "101220045288703963",
    "risk_toast": "",
    "bid_status": 0,
    "trans_biz_no": "",
    "user_id": "",
    "trade_status": 0
  },
  "trace_id": "f6d7fc42-e574-4e07-8bff-3b15b579f4ab"
}

4.2 data 主要字段

参数名 类型 说明
bidding_no string 出价单号
risk_toast string 风控提示文案，无则空字符串
bid_status number 出价状态
trans_biz_no string 业务流水号
user_id string 用户 ID
trade_status number 交易状态

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

4.3 失败示例

参数错误：

{
  "code": 1,
  "message": "参数sku_id不能为空或无效"
}
文档更新时间: 2026-09-30 17:30   作者：admin