TaxJar Integration
With TaxJar integration, ERPNext can calculate accurate sales tax during transactions without requiring manual tax configuration for every state or jurisdiction. The integration uses your TaxJar account settings, Nexus locations, and customer addresses to determine the applicable taxes.
How to Set Up TaxJar
- Create a TaxJar account.
- Obtain your API credentials.
- Configure Nexus locations in TaxJar.
- Configure TaxJar Settings in ERPNext.
- Verify company and customer addresses.
- Enable automatic tax calculation.
Create a TaxJar Account and Obtain API Keys
- Create a TaxJar account based on your business requirements.
- Log in to your TaxJar dashboard.
- Navigate to Account → TaxJar API.
- Copy your API credentials.
- Keep both the Live API Key and Sandbox API Key available for ERPNext configuration.
Configure Nexus Locations
Nexus represents the states or regions where your business has sufficient business presence and is legally required to collect sales tax.
Before enabling the integration, configure all applicable Nexus states within your TaxJar account.
- Your business automatically has Nexus in its home state.
- Add every additional state where tax collection is legally required.
- Only customers located in Nexus states will have taxes calculated according to TaxJar rules.
Configure TaxJar in ERPNext
Open the TaxJar Workspace and navigate to TaxJar Settings.
Configure the following settings:
- Live API Key
- Sandbox API Key
- Tax Account
- Shipping Account
- Enable Tax Calculation
- Create TaxJar Transactions
- Enable automatic tax calculation.
- Enable transaction creation so ERPNext sends completed transactions to TaxJar.
- Configure appropriate Tax and Shipping accounts before saving the settings.
Sandbox Mode
TaxJar provides a dedicated Sandbox environment for testing integrations without affecting live tax records.
- Use the Sandbox API Key while testing.
- Sandbox transactions are not recorded in your production TaxJar account.
- This mode is recommended during implementation and testing.
Enable TaxJar Logging
ERPNext can record every request sent to TaxJar along with the response received.
| Setting | Behavior |
|---|---|
| Logging Enabled | Requests, responses, skipped records, and errors are stored in the TaxJar API Log. |
| Logging Disabled | Tax calculation continues normally, but no API logs are generated. |
Configure Tax and Shipping Accounts
After entering the API credentials:
- Enable Tax Calculation.
- Enable Create TaxJar Transaction.
- Select the Tax Account.
- Select the Shipping Account.
- Save the configuration.
Configure Addresses Correctly
Verify that addresses contain:
- City
- State or Province
- Country
- Postal Code
When entering the state:
- Use the correct state name.
- ERPNext automatically converts state names to the required two-letter state code when communicating with TaxJar.
Configure preferred Billing and Shipping Addresses for customers to reduce manual entry and improve tax calculation accuracy.
How Tax Calculation Works
- Create a Sales Invoice.
- Select the Customer and Delivery Address.
- Save the document.
- ERPNext sends the transaction details to TaxJar.
- TaxJar calculates taxes using the configured Nexus rules.
- The calculated taxes are automatically added to the Sales Invoice.
- If enabled, the transaction is also recorded in your TaxJar account.
Important Notes
- Tax calculations depend on correctly configured company and customer addresses.
- Nexus locations must be configured in your TaxJar account before using automatic calculations.
- Disable any unnecessary default tax templates that could conflict with TaxJar’s automatic tax calculation.
- Sandbox transactions are intended only for testing and do not appear in the production TaxJar dashboard.