Question 1

Is this really free?

Accepted Answer

Yes. MIT-licensed, no email gate, no telemetry, no Byte8 endpoints called at runtime. Install via Composer and you're done. We make money downstream — most VAT-Validator users eventually adopt Byte8 Ledger to sync those validated B2B customers into Sage / Xero / FreeAgent — but the validator itself is free forever.

Question 2

Why not use Magento's native VAT validation?

Accepted Answer

Native validation hits the deprecated VIES SOAP endpoint, fails silently if your PHP doesn't have ext-soap, has no UK coverage post-Brexit, no Swiss coverage at all, runs at customer-save only (so changes-at-checkout slip through), and has just one 'valid' bucket — no distinction between domestic-valid (still pays VAT) and intra-EU-valid (zero-rated / reverse charge).

Question 3

What countries are covered?

Accepted Answer

All 27 EU member states + Northern Ireland (XI prefix) via the EC VIES REST API. Great Britain (GB) via the HMRC public lookup endpoint. Switzerland via the federal UID-Register (uid-wse.admin.ch) — returns valid only when the organisation is active AND VAT-registered (MWST). Each upstream is independently toggleable.

Question 4

What happens when VIES is down?

Accepted Answer

We preserve the customer's current group. Native Magento downgrades them on a flaky upstream (which happens regularly — VIES is famously unreliable on Monday mornings); we don't. Transient 'unavailable' outcomes are also kept out of the audit log, so a Finanzamt inspector doesn't see noise from EC outages.

Question 5

Does it satisfy German Finanzamt audit requirements?

Accepted Answer

The VIES qualifizierte Bestätigung reference (requestIdentifier) is captured on every successful call and stored in byte8_vat_validator_log alongside the raw request + response payloads. Retention defaults to 10 years per §147 AO with a nightly prune cron. Admin grid + CSV / Excel XML export are built-in. The export action is gated by a separate ACL so you can grant view without granting export.

Question 6

Does it work with my existing tax rules?

Accepted Answer

Yes — the module never touches Magento's tax rules. You configure a customer group with the tax class you want (e.g. 'B2B EU Valid' → 0% reverse charge), point our 'Intra-EU / UK Valid Group' setting at it, and the existing tax engine does the rest. Three group fields total: Domestic-Valid, Intra-EU/UK-Valid, Invalid.

Question 7

How do I bulk re-validate existing customers?

Accepted Answer

After install, run `bin/magento byte8:vat:revalidate-all` to back-fill the audit log for every customer with a vat_id. Filters: --country=DE,AT (DACH only), --since=2026-01-01 (recently updated only), --limit=N (spot-check), --dry-run (list, don't call). Each result is persisted via the same observer used at runtime — no special-case code path.

Question 8

Is there a REST endpoint for headless / SPA checkout?

Accepted Answer

Yes: `GET /rest/V1/byte8-vat-validator/validate/:countryCode/:vatNumber`. Returns the typed validation result (status, source, name, address, requestIdentifier). Ideal for VelaFront, Hyvä-headless, and PWA Studio storefronts.

Question 9

Does it work with Hyvä themes?

Accepted Answer

Yes — install the optional `byte8/module-vat-validator-hyva` companion to drop a live, debounced green/red VAT indicator directly into the Hyvä registration form (`taxvat`) and address form (`vat_id` + `country_id`). Alpine + Tailwind only — both already ship with Hyvä, so no extra JS dependencies. 600 ms debounce so we don't spam the REST endpoint while the user types, and it recognises both standard 2-letter prefixes (DE, GB, …) and the Swiss `CHE` prefix. On transient `unavailable` / `skipped` outcomes the indicator hides itself silently rather than showing a misleading red badge. The whole component is a single self-contained Alpine `x-data` block in `vat-indicator.phtml` — drop it into your theme to restyle. Hyvä Checkout (Magewire) wiring is not yet shipped — open an issue if you need it.

Question 10

What about the new German W-IdNr.?

Accepted Answer

The Wirtschafts-Identifikationsnummer (BZSt-issued business identifier rolling out from late 2024) has no public lookup endpoint yet. We'll add support the moment BZSt publishes one.

Question 11

GDPR-wise, what do you send to third parties?

Accepted Answer

Only the buyer's country code and VAT number — never their name, email, or address. The lawful basis is Art. 6(1)(c) (legal obligation under EU/UK VAT law), so consent is not required. Suggested privacy-policy copy is in the README. The module never calls byte8.io and uses no third-party telemetry.

Question 12

What Magento versions are supported?

Accepted Answer

Magento Open Source and Adobe Commerce 2.4.x on PHP 8.1+. MIT licensed.

EU VIES + UK HMRC VAT validation that actually works in 2026.

EU + UK + Swiss — modern HTTP, no Magento SOAP

Three-Way Customer Group Mapping

DACH-compliant audit log (§147 AO)

Free, MIT-licensed, install in 60 seconds

Frequently asked questions

From validation to invoicing — sync your B2B customers automatically

Stop accepting unvalidated B2B VAT numbers