Integratiegids · Nederland · Laatst bijgewerkt: juli 2026

BTW-nummer valideren via API — VIES-consultatienummer automatisch vastleggen

Als je boekhoudsysteem, webshop of facturatiesoftware intracommunautaire B2B-facturen met 0%-tarief uitreikt, moet je het btw-nummer van de koper valideren — én het bewijs van die controle bewaren. Precies daar laat de meeste integratie een gat vallen.

Bij een gekwalificeerde bevraging geeft VIES een consultatienummer terug — een officieel, getimestampt bewijs dat de Belastingdienst bij een controle accepteert als onderbouwing van het 0%-tarief bij intracommunautaire leveringen (art. 25 Wet OB 1968, art. 138 Richtlijn 2006/112/EG). Zonder dat nummer heb je bij een controle alleen een screenshot — geen erkend document.

Wat is een VIES-consultatienummer?

VIES (VAT Information Exchange System) is het officiële EU-systeem voor het valideren van btw-nummers. Als je een btw-nummer bevraagt met je eigen btw-nummer (de „aanvrager"), genereert VIES een consultatienummer in het formaat WAPIAAAAW1234567.

Dit nummer documenteert:

Welk btw-nummer is gecontroleerd
Door wie (jouw btw-nummer als aanvrager)
Het exacte moment van de controle
Dat het resultaat op dat moment „geldig" was

De Belastingdienst erkent dit nummer als bewijs voor intracommunautaire leveringen op grond van art. 25 Wet op de omzetbelasting 1968.

Het probleem: de meeste API's geven geen consultatienummer terug

Gangbare btw-controle-API's — inclusief veel integraties in populaire boekhoudsoftware — bevragen VIES, maar geven alleen true of false terug. Het consultatienummer gaat verloren.

Gevolg: je weet dat een btw-nummer geldig was, maar je kunt het niet bewijzen. Bij een controle is dat niet genoeg.

Vatnode: btw-nummer valideren én consultatienummer in één API-call

Vatnode geeft bij elk verzoek het volledige consultatienummer terug — klaar om op te slaan in je database of boekhoudsysteem:

cURL

curl -X POST https://vatnode.com/v1/validate \
  -H "x-api-key: vnd-jouw-sleutel" \
  -H "Content-Type: application/json" \
  -d '{"vat_number":"NL123456789B01","requester_vat":"NL987654321B01"}'

Antwoord · JSON

{
  "valid": true,
  "vatNumber": "NL123456789B01",
  "countryCode": "NL",
  "consultationNumber": "WAPIAAAAW1234567",  ← het bewijs
  "name": "...",
  "address": "...",
  "requestDate": "2026-07-06+02:00",
  "timestamp": "2026-07-06T10:14:02.000Z"
}

Sla consultationNumber en timestamp direct op in het factuurrecord — dat is je houdbare bewijs.

VIES is vaak onbereikbaar — wat dan?

VIES kent frequente storingen per land. Als de database van de betreffende lidstaat plat ligt, geeft Vatnode een duidelijke, herhaalbare fout terug in plaats van een misleidende valid:false — zodat je geen echte klant onterecht weigert:

JSON

{ "error": "vies_unavailable", "retryable": true }

Implementeer een korte retry met backoff. De live-status van alle 27 landen staat op de VIES-statuspagina.

Praktijkvoorbeeld: facturatiesoftware

JavaScript (Node.js)

// Bij het aanmaken van een B2B-factuur voor een EU-klant
async function valideerEnBewaar(btwNummer, aanvrager, factuurId) {
  const res = await fetch('https://vatnode.com/v1/validate', {
    method: 'POST',
    headers: { 'x-api-key': 'vnd-jouw-sleutel', 'Content-Type': 'application/json' },
    body: JSON.stringify({ vat_number: btwNummer, requester_vat: aanvrager })
  });
  const data = await res.json();
  if (data.error) throw new Error(data.error);      // bijv. vies_unavailable → retry
  if (!data.valid) throw new Error('BTW-nummer ongeldig');

  await db.facturen.update(factuurId, {
    btw_consultatienummer: data.consultationNumber,
    btw_gecontroleerd_op: data.timestamp
  });
}

Juridische achtergrond: art. 25 Wet OB

Op grond van art. 25 Wet op de omzetbelasting 1968 geldt het 0%-tarief voor een intracommunautaire levering wanneer de afnemer een ondernemer is en de goederen naar een andere lidstaat gaan. Als leverancier moet je aantonen dat je het btw-nummer van de afnemer op het moment van levering hebt gecontroleerd.

De Belastingdienst erkent het VIES-consultatienummer als geschikt bewijs. Een enkele „geldig"-melding zonder consultatienummer is geen voldoende bewijs.

Dekking

Vatnode dekt alle 27 EU-lidstaten via VIES — inclusief consultatienummer en verrijking (bedrijfsnaam + adres, indien door VIES geleverd). Daarnaast valideert Vatnode niet-VIES-landen via hun officiële nationale registers — Noorwegen al live, Zwitserland volgt. De volledige lijst staat in de API-documentatie.

Gratis proberen

100 controles per maand gratis — geen creditcard nodig. Founding-prijs gegarandeerd voor de eerste partners.

Geen spam. Prijzen voor vroege gebruikers gegarandeerd.