Naar de inhoud
WD Noord

BAG-adressen valideren voor je systeem

Het adres tegen de bron controleren voordat het je systeem in gaat.

De Basisregistratie Adressen en Gebouwen is de bron waar elk Nederlands adres in staat. Toch komt een adres in de meeste systemen binnen door iemand die het intypt. Zodra dat gebeurt, ontstaan er kleine afwijkingen die later moeilijk terug te draaien zijn. Een koppeling draait dat om: het adres gaat eerst langs de bron voordat het een record wordt.

FIG. 50 / BAG-ADRESSENADRES → BRON → SYSTEEM
Twee systemen verbonden, met een logboek van elke overdracht Webshop BESTELLINGEN BRON VAN WAARHEID Boekhouding FACTUREN VOLGT DE BRON Koppeling CONTROLEREN DOORGEVEN Logboek WAT ER OVERGING WANNEER WAT NIET DOORKON Handwerk DE GEVALLEN DIE OVERBLIJVEN Melding ALS EEN RECORD NIET DOORKOMT

EEN ADRES ZONDER ID BLIJFT EEN RAADSEL.

Wat er misgaat als een adres wordt ingetypt

Een adres lijkt eenvoudig: straat, huisnummer, postcode, plaats. In de praktijk gaat het op vier manieren mis.

  • Twee records voor hetzelfde pand. De ene keer staat er 'Kerkstraat 12' en de andere keer 'Kerkstraat 12 A', of de postcode wordt met of zonder spatie geschreven. Het systeem ziet twee adressen en maakt twee records aan voor een enkel gebouw.
  • Een postcode die niet klopt. Een cijfer verwisseld en het adres wijst naar een andere straat. Bij verzending of facturatie valt dat pas op als het al mis is.
  • Een huisnummer dat niet bestaat. Een nummer dat in de straat niet voorkomt, of een toevoeging die nergens op slaat. Zonder controle tegen de bron blijft dat gewoon staan.
  • Een nieuwbouwadres dat nog niet bestaat. Bij nieuwbouw komt het adres soms later in het register dan de bewoner of de aannemer het al gebruikt. Wie het dan intypt, loopt voor op de bron en dat verschil blijft hangen.

Wat die gevallen gemeen hebben: er is niets dat het adres controleert op het moment dat het binnenkomt.

Wat een koppeling oplost

Een koppeling op de BAG keert de volgorde om. Het adres wordt eerst langs de bron gelegd, en pas daarna een record in jouw systeem. Klopt de postcode niet bij de straat, dan komt dat eruit voordat het ergens wordt opgeslagen. Bestaat het huisnummer niet, dan blijft het buiten de deur.

Dat scheelt niet alleen typefouten. Het maakt het adres ook vergelijkbaar. Elk adres dat uit de bron komt heeft dezelfde vorm, zodat twee records van hetzelfde pand ook echt op elkaar lijken. Zoeken, ontdubbelen en koppelen aan een ander systeem worden daardoor eenvoudiger.

De controle gebeurt bij het moment van invoer, niet achteraf. Een adres dat al jaren fout in de database staat, blijft fout tot iemand het aanraakt. Daarom is de invoerkant de plek waar het het minst kost om het goed te doen.

Wat een BAG-id is

Aan elk adres in de BAG hangt een identificatie, het BAG-id. Dat is geen straatnaam en geen postcode, maar een vast nummer dat bij dat ene adres hoort en niet verandert als de straat wordt hernoemd of de postcode wordt aangepast.

Dat nummer is het verschil tussen een adres dat je kunt volgen en een adres dat je alleen kunt herkennen aan hoe het eruitziet. Een record zonder zo'n id is een tekst die toevallig op een adres lijkt. Verandert er iets aan de schrijfwijze, dan raak je het spoor kwijt.

Later wordt dat een probleem. Bij het samenvoegen van twee systemen kun je twee adressen alleen betrouwbaar aan elkaar koppelen via een id, niet via de tekst. Bij het verversen van gegevens weet je zonder id niet welk record bij welk adres hoort. En bij het aanvullen van een dossier mis je de haak waaraan de rest van de gegevens hangt. Een adres zonder id is een dood spoor zodra er iets met het systeem gebeurt.

Wat er gebeurt

