下载Excel账单
为了方便一些特殊场景的用户,需要对账单进行长时间保存或是二次加工汇总。蜂巢将前一天的费用明细生成Excel供用户下载。如果有这方面需求的用户,可以联系客服申请开通Excel账单下载服务。
- 开通后,蜂巢每天凌晨生成前一天的账单 ,建议每天早上9:30以后下载前一天账单。服务器上账单文件最长保留30天。
- Excel账单仅参考,具体费用以蜂巢后台的费用明细为准 。
- 若当天下载Excel账单问题, 请在3个工作日内及时联系客服。
- 若30天内都无进行Excel账单下载,将停止账单下载服务。
1.请求参数:
请求URL:
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
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