联系我们费用报告
费用报告显示每个客户、项目、费用类别或用户的费用总额，其中包括给定时间范围内的费用。
响应包含一个对象结果属性，该属性包含最多到的数组per_page结果。数组中的每个条目都是一个单独的结果对象。如果没有更多可用的结果，则结果数组将为空。响应中包含了几个额外的分页属性，以简化对结果的分页。
注意:每个费用报告请求都需要从而且来在URL的查询字符串中提供的参数。提供的时间范围不能超过1年(365天)。
结果对象
| 属性 | 类型 | 描述 |
|---|---|---|
client_id |
整数 | 与报告费用相关的客户ID。只在客户端和项目报告中返回。 |
client_name |
字符串 | 与报告费用相关的客户名称。只在客户端和项目报告中返回。 |
project_id |
整数 | 与报告费用相关的项目ID。只在客户端和项目报告中返回。 |
project_name |
字符串 | 与报告费用相关的项目名称。只在客户端和项目报告中返回。 |
expense_category_id |
整数 | 与所报告的费用相关联的费用类别的ID。只在费用类别报告中返回。 |
expense_category_name |
字符串 | 与所报告的费用相关联的费用类别的名称。只在费用类别报告中返回。 |
user_id |
整数 | 与所报告的费用相关联的用户ID。只在团队报告中返回。 |
user_name |
字符串 | 与报告费用相关的用户名。只在团队报告中返回。 |
is_contractor |
布尔 | 用户的承包商身份与所报告的费用相关联。只在团队报告中返回。 |
total_amount |
小数 | 给定时间框架、主题(客户、项目、费用类别或用户)和货币的所有费用的总成本。 |
billable_amount |
小数 | 给定时间框架、主题(客户、项目、费用类别或用户)和货币的可计费费用的总成本。 |
货币 |
字符串 | 与此结果的费用相关联的货币代码。 |
需要的权限
如果您是管理员，您将看到该帐户的所有客户端、项目、费用类别和用户。经理们将看到他们自己的支出，以及他们管理的任何项目或队友的支出。会员将只看到他们自己的费用。
客户报告
GET / v2 /报告/费用/客户| 参数 | 类型 | 要求 | 描述 |
|---|---|---|---|
从 |
日期 | 要求 | 只报告开支spent_date在给定日期或之后 |
来 |
日期 | 要求 | 只报告开支spent_date在给定日期或之前。 |
页面 |
整数 | 可选 | 在分页中使用的页码。例如，如果您提出一个列表请求并收到2000条记录，您的后续呼叫可以包括页面= 2检索列表的下一页。(默认值:1) |
per_page |
整数 | 可选 | 每页要返回的记录数。取值范围为1 ~ 2000。(默认:2000) |
示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/reports/expenses/clients?from=20170101&to=20171231" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"示例响应:
｛“结果”：［｛“client_id”：5735776，“client_name”：“123”产业，“total_amount”：One hundred.，“billable_amount”：One hundred.，“货币”：“欧元”}，｛“client_id”：5735774，“client_name”：“ABC集团”，“total_amount”：133.35，“billable_amount”：133.35，“货币”：“美元”｝]，“per_page”：2000，“total_pages”：1，“total_entries”：2，“next_page”：零，“previous_page”：零，“页面”：1，“链接”：｛“第一”：“https://api.bob客服端下载harvestapp.com/v2/reports/expenses/clients?from=20170101&page=1&per_page=2000&to=20171231”，“下一个”：零，“以前”：零，“最后一次”：“https://api.bob客服端下载harvestapp.com/v2/reports/expenses/clients?from=20170101&page=1&per_page=2000&to=20171231”｝｝项目报告
GET / v2 /报告/费用/项目| 参数 | 类型 | 要求 | 描述 |
|---|---|---|---|
从 |
日期 | 要求 | 只报告开支spent_date在给定日期或之后 |
来 |
日期 | 要求 | 只报告开支spent_date在给定日期或之前。 |
页面 |
整数 | 可选 | 在分页中使用的页码。例如，如果您提出一个列表请求并收到2000条记录，您的后续呼叫可以包括页面= 2检索列表的下一页。(默认值:1) |
per_page |
整数 | 可选 | 每页要返回的记录数。取值范围为1 ~ 2000。(默认:2000) |
示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/reports/expenses/projects?from=20170101&to=20171231" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"示例响应:
｛“结果”：［｛“client_id”：5735774，“client_name”：“ABC集团”，“project_id”：14307913，“project_name”：“[MW]营销网站”，“total_amount”：133.35，“billable_amount”：133.35，“货币”：“美元”}，｛“client_id”：5735776，“client_name”：“123”产业，“project_id”：14308069，“project_name”：[OS1]网上商店-第一阶段，“total_amount”：One hundred.，“billable_amount”：One hundred.，“货币”：“欧元”｝]，“per_page”：2000，“total_pages”：1，“total_entries”：2，“next_page”：零，“previous_page”：零，“页面”：1，“链接”：｛“第一”：“https://api.bob客服端下载harvestapp.com/v2/reports/expenses/projects?from=20170101&page=1&per_page=2000&to=20171231”，“下一个”：零，“以前”：零，“最后一次”：“https://api.bob客服端下载harvestapp.com/v2/reports/expenses/projects?from=20170101&page=1&per_page=2000&to=20171231”｝｝费用类别报告
GET / v2 /报告/费用/类别| 参数 | 类型 | 要求 | 描述 |
|---|---|---|---|
从 |
日期 | 要求 | 只报告开支spent_date在给定日期或之后 |
来 |
日期 | 要求 | 只报告开支spent_date在给定日期或之前。 |
页面 |
整数 | 可选 | 在分页中使用的页码。例如，如果您提出一个列表请求并收到2000条记录，您的后续呼叫可以包括页面= 2检索列表的下一页。(默认值:1) |
per_page |
整数 | 可选 | 每页要返回的记录数。取值范围为1 ~ 2000。(默认:2000) |
示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/reports/expenses/categories?from=20170101&to=20171231" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"示例响应:
｛“结果”：［｛“expense_category_id”：4197501，“expense_category_name”：“住宿”，“total_amount”：One hundred.，“billable_amount”：One hundred.，“货币”：“欧元”}，｛“expense_category_id”：4195926，“expense_category_name”：“吃饭”，“total_amount”：One hundred.，“billable_amount”：One hundred.，“货币”：“欧元”}，｛“expense_category_id”：4195926，“expense_category_name”：“吃饭”，“total_amount”：33.35，“billable_amount”：33.35，“货币”：“美元”｝]，“per_page”：2000，“total_pages”：1，“total_entries”：3.，“next_page”：零，“previous_page”：零，“页面”：1，“链接”：｛“第一”：“https://api.bob客服端下载harvestapp.com/v2/reports/expenses/categories?from=20170101&page=1&per_page=2000&to=20171231”，“下一个”：零，“以前”：零，“最后一次”：“https://api.bob客服端下载harvestapp.com/v2/reports/expenses/categories?from=20170101&page=1&per_page=2000&to=20171231”｝｝团队报告
GET / v2 /报告/费用/团队| 参数 | 类型 | 要求 | 描述 |
|---|---|---|---|
从 |
日期 | 要求 | 只报告开支spent_date在给定日期或之后 |
来 |
日期 | 要求 | 只报告开支spent_date在给定日期或之前。 |
页面 |
整数 | 可选 | 在分页中使用的页码。例如，如果您提出一个列表请求并收到2000条记录，您的后续呼叫可以包括页面= 2检索列表的下一页。(默认值:1) |
per_page |
整数 | 可选 | 每页要返回的记录数。取值范围为1 ~ 2000。(默认:2000) |
示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/reports/expenses/team?from=20170101&to=20171231" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"示例响应:
｛“结果”：［｛“user_id”：1782884，“user_name”：“鲍勃·鲍威尔”，“is_contractor”：假，“total_amount”：One hundred.，“billable_amount”：One hundred.，“货币”：“美元”}，｛“user_id”：1782959，“user_name”：“金艾伦”，“is_contractor”：假，“total_amount”：One hundred.，“billable_amount”：One hundred.，“货币”：“欧元”}，｛“user_id”：1782959，“user_name”：“金艾伦”，“is_contractor”：假，“total_amount”：33.35，“billable_amount”：33.35，“货币”：“美元”｝]，“per_page”：2000，“total_pages”：1，“total_entries”：3.，“next_page”：零，“previous_page”：零，“页面”：1，“链接”：｛“第一”：“https://api.bob客服端下载harvestapp.com/v2/reports/expenses/team?from=20170101&page=1&per_page=2000&to=20171231”，“下一个”：零，“以前”：零，“最后一次”：“https://api.bob客服端下载harvestapp.com/v2/reports/expenses/team?from=20170101&page=1&per_page=2000&to=20171231”｝｝