TaxJar

What it does

TaxJar receives a copy of every completed order so your sales tax returns reflect real sales. When an order is paid, the plugin sends it to your TaxJar transaction list with the VeloCMS order ID as the transaction ID, the order date, the buyer's shipping address as the destination, the amount before tax, the shipping charge, the sales tax that was already collected, and every line item. It is a reporting connector, not a calculator. Tax at checkout is still worked out by Stripe Tax, and this plugin only passes along what was collected. It never adds tax to a sale and never changes an order.

Who it's for

Store owners who sell taxable goods, already have a TaxJar account for filing, and collect tax at checkout with Stripe Tax. It saves you from entering sales into TaxJar by hand or exporting them each period. If you do not collect sales tax, or you do not use TaxJar for returns, this plugin has nothing useful to do for you.

How it works

1. 01

   In TaxJar, copy your API token from Account, SmartCalcs API. In VeloCMS, open the TaxJar plugin, paste the token, enter your nexus address, switch on Enable TaxJar and save. The token is stored encrypted.

2. 02

   Press Test Connection. VeloCMS asks TaxJar for a zero-amount tax estimate using your saved address. Nothing is filed.

3. 03

   When an order is paid, VeloCMS works out the tax that was already collected on it from the order records, not from a guess.

4. 04

   VeloCMS sends the finished order to your TaxJar transaction list in the background. An order whose collected tax is unknown is skipped and marked, not filed.

Settings you configure

Enable TaxJar

Starts switched off. While it is off, no order is sent, even if a token is saved.

API Token

Found in TaxJar under Account, SmartCalcs API. Stored encrypted and never shown back after you save.

Nexus / ship-from address

The origin address TaxJar treats as where you sell from. Only the ZIP and country are required for it to be sent along with each order.

Default product tax code

Optional. Applied to any line item that has no tax code of its own. TaxJar lists the codes under Product Tax Codes.

Test Connection

Checks the saved settings, so save first. It requests a zero-amount tax estimate and files nothing.

What it can access

After a paid order, the plugin reads the order ID and date, the total, the shipping cost, the tax collected on each item, the buyer's shipping address and the items bought. It sends those details to api.taxjar.com and nowhere else. It does not read your posts or members. Your TaxJar API token is stored encrypted and is never shown back in plain text.

Honest limits

• It reports only. Tax at checkout is calculated and collected by Stripe Tax if you have it switched on, and this plugin never adds or changes tax on a sale.

• If Stripe Tax is on but no collected tax was recorded for an order, that order is marked Skipped with the reason and is not sent. A made-up figure would corrupt a return, so you add that order to TaxJar by hand.

• If Stripe Tax is off and no tax was recorded, the order is sent with zero sales tax.

• An order without a shipping address that has both a country and a postal code, which is typical of digital-only purchases, has no destination and is skipped quietly.

• If TaxJar rejects the token or is unreachable, the sale still goes through. The failure is recorded in the connector activity and is not retried automatically.

• Refunds are not reported to TaxJar by this plugin. Only completed orders are sent.

• Orders placed before you connected are not sent.

Frequently asked questions

Related plugins

• Shippo
• ShipStation
• Printful

Specifications

Category

Commerce

Price

Included

Version

1.1.0

Source

First-party