出价预计收入

按 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