Haal Centraal koppeling laten maken
Appfront bouwt maatwerk Haal Centraal koppelingen waarmee u de basisregistraties realtime bevraagt — vanuit uw zaaksysteem, formulierenmodule of eigen applicatie. Via de uniforme REST/JSON-bevragings-API's van VNG, RvIG en het Kadaster haalt u actuele persoons-, adres- of bedrijfsgegevens rechtstreeks uit de bron, op het moment dat u ze nodig heeft. Geen eigen kopiebestanden meer bijhouden, minder overtypfouten en aantoonbaar actuele gegevens in elk proces.
Wat is Haal Centraal?
Haal Centraal is het initiatief van VNG, RvIG en het Kadaster om basisregistraties te bevragen via uniforme, moderne REST/JSON-API's, in plaats van via bulklevering of lokale kopieën. Het uitgangspunt: u haalt op het moment dat u een gegeven nodig heeft een gericht antwoord op uit de bronregistratie, zodat u altijd met actuele data werkt. Het programma Haal Centraal is inmiddels afgerond; de API's worden beheerd door RvIG (BRP) en het Kadaster (BAG, BRK, WOZ).
De bekendste bevragings-API's zijn BRP Bevragen (actuele personen, partners, ouders en kinderen uit de Basisregistratie Personen, inclusief de Registratie Niet-Ingezetenen), BAG (adressen en gebouwen), BRK (kadastrale gegevens) en HR Bevragen (handelsregister-/bedrijfsgegevens). Belangrijk onderscheid: met Haal Centraal bevraagt u bestaande basisregistraties — u voert er zelf geen registratie mee. Een maatwerk koppeling betekent in de praktijk: de juiste API's aanroepen met de juiste autorisatie, de JSON-response verwerken in uw eigen schermen of processen en alleen die gegevens opvragen waarvoor u een grondslag heeft.
Appfront bouwt volgens de officiële API-specificaties van VNG Haal Centraal en de geldende overheids-API-standaarden (REST API Design Rules, Nederlandse API Strategie). We stemmen autorisatie, foutafhandeling en logging af op uw werkelijke processen, zodat de koppeling meebeweegt met nieuwe API-versies en ook bij piekvolumes betrouwbaar blijft. Dit sluit aan op onze bredere software voor gemeenten.
Realtime uit de bron
Geen verouderde kopiebestanden meer: u bevraagt de BRP, BAG of BRK op het moment dat u het gegeven nodig heeft en krijgt het actuele antwoord uit de bronregistratie terug. Eenmalige registratie, meervoudig gebruik — minder fouten en minder overtypwerk.
Uniforme REST/JSON-API's
Alle Haal Centraal API's volgen dezelfde moderne opzet: REST, JSON en gepubliceerde OpenAPI-specificaties. Eén bouwwijze voor BRP, BAG, BRK en HR, zodat extra registraties later eenvoudig zijn toe te voegen aan uw koppeling.
Gecontroleerde autorisatie
Toegang verloopt via OAuth 2.0 / OpenID Connect en doorgaans een API Gateway, met logging van elke bevraging. U vraagt alleen op waarvoor u een wettelijke grondslag heeft, herleidbaar vastgelegd voor uw verwerkingsregister.
Ons ontwikkelproces voor Haal Centraal koppelingen
We werken volgens een bewezen methodiek die onzekerheid vroeg wegneemt en een stabiele koppeling oplevert. Van een eerste analyse van uw processen, benodigde registraties en autorisatie tot livegang en doorlopend beheer — elke stap is gericht op een koppeling die uw eigen organisatie kan begrijpen, beheren en verantwoorden.
We brengen in kaart welke registraties u wilt bevragen (BRP, BAG, BRK, HR), welke gegevens u nodig heeft, welke grondslag daarbij hoort en op welke schermen of processen de antwoorden moeten landen.
We ontwerpen de koppelarchitectuur, regelen de autorisatie via OAuth 2.0 / OpenID Connect en API Gateway en stellen een strategie op voor foutafhandeling en logging.
Implementatie tegen de testomgeving van Haal Centraal, met automated tests, gestructureerde logging en monitoring. U krijgt tussentijds werkende versies te zien.
Gecontroleerde aansluiting op de productieomgeving met validatie en vangnet, gevolgd door doorlopend beheer, monitoring en meebewegen met nieuwe API-versies.
Wat een Haal Centraal koppeling concreet oplevert
Elke Haal Centraal koppeling wordt specifiek ingericht voor uw processen, de registraties die u mag bevragen en uw bestaande applicaties. Hieronder de functionaliteiten die we het vaakst opleveren voor gemeenten en uitvoeringsorganisaties die de basisregistraties realtime willen raadplegen.
BRP Bevragen (Personen)
Actuele persoonsgegevens — NAW, partner, ouders en kinderen — rechtstreeks uit de Basisregistratie Personen, inclusief de Registratie Niet-Ingezetenen (RNI). Uw zaaksysteem of formulier vult de gegevens automatisch in op basis van een BSN of zoekvraag, zonder overtypwerk. Zie ook onze BRP-koppeling.
BAG-adresvalidatie
Adressen en gebouwen valideren en verrijken tegen de Basisregistratie Adressen en Gebouwen. Een ingevoerd adres wordt gecontroleerd, aangevuld en gekoppeld aan de juiste verblijfsobject- en pandgegevens — minder fouten in aanvragen en correspondentie.
BRK- en HR-bevraging
Kadastrale gegevens opvragen via BRK Bevragen en bedrijfs-/handelsregistergegevens via HR Bevragen. Zo raadpleegt u binnen hetzelfde koppelplatform eigendoms- en bedrijfsinformatie wanneer uw proces daarom vraagt, met dezelfde autorisatie-aanpak.
Autorisatie via Gateway
Centrale autorisatie en toegangsbeheer via een API Gateway en Identity Provider, met OAuth 2.0 / OpenID Connect-tokens. Per gebruiker en per registratie wordt afgedwongen welke bevragingen en velden zijn toegestaan.
Logging & herleidbaarheid
Elke bevraging wordt herleidbaar gelogd: wie vroeg wat op, wanneer en met welke grondslag. Dat houdt uw verwerkingsregister compleet, ondersteunt audits en maakt aantoonbaar dat alleen geautoriseerde gegevens zijn opgevraagd.
Verwerking in eigen schermen
De JSON-responses worden netjes verwerkt in uw bestaande zaaksysteem, formulieren of webapplicatie — met foutafhandeling, retries en duidelijke meldingen als de bron tijdelijk niet bereikbaar is. Zie ook onze maatwerk software.
Typische toepassingen in de praktijk
Een Haal Centraal koppeling pakt per organisatie verschillend uit. Een aantal patronen zien we vaak terugkomen bij gemeenten en uitvoeringsorganisaties — en voor elk daarvan hebben we een werkende opzet met aandacht voor de juiste registratie, autorisatie en verwerking.
Zaaksysteem & dienstverlening
Gemeenten die bij een aanvraag of melding direct de actuele NAW-gegevens uit de BRP ophalen, zodat een ambtenaar niet hoeft over te typen en de aanvrager geen gegevens dubbel hoeft in te vullen. Zie ook onze gemeente-website en ZGW API-koppeling.
Online formulieren & e-diensten
Aanvraagformulieren voor vergunningen, uitkeringen of subsidies die een adres tegen de BAG valideren en persoonsgegevens vooraf invullen vanuit de BRP. Dat verlaagt de uitval, voorkomt fouten en versnelt de afhandeling. Zie ook onze BAG API-koppeling.
Uitvoeringsorganisaties
Uitvoeringsorganisaties die in hun processen actuele persoons- of bedrijfsgegevens nodig hebben, bijvoorbeeld voor controle, toekenning of correspondentie. In plaats van een eigen kopiebestand bij te houden bevragen zij de bron op het juiste moment, met logging en grondslag per opvraging.
Adres- & bedrijfscontrole
Processen waarin kadastrale of handelsregister-gegevens nodig zijn — denk aan het controleren van eigendom via BRK of het verifiëren van een onderneming via HR Bevragen. De koppeling raadpleegt de juiste registratie en verwerkt het antwoord met dezelfde autorisatie en logging als de overige bevragingen.
Technologie die we inzetten
Haal Centraal koppelingen bouwen we tegen de officiële REST/JSON-bevragings-API's en hun OpenAPI-specificaties, in combinatie met de backend-stack die bij u past. De precieze keuze hangt af van welke registraties u bevraagt en welke autorisatie- en gateway-opzet u gebruikt — zodat uw eigen team de koppeling kan beheren en doorontwikkelen.
Waarom Appfront voor uw Haal Centraal koppeling?
Appfront heeft ruime ervaring met het bouwen van API-koppelingen voor uiteenlopende organisaties in Nederland, ook in de overheidscontext. We beginnen altijd met een grondige analyse van uw bestaande systemen, processen en grondslagen — een koppeling moet niet alleen technisch kloppen, maar ook passen binnen uw wettelijke kaders en werkwijze.
Bij elke integratie schrijven we heldere documentatie en zorgen we dat uw eigen team — of een toekomstige leverancier — de koppeling kan begrijpen en beheren. Geen black box, maar transparante code en duidelijke afspraken over monitoring, alerting en beheer.
U werkt samen met een vast aanspreekpunt dat zowel de technische als de functionele kant begrijpt. Dat houdt de lijnen kort, voorkomt miscommunicatie en versnelt beslissingen wanneer er tijdens de bouw keuzes gemaakt moeten worden.
Bekijk ook onze bredere diensten voor de overheid: software voor gemeenten, AI voor gemeenten en waterschap-software. Vragen over uw situatie? Neem contact op.
- Ervaring met de Haal Centraal bevragings-API's (BRP, BAG, BRK, HR)
- Vertrouwd met overheids-API-standaarden (REST API Design Rules, Nederlandse API Strategie)
- Autorisatie via OAuth 2.0 / OpenID Connect en API Gateway
- Aandacht voor grondslag, dataminimalisatie en herleidbare logging
- Gestructureerde foutafhandeling en retry-mechanismen
- Uitgebreide logging en monitoring vanaf dag één
- Heldere documentatie die uw team kan lezen en beheren
- Vast aanspreekpunt, geen doorgeschoven accountmanagers
- Doorlopend beheer en meebewegen met nieuwe API-versies
- Werkwijze afgestemd op uw bestaande IT-landschap
Security en privacy bij Haal Centraal koppelingen
Het bevragen van basisregistraties raakt vrijwel altijd persoonsgegevens — zeker bij de BRP. Appfront bouwt daarom volgens dataminimalisatie en de OWASP ASVS: alleen de velden opvragen waarvoor u een grondslag heeft, autorisatie via OAuth 2.0 / OpenID Connect en een API Gateway, beveiligde verbindingen en herleidbare logging van elke bevraging. Zo sluit de koppeling aan op de overheids-normenkaders voor informatiebeveiliging.
Wij documenteren de datastromen, de autorisatie-opzet en de grondslag per bevraging, zodat uw verwerkingsregister compleet is en u aantoonbaar voldoet aan de AVG. De logging van elke opvraging — wie, wat, wanneer en op welke grondslag — dient als verantwoording richting toezichthouders en bij audits.
Meer over onze overheidsexpertise: software voor gemeenten en maatwerk software op maat.
- AVG-conforme bevraging met dataminimalisatie en grondslag
- Encryptie in transit (TLS 1.2+) en at rest
- Rolgebaseerde toegang en least-privilege principes
- Auditlogs met traceerbare datastromen
- Automatische retry en dead-letter queues
- Monitoring en alerting voor afwijkingen
- Secrets management volgens best practices
- Documentatie en logging voor uw verwerkingsregister
Veelgestelde vragen over Haal Centraal koppelingen
Antwoorden op de vragen die we het vaakst krijgen over Haal Centraal koppelingen.
Een Haal Centraal koppeling is een technische integratie tussen uw applicatie — zoals een zaaksysteem, formulierenmodule of eigen webapplicatie — en de Haal Centraal bevragings-API's van de overheid. Via deze uniforme REST/JSON-API's bevraagt u realtime de basisregistraties (BRP Bevragen voor personen, BAG voor adressen en gebouwen, BRK voor kadaster). U haalt zo actuele gegevens op het moment dat u ze nodig heeft, in plaats van een eigen kopiebestand bij te houden. De koppeling regelt de autorisatie, de API-aanroepen en de verwerking van de JSON-response in uw eigen schermen of processen.
Haal Centraal is uitdrukkelijk bedoeld om bestaande basisregistraties te bevragen, niet om er zelf één te voeren. U bouwt geen kopie van de BRP of de BAG, maar stelt op het juiste moment een gerichte vraag aan de bronregistratie en krijgt het actuele antwoord terug. Dat verkleint de kans op verouderde of foutieve gegevens en sluit aan op het uitgangspunt 'eenmalige registratie, meervoudig gebruik'. Bulklevering of het lokaal synchroniseren van complete registraties is een andere aanpak; Haal Centraal kiest bewust voor realtime bevraging via API's.
Het Haal Centraal-initiatief levert bevragings-API's voor meerdere basisregistraties. De bekendste zijn BRP Bevragen (actuele persoonsgegevens uit de Basisregistratie Personen, inclusief RNI), BAG (adressen en gebouwen) en BRK (kadastrale gegevens); ook WOZ-bevraging valt hieronder. Daarnaast bestaat HR Bevragen voor handelsregister-/bedrijfsgegevens. Welke API's voor u relevant zijn hangt af van uw proces — we bepalen samen welke registraties u nodig heeft en welke gegevens u daaruit mag opvragen.
Toegang tot de Haal Centraal API's verloopt via gecontroleerde autorisatie. In de praktijk wordt gewerkt met OAuth 2.0 en OpenID Connect via een Identity Provider, vaak in combinatie met een API Gateway die centrale autorisatie en toegangsbeheer regelt voor de gemeente. Daarbovenop gelden de overheids-eisen voor beveiligd berichtenverkeer, zoals beveiligde verbindingen en logging. Per registratie geldt bovendien een grondslag: u mag alleen die gegevens opvragen waarvoor u een wettelijke taak en autorisatie heeft. We richten de koppeling zo in dat alleen de toegestane velden en bevragingen mogelijk zijn.
De kosten worden bepaald door het aantal te koppelen API's (BRP, BAG, BRK, HR), de complexiteit van uw autorisatie- en gatewayopzet, de mate van maatwerk in uw eigen schermen of processen en de gewenste logging en monitoring. Ook of u aansluit op een test- of productieomgeving en welke Identity Provider u gebruikt speelt mee. We maken altijd een heldere offerte na een vrijblijvende analyse van uw situatie.
Ja, mits zorgvuldig ingericht. Persoonsgegevens uit de BRP zijn bijzonder gevoelig, dus we bouwen volgens dataminimalisatie: alleen de velden opvragen die u daadwerkelijk nodig heeft, op basis van een geldige grondslag. We documenteren de datastromen zodat uw verwerkingsregister compleet is, richten logging in zodat bevragingen herleidbaar zijn, en stemmen de autorisatie af op uw wettelijke taak. Zo voldoet u aantoonbaar aan de AVG en aan de overheids-normenkaders voor informatiebeveiliging.
Ja. Appfront neemt regelmatig bestaande overheidskoppelingen in beheer, ook als deze oorspronkelijk door een andere partij zijn opgezet. We voeren een review uit op de API-aanroepen, de autorisatie- en gatewayconfiguratie, de foutafhandeling en de logging, documenteren de huidige opzet en stellen verbetervoorstellen op. Vanaf dat moment kunnen we aanpassingen, uitbreidingen naar extra registraties en monitoring verzorgen, inclusief het meebewegen met nieuwe API-versies.
Haal Centraal is bedoeld voor gemeenten en uitvoeringsorganisaties die in hun processen actuele persoons-, adres- of bedrijfsgegevens nodig hebben. Denk aan een zaaksysteem dat bij een aanvraag direct de actuele NAW-gegevens uit de BRP ophaalt, een formulier dat een adres valideert tegen de BAG, of een proces dat kadastrale of handelsregister-gegevens raadpleegt. Overal waar u nu een eigen kopiebestand bijhoudt of handmatig gegevens overtypt, kan een Haal Centraal koppeling het actueel en betrouwbaar maken.
Klaar om uw Haal Centraal koppeling te laten maken?
Vertel ons welke basisregistraties u wilt bevragen — BRP, BAG, BRK of HR — en in welk zaaksysteem of welke applicatie de gegevens moeten landen. We denken graag mee over autorisatie, grondslag, logging en de aansluiting op de test- en productieomgeving. In een vrijblijvend eerste gesprek krijgt u een scherp beeld van de mogelijkheden. Plan direct een gesprek.