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 en zonder sleutel: de app werkt direct na de installatie.
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.
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 nieuwe aanvraag.
Een onbekend adres, een dienst die niet antwoordt of een geweigerde sleutel: de velden blijven zoals ze waren, en een melding zegt waarom. De gebruiker kan altijd gewoon verder.
Standaard komen de adressen van de PDOK Locatieserver, de open dienst van het Kadaster: geen sleutel, geen account, en de app werkt meteen. Wilt u nieuwe adressen al op de dag van registratie, of een eigen sleutel bij het Kadaster? Kies dan de BAG API Individuele Bevragingen, met een gratis API-sleutel op naam van uw organisatie. De aanvraag gaat altijd rechtstreeks van uw Business Central naar PDOK of 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: beide adresdiensten zijn niet bedoeld voor bulk.
Op Instellingen AdresDirect 365 kiest u de adresdienst, test u de verbinding en zet u de app aan of uit. Kiest u de BAG API, dan plakt u daar ook de sleutel; die wordt per bedrijf versleuteld opgeslagen en daarna niet meer getoond.
Installeer de app via AppSource. De opzoeking staat meteen aan, met de PDOK Locatieserver; u hoeft geen sleutel aan te vragen.
Open Instellingen AdresDirect 365 en kies Verbinding testen. Wilt u de BAG API gebruiken, kies die dan bij Adresdienst, vraag met API-sleutel aanvragen een gratis sleutel aan en plak hem in het veld API-sleutel.
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. Beide adresdiensten zijn bedoeld om adressen één voor één op te zoeken, niet voor bulk. Met de BAG API geldt bovendien een limiet van 50.000 aanvragen per dag, en de sleutel hoort bij uw organisatie: hij mag niet met andere organisaties worden gedeeld, dus Van Oosten Software levert er geen. In een sandbox moet een beheerder de app 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 PDOK Locatieserver, of naar de BAG API als u die kiest. Per aanvraag gaan alleen de postcode en, als die er is, het huisnummer mee.
Kiest u de BAG API, dan staat de API-sleutel per bedrijf versleuteld in isolated storage. Na het opslaan toont de pagina alleen nog ********. PDOK vraagt geen sleutel.
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, standaard via de PDOK Locatieserver en desgewenst 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, de PDOK Locatieserver ook, en wie de BAG API kiest, krijgt de API-sleutel kosteloos van het Kadaster. Er is geen licentiesleutel en geen proefperiode.
Nee. Standaard komen de adressen van de PDOK Locatieserver, die geen sleutel vraagt. Alleen als u de BAG API Individuele Bevragingen kiest, hebt u een sleutel nodig. Die vraagt uw organisatie zelf aan, gratis, met het formulier dat de actie API-sleutel aanvragen opent. Het Kadaster geeft een sleutel uit aan één organisatie, dus Van Oosten Software kan er geen leveren.
Beide leveren de adressen uit de BAG van het Kadaster. De PDOK Locatieserver is de open dienst van de overheid: geen sleutel, direct te gebruiken. De BAG API vraagt het register zelf, met uw eigen sleutel: een adres dat vandaag is geregistreerd, staat daar het eerst. PDOK werkt zijn gegevens zeer regelmatig bij, maar zonder vaste termijn. U kiest per bedrijf op Instellingen AdresDirect 365, en kunt altijd wisselen.
Daar zijn de adresdiensten niet voor bedoeld. PDOK noemt de Locatieserver een zoekdienst en wijst voor grote aantallen naar downloads, en het Kadaster staat de BAG API toe voor één of enkele adressen, met maximaal 50.000 aanvragen per dag en 50 per seconde. 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, en stapt niet vanzelf over naar de andere dienst.
Nee. De aanvraag gaat rechtstreeks van uw Business Central-omgeving naar PDOK of, met uw eigen sleutel, naar het Kadaster. 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. De instellingen, en bij de BAG API de sleutel, gelden per bedrijf. Na een nieuwe installatie staat de opzoeking in elk bedrijf aan met PDOK, ook in een bedrijf dat u later aanmaakt. Met de BAG API richt u elk bedrijf apart in.
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.