V2的支出——收获APbob客服端下载I文档

牺牲的对象

属性	类型	描述
`id`	整数	惟一的ID的费用。
`客户端`	对象	一个对象包含费用的客户id,名称,和货币。
`项目`	对象	一个对象包含费用的项目id,名称和代码。
`expense_category`	对象	一个对象包含费用的费用类别id,名称,unit_price, unit_name。
`用户`	对象	一个对象包含用户的id和名称,记录费用。
`user_assignment`	对象	一个用户分配对象用户记录的费用。
`收据`	对象	一个对象包含费用的收据URL和文件名称。
`发票`	对象	一旦费用发票,这个领域将包括相关发票的id和号码。
`笔记`	字符串	文本笔记用来描述为代价。
`单位`	整数	用于计算的数量单位`total_cost`的费用。
`total_cost`	小数	的费用总额。
`计费`	布尔	费用是否计费。
`is_closed`	布尔	费用是否已经批准或因其他原因。
`is_locked`	布尔	费用是否已经签字,批准,或相关的项目或个人费用是存档。
`is_billed`	布尔	费用是否已标记为发票。
`locked_reason`	字符串	一个解释为什么一直锁着。
`spent_date`	日期	费用发生日期。
`created_at`	datetime	创建日期和时间为代价。
`updated_at`	datetime	最后一次更新费用的日期和时间。

列出所有费用

返回一个列表的费用。如果访问这个端点作为管理员,所有费用帐户将被归还。如果访问这个端点作为一名经理,所有费用分配的队友和管理项目将被归还。返回的费用分类的spent_at最近日期,费用先出现。

响应包含一个对象费用属性包含一个数组per_page费用。数组中的每一项都是一个单独的对象。如果没有更多的费用,由此产生的数组将是空的。几个额外的分页属性包含在响应简化方法你的支出。

获得/ v2 /费用

参数	类型	描述
`user_id`	整数	只返回费用属于给定的用户ID。
`client_id`	整数	只返回费用属于客户端与给定ID。
`project_id`	整数	只返回与给定的费用属于项目ID。
`is_billed`	布尔	通过`真正的`只返回费用结算`假`返回费用没有发票。
`updated_since`	datetime	只返回费用以来更新给定的日期和时间。
`从`	日期	只返回费用的`spent_date`或在给定的日期。
`来`	日期	只返回费用的`spent_date`在给定的日期或之前。
`页面`	整数	使用分页的页号。例如,如果您列出请求和收到2000条记录,后续调用可以包括`页面= 2`检索列表的下一个页面。(默认值:1)
`per_page`	整数	每个页面返回的记录数量。介于1和2000之间。(默认:2000)

示例请求:

          旋度" https://api.habob客服端下载rvestapp.com/v2/expenses " \ - h“授权:无记名ACCESS_TOKEN美元”\ - h”Harvest-Account-Id: $ ACCOUNT_ID \ - h“用户代理:MyApp (yourname@example.com)”
         

示例响应:

