Linux 软件免费装
Banner图

VAT Sentinel

开发者 flexpoint
更新时间 2026年7月28日 13:35
PHP版本: 7.4 及以上
WordPress版本: 7.0
版权: GPLv2 or later
版权网址: 版权信息

标签

woocommerce vies eu vat reverse charge vat validation

下载

0.1.0

详情介绍:

VAT Sentinel adds a VAT number field to your WooCommerce checkout for EU/EEA business buyers, validates it against the European Commission's official VIES service, and applies the cross-border B2B reverse charge when the number is valid. Every check is recorded with a UTC timestamp. The difference: when VIES is unavailable (which happens regularly and is outside any vendor's control), VAT Sentinel does not break your checkout. It accepts the order, flags it as "VAT pending verification", and lets you re-check it once VIES recovers. VAT Sentinel is a validation and record-keeping tool. It is NOT tax advice and does not guarantee tax compliance. Always consult your own tax advisor. Works on the block checkout, the modern WooCommerce default (it uses the WooCommerce Additional Checkout Fields and Store API, so it requires WooCommerce 8.9 or newer). The VAT number field does not currently appear on the legacy classic (shortcode) checkout — if your store still uses the classic checkout, switch to the block checkout to use VAT Sentinel. Free Pro (planned) A paid Pro version is planned for the future. It is not available yet, and this free version is complete and usable on its own.

屏幕截图:

  • An invalid VAT number keeps VAT charged, and the buyer is told why. When VIES itself is down, the buyer sees an honest "temporarily unavailable" message instead of a broken checkout.
  • Every check is recorded with a UTC timestamp, including the business name and address VIES returned and the official consultation number when the member state provides them.
  • Each order shows a VAT Sentinel box: the number checked, the result, whether reverse charge was applied, and the VIES-returned business identity.
  • Settings and the live per-country VIES status panel, straight from the European Commission.

常见问题:

Why doesn't the VAT number field show at checkout?

The most common reason: your store uses the legacy classic (shortcode) checkout. The field is registered through the WooCommerce Additional Checkout Fields API, which renders on the block checkout (the WooCommerce default) — it does not appear on the classic checkout. Beyond that, the field appears when the cart is taxable, and it requires WooCommerce 8.9 or newer. If another plugin replaces or heavily customizes your checkout, the field may not render there.

The VAT number is valid — why was VAT not removed?

Reverse charge only applies to cross-border EU B2B sales: the buyer's billing country must be an EU country different from your store's base country. A domestic order keeps VAT even with a valid VAT number. And if VIES was unreachable at the time, the default safe mode keeps VAT charged (see below).

What happens when VIES is down?

By default (safe mode) the order is still accepted, VAT is charged, and the order is flagged "VAT pending verification" with a manual re-check button for when VIES recovers. There is an opt-in setting to apply reverse charge provisionally instead, clearly marked "at your own risk". Either way your checkout never breaks because VIES is down.

Why is my order flagged "VAT pending verification"?

The VIES service was unavailable when the order was placed, so we accepted the order rather than blocking your sale and flagged it for re-checking. Until VIES confirms the number, the VAT treatment on this order is provisional and may be adjusted. VAT Sentinel records the check; it does not certify the order's tax treatment. Use the re-check button once VIES is back up.

Is VIES down right now?

Open the VAT Sentinel status panel; it shows live per-country availability straight from VIES.

VIES returned no business name or address. Is something wrong?

No. Some EU member states do not return the trader's name or address (Germany, for example). The validity result and the consultation reference still stand; the log shows "not provided by VIES" for those fields.

Does VAT Sentinel change my invoices or PDF documents?

No. It validates the number, adjusts the order's VAT via the standard WooCommerce exemption, and writes an internal order note plus an audit record. It does not generate or modify invoices, and it does not add reverse-charge wording to invoice documents — your invoicing plugin or accounting tool must do that.

Where are the validation records stored?

In your own WordPress database: an append-only audit table (wp_vatsentinel_vat_log, with your table prefix) plus meta fields on each order. Nothing is sent to the plugin author.

What is the consultation reference and how do I get one?

Enter your own business VAT number in VAT Sentinel's settings. Validations are then made with your number as the requester, and VIES returns an official consultation number that is stored with the check — dated evidence that the validation was performed. Without your merchant VAT number configured, checks still work but VIES does not issue a consultation number.

What happens to my records if I uninstall the plugin?

Uninstalling removes the plugin's settings but deliberately keeps the audit table and order data, because validation records are tax evidence you are commonly required to retain for years. If you truly want them gone, remove the wp_vatsentinel_vat_log table and the order meta manually.

Can I run VAT Sentinel together with another VAT/tax plugin?

Use one VAT validation plugin at a time. Two plugins that both set the customer's VAT exemption will fight each other and can produce wrong totals. General tax-rate plugins are fine; a second VIES/VAT-number plugin is not.

Does this make me VAT compliant?

No. VAT Sentinel validates numbers and keeps proof that you checked. It is not tax advice and does not guarantee compliance. Consult your tax advisor.

更新日志:

0.1.0