Adresvalidatie en postcode-API voor België

Je hebt een Belgisch adres in een formulierveld en je wilt weten of het bestaat. Dat is één HTTP-aanroep, en dit artikel beschrijft wat erin gaat, wat eruit komt, en waar het in België anders werkt dan je gewend bent.

Wat je meestuurt en wat je terugkrijgt

Je stuurt de postcode, de straat en het huisnummer, met het busnummer erbij. Je krijgt het adres terug in aparte velden, met de gemeente en de coördinaten. Moet je het adres nog verzamelen, laat postcode, gemeente, straat en huisnummer dan afzonderlijk voorstellen.

De parameters, de velden in het antwoord en een kant-en-klaar codevoorbeeld staan in de ontwikkelaarsdocumentatie.

Het busnummer

Dit is het veld dat in Belgische adressen het vaakst wordt vergeten en dat de meeste mislukte leveringen veroorzaakt.

In een appartementsgebouw bestaat het adres uit een huisnummer én een busnummer. "Kerkstraat 12 bus 3" is een ander adres dan "Kerkstraat 12 bus 8". Een formulier dat alleen een huisnummer kent, gooit die informatie weg of propt hem in het straatveld, waarna de koerier voor een gesloten deur staat.

Behandel het busnummer als een eigen veld, van het formulier tot in de database. Pro6PP geeft het ook als apart veld terug, precies om die reden.

Wat een formulier uit Nederland fout doet

Belgische adressen worden vaak afgewezen door formulieren die voor Nederland zijn gebouwd. De vier klassiekers:

Vier cijfers plus twee letters eisen. Dat is het Nederlandse formaat. België heeft alleen vier cijfers.
Vijf cijfers eisen. Dat is Frans of Duits. Ook fout voor België.
Geen busnummerveld. Zie hierboven, en het is de duurste van de vier.
Eén schrijfwijze van de gemeente aanvaarden. Brussel en Bruxelles zijn allebei juist, zie tweetalige gemeentenamen.

Drie antwoorden, drie reacties

Volledige treffer. Sla het genormaliseerde adres op, bewaar de oorspronkelijke invoer apart.

Treffer met correctie. Toon de correctie en laat de klant bevestigen. In België gebeurt dit vaak door de taalvormen en door deelgemeentenamen.

Geen treffer. Niet blokkeren. Toon de dichtstbijzijnde suggesties, en past er geen enkele, laat de klant dan bevestigen en markeer het record.

Gemeente, deelgemeente en NIS-code

Wil je op gemeente rapporteren, gebruik dan de NIS-code en niet de postcode of de plaatsnaam. Een postcode kan meerdere gemeenten bestrijken en een fusiegemeente heeft er meestal meerdere. De achtergrond staat in postcodes opzoeken in België, en wat dat betekent voor de grote steden in de postcodes van Antwerpen, Brussel en Gent.

Wat Pro6PP biedt

Pro6PP dekt België met adresvalidatie en aanvulling, suggesties tijdens het typen, omgevingszoekopdrachten, geocodering en afstandsberekening, inclusief het busnummer. Dezelfde API en hetzelfde antwoordformaat dekken Nederland, Duitsland, Frankrijk, Luxemburg, Denemarken, Oostenrijk, Zwitserland, Spanje en het Verenigd Koninkrijk.

Voor een Nederlandse webshop die naar Vlaanderen en Wallonië levert, betekent dat één koppeling in plaats van twee, en één datamodel in plaats van twee.

Veelgestelde vragen

Hoeveel cijfers heeft een Belgische postcode?

Vier, zonder letters. Het Nederlandse formaat met vier cijfers plus twee letters en het Franse of Duitse formaat met vijf cijfers gelden hier niet.

Wat is een busnummer en heb ik het nodig?

Het is de aanduiding van een appartement binnen een gebouw. Zonder busnummer kan een levering in een appartementsgebouw niet worden bezorgd, dus ja, je hebt het nodig als je aan particulieren levert.

Bestaat er een gratis postcode-API voor België?

Er zijn open datasets met postcodes en gemeenten. Voor volledige adressen met straat, huisnummer en busnummer, en voor een beschikbaarheidsafspraak, heb je doorgaans een commerciële dienst nodig.

Waarop groepeer ik voor rapportage per gemeente?

Op de NIS-code. De postcode is postaal en niet administratief, en de plaatsnaam bestaat vaak in twee talen.

Moet ik blokkeren als een adres niet valideert?

Nee. Waarschuw, toon suggesties en laat de klant bevestigen. Nieuwbouw en recente verkavelingen ontbreken regelmatig in het referentiebestand.