HaloITSM Guides

To connect to Avalara, navigate to the Integrations page and turn on the module by hovering over the module and clicking the plus icon. 

Once enabled, click onto 'Avalara tenants' and then click new tenant in the top right. 

Then fill in in the information for your Avalara URL in the name field and your username and password: 

Your details will likely be for a production envrionment not a developer instance. Your username and password should be your Avalara login details (Company ID will automatically populate once you connect and choose a company) Make sure to save your details before adding the company and clicking on "test configuration". If you want to see if it has connected you can click Fn + F12 to open the web browser developer console and see the status: 200 (Connection is OK):

Then, navigate back to the Avalara main screen so you can set the Default tenant: 

So we can authenticate this connection in Avalara, navigate into the Avalara tenant you just created and click Create Certificate from within the customers tab.

When clicking on Create Certificate, you should see this screen popup:

Then you can import clients using the import clients button. These will match on name so you will need to ensure the customer names in Avalara and HaloPSA are an exact match to prevent duplication. 

Then, you can choose what entities you would like to sync to Avalara in the 'Syncing to Avalara' tab. 

The clients sync will pass information about the client back to Avalara. Invoices, Quotes, POs and SOs will sync across to Avalara when a button is pressed in the individual entity unless the 'Sync Taxes Automatically' checbox is checked.

Then, you will need to set a default tax code, default item and a default client. These defaults define what should sync to Avalara in the case of a client, item or tax code not being able to be returned from Avalara, however this should not be the case, but it is an Avalara requirement to be set.

The last part necessary is to set the Default Item at Item Group level to define the type of item that this group will be used for. This means that you will need to ensure that your items are grouped correctly (eg Software in a dedicated software group). 

*The group level setting is not currently applying the Avalara default item to each item in the group, the Avalara default item must be set from within the "Billing" tab of the item, or imported (Check to make sure you can match to existing items using the name field as the unique identifier, and then you can have a second column header to update the Avalara default item called "iavalaraitemcode" which is where you set the field for the Avalara item.*

The import screen should include the name of the Product and the Default Avalara product:

Then your taxes will be calculated by Avalara. The lines of the address used by Avalara are address line 1 and the ZIP code so these will need to be set correctly in your clients/sites. 

If you are looking to sync taxes manually instead of automatically, then you will need to click this button in each entity i.e. an invoice. With the setting in the integration "Sync Taxes Automatically" turned off, you will need to manually use this button to sync i.e. invoices to avalara: 

As of v2.156

Within Configuration > Billing > General Settings, you can enable the following setting:

When enabled and voiding invoices in Halo, this settings means that the transactions will also void in Avalara. Voiding an Invoice will reset the related invoice entities in Halo such as the Labour will go back into ready for invoicing and it will roll back a Recurring Invoice 'Next Creation Date'.