Van ingetypt adres naar record met een id.

  1. 01

    Het adres tegen de bron leggen

    Het adres gaat langs de BAG voordat het een record wordt. Wat niet bestaat of niet klopt, komt er op dat moment uit.

  2. 02

    Het adres voorzien van een id

    Elk adres dat doorgaat krijgt de identificatie uit de bron mee. Dat nummer blijft bij het adres horen, ook als de schrijfwijze verandert.

  3. 03

    Afwijkingen melden

    Een adres dat niet gevonden wordt hoort een melding te geven, niet stil te verdwijnen. Zo blijft zichtbaar wat er niet door kon.

Waar de adressen vandaan komen

De adressen zelf komen uit de BAG. PostcodeBase doet de adressen en GetApi beheert de databronnen die eraan hangen, waaronder de BAG. Wie die bron gebruikt, krijgt bij hetzelfde adres ook hetzelfde antwoord.

Dat is het punt van een vaste bron: niet dat het een keer klopt, maar dat het bij elk adres op dezelfde manier klopt. Zie ook gegevens aanvullen.

Wat er na de koppeling nodig blijft

De koppeling is niet af op het moment dat hij werkt. De BAG wordt bijgehouden, en een adres dat vandaag bestaat kan morgen zijn aangepast. Nieuwe adressen komen erbij en oude verdwijnen.

Daarom hoort er een afspraak naast te staan over het heel houden. Dat betekent: meelezen als de bron verandert, de opvraging testen voordat het misgaat, en zeggen wanneer een koppeling zijn nut verliest in plaats van hem door te laten lopen. Zie onderhoud en reparatie.

Vragen

Kort vooraf.

De vragen die het vaakst terugkomen over dit onderwerp.

Wat is een BAG API?
Een BAG API is een koppeling waarmee je adressen uit de Basisregistratie Adressen en Gebouwen opvraagt. Je legt een adres langs de bron en krijgt terug of het bestaat, met de identificatie die erbij hoort. Zo controleer je een adres voordat het je systeem in gaat. PostcodeBase doet de adressen en GetApi beheert de databronnen erachter.
Waarom is een adres intypen een probleem?
Omdat een adres er bijna goed uitziet en dat genoeg is om een fout record te maken. Twee schrijfwijzen van hetzelfde pand worden twee records, een verwisselde postcode wijst naar een andere straat, en een huisnummer dat niet bestaat blijft gewoon staan. Bij het intypen is er niets dat het adres controleert. Die fouten vallen pas op als er iets misgaat.
Wat is een BAG-id en waarom heb je het nodig?
Het BAG-id is de vaste identificatie van een adres in de bron. Het verandert niet als de straat wordt hernoemd of de postcode wordt aangepast. Zonder dat id herken je een adres alleen aan de tekst, en dan raak je het spoor kwijt zodra de schrijfwijze verschilt. Bij het samenvoegen of verversen van gegevens is dat id de enige betrouwbare haak.
Kan een nieuwbouwadres gevalideerd worden?
Niet altijd, en dat is een eigenschap van het werk en niet van de koppeling. Bij nieuwbouw komt het adres soms later in het register dan de bewoner of de aannemer het al gebruikt. Een adres dat nog niet bestaat hoort dan een melding te geven in plaats van stil te verdwijnen. Zo blijft zichtbaar wat later nog een keer langs de bron moet.
Werkt dit met elk systeem?
De aanpak is overal hetzelfde: het adres ophalen bij de bron en wegzetten in de velden die je al hebt. In een CRM, een administratie of een eigen systeem is de plek waar het landt anders, het koppelwerk is vergelijkbaar. Wat telt is dat de controle bij het invoeren gebeurt en niet achteraf.
Wat gebeurt er als de BAG verandert?
Dan kan een opvraging veranderen of tijdelijk misgaan. De BAG wordt bijgehouden, en een adres dat vandaag bestaat kan morgen zijn aangepast. Dat is werk dat terugkomt, en daarom hoort er een afspraak naast te staan over het heel houden. Zonder die afspraak merk je een wijziging pas als er iets misgaat in je gegevens.

Moeten je adressen kloppen voordat ze je systeem in gaan?

Noem je systeem en waar de adressen nu vandaan komen. Dan hoor je snel of het te doen is.

Neem contact op