Straat, huisnummer en toevoeging: één veld, twee of drie?

Het probleem in één voorbeeld

Een klant vult in de checkout Peizerweg 97 A in. De webshop bewaart dat als één tekst. Het ERP wil drie velden: straat Peizerweg, huisnummer 97, toevoeging A.

De voor de hand liggende regel is: alles voor het eerste getal is de straat, het eerste getal is het huisnummer, de rest is de toevoeging. Die regel werkt voor dit adres. Hieronder staat wat hij met dit adres en zeven andere doet.

Zes van de acht gaan fout of vragen een besluit. Terug samenvoegen is ook niet zonder verlies. Huisnummer 1 met toevoeging 2 wordt aan elkaar geschreven 12, en dat is een ander adres. Met een spatie ertussen staat er 1 2, en de volgende koppeling in de keten weet niet of de 2 een toevoeging of een verdieping is.

Wat systemen verwachten

De veldnamen hieronder komen uit de documentatie van de leveranciers, gecontroleerd op 3 oktober 2026.

Tussen twee systemen met dezelfde vorm is er weinig aan de hand: van Shopify naar Exact Online gaat de regel ongesplitst over. Het splitsen begint zodra het doel drie velden heeft. Een order uit WooCommerce naar AFAS Profit heeft een geheel getal nodig in HmNr. 14-16 past daar niet in, en 12a ook niet.

In de tweede adresregel staat van alles. Klanten zetten er de verdieping in, de afdeling, t.a.v. inkoop, een afleverinstructie of het huisnummer dat ze in regel 1 vergaten. Een koppeling die address2 standaard weggooit, verliest bij een deel van de orders het huisnummer. Een koppeling die het altijd achter de straat plakt, zet achterom bij de loods in het straatveld van het ERP.

Zo komt een afleveradres uit Shopify:

{
  "shipping_address": {
    "company": "Bakker Installatietechniek en Duurzame Energie B.V.",
    "first_name": "Jan",
    "last_name": "Bakker",
    "address1": "Peizerweg 97 A",
    "address2": "t.a.v. inkoop",
    "zip": "9727 aj",
    "city": "Groningen",
    "country_code": "NL"
  }
}

De rest van het adres

Straat en nummer zijn het bekendste probleem. De andere velden hebben elk een eigen variant.

Postcode. Klanten typen 9727AJ, 9727 AJ en 9727 aj. De API van PostNL wil voor Nederland 6 tekens, dus zonder spatie: 9727AJ. Een ERP toont hem meestal met spatie. De koppeling bewaart één vorm en zet die per doel om. Dat geldt alleen voor Nederlandse adressen: een Belgische postcode heeft 4 cijfers.

Land. NL, NLD, Netherlands, Nederland en The Netherlands zijn vijf schrijfwijzen van hetzelfde land. Shopify en WooCommerce leveren de tweeletterige ISO-code. Een ERP dat de volledige naam of een eigen landcode verwacht, heeft een vertaaltabel nodig met elke waarde die in de praktijk voorkomt.

Bedrijf, contactpersoon en t.a.v. Het label van de vervoerder heeft een bedrijfsnaam en een naam nodig, elk met een maximale lengte. PostNL accepteert 35 tekens voor CompanyName en 35 voor Name. DPD hanteert 35 tekens voor de naam en 8 voor het huisnummer. De bedrijfsnaam uit het voorbeeld telt 51 tekens: 51 min 35 is 16 tekens die wegvallen. Op het label staat Bakker Installatietechniek en Duurz. Bij een bedrijfsverzamelgebouw met drie bedrijven die Bakker heten, weet de bezorger niet meer welke.

Drie soorten adressen. Factuuradres, afleveradres en bezoekadres zijn in een ERP losse records. Exact Online geeft elk adres een type, van 1 tot en met 4. Een koppeling maakt een afleveradres alleen aan als het afwijkt van het factuuradres. Vergelijkt hij de ruwe tekst, dan zijn Peizerweg 97 A en Peizerweg 97a twee adressen en krijgt de debiteur bij elke order een nieuw afleveradres. Vergelijken gebeurt dus na het normaliseren. Hetzelfde speelt bij debiteuren, zie dubbele klanten en debiteuren.

Hoe een koppeling dit oplost

Per veld ligt vast welk systeem de waarde bepaalt, hoe de waarde genormaliseerd wordt en wat er gebeurt als hij nergens past. Dat is veldmapping, toegepast op het adres.

Voor Nederlandse adressen is er een controle die de splitsing sluitend maakt. Een postcode met een huisnummer hoort bij precies één straat. De koppeling zoekt bij 9727 AJ en nummer 97 de straat op. Is dat de Peizerweg, dan klopt de splitsing. Komt er een andere straat uit, of bestaat het nummer niet bij die postcode, dan gaat de order naar de controlelijst.

De betrouwbaarste oplossing zit aan het begin van de keten. Een checkout met drie velden levert straat, huisnummer en toevoeging gescheiden aan, en dan hoeft niemand te raden. De koppeling leest die velden uit de order en gebruikt de splitsregel alleen voor orders die nog in de oude vorm binnenkomen, zoals orders van marktplaatsen.

Wat betekent dit voor je koppeling?

Wij leggen per adresveld vast hoe het van je webshop naar je ERP en je vervoerder gaat: welke vorm de bron levert, welke vorm het doel vraagt en hoe lang elk veld daar mag zijn. Bij de proefronde voor de livegang lopen je bestaande orders door de splitsregel. Je ziet dan welke adressen niet passen voordat er één label is geprint. Daarna staat elk adres dat de koppeling niet kan plaatsen op een controlelijst in het dashboard, met de oorspronkelijke regel erbij.

De hele orderstroom staat op orders koppelen. Hoe adressen passen in de koppeling met je ERP lees je in je webshop koppelen aan je ERP. Wil je weten wat dit voor jouw systemen betekent, stuur ze dan in.