Description
Kintsugi AI Tax connects your store to Kintsugi, a tax automation service. When tax calculation is turned on, the plugin asks your Kintsugi account for the tax on each WooCommerce checkout. Kintsugi uses the same order data to monitor where you owe tax and to prepare, file, and remit your returns.
A Kintsugi account is required. The plugin connects your store to the Kintsugi service and does not calculate tax on its own. You can create an account at https://app.trykintsugi.com/.
What the plugin does
- Calculates sales tax, VAT, and GST at checkout for orders in the United States, Canada, and the European Union
- Keeps your Kintsugi account up to date as orders and refunds change in your store
- Lets you turn tax calculation and webhook processing on or off from the plugin settings
What your Kintsugi account does
- Monitors your sales against economic nexus thresholds in each jurisdiction
- Registers your business in new jurisdictions
- Prepares, files, and remits your returns
- Stores exemption certificates for tax-exempt customers
- Supports back filing when you find past obligations
Which of these are included depends on your Kintsugi plan. Nexus monitoring is available on the free plan. Registration, filing, remittance, and tax calculation at checkout need a paid plan.
Requirements
- PHP 8.2 or higher
- WordPress 6.8 or higher
- WooCommerce 10.0.0 or higher
- A Kintsugi account and API key
- WooCommerce REST API keys (Read/Write) when connecting the store from Kintsugi Data Sources
Coverage
Checkout tax calculation covers the United States, Canada, and the European Union. For stores that ship elsewhere, Kintsugi imports and monitors your WooCommerce data, and checkout calculation is not applied outside those regions.
Compliance
Kintsugi helps your business meet its sales tax, VAT, and GST obligations. No plugin or service can guarantee legal compliance, and you remain responsible for your store’s tax obligations. Kintsugi’s service performs the calculation, registration, filing, and remittance work included in your plan.
Known limitations
- Manual refund and Recalculate actions apply at the parent order only
External Services
This plugin connects to the Kintsugi API at api.trykintsugi.com. The plugin makes no connection until you enter a Kintsugi API key in the plugin settings.
Data sent to Kintsugi:
- At checkout, the cart items, the store address, and the customer’s shipping and billing address, to calculate tax
- When orders or refunds change, the order or refund details needed to keep your Kintsugi account in sync
The service is provided by Kintsugi AI, Inc. Terms of Service: https://trykintsugi.com/terms-of-service. Privacy Policy: https://trykintsugi.com/privacy-policy.
Screenshots
Installation
- In WooCommerce, go to Settings, then Advanced, then REST API, and add a key with Read/Write permission. Create the key under a WordPress user with the Administrator or Shop Manager role.
- In Kintsugi, go to Data Sources, choose WooCommerce, and enter your shop domain, admin URL, consumer key, and consumer secret.
- In WordPress, go to Plugins, then Add New Plugin, search for Kintsugi AI Tax, then install and activate it.
- In Kintsugi, go to Configurations, then API Keys, and create a key.
- In WordPress, open the Kintsugi plugin settings, paste the key, and select Connect to Kintsugi.
- Select Enable Kintsugi AI Tax Calculation and Webhook Processing.
- In Kintsugi, open Data Sources, then Manage Integration, then WooCommerce, and select Enable Tax Collection.
The full guide, including firewall and Cloudflare settings, is in the Kintsugi help center: https://help.trykintsugi.com/en-US/trykintsugi/article/n4SbcmCo-woocommerce-tax-engine-integration-guide
FAQ
-
Do I need a Kintsugi account?
-
Yes. The plugin works with a Kintsugi account and does nothing without one.
-
Does this replace WooCommerce’s tax settings?
-
WooCommerce still displays tax at checkout. When Kintsugi tax calculation is turned on, the amounts come from Kintsugi.
-
Which countries does checkout calculation cover?
-
The United States, Canada, and the European Union.
-
My connection fails with a 403 error. What should I check?
-
Confirm the WooCommerce REST API key belongs to a user with the Administrator or Shop Manager role. Then check that your firewall, Cloudflare, or security plugin allows Kintsugi requests to /wp-json/wc/. The help center article linked above lists the settings.
-
Where do I get support?
-
Use the Kintsugi help center at https://help.trykintsugi.com/ or the chat in the Kintsugi app. You can also post in this plugin’s support forum on WordPress.org.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Kintsugi AI Tax” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Kintsugi AI Tax” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.5
- Fix – Safe activation when WooCommerce is not installed (Requires Plugins: woocommerce).
- Fix – Guard WooCommerce logger calls when WooCommerce is unavailable.
- Fix – Privacy Policy URL, Contributors field, and readme claims that did not match plugin behavior.
- Update – Package slug and text domain renamed to kintsugiai-tax; display name Kintsugi AI Tax.
- Update – Exclude translation catalog files from the distribution zip.
1.0.4
- Initial release on WordPress.org.