Veille
Guides pratiques

Validate EU VAT Numbers

Verify European VAT numbers at checkout to enable B2B tax exemptions and prevent fraud using the Veille VAT validation API.

Overview

EU businesses are exempt from VAT when purchasing from other EU businesses — but only with a valid VAT number. This playbook shows how to validate a VAT number at checkout and retrieve the associated company details (name and address) from the VIES database.

Prerequisites

  • A Veille API key — get one at app.veille.io
  • Install dependencies for your language:
pip install requests

Steps

Validate a VAT number

Call GET /v1/vat with the vat parameter. The number should include the country prefix (e.g. FR12345678901).

import requests

API_KEY  = "YOUR_API_KEY"
response = requests.get(
    "https://api.veille.io/v1/vat",
    headers={"x-api-key": API_KEY},
    params={"vat": "FR12345678901"},
)
result = response.json()
print(result)

Read the company details

A valid number returns is_valid: true, the company_name, company_address, and country_code.

if result.get("is_valid"):
    print(f"✅ Valid VAT number")
    print(f"   Company : {result.get('company_name')}")
    print(f"   Address : {result.get('company_address')}")
    print(f"   Country : {result.get('country_code')}")
else:
    print(f"❌ Invalid VAT number: {result.get('error', 'Not found in VIES')}")

Build a B2B checkout VAT handler

Strip VAT from the order total when a verified EU business VAT number is provided.

import requests

API_KEY    = "YOUR_API_KEY"
VAT_RATE   = 0.20  # 20% VAT

def lookup_vat(number: str) -> dict:
    r = requests.get("https://api.veille.io/v1/vat",
        headers={"x-api-key": API_KEY}, params={"vat": number})
    return r.json()

def calculate_checkout(subtotal: float, vat_number: str | None = None) -> dict:
    vat_amount = subtotal * VAT_RATE
    vat_info   = None

    if vat_number:
        result = lookup_vat(vat_number)
        if result.get("is_valid"):
            vat_amount = 0  # B2B reverse charge — no VAT charged
            vat_info   = {"company": result["company_name"], "country": result["country_code"]}
        else:
            return {"error": "The VAT number you provided is not valid."}

    total = subtotal + vat_amount
    return {"subtotal": subtotal, "vat": vat_amount, "total": total, "company": vat_info}

print(calculate_checkout(100.00))
print(calculate_checkout(100.00, vat_number="FR12345678901"))
print(calculate_checkout(100.00, vat_number="INVALID123"))

Always store the validated company name and address alongside the order record. EU tax authorities require proof that the reverse-charge mechanism was correctly applied.

Sur cette page