Koppel een afleveradres pas aan een AFAS-debiteur wanneer klantidentiteit, adresinhoud en herkomst samen kloppen. Een gevonden debiteur op alleen e-mailadres of postcode is geen voldoende bewijs. Valideer of de order werkelijk bij die relatie hoort, normaliseer het adres en behandel meerdere plausibele matches als een uitzondering die een medewerker moet beoordelen.
Een adres is meer dan een tekstveld
Webshops leveren straat en huisnummer niet altijd in dezelfde velden aan. Nederlandse en Belgische adressen, toevoegingen en bedrijfsnamen zorgen voor variatie. Tegelijk kan een consument hetzelfde e-mailadres voor privé en zakelijk gebruiken, of kunnen gezinsleden één adres delen. Een integratie die “lijkt erop” verwart met “is dezelfde” kan een geldig adres op de verkeerde debiteur zetten.
Splits daarom de vraag in twee delen: kan het adres technisch betrouwbaar worden gelezen, en is de relatie-identiteit voldoende sterk? Bewaar de originele ordervelden naast de genormaliseerde vorm, zodat een medewerker bij twijfel kan terugzien wat de klant invoerde. Gebruik een bestaande doelidentiteit uit eerdere betrouwbare synchronisatie als sterker signaal dan een nieuwe fuzzy match.
Identiteitscheck vóór de update
- Werkruimte en winkel. Zoek uitsluitend binnen de juiste organisatiecontext.
- Bestaande koppeling. Controleer of de lokale order al een bevestigde AFAS-debiteuridentiteit heeft.
- Relatiesignalen. Vergelijk klantnummer, e-mail en relevante bedrijfskenmerken volgens vooraf bepaalde regels.
- Adresparse. Valideer land, postcode, plaats, straat, huisnummer en toevoeging afzonderlijk.
- Ambiguïteit. Stop bij nul of meerdere overtuigende kandidaten; kies nooit de eerste zoekhit.
- Effect. Bepaal of je een orderafleveradres, relatieadres of beide mag wijzigen.
Bij een WooCommerce-AFAS-orderstroom verdient vooral dat laatste punt aandacht. Een eenmalig cadeauadres hoeft niet automatisch het vaste relatieadres te vervangen.
Fictief voorbeeld: gedeelde mailbox, twee vestigingen
Fictief voorbeeld: zakelijke klant Stadsgroen bestelt vanuit twee vestigingen met `[email protected]`. Order 5810 noemt als afleveradres de werkplaats in Breda. In AFAS bestaan twee debiteuren met die mailbox: de holding en de regionale vestiging. Een zoekactie op e-mail levert dus geen unieke relatie op.
De integratie ziet geen bevestigde koppeling op de order en opent een duurzame aandachtstaak. De medewerker vergelijkt het klantnummer uit de checkout, de bedrijfsnaam en eerdere orders, kiest de regionale vestiging en legt de bevestigde identiteit vast. Alleen het afleveradres van de verkooporder wordt bijgewerkt; het hoofdadres van de holding blijft onaangeroerd. Dit fictieve voorbeeld laat zien waarom een paar seconden automatische “handigheid” veel duurder kan worden dan een gerichte ambiguïteitstaak.
Adresacceptatie als stoplicht
| Kleur | Situatie | Beleid |
|---|---|---|
| Groen | Bevestigde doelidentiteit en volledig valide orderadres | Gecontroleerd verwerken |
| Oranje | Unieke kandidaat, maar nieuw of afwijkend adres | Extra regels of menselijke controle |
| Rood | Meerdere kandidaten, onparseerbaar adres of contextmismatch | Niet schrijven; aandachtstaak |
Connect kan bronvelden, identiteit en providerstap controleerbaar samenbrengen. Desk geeft de medewerker bij oranje en rood de relevante ordercontext en één volgende actie. Leg na een handmatige keuze vast welk bewijs is gebruikt, zodat een volgende order niet opnieuw dezelfde ambiguïteit hoeft te doorlopen.
Test adreslogica met echte vormen, maar geanonimiseerde waarden. Neem hoekgevallen op zoals een huisnummer met letter, toevoeging met streepje, Belgische bus, postbus, ontbrekende postcode, lange bedrijfsnaam en een bestelling waarbij factuur- en afleveradres verschillen. Controleer na transformatie ieder veld, niet alleen de samengestelde weergave. Een adres kan er in één tekstregel goed uitzien terwijl huisnummer en toevoeging verkeerd in het ERP belanden. Leg ook landafhankelijke parse-regels vast en kies bij onbekende landen voor behoud van bronvelden plus beoordeling. Maak van parsing nooit een identiteitsbewijs: zelfs een perfect genormaliseerd adres bewijst niet welke debiteur eigenaar is. Scheid daarom testresultaten voor technische leesbaarheid en relationele match.
Verwijder tot slot niet stil een oud afleveradres wanneer het doelsysteem historie nodig heeft. Bepaal vooraf of de koppeling een bestaand adres bijwerkt, een ordergebonden adres toevoegt of een nieuwe geldigheidsperiode start. Controleer daarna op één fictieve klant met twee gelijktijdige orders of beide zendingen hun eigen bestemming behouden. Dat voorkomt dat een latere bestelling een eerdere fulfilmentopdracht onbedoeld verandert en houdt de oorspronkelijke klantinvoer voor onderzoek beschikbaar.
Wil je adresupdates automatiseren zonder verkeerde debiteuren te raken? Laat Yindle jouw identiteits- en adresregels uitwerken.