VATFix Plus icon

VATFix Plus

EU VAT validation via VATFix Plus
Join our community

Overview

This node integrates with the VATFix Plus service to validate and look up EU VAT numbers. It is designed to help users verify the validity of VAT numbers issued by EU countries, which is essential for compliance in cross-border trade within the European Union. The node supports two main operations: a recommended "Lookup" that provides detailed information about the VAT number, and a "Validate" operation that serves as an alias for basic validation.

Practical examples include:

  • Verifying customer VAT numbers before processing invoices.
  • Automating VAT compliance checks in accounting workflows.
  • Enriching customer data with VAT-related details from official sources.

Properties

Name Meaning
Country Code The two-letter ISO code of the EU country where the VAT number was issued (e.g., "DE").
VAT Number The VAT number to be validated or looked up (e.g., "123456789").
Endpoint The API endpoint to use: either "Lookup (recommended)" for detailed info or "Validate (alias)" for basic validation.

Output

The node outputs an array of JSON objects, each corresponding to one input item processed. Each output object contains:

  • input: An object echoing the input parameters (countryCode and vatNumber).
  • result: The response from the VATFix Plus API when the request succeeds. This includes detailed VAT validation or lookup data depending on the chosen endpoint.
  • error: A boolean flag set to true if the API request failed.
  • status: The HTTP status code returned by the API or a default of 500 if unavailable.
  • data: Additional error information or message describing the failure.

No binary data is produced by this node.

Dependencies

  • Requires an active VATFix Plus API key credential and associated customer email configured in n8n credentials.
  • Makes HTTPS POST requests to the VATFix Plus API at https://plus.vatfix.eu/vat/{endpoint}.
  • The node expects the environment to allow outbound HTTPS connections to the VATFix Plus service.

Troubleshooting

  • Common issues:

    • Invalid or missing API key or customer email will cause authentication failures.
    • Incorrect country codes or VAT numbers may result in validation errors or empty results.
    • Network connectivity problems can lead to request timeouts or failures.

  • Error messages:

    • If the API returns an error, the node outputs an error flag with the HTTP status and error message.
    • Typical HTTP status codes like 400 (bad request) indicate invalid input parameters.
    • 401 or 403 statuses suggest authentication or permission issues; verify API credentials.
    • 500 or other server errors indicate issues on the VATFix Plus side; retry later or contact support.

To resolve errors, ensure correct input values, valid API credentials, and stable network connectivity.

Links and References

Discussion