n8n-nodes-vies
v1.0.0
Published
n8n community node for VIES - EU VAT number validation via European Commission
Downloads
109
Maintainers
Readme
n8n-nodes-vies
This is an n8n community node for VIES (VAT Information Exchange System) -- the European Commission service for validating EU VAT numbers.
No API key or registration is required. VIES is a free, public service.
n8n is a fair-code licensed workflow automation platform.
Operations
| Resource | Operation | Description | |------------|-----------|----------------------------------------------------------| | VAT Number | Validate | Validate an EU VAT number and get company name & address |
Supported Countries
All 27 EU member states plus Northern Ireland:
AT (Austria), BE (Belgium), BG (Bulgaria), CY (Cyprus), CZ (Czech Republic), DE (Germany), DK (Denmark), EE (Estonia), EL (Greece), ES (Spain), FI (Finland), FR (France), HR (Croatia), HU (Hungary), IE (Ireland), IT (Italy), LT (Lithuania), LU (Luxembourg), LV (Latvia), MT (Malta), NL (Netherlands), PL (Poland), PT (Portugal), RO (Romania), SE (Sweden), SI (Slovenia), SK (Slovakia), XI (Northern Ireland).
No Credentials Required
VIES is a public API provided by the European Commission. No API key, registration, or authentication is needed.
Response Fields
| Field | Type | Description | |-------------|---------|------------------------------------------------------| | isValid | boolean | Whether the VAT number is valid | | name | string | Company name (or "---" if invalid/unavailable) | | address | string | Company address (or "---" if invalid/unavailable) | | vatNumber | string | The VAT number that was checked | | userError | string | Status: VALID, INVALID, or MS_UNAVAILABLE |
Note on MS_UNAVAILABLE
Individual country VIES services may be temporarily offline. When this happens, the API returns userError: "MS_UNAVAILABLE" and isValid: false. This does not mean the VAT number is invalid -- it means the country's service could not be reached. Retry later.
Installation
In n8n Desktop / Self-hosted
- Go to Settings > Community Nodes
- Select Install a community node
- Enter
n8n-nodes-vies - Agree to the risks and click Install
Using npm (for custom setups)
cd ~/.n8n/custom
npm install n8n-nodes-viesRestart n8n after installation.
Example Workflow
{
"nodes": [
{
"parameters": {
"countryCode": "PL",
"vatNumber": "5213017228"
},
"name": "VIES",
"type": "n8n-nodes-vies.vies",
"typeVersion": 1,
"position": [450, 300]
}
]
}