{“费用”:【{“id”:15296442,“笔记”:“与客户共进午餐”,“total_cost”:33.35,“单位”:1.0,“is_closed”:假,“is_locked”:真正的,“is_billed”:真正的,“locked_reason”:“费用开发票。”,“spent_date”:“2017-03-03”,“created_at”:“2017 - 06 - 27 t15:09:54z”,“updated_at”:“2017 - 06 - 27 t16:47:14z”,“计费”:真正的,“收据”:{“url”:“https:// {ACCOUNT_SUBDOMAIN}bob客服端下载.harvestapp.com/expenses/15296442/receipt”,“file_name”:“lunch_receipt.gif”,“file_size”:39410年,“content_type”:“图像/ gif”},“用户”:{“id”:1782959,“名称”:“金艾伦”},“user_assignment”:{“id”:125068553,“is_project_manager”:真正的,“is_active”:真正的,“预算”:零,“created_at”:“2017 - 06 - 26 t22:32:52z”,“updated_at”:“2017 - 06 - 26 t22:32:52z”,“hourly_rate”:100.0},“项目”:{“id”:14307913,“名称”:“营销网站”,“代码”:“瓦”},“expense_category”:{“id”:4195926,“名称”:“吃饭”,“unit_price”:零,“unit_name”:零},“客户端”:{“id”:5735774,“名称”:“ABC集团”,“货币”:“美元”},“发票”:{“id”:13150403,“数量”:“1001”}},{“id”:15296423,“笔记”:“会议酒店住宿”,“total_cost”:100.0,“单位”:1.0,“is_closed”:真正的,“is_locked”:真正的,“is_billed”:假,“locked_reason”:“这个时期的项目是锁着的。”,“spent_date”:“2017-03-01”,“created_at”:“2017 - 06 - 27 t15:09:17z”,“updated_at”:“2017 - 06 - 27 t16:47:14z”,“计费”:真正的,“收据”:零,“用户”:{“id”:1782959,“名称”:“金艾伦”},“user_assignment”:{“id”:125068554,“is_project_manager”:真正的,“is_active”:真正的,“预算”:零,“created_at”:“2017 - 06 - 26 t22:32:52z”,“updated_at”:“2017 - 06 - 26 t22:32:52z”,“hourly_rate”:100.0},“项目”:{“id”:14308069,“名称”:“在线商店——第一阶段”,“代码”:“OS1”},“expense_category”:{“id”:4197501,“名称”:“住宿”,“unit_price”:零,“unit_name”:零},“客户端”:{“id”:5735776,“名称”:“123”产业,“货币”:“欧元”},“发票”:零}),“per_page”:2000年,“total_pages”:1,“total_entries”:2,“next_page”:零,“previous_page”:零,“页面”:1,“链接”:{“第一”:“https://api.bob客服端下载harvestapp.com/v2/expenses?page=1&per_page=2000”,“下一个”:零,“以前”:零,“最后一次”:“https://api.bob客服端下载harvestapp.com/v2/expenses?page=1&per_page=2000”}}

检索一个费用

检索与给定ID为代价。返回一个对象和一个费用200好了响应代码提供了一个有效的标识符。

GET / v2 /费用/ {EXPENSE_ID}

示例请求:

          旋度" https://api.habob客服端下载rvestapp.com/v2/expenses/15296442 " \ - h“授权:无记名ACCESS_TOKEN美元”\ - h”Harvest-Account-Id: $ ACCOUNT_ID \ - h“用户代理:MyApp (yourname@example.com)”
         

示例响应:

{“id”:15296442,“笔记”:“与客户共进午餐”,“total_cost”:33.35,“单位”:1.0,“is_closed”:假,“is_locked”:真正的,“is_billed”:真正的,“locked_reason”:“费用开发票。”,“spent_date”:“2017-03-03”,“created_at”:“2017 - 06 - 27 t15:09:54z”,“updated_at”:“2017 - 06 - 27 t16:47:14z”,“计费”:真正的,“收据”:{“url”:“https:// {ACCOUNT_SUBDOMAIN}bob客服端下载.harvestapp.com/expenses/15296442/receipt”,“file_name”:“lunch_receipt.gif”,“file_size”:39410年,“content_type”:“图像/ gif”},“用户”:{“id”:1782959,“名称”:“金艾伦”},“user_assignment”:{“id”:125068553,“is_project_manager”:真正的,“is_active”:真正的,“预算”:零,“created_at”:“2017 - 06 - 26 t22:32:52z”,“updated_at”:“2017 - 06 - 26 t22:32:52z”,“hourly_rate”:100.0},“项目”:{“id”:14307913,“名称”:“营销网站”,“代码”:“瓦”},“expense_category”:{“id”:4195926,“名称”:“吃饭”,“unit_price”:零,“unit_name”:零},“客户端”:{“id”:5735774,“名称”:“ABC集团”,“货币”:“美元”},“发票”:{“id”:13150403,“数量”:“1001”}}

创建一个费用

创建一个新的对象。返回一个对象和一个费用201年创建响应代码如果调用成功。

POST / v2 /费用

参数	类型	要求	描述
`user_id`	整数	可选	用户的ID与此相关的费用。默认为当前身份验证的用户的ID。
`project_id`	整数	要求	项目的ID与此相关的费用。
`expense_category_id`	整数	要求	这个费用是费用类别的ID被跟踪。
`spent_date`	日期	要求	费用发生日期。
`单位`	整数	*可选	单位使用的数量计算`total_cost`的费用。
`total_cost`	小数	*可选	的费用总额。
`笔记`	字符串	可选	文本笔记用来描述为代价。
`计费`	布尔	可选	是否这个费用计费。默认为`真正的`。
`收据`	文件	可选	收到文件附加费用。如果包括收据,你必须提交一个多部分/格式要求。

*要么单位或total_cost是必需的。单位如果需要使用一个单位费用类别。total_cost如果不需要使用单位费用类别。

示例请求:

          旋度" https://api.habob客服端下载rvestapp.com/v2/expenses " \ - h“授权:无记名ACCESS_TOKEN美元”\ - h”Harvest-Account-Id: $ ACCOUNT_ID \ - h“用户代理:MyApp (yourname@example.com)”\ -X POST \ -H "Content-Type: application/json" \ -d '{"user_id":1782959,"project_id":14308069,"expense_category_id":4195926,"spent_date":"2017-03-01","total_cost":13.59}'
         

示例响应:

{“id”:15297032,“笔记”:零,“total_cost”:13.59,“单位”:1.0,“is_closed”:假,“is_locked”:假,“is_billed”:假,“locked_reason”:零,“spent_date”:“2017-03-01”,“created_at”:“2017 - 06 - 27 t15:42:27z”,“updated_at”:“2017 - 06 - 27 t15:42:27z”,“计费”:真正的,“收据”:零,“用户”:{“id”:1782959,“名称”:“金艾伦”},“user_assignment”:{“id”:125068553,“is_project_manager”:真正的,“is_active”:真正的,“预算”:零,“created_at”:“2017 - 06 - 26 t22:32:52z”,“updated_at”:“2017 - 06 - 26 t22:32:52z”,“hourly_rate”:100.0},“项目”:{“id”:14308069,“名称”:“在线商店——第一阶段”,“代码”:“OS1”},“expense_category”:{“id”:4195926,“名称”:“吃饭”,“unit_price”:零,“unit_name”:零},“客户端”:{“id”:5735776,“名称”:“123”产业,“货币”:“欧元”},“发票”:零}

更新费用

更新的具体费用通过设置的值传递的参数。没有提供任何参数将保持不变。返回一个对象和一个费用200好了响应代码如果调用成功。

补丁/ v2 /费用/ {EXPENSE_ID}

参数	类型	描述
`project_id`	整数	项目的ID与此相关的费用。
`expense_category_id`	整数	这个费用是费用类别的ID被跟踪。
`spent_date`	日期	费用发生日期。
`单位`	整数	单位使用的数量计算`total_cost`的费用。
`total_cost`	小数	的费用总额。
`笔记`	字符串	文本笔记用来描述为代价。
`计费`	布尔	是否这个费用计费。默认为`真正的`。
`收据`	文件	收到文件附加费用。如果包括收据,你必须提交一个多部分/格式要求。
`delete_receipt`	布尔	附加费用收据是否应该被删除。通过`真正的`删除费用收据。

示例请求:

          旋度" https://api.habob客服端下载rvestapp.com/v2/expenses/15297032 " \ - h“授权:无记名ACCESS_TOKEN美元”\ - h”Harvest-Account-Id: $ ACCOUNT_ID \ - h“用户代理:MyApp (yourname@example.com)”\ -X PATCH \ -F notes="Dinner" \ -F receipt=@dinner-receipt.gif
         

示例响应:

{“id”:15297032,“笔记”:“晚餐”,“total_cost”:13.59,“单位”:1.0,“is_closed”:假,“is_locked”:假,“is_billed”:假,“locked_reason”:零,“spent_date”:“2017-03-01”,“created_at”:“2017 - 06 - 27 t15:42:27z”,“updated_at”:“2017 - 06 - 27 t15:45:51z”,“计费”:真正的,“收据”:{“url”:“https:// {ACCOUNT_SUBDOMAIN}bob客服端下载.harvestapp.com/expenses/15297032/receipt”,“file_name”:“dinner_receipt.gif”,“file_size”:39410年,“content_type”:“图像/ gif”},“用户”:{“id”:1782959,“名称”:“金艾伦”},“user_assignment”:{“id”:125068553,“is_project_manager”:真正的,“is_active”:真正的,“预算”:零,“created_at”:“2017 - 06 - 26 t22:32:52z”,“updated_at”:“2017 - 06 - 26 t22:32:52z”,“hourly_rate”:100.0},“项目”:{“id”:14308069,“名称”:“在线商店——第一阶段”,“代码”:“OS1”},“expense_category”:{“id”:4195926,“名称”:“吃饭”,“unit_price”:零,“unit_name”:零},“客户端”:{“id”:5735776,“名称”:“123”产业,“货币”:“欧元”},“发票”:零}

删除一个费用

删除一个费用。返回一个200好了响应代码如果调用成功。

删除/ v2 /费用/ {EXPENSE_ID}

示例请求:

          旋度" https://api.habob客服端下载rvestapp.com/v2/expenses/15297032 " \ - h“授权:无记名ACCESS_TOKEN美元”\ - h”Harvest-Account-Id: $ ACCOUNT_ID \ - h“用户代理:MyApp (yourname@example.com)”\ -X DELETE
         

欢迎来到收获API v2帮助中bob客服端下载心

费用

牺牲的对象

列出所有费用

检索一个费用

创建一个费用

更新费用

删除一个费用

仍然有问题吗?我们很乐意帮助!