显示和更新发票V1 -收获API文档bob客服端下载

显示最近创建发票

得到https://YOURACCOUNT.bob客服端下载harvestapp.com/invoices

HTTP响应:200好了

示例请求邮递员

< ?xml version = " 1.0 " encoding = " utf - 8 " ? ><发票类型=“数组”><发票>< id类型=“整数”>6763297< / id ><客户机id类型=“整数”>1929151< /客户机id >< period-start类型=“日期”nil =“真正的”/ ><期末类型=“日期”nil =“真正的”/ ><数>1< / >数量<在类型=“日期”>2015-04-22< /在><到期类型=“日期”>2015-04-22< /到期><数量类型=“小数”>100.0< / >数量<货币>美国美元美元< /货币><状态>开放< /状态><笔记>一些笔记到这里。< /笔记><定购单> < /定购单><将类型=“小数”>100.0< /将>< due-at-human-format >在收到< / due-at-human-format ><创建类型=“dateTime”>2015 - 04 - 21 - t18:41:58z< /创建><更新于类型=“dateTime”>2015 - 04 - 21 - t18:42:02z< /更新于><税收类型=“小数”nil =“真正的”/ ><税额类型=“小数”>0.0< /税额><主题> < /主题>< recurring-invoice-id类型=“整数”nil =“真正的”/ >< tax2类型=“小数”nil =“真正的”/ >< tax2-amount类型=“小数”>0.0< / tax2-amount >< client-key >43 d9342a017e262c33a395ef3b9dca294f736792< / client-key >< estimate-id类型=“整数”nil =“真正的”/ ><折扣类型=“小数”nil =“真正的”/ >< discount-amount类型=“小数”>0.0< / discount-amount >< retainer-id类型=“整数”nil =“真正的”/ >< created-by-id类型=“整数”>508343年< / created-by-id ><客户名字>你的客户!< /客户名字>> < /发票< /发票>

({“发票”:{“id”:6763297,“client_id”:1929151,“period_start”:零,“period_end”:零,“数量”:“1”,“issued_at”:“2015-04-22”,“due_at”:“2015-04-22”,“数量”:One hundred.,“货币”:“美国美元——美元”,“状态”:“开放”,“笔记”:“一些笔记去。”,“purchase_order”:”“,“due_amount”:One hundred.,“due_at_human_format”:“收到”,“created_at”:“2015 - 04 - 21 - t18:41:58z”,“updated_at”:“2015 - 04 - 21 - t18:42:02z”,“税”:零,“tax_amount”:0,“主题”:”“,“recurring_invoice_id”:零,“tax2”:零,“tax2_amount”:0,“client_key”:“43 d9342a017e262c33a395ef3b9dca294f736792”,“estimate_id”:零,“折扣”:零,“discount_amount”:0,“retainer_id”:零,“created_by_id”:508343年,“client_name”:“你的客户!”}}]

状态属性可能对无偿开放,发送发票(现在或过去),草案,部分与部分发票支付,支付全额支付发票,或关闭注销发票。
由于性能原因行项目数据没有显示这个电话,你必须使用一个更具体的API调用。
默认情况下收获将每页显bob客服端下载示50个记录。你可以进一步通过页面页面参数。请注意,第一页的记录是编号1页0是不存在的。

得到https://YOURACCOUNT.bob客服端下载harvestapp.com/invoices?page=2

你也可以查询发票的时间根据发行日期(创建日期)。

得到https://YOURACCOUNT.bob客服端下载harvestapp.com/invoices?from=YYYYMMDD&to=YYYYMMDD

你可以过滤updated_since。以来,已更新的发票只显示“2010-09-25 18:30”,通过UTC日期时间值(URL编码)。

得到故事本来https://YOURACCObob客服端下载UNT.harvestapp.com/invoices?updated_since=2010-09-25 + 18% 3

