Reference · built on requestConnectorPayments, billing & fraud

TaxJar

Sales tax calculations, rates, transactions, customers, and nexus regions from TaxJar through the v2 API.

About

TaxJar is a sales tax calculation service. Its v2 API at api.taxjar.com calculates tax for an order, returns rates by location, lists product tax categories, and stores order and refund transactions, customers, and nexus regions. It is versioned by an x-api-version date header, and a sandbox host serves plans at Professional or higher.

Through Fibric an operator reads rates, transactions, and nexus regions, and proposes transaction uploads or customer exemption changes for your approval, each with a receipt.

This is a reference listing. It documents what Fibric would read from TaxJar and what it could propose, based on the vendor's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Tax calculations for an order through POST /v2/taxes, with a breakdown by jurisdiction and line item
  • Rates for a location through GET /v2/rates/:zip and summarized rates through GET /v2/summary_rates
  • Order and refund transactions through GET /v2/transactions/orders and /v2/transactions/refunds, filtered by date and provider
  • Nexus regions through GET /v2/nexus/regions
  • Customers and their exemption_type through GET /v2/customers
  • Address validation results through POST /v2/addresses/validate

Proposed actions

  • Target capability: propose recording an order through POST /v2/transactions/orders
  • Target capability: propose recording or updating a refund through /v2/transactions/refunds
  • Target capability: propose creating or deleting a customer record through /v2/customers
  • Target capability: propose deleting an order transaction through DELETE /v2/transactions/orders/:transaction_id

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Know when a state crosses nexus

    Order transactions are summed by state and compared with nexus regions on file. States nearing a threshold are written up for a person to decide.

    With Nexus Threshold

  • Keep exemptions consistent

    Customers with exemption_type wholesale, government, or marketplace are matched to orders taxed in full. Mismatches are proposed as fixes.

    With Tax Exemption

  • Validate the ship-to first

    POST /v2/addresses/validate is run on new orders. Suggested corrections go to the order system as proposals.

    With Address Repair

  • Reconcile what was recorded

    Transactions recorded through the API are compared with the order system by date. Gaps are listed before a return is filed.

    With Metric Reconciliation

Requirements

  • A TaxJar account and an API token
  • A TaxJar Professional or higher plan for the sandbox environment
  • Nexus regions set in your TaxJar account, or passed as nexus_addresses on each calculation
  • An x-api-version header pinned to a date, such as 2022-01-24
Authentication
An API token sent as a Bearer token in the Authorization header; sandbox tokens are separate and point at api.sandbox.taxjar.com.

Limits

  • Requests are limited to 10,000 per minute on Professional plans and 25,000 on Premium plans; 429 beyond that
  • Each calculation or rate lookup counts as a transaction toward your monthly plan limit, with overage fees
  • Sandbox results are for validating an integration and are not to be relied on for accurate rates
  • No webhooks are documented; changes are found by polling transactions by date

Access and pricing

Reference listing. Fibric builds the connector under a managed deployment when you request it. Your quote covers the build, capabilities, usage, and support.

Request TaxJar ↗

Questions and answers

How is the TaxJar API versioned?
By date in the x-api-version header. Documented versions are 2012-01-01, 2020-08-07, and 2022-01-24. The latest is the default for accounts created after February 3, 2022.
What are the rate limits?
10,000 requests per minute on TaxJar Professional plans and 25,000 per minute on Premium. Above that the API returns 429. TaxJar suggests calculating only where you have nexus, caching unchanged orders, and using summarized rates as a fallback.
Does TaxJar have a sandbox?
Yes, at api.sandbox.taxjar.com, for Professional or higher plans. You generate a separate sandbox token. Calculations return similar results to production but are meant to validate an integration, not to give accurate rates in every case.
Ask about TaxJar

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.