Referentie · Eigen app voor Business Central
Een Nederlands adres met de hand overtypen kost tijd en gaat af en toe mis. AdresDirect 365 is de Business Central-app die dat overneemt: wie bij een klant, leverancier of contactpersoon een postcode en een huisnummer typt, krijgt straat, plaats en provincie uit de BAG van het Kadaster. Gratis, zonder sleutel, en rechtstreeks van Business Central naar de bron.
Iemand typt bij een klant een postcode en een huisnummer, bijvoorbeeld 1071XX en 1, en verlaat het veld.
Business Central vraagt het adres rechtstreeks op in de BAG, standaard via de PDOK Locatieserver zonder sleutel, en wacht hooguit vijf seconden.
Adres, Plaats en Provincie vullen zich in en de postcode wordt 1071 XX. Passen er meer adressen, dan kiest de gebruiker er een.
De gevonden postcode komt in de standaardtabel Postcodes, zodat een bekende postcode daarna geen aanvraag meer kost.
Van Oosten Software bouwde de app voor het eigen werk in Business Central en voor dat van klanten. Een Nederlands adres met de hand overtypen is traag, en er sluipen fouten in: een straatnaam met een tikfout, een plaats die niet bij de postcode hoort.
De postcodetabel van Business Central zelf helpt maar een klein stuk: bij een postcode geeft die alleen een plaats, nooit een straat. Die komt dan nog steeds uit het hoofd van wie typt. AdresDirect 365 zoekt daarom het hele Nederlandse adres op in de BAG van het Kadaster.
AdresDirect 365 werkt in de standaardschermen van Business Central; er komt één veld bij, Huisnummer. Dit zijn de schermen van de gebruiker en van de beheerder, gemaakt in een Business Central-sandbox met de Engelstalige client.
Op de klantkaart typt de gebruiker postcode 1071XX en huisnummer 1. Zodra hij het veld verlaat, vult de app Adres, Plaats en Provincie in uit de BAG en schrijft hij de postcode als 1071 XX. Met alleen een postcode komen Plaats en Provincie.
Straat en huisnummer uit de BAG: Museumstraat 1, en als plaats Amsterdam.
Getypt als 1071XX, geschreven als 1071 XX.
Het veld Huisnummer, dat de app direct na Postcode toevoegt.
Het veld Huisnummer en de opzoeking zitten niet alleen op de klantkaart. Ze werken op dezelfde manier op zeven plekken waar Business Central een adres vastlegt.
Huisletters en toevoegingen vergelijkt de app zoals ze getypt zijn: 12a, 12 - 2 of 12B bis. Past er geen adres precies, dan beslist de gebruiker. Bij postcode 7311 KP bestaat huisnummer 17 alleen als Hofstraat 17A en 17B, en die staan allebei in de lijst Kies een adres.
Een verkeerde sleutel, een adres dat de BAG niet kent of vijf seconden zonder antwoord: de velden blijven zoals ze waren, en een melding zegt waarom. Opslaan wordt nooit tegengehouden. Hier typte de gebruiker postcode 7311 KP met huisnummer 1, een adres dat de BAG niet kent.
De melding zegt waarom: de BAG heeft geen adres op 7311 KP 1.
Adres en plaats blijven zoals ze waren.
De getypte postcode blijft staan; de gebruiker kan hem verbeteren of gewoon opslaan.
De app staat tussen de handmatige instellingen van Business Central en werkt direct na de installatie, met de PDOK Locatieserver. Op Instellingen AdresDirect 365 test de beheerder de verbinding. Wie liever de BAG API gebruikt, kiest die bij Adresdienst en plakt de eigen API-sleutel van het Kadaster; API-sleutel aanvragen opent dan het aanvraagformulier.
Verbinding testen stuurt één aanvraag naar de gekozen adresdienst.
Adresdienst: standaard de PDOK Locatieserver, zonder sleutel.
Het antwoord van PDOK: adressen kunnen worden opgezocht.
Een postcodetabel geeft een plaats, geen straat. AdresDirect 365 vraagt daarom het hele adres op waar het wordt bijgehouden: in de BAG van het Kadaster. Daarmee werkt de app alleen voor Nederlandse adressen, maar vult hij het hele adres in, tot en met de provincie.
De BAG zelf kent geen provincies. Een tabel van 4.086 gebieden van vier cijfers, gebouwd uit GeoNames (CC BY 4.0), geeft de provincie bij de postcode.
Beide adresdiensten zijn bedoeld voor losse opzoekingen, niet voor bulk; de sleutel van het Kadaster heeft bovendien een limiet van 50.000 per dag en 50 per seconde. De app zoekt daarom standaard alleen als iemand typt. Wie imports of koppelingen ook wil laten opzoeken, zet Opzoeken bij import en API's aan.
Versie 2.0 vroeg nog een eigen sleutel van het Kadaster. Sinds versie 2.1 komen de adressen standaard van de PDOK Locatieserver, die dezelfde BAG-adressen zonder sleutel levert, zodat de app direct na de installatie werkt. De BAG API blijft een keuze voor wie het register zelf wil.
49 geautomatiseerde tests draaien tegen een nagebootste BAG API en PDOK Locatieserver. De build loopt door de codeanalyzers van Microsoft en laat geen enkele waarschuwing door. Versie 2.0 is daarna live getest tegen de BAG, in een Business Central-sandbox met een echte sleutel; de schermen op deze pagina komen daarvandaan.
Een opzoeking is een hulp, geen voorwaarde. Dit zijn de regels die in de code vastliggen.
Een verkeerde sleutel, een onbekend adres of geen antwoord binnen vijf seconden: de velden blijven staan zoals ze waren, en een melding zegt waarom. De app houdt niemand tegen.
De aanvraag gaat van de Business Central van de klant direct naar PDOK of het Kadaster. Er zit geen server van Van Oosten Software tussen.
Standaard is er geen sleutel nodig. Wie de BAG API kiest, vraagt zelf een gratis API-sleutel aan bij het Kadaster, met het aanvraagformulier; die komt op werkdagen doorgaans binnen een uur.
Een sleutel voor de BAG API wordt per bedrijf versleuteld opgeslagen. Na het opslaan toont de instellingenpagina hem niet meer.
Standaard zoekt de app alleen tijdens het typen. Bij imports en koppelingen doet hij dat pas als de beheerder Opzoeken bij import en API's aanzet, want beide adresdiensten zijn niet voor bulk bedoeld.
Elke gevonden postcode komt in de tabel Postcodes van Business Central. Een postcode die daar al staat, kost geen aanvraag meer.
AdresDirect 365 versie 2.0 staat sinds 24 september 2026 gratis op AppSource, na de validatie en certificering door Microsoft. Versie 2.1 volgde op 17 oktober 2026: sindsdien werkt de app zonder sleutel, met de PDOK Locatieserver. De handleiding, de versiegeschiedenis, de licentievoorwaarden en de privacyverklaring staan op deze site.
Voor wie in Business Central adressen vastlegt, verandert het werk nauwelijks: dezelfde kaarten, één veld erbij. Alleen komt het adres voortaan uit de BAG, en niet uit het hoofd van wie typt.
Standaard Business Central en één bron daarbuiten: de BAG van het Kadaster, via PDOK of de BAG API rechtstreeks aangeroepen. Geen tussenserver.
Vertel me welke gegevens u nu met de hand invoert. Dan zeg ik eerlijk of een koppeling of een eigen extensie de moeite waard is, of dat er al iets bestaat dat volstaat.