通用修改出价

修改已有出价的价格 / 数量等。

一、接口名称

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

二、请求参数

公共参数

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

业务参数

参数名 类型 是否必需 说明
seller_nick string 必需 得物店铺标识(授权回调中的 seller_nick)
bidding_no string 必需 出价单号
price number 必需 修改后的出价金额,单位:分
qty number 否 修改后的数量
old_qty number 否 修改前的旧数量(上游校验场景常用)
after_sale_type number 否 售后类型
address_id number 否 发货地址 ID
support_cancel_to_warehouse string 否 是否支持取消转入仓,true / false
trans_mfs string 否 是否转 MFS,true / false
inventory_list string 否 库存明细 JSON 数组字符串,见下方说明
sellable_area_type number 否 可售区域类型(品牌直发)
sellable_area_no string 否 可售区域编号
sys_id / sysid string 否 上游应用标识,默认 580(千里马得物)

inventory_list 示例(寄售 / 分仓库存场景):

[
  {"wh_inv_no": "WH001", "qty": 1, "old_qty": 1}
]
字段 类型 说明
wh_inv_no string 仓存单号
qty number 数量
old_qty number 旧数量

说明:

  • 调用前店铺须已完成得物授权,否则返回「没有找到商家授权信息」或「access_token 为空」
  • price 单位为分,例如 77800 表示 778.00 元
  • 可选 bool 参数请传字符串 true / false
  • 修改数量时建议同时传 qty 与 old_qty,避免上游返回「旧数量不能为空」

三、请求示例代码(Java)

@Test
public void dewuBiddingGeneralUpdate() throws Exception {

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

    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", "101220045272371569");
    data.put("price", "77800"); // 单位:分
    data.put("qty", "1");
    data.put("old_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": "101220045272922006",
    "qty": 1,
    "tips": "",
    "risk_toast": "",
    "bid_status": 0
  },
  "trace_id": "3d157890-f2a4-4a1d-b3de-086000b820dd"
}

4.2 data 主要字段

参数名 类型 说明
bidding_no string 出价单号
qty number 修改后数量
tips string 提示文案,无则空字符串
risk_toast string 风控提示文案,无则空字符串
bid_status number 出价状态

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

4.3 失败示例

参数错误:

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

文档更新时间: 2026-09-29 18:51   作者:admin