出价预计收入
按 SKU、出价类型与出价金额,查询预计收入及各项费用明细。
一、接口名称
- 接口名称:得物出价预计收入
- 接口地址:
https://kf.fw199.com/gateway/dewu/bidding/queryexpectincome - 请求方式:
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 |
| bidding_type | number | 必需 | 出价类型 |
| bidding_price | number | 必需 | 出价金额,单位:分 |
| sys_id / sysid | string | 否 | 上游应用标识,默认 580(千里马得物) |
三、请求示例代码(Java)
@Test
public void dewuBiddingQueryExpectIncome() throws Exception {
String apiUrl = "https://kf.fw199.com/gateway/dewu/bidding/queryexpectincome";
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", "58632565");
data.put("bidding_type", "0");
data.put("bidding_price", "19900"); // 单位:分
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_price": 19900,
"expect_income": 13441,
"tech_service_fee": 1500,
"transfer_fee": 199,
"operate_fee": 3800,
"free_postage_service_fee": 920,
"customer_service_fee": 40,
"packing_service_fee": 0,
"after_sale_service_fee": 0,
"version": "",
"extend_json": "",
"tech_service_fee_original_expense": 0,
"tech_service_fee_current_expense": 0,
"tech_service_fee_original_percent": 0,
"tech_service_fee_current_percent": 0
},
"trace_id": "9ea483dd-2508-4cb2-ae2d-ec7a7d511d2e"
}4.2 data 主要字段
| 参数名 | 类型 | 说明 |
|---|---|---|
| bidding_price | number | 出价金额(分) |
| expect_income | number | 预计收入(分) |
| tech_service_fee | number | 技术服务费(分) |
| transfer_fee | number | 转账手续费(分) |
| operate_fee | number | 操作服务费(分) |
| free_postage_service_fee | number | 包邮服务费(分) |
| customer_service_fee | number | 客服服务费(分) |
| packing_service_fee | number | 包装服务费(分) |
| after_sale_service_fee | number | 售后服务费(分) |
| version | string | 版本号 |
| extend_json | string | 扩展 JSON |
| tech_service_fee_original_expense | number | 技术服务费原费用 |
| tech_service_fee_current_expense | number | 技术服务费当前费用 |
| tech_service_fee_original_percent | number | 技术服务费原比例 |
| tech_service_fee_current_percent | number | 技术服务费当前比例 |
完整字段以上游得物开放平台返回为准;蜂巢将上游
data对象原样放入响应data。
4.3 失败示例
参数错误:
{
"code": 1,
"message": "参数sku_id不能为空或无效"
}文档更新时间: 2026-09-30 14:50 作者:admin