vatnode - EU VAT Validation and Reverse Charge
| 开发者 | iuriirogulia |
|---|---|
| 更新时间 | 2026年8月19日 21:46 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
- Daily rate sync from the European Commission TEDB for the EU-27 plus XI
- Manual "Sync now" whenever you want it
- VAT number field on both the classic and block checkout
- Offline format checking against the country pattern
- VAT number stored on the order and shown in the admin
- Live VIES verification of the VAT number
- Automatic reverse charge for verified EU business buyers
- Company name from the official register stored with the order
- VIES consultation number stored as audit evidence, when your vatnode account has a requester VAT configured
- Empty field → nothing happens, VAT is charged
- Wrong format for the country, or a VAT country that does not match the billing country → the shopper is asked to fix it
- Same country as your store → domestic sale, VAT is charged
- Another EU country and VIES confirms the number → VAT removed, reverse charge applied
- VIES says the number does not exist → the shopper is asked to correct it or remove it
安装:
- Upload the plugin folder to
/wp-content/plugins/, or install it from the WordPress plugin directory - Activate it through Plugins → Installed Plugins
- Go to WooCommerce → EU VAT Rates — rates sync automatically on first activation
- Optional: paste a vatnode API key and save — VIES verification and the reverse charge switch on with it
屏幕截图:
常见问题:
Do I need an API key?
Only for live VAT number verification and the reverse charge. Rate syncing, the checkout field and format checking work with no key and no account.
Does it work with the block checkout?
Yes, both the block checkout and the classic shortcode checkout. On the block checkout the field appears in the contact section, and the total updates as soon as a valid number is entered.
What happens if VIES is down?
The order is placed with VAT charged as usual and a note is added to the order explaining that the number could not be verified. Checkout is never blocked.
How often do EU VAT rates actually change?
More often than you would expect. Estonia raised its standard rate twice in recent years, Finland moved to 25.5%, and reduced rates change somewhere in the EU most years. Tracking this by hand is not realistic.
Does this replace my existing tax rates?
No. The plugin upserts rates named "VAT" per country code — insert if missing, update if already there. Rates with other names, and anything you added manually, are left alone.
Which countries can be validated?
VIES covers the 27 EU member states plus XI (Northern Ireland). Rate data covers those plus 17 other European jurisdictions, which are rate-lookup only.
Where is the VAT number stored?
On the order, together with the verification status, the registered company name and the VIES consultation number when one was issued. You can see all of it on the order screen in the WooCommerce admin.
Do Greek EL numbers work?
Yes. Greece issues VAT numbers under the EL prefix while the billing country is GR, and the plugin treats the two as the same country. An EL number on a Greek billing address validates, and a Greek store selling to a Greek business is correctly treated as domestic.
Does it work with HPOS?
Yes. The plugin declares compatibility with High-Performance Order Storage and with the cart and checkout blocks, and reads and writes order data through the WooCommerce CRUD layer either way.
Can I make the VAT number field mandatory?
Yes, there is a setting for it. Leave it off unless you sell to businesses only — consumers do not have a VAT number and would not be able to check out.
Is my API key sent anywhere else?
No. The key is stored in your own site and travels only to api.vatnode.dev, over HTTPS, in the request that validates a VAT number. It is masked down to its prefix on the settings screen and removed from the database when you uninstall the plugin.
Where do I get support?
Open a thread in the support forum for this plugin. Bugs and feature requests are also welcome on GitHub at https://github.com/vatnode/eu-vat-rates-wp.
更新日志:
- Fixed: the bundled Irish VAT number pattern accepted a few check-letter combinations VIES never issues; the offline format check is now precise for both the old and new Irish number formats
- Translated into 34 languages: every official EU language plus Albanian, Arabic, Bosnian, Chinese, Hindi, Portuguese (Brazil), Russian, Serbian, Turkish, Ukrainian and Vietnamese
- The settings screen, the checkout field and every message shown to a shopper now follow the language of the site
- The full EU VAT rate dataset now ships inside the plugin, so rates, country patterns and the settings screen work on a site with no outbound network access at all. The daily refresh only replaces it when a newer dataset is published
- Internal names — options, hooks, classes, script handles and the settings page address — now all carry the vatnode prefix, so nothing can collide with another plugin. Existing settings, including a saved API key, are carried over automatically
- Fixed: Greek VAT numbers were rejected at checkout. Greece issues them under the EL prefix while the billing country is GR, and the two are now treated as one country — a Greek B2B checkout works, and a domestic Greek sale is no longer mistaken for a cross-border one
- Fixed: when the rate source could not be reached and the local cache had expired, every VAT number was reported as invalid and the checkout was blocked. The last known-good dataset is now kept on the site and used instead, and a number that cannot be checked never blocks an order
- Rate refreshes no longer happen inside a shopper's request; a stale cache schedules a background sync and serves the last known-good data meanwhile
- Added Settings and Get an API key links to the plugin row on the Plugins screen
- A newly saved API key is checked immediately, so a typo shows up on the settings screen instead of in the first B2B order
- VIES validation is now on by default, so pasting a key is the only step needed
- Uninstall now also removes the OSS setting and the cached rate dataset
- Rates are now synced only for the EU-27 plus XI; rates this plugin previously wrote for non-EU countries are removed on the next sync, so an export is no longer taxed at the destination country's rate
- Added an OSS setting: untick it to charge your own country's rate to every EU buyer, as applies below the EU-wide 10,000 EUR threshold
- Added VAT number field to the classic and block checkout
- Added offline VAT number format checking (no key required)
- Added live VIES validation and automatic reverse charge via a vatnode API key
- Verification result, company name and VIES consultation number stored on the order
- Daily auto-sync is now free for everyone; the paid plugin licence has been removed
- Fixed: synced rates were linked to a country location row, which stopped WooCommerce from applying them at all — existing installs are repaired on the next sync
- Fixed: the last sync time is shown in the site's own date format instead of a raw timestamp
- The stored API key is now masked down to its prefix on screen
- Declared HPOS and cart/checkout blocks compatibility
- Initial release
- Sync standard EU VAT rates from EC TEDB
- Daily auto-sync via WP-Cron
- Manual sync button
- Admin dashboard with sync status and full rates table