Postcode-autocomplete
Postcode-autocomplete
Nederlandse adressen volgen een strikt, machine-vriendelijk formaat: een 4-cijferige + 2-lettercombinatie postcode plus een huisnummer is genoeg om elk afleverpunt in het land uniek te identificeren. Deze module gebruikt dat om adressen automatisch in te vullen zodra die twee velden ingevuld zijn.
Hoe het werkt
Open een Adres-formulier, zet land op Nederland, en vul in:
- Postcode (bv.
1011 PN) - Adresregel 1 met een huisnummer (bv.
Damrak 70)
Zodra beide velden parseerbare waarden hebben, bevraagt de module de PDOK Locatieserver — de open-data-geocoder van de Nederlandse overheid — en vult automatisch in:
- Straat (straatnaam)
- Plaats (plaats)
- Breedte- / lengtegraad indien uw Adres-formulier die velden toont
PDOK is gratis, beheerd door de Nederlandse overheid, en vereist geen API-sleutel of registratie. Geen gebruikslimieten voor normale bedrijfsvolumes.
Parsen van het huisnummer
De module pakt de eerste reeks cijfers uit Adresregel 1:
| Invoer | Gebruikt huisnummer |
|---|---|
Damstraat 12 |
12 |
Damstraat 12-A |
12 |
Damstraat 12 bis |
12 |
Herengracht 182 2e hg |
182 (negeert correct de 2e) |
182 Damstraat |
182 (nummer-eerst werkt ook) |
Wordt geen cijferreeks gevonden, dan slaat de opzoek over — geen fout, gewoon geen auto-invullen.
Wanneer het activeert
- Bij wijziging van Postcode of Adresregel 1, indien land Nederland is en beide velden parseerbare inhoud hebben.
- Alleen op de Adres-doctype. Activeert niet direct op Klant / Leverancier-formulieren — die verwijzen naar Adressen, dus bewerken van het Adres triggert de auto-invulling.
Validatie bij opslaan
Een server-side validate-hook draait ook op Adres-records met land = Nederland. Het controleert of de postcode structureel geldig is (4 cijfers + 2 letters, spaties genegeerd). Ongeldige postcodes geven een fout zodat u geen half-afgemaakt Nederlands adres kunt opslaan.
Beperkingen
- Alleen Nederlandse adressen. De opzoek slaat over als het land niet Nederland is.
- Niet realtime tijdens typen. De trigger vuurt bij veld-wijzigings- events (bij blur van het veld), niet bij elke toetsaanslag.
- PDOK-uptime. PDOK is een overheidsdienst met hoge beschikbaarheid, maar uitval gebeurt. Mislukt de opzoek stil, dan kunt u het adres handmatig invullen — niets anders in het formulier hangt af van de auto-invulling.