Avalara Integration

AvaTax Account Details

To instruct BillForward to make use of AvaTax when performing tax calculations an avatax-configuration object must be created.

The avatax-configuration object stores the following Avalara account details: login details (username and password), license code, account number, company code and company id

Example:

{
    "username": "avalara@billforward.net",
    "password": "********",
    "licenseCode": "2246101626426",
    "accountNumber": "1123581321",
    "companyCode": "example_company",
    "companyID": "123456",
    "organizationID": "ORG-E58BC014-3EC5-11E6-BC39-D5511267"
}

If AvaTax is enabled we will ignore any taxation-strategies linked against product-rate-plans.

Address Validation

AvaTax requires a valid address to calculate the correct tax jurisdiction of end customers. If AvaTax support is enabled BillForward will apply additional address validation upon address creation and update.

Note: If a BillForward account does not have any associated addresses and AvaTax support is enabled, it will not be possible to create subscriptions for that account.

Quoting

The BillForward quoting system makes use of AvaTax to generate quotes inclusive of tax. A record of the calculation will not be created in AvaTax.

If an account to be quoted does not have an associated address then it will only be possible to generate a quote exclusive of tax.

Invoice Generation

When an invoice is generated AvaTax will be used to calculate the tax associated with it.

A record of the calculation will be created in AvaTax but will not be committed until the invoice has been successfully paid.

An AvaTax transaction may have a maximum of 15,000 lines. The number of invoice-lines associated with the invoice must not exceed this limit.

Invoice Recalculation

When an invoice is recalculated AvaTax will be used to recalculate the tax associated with it.

The AvaTax record for this invoice will be updated but will not be committed until the invoice has been successfully paid.

Voiding

If an invoice is voided in BillForward any associated tax calculation in AvaTax will also be voided.

Refunds

When a paid invoice is refunded the tax calculation associated with it in AvaTax will be voided.


Avalara Downtime

Avalara services may experience downtime. If this occurs it will not be possible to create or start subscriptions. Any recurring subscriptions due to enter their next period will be queued until the Avalara service comes back online.

The Avalara status page is accessible here: Status Page


Structure

AxTax Structure