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:

1. Postcode (bv. 1011 PN)
2. 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:

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.