Kennisbank › VIES storing: wat nu?
VIES storing: wat nu?
Bijgewerkt: 1 november 2026 · Klik&Shop
Krijg je bij een btw-nummercontrole een foutmelding als MS_UNAVAILABLE? Dan ligt VIES of de database van één land tijdelijk plat. Het nummer is dan niet ongeldig.
Veelvoorkomende VIES-foutmeldingen
| Melding | Betekenis |
|---|---|
MS_UNAVAILABLE | De database van het betreffende land (member state) is niet bereikbaar, bijvoorbeeld door onderhoud. |
MS_MAX_CONCURRENT_REQ | Te veel gelijktijdige verzoeken naar dat land. Even wachten en opnieuw proberen. |
GLOBAL_MAX_CONCURRENT_REQ | VIES zelf is overbelast. |
SERVICE_UNAVAILABLE / TIMEOUT | VIES reageert niet of te traag. |
INVALID_INPUT | Het nummer of de landcode klopt niet. Dit is geen storing, maar een invoerfout. |
Status per land bekijken
De Europese Commissie publiceert de beschikbaarheid per land. Via onze API zie je dat ook met GET /v1/status (geen key nodig). Storingen duren meestal minuten tot enkele uren; sommige landen hebben vast onderhoud in de nacht of het weekend.
Wat doe je bij een storing?
- Behandel het nummer niet als ongeldig. Een storing zegt niets over het nummer.
- Probeer het later opnieuw, bijvoorbeeld na een minuut, en daarna met steeds langere pauzes.
- Accepteer een bestelling voorlopig en controleer het nummer opnieuw voordat je factureert.
- Gebruik een recent resultaat als je het nummer kort geleden al hebt gecontroleerd.
- Log de mislukte controle, zodat je kunt aantonen dat je het hebt geprobeerd.
Zo gaat de BTW-check API ermee om
De BTW-check API geeft bij een storing nooit een vals 'ongeldig'. Je krijgt 503 service_unavailable met de VIES-foutcode, een Retry-After-header en concreet advies; die check wordt niet afgeschreven. Is het nummer in de afgelopen 7 dagen al gecontroleerd, dan krijg je het laatst bekende resultaat terug met source: "cache_stale" en een waarschuwing. Zie de documentatie.
Wil je nu een nummer controleren? Gebruik de gratis btw-nummer check.
Veelgestelde vragen
Betekent MS_UNAVAILABLE dat het btw-nummer ongeldig is?
Nee. Het betekent dat de database van dat land tijdelijk niet bereikbaar is. Probeer het later opnieuw.
Hoe lang duurt een VIES storing?
Meestal van enkele minuten tot een paar uur. Gepland onderhoud valt vaak 's nachts of in het weekend.
Direct een btw-nummer controleren
Eenmalig 5 gratis controles via VIES, of automatisch met de API (5 gratis checks per maand).