TaxJar ERPNext
TaxJar ERPNext connects ERPNext selling documents to TaxJar so US-based companies can calculate sales tax at quote, order, and invoice time without maintaining rate tables by hand. The integration respects nexus, product tax categories, and exemptions, then optionally reports completed sales back to TaxJar for compliance workflows such as AutoFile.
Each company that uses TaxJar gets its own TaxJar Account: API credentials, nexus list, and GL mapping stay separate in multi-company sites. Tax is calculated on Quotation, Sales Order, and Sales Invoice when the ship-to destination is in a nexus state. Optional features extend that baseline—estimated tax on quotes for non-nexus states, ToDo alerts when orders ship outside nexus, and transaction sync when invoices are submitted.
This documentation is the user guide and technical reference for installing, configuring, and operating the app. Start with Setup to install and configure a site; use Integration for hooks, data model, and API behavior; see Troubleshooting and contributing for common failures, development, and licensing.
In this section
- Setup — Installation, prerequisites, TaxJar Account configuration, and what to expect on each selling document.
- Integration — Hooks, DocTypes, custom fields, calculation pipeline, transaction sync, and limitations.
- Troubleshooting and contributing — Symptom checklist, running tests, license, and acknowledgements.
Development and testing
- Hooks entry point:
hooks.py. - Whitelisted DocType method:
TaxJar Account.update_nexus_list. - Integration tests:
taxjar_erpnext/tests/(test_sales_tax.py,test_taxjar_account.py). Fixture loading uses test_utils. - Load fixture data once on a test site, then run pytest from the bench:
bench execute 'taxjar_erpnext.tests.setup.before_test' cd frappe-bench && source env/bin/activate && pytest apps/taxjar_erpnext/ --disable-warnings -s -v - CI:
.github/workflows/(lint, pytest, release, and related workflows).
License and acknowledgements
License: This project is distributed under the MIT License. The full text is in the repository license.txt at the app root (same folder as pyproject.toml).
Acknowledgements: This project is a fork of the original TaxJar Integration developed by Frappe. Thanks to the Frappe team and all contributors to the upstream project.