账单下载

下载Excel账单

为了方便一些特殊场景的用户，需要对账单进行长时间保存或是二次加工汇总。蜂巢将前一天的费用明细生成Excel供用户下载。如果有这方面需求的用户，可以联系客服申请开通Excel账单下载服务。

开通后，蜂巢每天凌晨生成前一天的账单，建议每天早上9：30以后下载前一天账单。服务器上账单文件最长保留30天。
Excel账单仅参考，具体费用以蜂巢后台的费用明细为准。
若当天下载Excel账单问题，请在3个工作日内及时联系客服。
若30天内都无进行Excel账单下载，将停止账单下载服务。

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/partner/bill/down

公共参数

参数名称	参数类型	是否必须	示例值	参数描述
appid	String	是		合作伙伴AppId
timestamp	String	是	1657525936	当前Unix时间戳，秒
sign	String	是

业务参数

参数名称	参数类型	是否必须	示例值	参数描述
biz_date	string	是	2023-01-04	账单日期，开通次日后，可下载前一天或近30天的账单

二、请求示例代码

Java

@Test
    public void  DownBill() throws Exception {

        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("biz_date", "2023-01-02");
        // 签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.PartnerBillDownUrl ,data);
    }

三、返回结果

三（一）、成功返回

{
  "code": 0,
  "message": "ok",
  "data": {
    "bill_date": "2023-01-04",
    "file_name": "2023-01-04-xxxx-xxxxxxx-xxxx-xxxxxx-xxxx-xxxxxxxxxxx.zip",
    "down_url": "https://static.fw199.com/fc/bill/2023-01-04-xxxx-xxxxxxx-xxxx-xxxxxx-xxxx-xxxxxxxxxxx.zip"
  },
  "trace_id": ""
}

说明： code为0表示成功，非0为失败，message会包含失败原因。

四、返回字段说明

参数名称	参数类型	参数描述
bill_date	String	账单日期
file_name	String	文件名
down_url	String	账单Excel文件下载地址，请勿随意将自己的账单下载地址公开。