由国家过滤发票(开放,部分,草案,支付,无薪,pastdue也是可能的,例如这将返回部分支付发票:

得到https://YOURACCOUNT.bob客服端下载harvestapp.com/invoices?status=partial

你也可以通过客户端滤波器。例如,只显示发票属于客户机id 23445

得到https://YOURACCOUNT.bob客服端下载harvestapp.com/invoices?client=23445

可以结合上面的过滤器,允许更强大的查询。

显示一个单独的发票

得到https://YOURACCOUNT.bob客服端下载harvestapp.com/invoices/ {INVOICEID}

HTTP响应:200好了

示例请求邮递员

< ?xml version = " 1.0 " encoding = " utf - 8 " ? ><发票>< id类型=“整数”>6763297< / id ><客户机id类型=“整数”>1929151< /客户机id >< period-start类型=“日期”nil =“真正的”/ ><期末类型=“日期”nil =“真正的”/ ><数>1< / >数量<在类型=“日期”>2015-04-22< /在><到期类型=“日期”>2015-04-22< /到期><数量类型=“小数”>100.0< / >数量<货币>美国美元美元< /货币><状态>开放< /状态><笔记> < /笔记><定购单> < /定购单><将类型=“小数”>100.0< /将>< due-at-human-format >在收到< / due-at-human-format ><创建类型=“dateTime”>2015 - 04 - 21 - t18:41:58z< /创建><更新于类型=“dateTime”>2015 - 04 - 21 - t18:42:02z< /更新于><税收类型=“小数”nil =“真正的”/ ><税额类型=“小数”>0.0< /税额><主题> < /主题>< recurring-invoice-id类型=“整数”nil =“真正的”/ >< tax2类型=“小数”nil =“真正的”/ >< tax2-amount类型=“小数”>0.0< / tax2-amount >< client-key >43 d9342a017e262c33a395ef3b9dca294f736792< / client-key >< estimate-id类型=“整数”nil =“真正的”/ ><折扣类型=“小数”nil =“真正的”/ >< discount-amount类型=“小数”>0.0< / discount-amount >< retainer-id类型=“整数”nil =“真正的”/ >< created-by-id类型=“整数”>508343年< / created-by-id >< csv-line-items >类型、描述、数量、unit_price、数量、征税,taxed2, project_id产品,一个描述,1.00,100.00,100.0,假的,假的,< / csv-line-items >> < /发票

{“发票”:{“id”:6763297,“client_id”:1929151,“period_start”:零,“period_end”:零,“数量”:“1”,“issued_at”:“2015-04-22”,“due_at”:“2015-04-22”,“数量”:One hundred.,“货币”:“美国美元——美元”,“状态”:“开放”,“笔记”:”“,“purchase_order”:”“,“due_amount”:One hundred.,“due_at_human_format”:“收到”,“created_at”:“2015 - 04 - 21 - t18:41:58z”,“updated_at”:“2015 - 04 - 21 - t18:42:02z”,“税”:零,“tax_amount”:0,“主题”:”“,“recurring_invoice_id”:零,“tax2”:零,“tax2_amount”:0,“client_key”:“43 d9342a017e262c33a395ef3b9dca294f736792”,“estimate_id”:零,“折扣”:零,“discount_amount”:0,“retainer_id”:零,“created_by_id”:508343年,“csv_line_items”:“善良、描述、数量、unit_price,数量,缴税,taxed2, project_id\ n产品描述,1.00,100.00,100.0,假的,假的,\ n”}}

客户指示板

您可以构建一个URL到公共网络发票视图使用client-key属性:

https://YOURACCOUNT.bob客服端下载harvestapp.com/client/invoices/ {CLIENTKEY}

更新现有的发票

把https://YOURACCOUNT.bob客服端下载harvestapp.com/invoices/ {INVOICEID}

请求成功后,我们将返回HTTP响应:200好了,除了地点:/发票/ {INVOICEID}。

这个请求,您可以更新发票的任何用户可编辑字段。

删除现有的发票

删除https://YOURACCOUNT.bob客服端下载harvestapp.com/invoices/ {INVOICEID}

请求成功后,我们将返回HTTP响应:200好了。

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

显示和更新发票