Difference between revisions of "FreshBooks"

From Hornbill
Jump to navigation Jump to search
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<div style="border:1px solid #90C0FF; background:#D0E0FF; width:99%; padding:4px; margin-bottom:10px;">
+
This document can now be found at its new location in the [https://docs.hornbill.com/ibridge-packages/welcome Hornbill Document Library].
__NOTOC__[[Main Page|Home]] > [[Integration]] > [[Business Process Automation & Orchestration]] > [[Hornbill iBridge]] > FreshBooks
 
</div>
 
{|style="width: 100%"
 
|- valign="top"
 
|style="width:73%"|
 
[[File:freshbookslogo.png|100px|link=]]
 
<br>
 
==Introduction==
 
FreshBooks is a cloud-based accounting software service designed for owners of the types of small client-service businesses that send invoices to clients and get paid for their time and expertise
 
  
Keep your customers up to date with what is happening in Hornbill and tickets in real time with the Hornbill iBridge integration to FreshBooks.
+
    [[file:hornbill-document-library.png|iBridge Package Reference|link=https://docs.hornbill.com/ibridge-packages/welcome]]
|style="width:5%"|
 
|
 
|style="width:22%; border-style: solid; border-width: 1px; border-color:#e6e6e6; background-color:#f2f2f2;"|
 
 
 
== Related Articles ==
 
:* [[Hornbill iBridge]]
 
:* [[Hornbill_KeySafe|KeySafe]]
 
:* [[Integration Call]]
 
:* [[Business_Process_Designer|Business Process Designer]]
 
|}
 
==KeySafe Configuration==
 
[[File:freshbookskeysafe.png|300px|right|link=]]
 
In order to integrate with FreshBooks, you will first need to configure, and securely store the authentication credentials for the FreshBooks Account/s you want to use with the Hornbill App.
 
 
 
Configure your '''FreshBooks''' account authentication in '''[[Hornbill_KeySafe|KeySafe]]''' in order to use the FreshBooks options.  
 
 
 
In the admin console > System > Security > KeySafe
 
 
 
* Select on '''+''' and select '''FreshBooks'''
 
* The Sub Type is automatically set to use OAuth2
 
* Give the FreshBooks KeySafe a Title (this is the name / identifier for the FreshBooks account as you will see it when using the Integration Call node in your business process)
 
* Optionally add a description
 
* Select ''Create Key''
 
* Click on ''Connect'' to open OAuth authentication window
 
* Enter your Email and Password then login
 
 
 
Right your all set........
 
 
 
'''Managing FreshBooks Configurations'''
 
 
 
* Use KeySafe to create, store and enable integrations with multiple FreshBooks accounts for use in your business processes
 
 
 
==Business Process==
 
 
 
===Options (Methods)===
 
Once you have your FreshBooks Account Authorised, your all set to use it with the '''[[Integration Call]]''' in your business processes. The following options are now available for you to use with FreshBooks:
 
 
 
:* '''Clients'''
 
:: Client Create, Client Delete, Client Get, Client Update
 
:*  '''Expenses'''
 
:: Expense Create, Expense Delete, Expense Get
 
:* '''Invoices'''
 
:: Invoice Add Payment, Invoice Create, Invoice Delete, Invoice Get, Invoice Mark as Sent, Invoice Update
 
 
 
Read more about using the '''[[Integration Call]]''' from the Related Articles section, and learn how to work with input and out parameters for each of the FreshBooks options.
 
 
 
==Example==
 
{{#ev:youtube|jXZjOHOygtI|350|right}}
 
In this example, we will take you through the configuration of the FreshBooks integration and how to automatically create an expense in FreshBooks from Hornbill.  We'll need to specify using KeySafe the FreshBooks authentication details and authorize the Hornbill app to utilize this account.
 
 
 
Through the business process designer we can then use the Integration Call node to decide where and how we want to utilize the FreshBooks integration, configuring the input parameters on each occasion, allowing if required to use different FreshBooks Accounts via different KeySafe configurations and different types of updates through the specific input parameters on each Integration Call node.
 
 
 
[[Category:Integration]]
 

Revision as of 18:38, 18 January 2024

This document can now be found at its new location in the Hornbill Document Library.

   iBridge Package Reference