通用修改出价
修改已有出价的价格 / 数量等。
一、接口名称
- 接口名称:得物通用修改出价
- 接口地址:
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