Zo werkt de opzoeking
Typ of plak één Belgisch ondernemingsnummer of btw-nummer in een gangbare vorm: 0417.497.106, BE0417497106 of het oude nummer van 9 cijfers 417497106. Het nummer wordt eerst in uw browser gecontroleerd met de modulo-97-regel, zodat een tikfout opvalt voordat er iets online gaat. Alleen een geldig nummer gaat naar onze server, die tegelijk twee openbare registers bevraagt:
- VIES, de btw-controledienst van de Europese Commissie, die de Belgische btw-administratie raadpleegt en meldt of het btw-nummer actief is, samen met de geregistreerde naam en het adres.
- Het Peppol-netwerk: een SML-opzoeking toont of het bedrijf geregistreerd is als
0208:+ ondernemingsnummer, en de SMP van zijn access point somt op welke documenttypes (factuur, creditnota, bestelling...) het kan ontvangen.
De rest van het record (het opgemaakte ondernemingsnummer, het btw-nummer en beide Peppol-ID’s) wordt lokaal uit de cijfers berekend.
Voorbeeld van het resultaat
Invoer 417497106 geeft een record in deze vorm (naam en adres ingekort):
{
"enterpriseNumber": "0417.497.106",
"enterpriseNumberDigits": "0417497106",
"vatNumber": "BE0417497106",
"peppolIds": {
"primary": "iso6523-actorid-upis::0208:0417497106",
"vat": "iso6523-actorid-upis::9925:BE0417497106"
},
"vies": { "valid": true, "name": "...", "address": "...", "checkedAt": "..." },
"peppol": { "registered": true, "smp": "...", "documentTypes": [ ... ] }
}
Kopieer het of download het als company-0417497106.json voor een spreadsheet, een CRM-import of een checklist bij het aanmaken van een nieuwe leverancier.
Randgevallen om te kennen
- Geldig maar niet actief voor btw. Veel vzw’s, sommige van btw vrijgestelde ondernemingen en stopgezette bedrijven hebben een ondernemingsnummer maar geen actief btw-nummer. VIES antwoordt dan "niet geldig", ook al is het nummer correct.
- Niet op Peppol onder 0208. Sommige bedrijven zijn alleen geregistreerd onder het btw-schema
9925. Controleer beide ID’s met de Peppol-ID-controle voor u besluit dat ze geen e-facturen kunnen ontvangen. - Vestigingseenheden (nummers die met 2 tot 8 beginnen) zijn geen ondernemingen en staan niet in VIES.
- VIES tijdelijk onbereikbaar. De Belgische VIES-dienst valt soms enkele minuten uit; het record bevat dan een foutmelding in plaats van een naam en u kunt het opnieuw proberen.
Rechtsvorm, NACE-activiteiten, bestuurders en vestigingseenheden staan in de KBO, die geen gratis realtime-API heeft. Decodeer de codes uit de maandelijkse KBO Open Data-bestanden met de KBO-codes-opzoeking en de NACE-BEL-opzoeking, en lees de gids over Belgische ondernemingsnummers om te zien hoe de nummers samenhangen.
Veelgestelde vragen
Kan ik hier een Belgisch bedrijf op naam zoeken?
Nee. De opzoeking vertrekt van een ondernemings- of btw-nummer, omdat VIES en Peppol op nummer bevraagd worden. Zoek op naam via de openbare KBO-zoekfunctie van de FOD Economie en plak daarna het nummer.
Waarom zegt VIES dat het nummer ongeldig is terwijl het bedrijf bestaat?
VIES bevestigt alleen actieve btw-registraties. Een bedrijf dat niet of nog niet voor btw geregistreerd is, of dat stopgezet is, heeft wel een geldig ondernemingsnummer maar staat als niet actief in VIES.
Wat betekent het Peppol-deel van het record?
Het toont of het bedrijf op het Peppol-netwerk geregistreerd is onder 0208 plus het ondernemingsnummer, welke metadataserver (SMP) het bedient en welke documenttypes het kan ontvangen.
Wordt mijn opzoeking bewaard of gelogd?
Het nummer wordt in uw browser gecontroleerd en alleen op het moment van de opzoeking naar onze server gestuurd om VIES en Peppol te bevragen. Het resultaat wordt niet bewaard op gratistools.be.
Kan ik veel bedrijven tegelijk opzoeken?
Deze tool verwerkt één nummer per keer. Controleer en schoon lijsten eerst op met de btw-nummercontrole of de ondernemingsnummer-opschoner, die ook de Peppol-ID’s geven.