下载Excel账单

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

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

1.请求参数:

请求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天的账单

2. 请求示例代码(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);
    }

3. 返回结果如下:

3.1 成功返回
{
  "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会包含失败原因。

4. 返回字段说明

参数名称 参数类型 示例值 参数描述
bill_date String 账单日期
file_name String 文件名
down_url String 账单Excel文件下载地址,请勿随意将自己的账单下载地址公开。
文档更新时间: 2024-01-17 14:11   作者:admin