Tax integration
Kill Bill and Avalara AvaTax
Add US sales tax to every Kill Bill invoice with Avalara AvaTax. Tax is calculated when the invoice is generated and added as separate tax lines. The plugin is open source and maintained by the Kill Bill team.
Last updated: October 2026
Short answer
Does Kill Bill work with Avalara?
Yes. The AvaTax plugin sends each invoice's line items and the customer's address to Avalara AvaTax when the invoice is generated. Avalara returns the sales tax, and Kill Bill adds it as TAX lines next to the items they apply to. Tax codes, exemptions and dry-run previews are handled in Kill Bill. Kill Bill does not file tax returns.
- Plugin
- Open source, Apache 2.0
- Maintained by
- The Kill Bill team
- Calculates
- Sales tax by state, county and city
- On the invoice
- TAX lines next to the items they apply to
- Exemptions
- Avalara entity use code on the account
- Configuration
- Per tenant: URL, account ID, license key, company code
How it works
From Invoice to Tax Lines
- 1Connect your Avalara accountUpload the AvaTax URL, account ID, license key and company code for each tenant.
- 2Map products to tax codesGive each catalog product its Avalara tax code, so products are taxed differently where needed.
- 3Generate the invoiceKill Bill sends the invoice line items and the account address to AvaTax.
- 4Add tax linesAvaTax returns the tax for each line. Kill Bill adds it as TAX items, next to the items they apply to.
- 5Preview, commit, voidDry runs preview the tax without committing. Documents can be committed to Avalara, and retrieved or voided through the plugin.
Example
Sales Tax on a Kill Bill Invoice
Each jurisdiction returned by Avalara becomes its own tax line.
Invoice with AvaTax sales taxIllustrative example
| Line | Type | Amount (USD) |
|---|---|---|
| Pro plan, monthly | RECURRING | 100.00 |
| Sales tax, state | TAX | 6.00 |
| Sales tax, county | TAX | 1.00 |
| Sales tax, city | TAX | 0.50 |
| Total | 107.50 |
Illustrative example with made-up rates. Actual rates come from Avalara for the customer's address and the product's tax code.
Who does what
Avalara Calculates, Kill Bill Invoices
Avalara holds the tax rules and rates. Kill Bill builds the invoice, asks for the tax and records it.
| Task | Avalara | Kill Bill |
|---|---|---|
| Tax rates and jurisdiction rules | Avalara | · |
| Address check during tax calculation | Avalara | · |
| Tax code catalog | Avalara | · |
| Invoices and line items | · | Kill Bill |
| Tax lines on the invoice | · | Kill Bill |
| Tax codes per catalog product | · | AvaTax plugin |
| Tax-exempt accounts | · | Kill Bill |
| Tax preview on dry-run invoices | · | Kill Bill |
| AvaTax screens in the admin UI | · | Kaui |
Choosing a tax engine
AvaTax or Aviate Tax?
Kill Bill also works with Vertex and Kintsugi. For VAT or GST at country level, Aviate includes its own tax module.
- US sales tax by state, county and city
- Avalara tax codes per product
- Exemptions with entity use codes
- Needs an Avalara account
- Open source plugin, works with Kill Bill and Aviate
Aviate Tax- VAT or GST rates you set per product and country
- Rates with validity dates
- Exempt flag per account
- No third-party tax engine
- Part of Aviate, country level only
Setup demo
Install and Configure the Plugin
A click-through demo of installing the AvaTax plugin and connecting an Avalara account.
If the demo does not load, open it in a new tab.
FAQs
Frequently Asked Questions
Does Kill Bill integrate with Avalara?
Yes. The open source AvaTax plugin, maintained by the Kill Bill team under the Apache 2.0 license, sends invoice line items to Avalara AvaTax when an invoice is generated, and adds the returned tax as TAX lines on the Kill Bill invoice.
Which taxes does the AvaTax plugin calculate?
Sales tax, delegated to Avalara AvaTax. The plugin returns tax by state, county and city, using the address on the Kill Bill account. An active Avalara account is required.
How do I map products to Avalara tax codes?
Store a tax code for each catalog product with the plugin's tax code API, set a taxCode custom field on an invoice item, or pass the tax code as a plugin property. Products with different tax codes are taxed differently.
Can some customers be tax exempt?
Yes. Set the customerUsageType custom field on the Kill Bill account, with the Avalara entity use code that applies, for example E for charitable organizations. Tax calculation can also be skipped for an account at runtime.
Can I preview the tax before an invoice is issued?
Yes. Dry-run invoices include a preview of the tax lines, and the matching document is not committed to Avalara.
Are invoices committed to Avalara?
Only if you turn on the commitDocuments option. The plugin also offers pass-through APIs to retrieve, commit and void documents. Documents are not voided automatically, because that depends on your dunning rules.
Should I use AvaTax or Aviate Tax?
AvaTax suits US sales tax by state, county and city, with an Avalara account. Aviate Tax, part of Aviate, applies VAT or GST rates you set per product and country, without a third-party engine. It works at country level.
Does the AvaTax plugin cost anything?
The plugin is open source and free. You need your own Avalara account, under Avalara's terms.