less than a minute read • Updated 44 minutes ago
Third-party Tax Services Overview
How third-party tax services work with Foxy, including how a provider overrides other rates and why displayed and charged tax can differ slightly.
Overview
Foxy integrates with full tax services for automatic rates, filing data, and broader coverage. These notes apply to Avalara AvaTax, TaxJar, Thomson Reuters ONESOURCE Indirect, and any other third-party tax integration. Read them before setting up a specific provider: Set up Avalara AvaTax, Set up TaxJar, Set up Thomson Reuters ONESOURCE.
Configuration rules
Configure providers at the country level. State or province configuration may still be allowed but will be disallowed in a future update. You do not need to list every state; the service knows where you should collect.
Use one provider, and do not mix. Do not mix provider and non-provider rates within a single country, and do not use different providers within one store.
Multi-ship is currently supported only by Avalara. (ONESOURCE Indirect can technically support it; contact Foxy to discuss a custom implementation.)
Displayed vs charged tax
Foxy always charges the total the provider returns. Before the transaction completes, the rates shown on the cart and checkout are calculated dynamically by Foxy from the provider's rate, so the displayed amount can be slightly off (typically about 1¢ from rounding). Once the transaction completes, the tax on the receipt and in the admin matches the provider exactly. If this matters, you can change the "Tax" language string in your admin to "Tax (estimated)".