| java.lang.Object | |
| ↳ | org.mule.modules.freshbooks.FreshBooksConnector |
Known Direct Subclasses
|
Known Indirect Subclasses
|
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 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
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 |