Gratis app voor Business Central
Typ bij een klant, leverancier of contactpersoon een Nederlandse postcode en een huisnummer, en AdresDirect 365 vult straat, plaats en provincie in uit de BAG, de officiële adressenregistratie van het Kadaster. Gratis, met uw eigen API-sleutel.
U typt
De app vult in
Bij het overtypen van een adres ontstaan de fouten: een verkeerd gespelde straat, een plaats die niet bij de postcode hoort, een provincie die leeg blijft. Business Central vult bij een postcode alleen de plaats in, en alleen als die postcode al in de tabel Postcodes staat. AdresDirect 365 haalt het adres op bij de bron: de Basisregistratie Adressen en Gebouwen (BAG) van het Kadaster, waarin elk adres in Nederland staat. Er komt één veld bij, Huisnummer, direct na Postcode; verder werkt Business Central zoals u gewend bent.
Eén nieuw veld, één instellingenpagina, en verder de standaardvelden van Business Central. De schermen hieronder komen uit een Business Central-sandbox met de Engelstalige client en een echte API-sleutel.
Typ een postcode en een huisnummer, en de app vult Adres (straat en huisnummer), Plaats en Provincie in en schrijft de postcode als 1234 AB. Met alleen een postcode komen Plaats en Provincie, maar niet de straat: één postcode kan over twee straten lopen.
Het veld Huisnummer staat direct na Postcode bij klanten, leveranciers, contactpersonen, verzendadressen, bestelladressen van leveranciers, vestigingen en de bedrijfsgegevens.
12, 12a, 12 A, 12-2 of 12B bis: wat na het nummer komt, wordt vergeleken met huisletter en toevoeging samen, zoals de BAG ze kent. Past er niets precies, bijvoorbeeld 14 waar alleen 14A en 14B bestaan, dan kiest de gebruiker uit een lijst.
De BAG kent geen provincies. De app leidt de provincie af uit de eerste vier cijfers van de postcode, met een tabel van 4.086 gebieden op basis van GeoNames.
Elke gevonden postcode komt in de standaardtabel Postcodes van Business Central. Typt iemand daarna een bekende postcode, dan komt de plaats daaruit, zonder aanvraag bij de BAG.
Een verkeerde sleutel, een onbekend adres of een BAG die niet bereikbaar is: de velden blijven zoals ze waren, en een melding zegt waarom. De gebruiker kan altijd gewoon verder.
De app gebruikt de BAG API Individuele Bevragingen met een API-sleutel op uw eigen naam, die het Kadaster gratis uitgeeft. De aanvraag gaat rechtstreeks van uw Business Central naar het Kadaster.
Standaard zoekt de app alleen op als een gebruiker op een kaart typt. Met Opzoeken bij import en API's zoekt hij ook bij een import, een configuratiepakket of een API-koppeling. Laat dat uit bij grote imports: de BAG API is niet bedoeld voor bulk.
Op Instellingen AdresDirect 365 plakt u de sleutel, test u de verbinding en zet u de app aan. De sleutel wordt per bedrijf versleuteld opgeslagen en daarna niet meer getoond.
Vraag bij het Kadaster een gratis API-sleutel aan voor de BAG API Individuele Bevragingen, op naam van uw eigen organisatie. De actie API-sleutel aanvragen op de instellingenpagina opent het aanvraagformulier.
Installeer de app, open Instellingen AdresDirect 365, plak de sleutel en kies Verbinding testen. Zet daarna Ingeschakeld aan.
Typ op een adreskaart de postcode en het huisnummer. Zodra u het veld verlaat, worden Adres, Plaats en Provincie ingevuld.
Horen er bij een huisnummer meer adressen en past er geen precies, dan kiest u het juiste adres in de lijst Kies een adres.
AdresDirect 365 zoekt alleen Nederlandse adressen op. Het land op het adres moet het land van de instellingenpagina zijn (standaard NL), of leeg in een bedrijf dat zelf in dat land zit, en de postcode moet eruitzien als 1234 AB. Andere adressen typt u zoals altijd. Zonder een eigen API-sleutel van het Kadaster doet de app niets. Die sleutel is gratis, hoort bij uw organisatie en mag niet met andere organisaties worden gedeeld; Van Oosten Software levert er dus geen. Hij is bedoeld om adressen één voor één op te zoeken, met maximaal 50.000 aanvragen per dag, en niet voor bulk. In een sandbox moet een beheerder de app bovendien eerst uitgaande HTTP-aanvragen laten doen, op de pagina Extensiebeheer.
De app is gratis. Wat u verder nodig hebt, staat hieronder; de handleiding legt elke stap uit.
Adressen van eenmanszaken en particulieren kunnen persoonsgegevens zijn. Ze blijven in uw eigen Business Central-omgeving en gaan niet langs Van Oosten Software.
De aanvraag gaat van uw Business Central-omgeving direct naar de BAG API, met uw eigen sleutel. Per aanvraag gaan alleen de postcode en, als die er is, het huisnummer mee.
De API-sleutel staat per bedrijf versleuteld in isolated storage. Na het opslaan toont de pagina alleen nog ********.
Van Oosten Software ontvangt alleen of een opzoeking lukte, niets vond of mislukte, met een vaste reden. Nooit postcodes, huisnummers, adressen, namen of de sleutel.
Wie adressen invoert, heeft geen extra machtigingenset nodig. De set AdresDirect 365 is alleen voor wie de instellingen beheert.
Twee open bronnen. De adressen komen bij elke opzoeking vers uit de BAG; de tabel met provincies zit in de app.
De Basisregistratie Adressen en Gebouwen van het Kadaster, via de BAG API Individuele Bevragingen. De BAG is open data (CC0).
De provincie per postcodegebied is afgeleid van gegevens van GeoNames (geonames.org), onder de licentie Creative Commons Naamsvermelding 4.0 (CC BY 4.0).
Niets. De app is gratis, en de API-sleutel voor de BAG API Individuele Bevragingen geeft het Kadaster kosteloos uit. Er is geen licentiesleutel en geen proefperiode.
Nee. Het Kadaster geeft een sleutel uit aan één organisatie, en alleen die organisatie mag hem gebruiken; delen met andere organisaties mag niet. U vraagt dus zelf een sleutel aan, gratis, met het formulier dat de actie API-sleutel aanvragen opent. Hij komt per e-mail, doorgaans binnen een uur op werkdagen tijdens kantooruren, en u plakt hem in Instellingen AdresDirect 365.
Daar is de BAG API niet voor bedoeld. Het Kadaster staat hem toe om één of enkele adressen op te zoeken, met maximaal 50.000 aanvragen per dag en 50 per seconde, en niet voor bulk. Daarom zoekt de app standaard alleen op als iemand typt, en staat Opzoeken bij import en API's standaard uit. Voor grote aantallen biedt het Kadaster BAG Extract en BAG GeoPackage.
Nee. De BAG bevat alleen Nederlandse adressen, en de app zoekt alleen op als het land op het adres Nederland is (of leeg, in een Nederlands bedrijf) en de postcode eruitziet als 1234 AB. Andere adressen typt u zoals altijd.
Dan blijven de velden zoals ze waren en zegt een melding waarom. Opslaan wordt nooit geblokkeerd. De app wacht maximaal vijf seconden op een antwoord.
Nee. De aanvraag gaat rechtstreeks van uw Business Central-omgeving naar het Kadaster, met uw eigen sleutel. Van Oosten Software ontvangt alleen technische telemetrie, zonder postcodes, huisnummers of adressen.
Omdat één postcode over twee straten kan lopen. Met alleen een postcode komen Plaats en Provincie; de straat komt pas met het huisnummer erbij.
Ja, als het adres gevonden is: Adres, Plaats en Provincie krijgen dan de waarden uit de BAG. Wordt er niets gevonden, dan blijft alles zoals het was.
Ja. Instellingen en API-sleutel gelden per bedrijf, dus u richt elk bedrijf apart in. In een bedrijf zonder instellingen verandert er niets.
De handleiding, de versiegeschiedenis en hoe u hulp vraagt, staan op deze site, in het Nederlands en het Engels. Ze beschrijven de huidige versie van de app.
Instellen, dagelijks gebruik, wat de meldingen betekenen, de tabel Postcodes en de machtigingen.
Wat er in elke versie van de app zit, de nieuwste eerst.
Hoe u hulp vraagt, en wat u meestuurt.
Deze drie documenten gaan over de app en niet over deze website; daarom staan ze apart. De privacyverklaring en de voorwaarden van van-oosten.nl zelf vindt u onderaan elke pagina.
Twijfelt u of de app past bij hoe u adressen in Business Central vastlegt? Stel uw vraag; meestal hebt u binnen één werkdag antwoord.