EU VAT-ID Validation
EU VAT-ID validation checks European VAT identification numbers when you create billing documents. You activate it per billing group; the result is stored with the document so you can prove why a tax decision was made.
Why use EU VAT-ID validation
Use EU VAT-ID validation when you need an auditable answer to: Was this European VAT-ID checked, and what was the outcome?
Typical outcomes:
- Valid EU VAT-IDs are confirmed against the official VIES register before tax rules are applied.
- Invalid or unavailable checks still leave a documented result on the document — not a silent gap.
- If a VAT-ID has no EU country prefix, VIES is not called, but the document still carries a result (UNSUPPORTED) so an auditor can see why no register check ran.
- When printing the result on the document is enabled, the PDF shows the status and — for INVALID — the rejection reason.
EU VAT-ID validation is part of Tax Conformity. How the result steers tax rules is described under How taxes are applied.
How to activate EU VAT-ID validation
Step 1: Open the billing group
Navigate to: Billing > Billing Groups, open the billing group that should run the check, and click "Edit".
Step 2: Enable the check
Enable the "EU VAT-ID check" toggle and save.
Only billing groups with EU VAT-ID validation enabled create a validation result during document creation. Configuration via API uses the Tax Service Billing Group Configuration endpoints — see also instellix Tax Service Configuration.
How the check runs during document creation
When enabled, instellix can validate European VAT identification numbers during document creation against the official VIES interface of the European Commission: https://ec.europa.eu/taxation_customs/vies
The result influences tax calculation (when instellix calculates tax) and is stored with the document for audit — including cases where VIES is not called.
When is a VIES request sent?
A request to VIES is sent only if all of the following are true:
- Tax calculation is enabled for the document (not custom provided).
- EU VAT-ID validation is activated in the assigned billing group.
- A VAT-ID is present in the invoice address.
- The VAT-ID contains a valid EU country prefix.
When is a result stored without calling VIES?
If EU VAT-ID validation is activated and a VAT-ID is present without a valid EU country prefix, instellix does not call VIES. It still stores a validation result on the document with status UNSUPPORTED, shown on the document details page in the webportal. No validation attachment is created for UNSUPPORTED, because no register check ran.
If EU VAT-ID validation is not activated for the billing group, no check runs (NONE where a result is shown).
Result caching
VIES results are cached for 24 hours per VAT-ID. Within that period, the stored result is reused instead of a new VIES request.
If a VAT-ID was validated with a negative result and the registration is corrected afterwards, the new status may only take effect once the cache has expired (up to 24 hours).
Validation results
| Result | Meaning |
|---|---|
| VALID | VIES confirmed the VAT-ID. |
| INVALID | VIES rejected the VAT-ID. |
| FAILED | Technical error or VIES unavailable. |
| UNSUPPORTED | VAT-ID present but not eligible for VIES (for example missing EU country prefix). No VIES call. |
| NONE | No EU VAT-ID check applied (for example validation not activated on the billing group). |
Impact on tax calculation
If instellix determines the taxes for a document, the EU VAT-ID validation result influences which tax rule is applied (see How taxes are applied):
| EU VAT-ID validation result | Applied tax rule |
|---|---|
| VALID | Tax rule with VAT-ID for the respective country |
| INVALID | Tax rule without VAT-ID for the respective country |
| FAILED | Tax rule without VAT-ID for the respective country |
| UNSUPPORTED | Tax rule without VAT-ID for the respective country |
This logic applies only if tax calculation is handled by instellix. If taxes are externally provided, the validation result is still stored for audit, but no tax rule adjustment is performed. FAILED is treated like INVALID so compliance is preserved when VIES is temporarily unavailable.
Which document types are validated
The check applies to invoices, credit notes, deposit invoices, and self-billing invoices. Credit notes do not trigger a new validation; they reuse the validation result of the original invoice. You can find the result on the document in Manage Documents.
Where the result appears
The EU VAT-ID validation result is:
- Shown on the document details page in the webportal as "EU VAT-ID validation result"
- Stored as a document attachment when the VAT-ID was checked with VIES. Status UNSUPPORTED is shown on the document, but no validation attachment is created.
- Optionally printed on the PDF — including the status and, for INVALID, the rejection reason (layout depends on your document template)
Each check can also trigger a vatId.checked notification.
Related topics
- Tax Conformity — tax calculation, providers, and EU VAT-ID validation
- How taxes are applied — how tax rules are selected
- Billing Groups — where you activate the EU VAT-ID check
- instellix Tax Service Configuration — tax service setup per billing group
- Document Templates — how results can appear on the PDF
- Manage Documents — open the document and see the result
Via API
Configure EU VAT-ID validation per billing group via the Tax Service Billing Group Configuration endpoints. For the notification payload, see vatId.checked.
Updated 4 days ago