java.lang.Object | |
↳ | org.mule.modules.freshbooks.FreshBooksConnector |
![]() |
![]() |
FreshBooks is an online invoicing software as a service for freelancers, small businesses, agencies, and professionals. It is produced by the software company 2ndSite Inc. which is located in Toronto, Ontario, Canada. The product includes a myriad of other related features, such as time tracking, expense tracking, recurring billing, online payment collection, the ability to mail invoices through the U.S. Post, and support tickets.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
String | DEFAULT_API_URL |
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
config |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Authorize an user using OAuth1.0a
| |||||||||||
Create a new callback for a specific event or a set of events.
| |||||||||||
Create a new category.
| |||||||||||
Create a new client and return the corresponding client_id.
| |||||||||||
Create a new invoice complete with line items. | |||||||||||
Create a new item and return the corresponding item_id. | |||||||||||
Create a license
| |||||||||||
Create a new payment and returns the corresponding payment_id.
| |||||||||||
Create a session
| |||||||||||
Create a system user.
| |||||||||||
Create a new task and returns the corresponding task_id.
| |||||||||||
Create a new tax and returns the corresponding tax_id.
| |||||||||||
Deletes a callback.
| |||||||||||
Delete an existing expense category.
| |||||||||||
Delete the client with the given client_id.
| |||||||||||
Delete an existing invoice.
| |||||||||||
Delete an existing item.
| |||||||||||
Permanently delete a license.
| |||||||||||
Permanently delete a payment.
| |||||||||||
Permanently delete a task.
| |||||||||||
Permanently delete a tax.
| |||||||||||
Extract accessToken
| |||||||||||
Return the complete category details associated with the given category_id.
| |||||||||||
Return the client details associated with the given client_id.
| |||||||||||
Returns information about the current user
| |||||||||||
Return the complete invoice details associated with the given invoice_id. | |||||||||||
Get an existing item with the given item_id. | |||||||||||
Retrieve payment details according to payment_id. | |||||||||||
Retrieve an existing task. | |||||||||||
Retrieve tax details according to tax_id. | |||||||||||
Returns a list of addons summaries.
| |||||||||||
Return a list of registered callbacks.
| |||||||||||
Returns a list of expense categories.
| |||||||||||
Returns a list of client summaries in order of descending client_id.
| |||||||||||
Returns a list of invoice summaries.
| |||||||||||
Returns a list of items, ordered by descending item_id.
| |||||||||||
Returns a list of licenses summaries.
| |||||||||||
Returns a list of payment summaries.
| |||||||||||
Returns a list of tasks summaries.
| |||||||||||
Returns a list of taxs, ordered by descending tax_id.
| |||||||||||
Undelete a client
| |||||||||||
Undelete an invoice
| |||||||||||
Update an existing expense category with the given category_id.
| |||||||||||
Update the details of the client with the given client_id.
| |||||||||||
Update an existing invoice with the given invoice_id. | |||||||||||
Update an existing item. | |||||||||||
Update an existing payment. | |||||||||||
Update an existing task. | |||||||||||
Update an existing tax. | |||||||||||
Verify a callback.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
Authorize an user using OAuth1.0a
requestTokenUrl | RequestTokenUrl |
---|---|
accessTokenUrl | AccessTokenUrl |
authorizationUrl | AuthorizationUrl |
callbackUrl | CallbackUrl for OAuth service |
requestTokenId | Optional value for identifying the requestToken. If it is not passed the client will use a UUID |
headers | Outbound headers |
ObjectStoreException | from the Object Store instance |
---|---|
OAuthCommunicationException | requesting to OAuth provider |
OAuthExpectationFailedException | requesting to OAuth provider |
OAuthNotAuthorizedException | requesting to OAuth provider |
OAuthMessageSignerException | requesting to OAuth provider |
Create a new callback for a specific event or a set of events.
Valid events
* all
* category
* category.create
* category.delete
* category.update
* client
* client.create
* client.delete
* client.update
* estimate
* estimate.create
* estimate.delete
* estimate.sendByEmail
* estimate.update
* expense
* expense.create
* expense.delete
* expense.update
* invoice
* invoice.create
* invoice.delete
* invoice.dispute
* invoice.pastdue.1
* invoice.pastdue.2
* invoice.pastdue.3
* invoice.sendByEmail
* invoice.sendBySnailMail
* invoice.update
* item
* item.create
* item.delete
* item.update
* payment
* payment.create
* payment.delete
* payment.update
* project
* project.create
* project.delete
* project.update
* recurring
* recurring.create
* recurring.delete
* recurring.update
* staff
* staff.create
* staff.delete
* staff.update
* task
* task.create
* task.delete
* task.update
* time_entry
* time_entry.create
* time_entry.delete
* time_entry.update
sourceToken | Source token value |
---|---|
callback | To be created |
accessTokenId | AccessTokenIdentifier |
Create a new category. If successful, returns the category id of the newly created item.
sourceToken | Source token value |
---|---|
category | To be created |
accessTokenId | AccessTokenIdentifier |
Create a new client and return the corresponding client_id. If a password is not supplied, one will be created at random.
sourceToken | Source token value |
---|---|
client | To be created |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Create a new invoice complete with line items. If successful, returns the invoice_id of the newly created invoice.
* If you don't specify an invoice number, it will increment from the last one.
* You may optionally specify a different address on the invoice; otherwise the address will be pulled from your client's details.
* You may optionally specify a return_uri element. If provided, users will be presented with a link to the URI when they pay the invoice.
sourceToken | Source token value |
---|---|
invoice | To be created |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Create a new item and return the corresponding item_id.
sourceToken | Source token value |
---|---|
item | To be created |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Create a license
sourceToken | Source token value |
---|---|
license | The license to be created |
accessTokenId | AccessTokenIdentifier |
Create a new payment and returns the corresponding payment_id.
This function can have one of three possible effects depending on the presence of invoice_id and client_id:
* If you specify an invoice_id only, the payment will be recorded as an invoice payment.
* If you specify a client_id only, the payment will be recorded as a client credit.
* If you specify both an invoice_id and client_id, the payment will be recorded as an invoice payment, and the amount will be subtracted from the client's credit.
Note that 'currency_code' can only be provided when creating a credit, not a regular payment. Regular payments will default to the currency code of the invoice they are being made against.
sourceToken | Source token value |
---|---|
payment | To be created |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Create a session
sourceToken | Source token value |
---|---|
session | The session to be created |
accessTokenId | AccessTokenIdentifier |
Create a system user. You don't need to be authenticated to call this processor.
sourceToken | Source token value |
---|---|
systemUser | The system user to be created |
userIdentifier | Identifier to be used for storing the accessToken |
ObjectStoreException | in case of failure storing the accessToken information |
---|
Create a new task and returns the corresponding task_id.
sourceToken | Source token value |
---|---|
task | To be created |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Create a new tax and returns the corresponding tax_id.
*Tax “name” must be unique. You may not create more than one tax with the same name.
sourceToken | Source token value |
---|---|
tax | To be created |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Deletes a callback.
sourceToken | Source token value |
---|---|
callback | To be deleted |
accessTokenId | AccessTokenIdentifier |
Delete an existing expense category.
sourceToken | Source token value |
---|---|
category | To be deleted |
accessTokenId | AccessTokenIdentifier |
Delete the client with the given client_id.
sourceToken | Source token value |
---|---|
client | To be deleted |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Delete an existing invoice.
sourceToken | Source token value |
---|---|
invoice | To be deleted |
accessTokenId | AccessTokenIdentifier |
Delete an existing item.
sourceToken | Source token value |
---|---|
item | To be deleted |
accessTokenId | AccessTokenIdentifier |
Permanently delete a license.
sourceToken | Source token value |
---|---|
license | To be deleted |
accessTokenId | AccessTokenIdentifier |
Permanently delete a payment. This will modify the status of the associated invoice if required.
sourceToken | Source token value |
---|---|
payment | To be deleted |
accessTokenId | AccessTokenIdentifier |
Permanently delete a task.
sourceToken | Source token value |
---|---|
task | To be deleted |
accessTokenId | AccessTokenIdentifier |
Permanently delete a tax.
sourceToken | Source token value |
---|---|
tax | To be deleted |
accessTokenId | AccessTokenIdentifier |
Extract accessToken
apiUrl | API URL |
---|---|
verifier | OAuth verifier. It comes within the callback. The default value is "#[header:inbound:oauth_verifier]" |
requestTokenId | Id used for identifying the authorized request token. It comes within the callback. By default the query string parameter is userId |
userIdentifier | Id used for store the accessToken in the Object Store. If it is not provided by the app the connector uses the username from FreshBooks |
ObjectStoreException | from the object store instance |
---|---|
OAuthCommunicationException | requesting to OAuth provider |
OAuthExpectationFailedException | requesting to OAuth provider |
OAuthNotAuthorizedException | requesting to OAuth provider |
OAuthMessageSignerException | requesting to OAuth provider |
Return the complete category details associated with the given category_id.
sourceToken | Source token value |
---|---|
categoryId | The category id |
accessTokenId | AccessTokenIdentifier |
Category
object
Return the client details associated with the given client_id.
sourceToken | Source token value |
---|---|
clientId | The client id |
accessTokenId | AccessTokenIdentifier |
Client
FreshBooksException |
---|
Returns information about the current user
sourceToken | Source token value |
---|---|
accessTokenId | AccessTokenIdentifier |
credentials | Provided by the app when the credentials are not stored yet |
Return the complete invoice details associated with the given invoice_id.
* You can use the links element to provide your customers with direct links to the invoice for editing, viewing by the client and viewing by an administrator.
sourceToken | Source token value |
---|---|
invoiceId | The invoice id |
accessTokenId | AccessTokenIdentifier |
Get an existing item with the given item_id.
sourceToken | Source token value |
---|---|
itemId | The item id |
accessTokenId | AccessTokenIdentifier |
Retrieve payment details according to payment_id.
sourceToken | Source token value |
---|---|
paymentId | The payment id |
accessTokenId | AccessTokenIdentifier |
Retrieve an existing task.
sourceToken | Source token value |
---|---|
taskId | The task id |
accessTokenId | AccessTokenIdentifier |
Retrieve tax details according to tax_id.
sourceToken | Source token value |
---|---|
taxId | The tax id |
accessTokenId | AccessTokenIdentifier |
Returns a list of addons summaries. Results are ordered by descending id.
sourceToken | Source token value |
---|---|
accessTokenId | AccessTokenIdentifier |
Return a list of registered callbacks. You can optionally filter by event or uri.
sourceToken | Source token value |
---|---|
callbackRequest | CallbackRequest CallbackRequest object |
accessTokenId | AccessTokenIdentifier |
Returns a list of expense categories.
sourceToken | Source token value |
---|---|
categoryRequest | CategoryRequest CategoryRequest Object |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Returns a list of client summaries in order of descending client_id.
sourceToken | Source token value |
---|---|
clientRequest | ClientRequest ClientRequest object |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Returns a list of invoice summaries. Results are ordered by descending invoice_id.
sourceToken | Source token value |
---|---|
invoiceRequest | InvoiceRequest InvoiceRequest object |
accessTokenId | AccessTokenIdentifier |
Returns a list of items, ordered by descending item_id.
sourceToken | Source token value |
---|---|
itemRequest | ItemRequest ItemRequest object |
accessTokenId | AccessTokenIdentifier |
Returns a list of licenses summaries. Results are ordered by descending license_id.
sourceToken | Source token value |
---|---|
licenseRequest | LicenseRequest LicenseRequest object |
accessTokenId | AccessTokenIdentifier |
Returns a list of payment summaries. Results are ordered by descending payment_id.
sourceToken | Source token value |
---|---|
paymentRequest | PaymentRequest PaymentRequest object |
accessTokenId | AccessTokenIdentifier |
Returns a list of tasks summaries.
sourceToken | Source token value |
---|---|
taskRequest | TaskRequest TaskRequest object |
accessTokenId | AccessTokenIdentifier |
Returns a list of taxs, ordered by descending tax_id.
Filters: Use a “compound” tag to return only compound or non-compound taxes.
sourceToken | Source token value |
---|---|
taxRequest | TaxRequest TaxRequest object |
accessTokenId | AccessTokenIdentifier |
Undelete a client
sourceToken | Source token value |
---|---|
client | To be undeleted |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Undelete an invoice
sourceToken | Source token value |
---|---|
invoice | To be undeleted |
accessTokenId | AccessTokenIdentifier |
Update an existing expense category with the given category_id. Any category fields left out of the request will remain unchanged.
sourceToken | Source token value |
---|---|
category | To be updated |
accessTokenId | AccessTokenIdentifier |
Update the details of the client with the given client_id. Any fields not referenced in the request will remain unchanged.
sourceToken | Source token value |
---|---|
client | To be updated |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Update an existing invoice with the given invoice_id. Any invoice fields left out of the request will remain unchanged.
* If you do not specify a lines element, the existing lines will remain unchanged. If you do specify lines elements the original ones will be replaced by the new ones.
sourceToken | Source token value |
---|---|
invoice | To be updated |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Update an existing item. All fields aside from the item_id are optional; by omitting a field, the existing value will remain unchanged.
sourceToken | Source token value |
---|---|
item | To be updated |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Update an existing payment. All fields besides payment_id are optional - unpassed fields will retain their existing value.
Note that 'currency_code' can only be provided when updating a credit, not a regular payment. Regular payments will default to the currency code of the invoice they are being made against.
sourceToken | Source token value |
---|---|
payment | To be updated |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Update an existing task.
sourceToken | Source token value |
---|---|
task | To be updated |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Update an existing tax. All fields aside from the tax_id are optional; by omitting a field, the existing value will remain unchanged.
sourceToken | Source token value |
---|---|
tax | To be updated |
accessTokenId | AccessTokenIdentifier |
FreshBooksException |
---|
Verify a callback.
sourceToken | Source token value |
---|---|
callback | To be verified |
accessTokenId | AccessTokenIdentifier |