Voor wie · Welk probleem het oplost
Voor wie
Elke Odoo-database met klanten, leveranciers of contacten in Nederland of België.
Welk probleem het oplost
Met de hand getypte adressen leiden tot typefouten, mislukte leveringen en teruggestuurde facturen. Hier typt u postcode en huisnummer, en de officiële adresregisters vullen de rest aan.
Adressen met de hand typen leidt tot typefouten en retourpost. Deze module vult Nederlandse en Belgische adressen van relaties in Odoo vanuit de officiële open adresdiensten van de overheid: vul postcode en huisnummer in, en straat, plaats en land worden ingevuld. Geen account, geen API-sleutel, geen gebruikskosten.
Wat het doet
Nederland via PDOK
Vul een Nederlandse postcode en huisnummer in (met eventuele letter of toevoeging). De PDOK Locatieserver, die de BAG publiceert, vult straat, plaats, provincie en land.
België via BeST
Vul een Belgische postcode en huisnummer in (met eventueel bus). Straat en gemeente komen uit de open API BeST van BOSA, die de regionale adresregisters combineert.
Invullen tijdens het typen
Zodra postcode en huisnummer compleet zijn, wordt het adres ingevuld. Een Nederlandse postcode zet het land als dat nog leeg is. Tekst in de tweede adresregel wordt nooit overschreven.
Validatievlag en bron
Een geslaagde opzoeking markeert het adres als gevalideerd en legt vast of het uit PDOK of BeST komt. Wijzigt u postcode, huisnummer of land, dan verdwijnt de vlag.
Cache, time-out en herhaalpogingen
Opzoekingen worden per bedrijf gecachet. Bij een tijdelijke fout volgt kort een nieuwe poging. Is de dienst onbereikbaar, dan krijgt u een duidelijke melding en kunt u het adres gewoon zelf typen.
Per land aan of uit
Zet Nederland en/of België aan, stel cacheduur en time-out in en kies invullen tijdens het typen of alleen via de knop.
Voordat u begint
- Uw Odoo-server heeft uitgaande HTTPS-toegang nodig tot de diensten van PDOK en BeST.
Installeren
- Koop en download de module voor uw Odoo-versie in de Odoo Apps Store, of installeer hem via het menu Apps als uw database aan uw winkelaccount is gekoppeld.
- Kopieer de map
l10n_nl_be_address_lookupnaar uw addons-pad (op Odoo.sh: commit hem in uw repository) en herstart Odoo. - Klik in Apps op Apps-lijst bijwerken, zoek op Address Lookup en installeer de module. Contacten en Base Address Extended worden zo nodig automatisch geïnstalleerd.
Begeleide inrichting
- Open Instellingen › NL/BE-adres en zet Nederland en/of België aan.
- Optioneel: pas de cacheduur aan (standaard één week), de HTTP-time-out, en of adressen tijdens het typen of alleen via de knop worden ingevuld. Daar staat ook de bronvermelding voor BeST-gegevens.
Dagelijks gebruik
- Open een relatie en zet het land op Nederland of België (of laat het leeg en typ een Nederlandse postcode zoals 1234 AB).
- Vul postcode en huisnummer in, plus letter, toevoeging of bus indien nodig.
- Straat en plaats worden automatisch ingevuld. Gebruik Adres opzoeken om opnieuw te zoeken, of als invullen tijdens het typen uit staat.
Screenshots
Alle screenshots tonen fictieve demogegevens.
Veelgestelde vragen
Heb ik een API-sleutel of abonnement nodig?
Nee. De PDOK Locatieserver en de open API van BeST vragen geen sleutel.
Wat als de overheidsdienst traag is of plat ligt?
De opzoeking probeert het kort opnieuw en toont dan een melding. Opslaan van de relatie wordt nooit geblokkeerd; u kunt het adres altijd zelf typen.
Zit website-checkout of Kassa erbij?
Nee. Deze versie vult adressen van relaties in de backend (klanten, leveranciers, alles wat een relatie is).
Andere landen?
Alleen Nederland en België. Voor andere landen legt de knop dat uit en blijft het adres ongewijzigd.
Onder welke licentie vallen de gegevens?
BeST-gegevens worden gepubliceerd onder Creative Commons Naamsvermelding 4.0; de bronvermelding staat in de instellingen. PDOK publiceert de BAG als open data.
Worden er gegevens naar Normalane gestuurd?
Nee. Opzoekingen gaan rechtstreeks van uw Odoo-server naar PDOK (NL) of BeST (BE), en alleen postcode, huisnummer, toevoeging of bus (en voor België de straatnaam als die is ingevuld) worden verstuurd, nooit namen of andere contactgegevens.
Werkt het op Odoo Online?
Nee. Odoo Online staat geen modules van derden toe. Gebruik Odoo.sh of een eigen installatie (on-premise).
Hoe installeer ik het?
Koop de module voor uw Odoo-versie en download de zip uit de store (of later via uw bestellingen). Kopieer de map naar uw addons-pad, werk de apps-lijst bij en installeer. Op Odoo.sh commit u de map in uw repository. De sectie Installeren beschrijft elke stap.
Wat gebeurt er als ik Odoo upgrade?
Sinds Odoo 13 verkoopt de Odoo Apps Store elke Odoo-versie van een module apart, dus voor een nieuwe hoofdversie koopt u de module voor die versie. Bugfix-updates binnen uw versie zijn gratis: download de nieuwste zip via uw bestellingen en vervang de map. Mail ons vóór een grote upgrade, dan delen we eventuele migratie-aanwijzingen.
Werkt het met meerdere bedrijven?
Ja. Instellingen en de opzoekcache worden per bedrijf bewaard.
Hoe snel antwoorden jullie?
Mail support@normalane.com of gebruik de supportknop op uw bestelpagina in de Odoo Apps Store. Elk bericht wordt door een mens gelezen en beantwoord op werkdagen (CET). Bugfixes voor de gekochte versie zijn gratis.
Klaar om Address Lookup NL/BE te gebruiken?
€ 15, eenmalig, per Odoo-versie. Te koop en te downloaden in de Odoo Apps Store.
Hulp nodig?
Mail naar support@normalane.com met uw Odoo-versie en -editie (Community of Enterprise). Bugfixes voor de gekochte Odoo-versie zijn gratis.
Onafhankelijke module, niet verbonden aan of goedgekeurd door het Kadaster, PDOK, BOSA of de regionale adresregisters of Odoo S.A.
