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, met de eigen API-sleutel van de klant, en rechtstreeks van Business Central naar het Kadaster.
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, met de eigen API-sleutel van de klant, 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 en een echte API-sleutel.
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. Op Instellingen AdresDirect 365 plakt de beheerder de eigen API-sleutel van het Kadaster, kiest Verbinding testen en zet de app aan. API-sleutel aanvragen opent het aanvraagformulier van het Kadaster.
Verbinding testen stuurt één aanvraag met de opgeslagen sleutel naar de BAG.
De sleutel staat per bedrijf versleuteld opgeslagen en komt na het opslaan niet meer in beeld.
Het antwoord van de BAG: de sleutel is geaccepteerd.
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.
De sleutel van het Kadaster is bedoeld voor losse opzoekingen: maximaal 50.000 per dag en 50 per seconde, geen bulk. 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.
28 geautomatiseerde tests draaien tegen een nagebootste BAG. De build loopt door de codeanalyzers van Microsoft en laat geen enkele waarschuwing door. Daarna is de app 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 het Kadaster. Er zit geen server van Van Oosten Software tussen.
Elke klant vraagt zelf een gratis API-sleutel aan bij het Kadaster, met het aanvraagformulier. Die komt op werkdagen doorgaans binnen een uur.
De sleutel 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 de sleutel is 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 is gratis en op weg naar AppSource: Microsoft heeft het objectbereik toegekend, de builds zijn ondertekend en de indiening loopt. 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, 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.