联系我们Uninvoiced报告
未开票报告突出显示了给定时间范围内所有计费项目的未开票时间和费用。
结果对象
| 属性 | 类型 | 描述 |
|---|---|---|
client_id |
整数 | 与所报告的工作时间和费用相关的客户ID。 |
client_name |
字符串 | 与报告的工作时间和费用相关的客户名称。 |
project_id |
整数 | 与报告的时间和费用相关联的项目ID。 |
project_name |
字符串 | 与所报告的时间和费用相关联的项目名称。 |
货币 |
字符串 | 与此结果的跟踪时间相关联的货币代码。 |
total_hours |
小数 | 给定时间框架和项目的总小时数。如果时间排开启时，小时数将根据您的设置四舍五入。 |
uninvoiced_hours |
小数 | 给定时间框架和项目中未开票的总小时数。如果时间排开启时，小时数将根据您的设置四舍五入。 |
uninvoiced_expenses |
小数 | 未开票的时间范围和项目的计费费用总额。 |
uninvoiced_amount |
小数 | 未开票的时间范围和项目的总金额(时间和费用)。 |
需要的权限
管理员可以在未开票报告中看到所有项目。具有创建发票权限的经理只能看到他们管理的项目。
Uninvoiced报告
响应包含一个对象结果属性，该属性包含最多到的数组per_page结果。数组中的每个条目都是一个单独的结果对象。如果没有更多可用的结果，则结果数组将为空。响应中包含了几个额外的分页属性，以简化对结果的分页。
注意:每个请求都需要从而且来在URL的查询字符串中提供的参数。提供的时间范围不能超过1年(365天)。
GET / v2 /报告/ uninvoiced| 参数 | 类型 | 要求 | 描述 |
|---|---|---|---|
从 |
日期 | 要求 | 只报告工时和费用spent_date在给定日期或之后 |
来 |
日期 | 要求 | 只报告工时和费用spent_date在给定日期或之前。 |
页面 |
整数 | 可选 | 在分页中使用的页码。例如，如果您提出一个列表请求并收到2000条记录，您的后续呼叫可以包括页面= 2检索列表的下一页。(默认值:1) |
per_page |
整数 | 可选 | 每页要返回的记录数。取值范围为1 ~ 2000。(默认:2000) |
示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/reports/uninvoiced?from=20170101&to=20171231" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"示例响应:
｛“结果”：［｛“client_id”：5735776，“client_name”：“123”产业，“project_id”：14308069，“project_name”：“网上商店-第一期”，“货币”：“欧元”，“total_hours”：4，“uninvoiced_hours”：0，“uninvoiced_expenses”：One hundred.，“uninvoiced_amount”：One hundred.}，｛“client_id”：5735776，“client_name”：“123”产业，“project_id”：14808188，“project_name”：“工作组”，“货币”：“欧元”，“total_hours”：0．5，“uninvoiced_hours”：0．5，“uninvoiced_expenses”：0，“uninvoiced_amount”：50}，｛“client_id”：5735774，“client_name”：“ABC集团”，“project_id”：14307913，“project_name”：“营销网站”，“货币”：“美元”，“total_hours”：2，“uninvoiced_hours”：0，“uninvoiced_expenses”：0，“uninvoiced_amount”：0｝]，“per_page”：2000，“total_pages”：1，“total_entries”：3.，“next_page”：零，“previous_page”：零，“页面”：1，“链接”：｛“第一”：“https://api.bob客服端下载harvestapp.com/v2/reports/uninvoiced?from=20170101&page=1&per_page=2000&to=20171231”，“下一个”：零，“以前”：零，“最后一次”：“https://api.bob客服端下载harvestapp.com/v2/reports/uninvoiced?from=20170101&page=1&per_page=2000&to=20171231”｝｝