Skip to main content

TaxJar Integration

Overview: TaxJar integration enables ERPNext to automatically calculate sales taxes based on the addresses of your company, customers, and delivery locations. It also allows tax transactions to be synchronized with your TaxJar account for reporting and compliance.

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

Setup Summary

  • 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

  1. Create a TaxJar account based on your business requirements.
  2. Log in to your TaxJar dashboard.
  3. Navigate to Account → TaxJar API.
  4. Copy your API credentials.
  5. Keep both the Live API Key and Sandbox API Key available for ERPNext configuration.
Result: These API keys allow ERPNext to securely communicate with your TaxJar account for tax calculations and transaction synchronization.

Configure Nexus Locations

What is Nexus?
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.
Tip: Review your business’s Nexus obligations carefully before configuring TaxJar to ensure accurate tax collection.

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
Recommended Configuration
  • 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.
Best Practice: Complete all testing in Sandbox Mode before switching to the Live API Key.

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.
Tip: Enable logging during implementation or troubleshooting to quickly identify configuration or API issues.

Configure Tax and Shipping Accounts

After entering the API credentials:

  1. Enable Tax Calculation.
  2. Enable Create TaxJar Transaction.
  3. Select the Tax Account.
  4. Select the Shipping Account.
  5. Save the configuration.
Result: Every eligible ERPNext sales transaction is automatically submitted to TaxJar for reporting and tax analysis.

Configure Addresses Correctly

Accurate addresses are essential because TaxJar calculates taxes based on geographic location.

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.
Recommendation:
Configure preferred Billing and Shipping Addresses for customers to reduce manual entry and improve tax calculation accuracy.

How Tax Calculation Works

Automatic Tax Workflow
  1. Create a Sales Invoice.
  2. Select the Customer and Delivery Address.
  3. Save the document.
  4. ERPNext sends the transaction details to TaxJar.
  5. TaxJar calculates taxes using the configured Nexus rules.
  6. The calculated taxes are automatically added to the Sales Invoice.
  7. 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.
Rating: 0 / 5 (0 votes)