De mogelijkheden van Haal Centraal
Organisaties die vallen onder de overheid gebruiken net als iedere andere organisatie basisgegevens voor de uitvoering van hun taken. Deze gegevens komen vaak uit kopieën van (delen van) basisregistraties. Met de snelheid van processen en digitalisatie verouderen deze kopieën snel waardoor er mogelijk fouten ontstaan. Daarnaast is het het aansluiten op deze kopieën is duur en ingewikkeld. Met de Haal Centraal API’s bevraag je de basisgegevens rechtstreeks bij de landelijke registraties zodat gegevens altijd actueel zijn.
Dat brengt een aantal voordelen:
- Burgers en bedrijven krijgen betere dienstverlening. De landelijke registraties leveren de gegevens kant-en-klaar aan. Daardoor wordt de kans op fouten in het gebruik van de gegevens kleiner.
- Als organisatie kan je sneller inspelen op ontwikkelingen, doordat een aanpassing bij de landelijke registratie direct voor afnemers binnen de organisatie beschikbaar is.
- Als organisatie bespaar je kosten, omdat aansluiten makkelijker is en er minder kopieën en geen administratief gegevensmagazijn meer hoeft te beheren.
- Het beheer van de API’s is eenvoudiger: de API’s worden zo ontwikkeld dat afnemers meestal niets hoeven aan te passen als er functionaliteit bij komt. Integratieleveranciers (zoals KoppelHet) kunnen zich volledig richten op het ophalen van deze gegevens en koppelen in de applicaties waar nodig.
Haal Centraal is een initiatief dat in 2018 door de gemeenten Amsterdam, Rotterdam, Den Haag, Utrecht en Eindhoven in gang is gezet. In samenwerking met de VNG, VNG Realisatie, Kamer van Koophandel, de Rijksdienst voor Identiteitsgegevens (RvIG), het Kadaster en het ministerie van Binnenlandse Zaken en en Koninkrijksrelaties zijn er verschillende API’s ontwikkeld die het opvragen van basisgegevens bij landelijke registraties vergemakkelijkt.
Programma Haal Centraal heeft API’s (Application Programming Interfaces) ontwikkeld waarmee je als gemeente basisgegevens rechtstreeks bij de landelijke registraties kan bevragen. Dat is beter, sneller en goedkoper. Ook past dit bij de informatiekundige visie Common Ground. De API’s zijn voor overheidsbreed gebruik.
Kopieën van gegevens zijn snel verouderd
In het verleden maakten gemeenten vaak gebruik van kopieën van basisgegevens voor de uitvoering van taken. Deze kopieën kunnen problemen veroorzaken omdat de gegevens mogelijk niet actueel zijn. Lokale kopieën van basisregistraties kunnen verouderd raken, wat tot fouten kan leiden. Bovendien kan het aansluiten op deze kopieën een kostbare en complexe aangelegenheid zijn. De Haal Centraal API’s bieden nu een oplossing, waarmee je als gemeente rechtstreeks toegang hebt tot actuele basisgegevens bij de landelijke registraties.
Welke Haal Centraal API's zijn er?
Op het moment van schrijven zijn er 6 verschillende Haal Centraal API’s:
- BAG Bevragen
- BRK Bevragen
- WOZ Bevragen
- BRP Persoon
- BRP Bewoning
- BRP Reisdocumenten
BAG Bevragen API
Haal Centraal BAG Individuele bevragingen is een API voor alle binnengemeentelijke afnemers en verschillende overheidsinstanties, zoals gemeenten en waterschappen, specifieke informatie kunnen opvragen uit de Nederlandse Basisregistratie Adressen en Gebouwen (BAG).
De volgende endpoints kunnen worden opgehaald via de API:
Woonplaatsen
Openbare ruimten
Nummeraanduidingen
Verblijfsobjecten
Standplaatsen
Ligplaatsen
- Panden
- Bronhouders
- Adressen
- Adressen uitgebreid
- Adresseerbare objecten
BRP API's
Haal Centraal heeft op dit moment 3 ‘BRP bevragen API’s’ voor de basisregistratie personen (BRP). Daarnaast zijn er 3 BRP Bevragen API’s die momenteel nog niet live zijn.
BRP personen API
De Haal Centraal BRP Personen API is bedoeld voor het zoeken en raadplegen van actuele personen, partners, ouders en kinderen uit het BRP, inclusief de registratie niet-ingezeten (RNI) Daarnaast bied de API ook de informatieproducten leeftijd, aan schrijfwijze, aanhef, een verwijzing naar een persoon in de tekst van een brief en adressering. Zo kan RvIG beter voorzien in klantbehoeften en hoeven de klanten van RvIG minder persoonsgegevens te verwerken.
Binnen de Haal Centraal BRP personen API kunnen personen gezocht worden met één van de verplichte combinaties van parameters:
- Raadpleeg met burgerservicenummer
- Zoek met geslachtsnaam en geboortedatum
- Zoek met geslachtsnaam, voornamen en gemeente van inschrijving
- Zoek met postcode en huisnummer
- Zoek met straat, huisnummer en gemeente van inschrijving
- Zoek met nummeraanduiding identificatie
Daarnaast kunnen de specialisten van KoppelHet jullie helpen om verplichte parameters aan te vullen met optionele parameters om zo een nog nauwkeuriger resultaat te krijgen.
Ook kunnen er ‘fields’ toegevoegd worden om alleen de gegevens op te vragen die voor jou nodig zijn en waarvoor je geautoriseerd bent. Denk hierbij bijvoorbeeld aan BSN, Geslacht en/of naam.
BRP Bewoning API
De Haal Centraal BRP Bewoning API is bedoeld voor het raadplegen van de historische bewoning van een adres. Zo kan je raadplegen welke personen op een opgegeven moment (peildatum) een adresseerbaar object of welke samenstellingen van personen een adresseerbaar object bewoonden in een opgegeven periode.
De BRP Bewoning API kan voorlopig alleen gebruikt worden door gemeenten die deelnemen aan het Experiment Dataminimalisatie (https://www.rijksoverheid.nl/documenten/besluiten/2023/08/28/experimentbesluit-brp-dataminimalisatie-amvb-nvt-versie-voorhang). Daarnaast is voor de technische aansluiting een API gateway nodig.
BRP Reisdocumenten API
De Haal Centraal BRP Reisdocumenten API is bedoeld voor het zoeken van een reisdocument op basis van burgerservicenummer en voor het raadplegen van een reisdocument met een reisdocument nummer.
De Haal Centraal BRP Reisdocumenten API kan voorlopig alleen gebruikt worden door gemeenten die deelnemen aan het Experiment Dataminimalisatie (https://www.rijksoverheid.nl/documenten/besluiten/2023/08/28/experimentbesluit-brp-dataminimalisatie-amvb-nvt-versie-voorhang). Daarnaast is net zoals bij de BRP Bewoning API voor de technische aansluiting een API gateway nodig.
WOZ Bevragen API
De Haal Centraal WOZ Huidige Bevragingen API is bedoeld voor het zoeken en raadplegen van WOZ objecten en WOZ waardes. De API Is echter alleen beschikbaar voor gemeenten.
De opgevraagde informatie mag alleen gebruikt worden voor het heffen van belasting.
Als gebruiker kan je op meerdere manieren WOZ objecten (met WOZ waardes) zoeken en raadplegen:
- Opvragen van een WOZ-object met een identificatie.
- Zoeken van een WOZ-object met de identificatie van het adres.
- Zoeken van 1 of meer WOZ-objecten met een postcode en een huisnummer, eventueel aangevuld met huisletter en/of huisnummertoevoeging.
- Zoeken van 1 of meer WOZ-objecten met een niet-natuurlijk persoon (rsin) of een maatschappelijke activiteit (kvknr).
- Zoeken van 1 of meer WOZ-objecten met de identificatie van een adresseerbaar object (verblijfsobject, ligplaats, standplaats).
Echter bevat een WOZ-object wat opgevraagd is via de WOZ Bevragen API alle vastgestelde waarden per waardepeildatum voor het desbetreffende WOZ-object. Om voor dit WOZ-object alleen de relevante actuele waarde per waardepeildatum op te vragen, kan gebruik worden gemaakt van de ‘wozbevragen-proxy’. De wozbevragen-proxy routeert een WOZ-object bevraging naar de Haal Centraal WOZ Huidige Bevragingen API en filtert hier de niet-relevante waarden uit de resultaat voordat dit doorgestuurd word naar de bevrager.
Hoe kun je starten met Haal Centraal?
De tip van KoppelHet: Ga ermee aan de slag en begin klein. Je hoeft niet direct alles aan te pakken, door een klein proces aan te pakken en te starten met Haal Centraal kunnen we gezamenlijk de mogelijkheden verkennen. Onze integratieoplossingen zijn flexibel zodat we daarna gemakkelijk andere API’s en processen kunnen toevoegen. Zo houden we het klein, en kunnen we langzamerhand alle processen aanpakken.
Kunnen we jullie helpen met Haal Centraal?
Neem contact op of plan een afspraak met ons in.
Mike Fraanje
Integratie specialist
