Gatemi VAT Number FAQ and Troubleshooting

Troubleshooting

The VAT number field does not appear at the checkout

Check, in order:

  1. Is the field switched on? WooCommerce → VAT Number → Ask for a VAT number at the checkout.
  2. Does the plugin know your country? The field is only shown when Your country is set, or your WooCommerce store address has a country (WooCommerce → Settings → General).
  3. Are you on the Checkout block with WooCommerce older than 8.9? The block field needs WooCommerce's Additional Checkout Fields API, added in 8.9. Update WooCommerce, or use the classic checkout.
  4. Are both editions active? The free edition stands down when the full edition is active. That is expected; the full edition shows the field.
  5. Is another plugin registering a block field with the id gatemi-vat/number? If WooCommerce refuses the registration, the block checkout carries no field rather than breaking the page.

The number is valid but the VAT did not come off

All four conditions must hold. The usual reasons:

  • The billing country is your own country. Domestic business sales are taxed. See Reverse charge in your own country.
  • The number's prefix does not match the billing country. A FR number with a German address is not exempted. (Greece is handled: billing GR matches prefix EL.)
  • It is an XI (Northern Ireland) number on the wrong kind of order. An XI number is matched to a United Kingdom (GB) billing address only when the cart has goods to deliver and the delivery postcode is a Northern Ireland one (it begins BT). A cart of downloads or services, or a delivery elsewhere in the UK, is not exempted — the XI prefix covers goods, not services. The checkout says so.
  • VIES could not be reached. The order box will say "VIES could not be reached, so the number was not confirmed." Both editions fail closed by default.
  • Your country setting is wrong. If Your country is set, it overrides your store address. Leave it empty to use the store address.

The order's VAT number box tells you which: the VIES status line, plus "Tax was removed" or "Tax was charged".

The checkout says "VIES does not recognise that VAT number"

VIES asked the issuing country, and that country said the number is not valid. Ask the customer to check the number and the country prefix. The VIES FAQ advises that if a number stays invalid, the customer should contact their own tax administration, because only national administrations can update VIES data. Some countries only list businesses registered for intra-EU trade.

Austrian numbers start ATU. Type the whole thing, for example ATU12345678.

The checkout says "That does not look like a VAT number"

The number has no recognised country prefix, or nothing after it that contains a digit. VAT numbers start with a two-letter prefix (DE, FR, EL for Greece…). UK GB numbers are not checked by VIES and are refused.

VIES was down; the customer has now asked for a refund

The order records the check as "unavailable" and the VAT as charged. Check the number yourself on the VIES website (or, in the full edition, with Test it → Ask VIES about a number), and if it is valid and the other conditions hold, refund the VAT through WooCommerce's refund screen and issue the corrected invoice your accountant expects. The plugin does not change an existing order.

The customer retried after VIES came back, but nothing changed

An "unavailable" result is remembered for one minute at most, so the next checkout refresh after that asks VIES again and the VAT comes off if the number is valid. If it still does not change, have the customer edit any checkout field to trigger a refresh. Changing the number, or emptying the cart, also asks VIES again.

Where does the shopper see the "VIES cannot be reached" message?

On the classic checkout it appears as a notice when the checkout refresh gets an unavailable answer; it does not stop the order. On the order-received page — classic or the block Order Confirmation template — it is shown for an order recorded as unavailable whose VAT was not removed. The block checkout itself shows it only there, because the Store API passes on error notices alone. The wording is the What the shopper reads when VIES cannot be reached setting, or the built-in sentence when that is empty.

No consultation number on the order

The free edition does not send a requester number, so VIES does not return one. In the full edition, set Your own VAT number. If it is set and there is still none, run the test lookup: an "invalid requester" error from VIES means your own number was rejected.

Checks are slow

Each check waits up to the How long to wait for VIES setting (default 10 seconds) when VIES is slow. Lowering it makes an outage fail faster, at the cost of treating a slow-but-working VIES as unavailable.

FAQ

Is this tax advice?

No. The plugins check numbers and apply the rules described in How it works. What you owe and how you report it is between you and your accountant.

Does it work with the block checkout?

Yes, on WooCommerce 8.9 or later, through WooCommerce's own Additional Checkout Fields API. Same rules, same messages, same evidence as the classic checkout.

Does it work with HPOS?

Yes. Both editions declare compatibility with High-Performance Order Storage, and the order box appears on both order screens.

What is sent to the European Commission?

The VAT number and its country prefix, from your server, each time a customer enters a new number. Nothing about the customer, the cart or the order. Full edition: your own VAT number is also sent as the requester when you set one. Nothing is sent to VIES until a number is typed.

Does it contact gatemi.com?

The free edition never does. The full edition contacts gatemi.com only to activate, re-check and deactivate a licence key you entered, and to fetch updates.

Does it add "Reverse charge" to my invoices?

No. It removes the VAT and keeps the evidence on the order. The invoice wording comes from your invoicing tool.

Does it use the billing or the shipping address?

The billing country.

What happens to the evidence if I uninstall?

It stays on the orders. Neither edition deletes order data.

Can I move from the free to the full edition?

Yes. Install and activate the full edition; the free edition stands down. Both use the same settings option and the same order meta, so your settings carry over and every past order still reads.

What does the full edition add?

Your own VAT number as the VIES requester (so checks return consultation numbers), a test lookup on the settings screen, and two optional settings — accepting a number while VIES is unreachable, and exempting your own country — both off by default. It also adds licence-based updates and the gmvat_settings and gmvat_modules filters.

Shopping Cart
Scroll to Top