Magento koppelen met AFAS: datastromen, keuzes en testscenario’s

Een Magento-AFAS-koppeling wordt soms beschreven alsof er simpelweg twee stekkers in elkaar worden geschoven. In werkelijkheid moeten twee systemen het eens worden over producten, prijzen, voorraad, klanten en orders. Ze gebruiken daarbij niet altijd dezelfde definities. Een klant in Magento is niet vanzelf dezelfde entiteit als een debiteur in AFAS, en een betaalde webshoporder is boekhoudkundig nog niet altijd volledig verwerkt.

De techniek is slechts een deel van het project. Eerst moet duidelijk zijn welk systeem eigenaar is van iedere waarde, wanneer data wordt uitgewisseld en wat er gebeurt als één kant tijdelijk niet reageert. Zonder die afspraken kan een technisch werkende connector alsnog dagelijks handmatig herstelwerk veroorzaken.

MagentoSEO.nl bouwt of configureert geen AFAS-koppeling. Wij analyseren de gevolgen voor productdata, voorraadcommunicatie, landingspagina’s, feeds en metingen, maken een briefing voor de integratiepartner en valideren de storefront na implementatie.

Begin bij de bedrijfsdag, niet bij de API

Stel je een normale ochtend voor. In AFAS wordt een nieuwe prijs actief. Een medewerker corrigeert een klantadres. In Magento komt een order binnen met een coupon, verzendkosten en gedeeltelijke betaling. Ondertussen retourneert een klant één van de drie orderregels. Welke gebeurtenissen moeten direct door, welke mogen in een wachtrij en welke vragen eerst menselijke goedkeuring?

Door een echte bedrijfsdag uit te schrijven, komen uitzonderingen sneller boven tafel dan in een technische workshop over velden. De AFAS REST API en connectoren zijn middelen; het proces bepaalt hoe ze worden gebruikt. De actuele technische mogelijkheden moeten door de AFAS-integratiepartner worden getoetst aan de officiële AFAS-documentatie.

Wie is eigenaar van welke data?

Veel projecten noemen AFAS algemeen “leidend”. Dat is te grof. AFAS kan leidend zijn voor artikelnummer en financiële gegevens, terwijl marketingcontent in een PIM of Magento wordt beheerd. Voorraad kan uit AFAS komen, maar ook uit een WMS. Een verkoopprijs kan afhankelijk zijn van klantgroep, land of promotie in Magento.

Gegeven	Mogelijke bron	Belangrijke ontwerpvraag
SKU en artikelstatus	AFAS	Wanneer wordt een artikel online verkoopbaar?
Productcontent	PIM of Magento	Mag een import handmatige SEO-content overschrijven?
Prijs	AFAS, pricing of Magento	Welke prijs is basis, actie of klantspecifiek?
Voorraad	AFAS of WMS	Is voorraad fysiek, beschikbaar of verkoopbaar?
Klant	Magento en AFAS	Wanneer wordt een webshopklant debiteur?
Order	Magento	Op welk moment wordt de order naar AFAS gestuurd?
Factuur en betaling	AFAS/PSP	Hoe worden verschillen en refunds verwerkt?

Maak deze keuzes per veldgroep. Een enkele uitzondering kan al bepalen dat terugschrijven niet veilig is.

Producten: voorkom dat operationele data de storefront verslechtert

AFAS bevat vaak artikeldata die geschikt is voor administratie, maar niet direct voor een klantgerichte productpagina. Interne afkortingen, technische codes en korte omschrijvingen kunnen operationeel prima zijn en commercieel onbruikbaar.

Daarom is een scheiding tussen bronfeiten en verrijking verstandig. AFAS kan bijvoorbeeld SKU, btw-groep en basisstatus leveren. Magento of een PIM beheert vervolgens titel, beschrijving, afbeeldingen, filters en SEO-velden. Leg vast dat de integratie die verrijking niet overschrijft.

Ook de publicatiestatus verdient aandacht. Een artikel dat in AFAS bestaat, hoeft niet meteen online. Het kan nog foto’s, specificaties of juridische informatie missen. Werk met een expliciete gereedstatus in plaats van “bestaat dus publiceren”.

Prijzen zijn zelden één veld

Een bedrag kan exclusief of inclusief btw zijn, voor een specifieke valuta gelden, een ingangsdatum hebben of afhankelijk zijn van klantafspraken. Magento kan daarnaast catalogus- en winkelmandregels toepassen.

Schrijf enkele rekenvoorbeelden uit voordat de partner gaat bouwen. Neem een normaal product, actieprijs, B2B-klant, staffel, coupon en retour. Vergelijk bij ieder scenario wat AFAS, Magento, checkout en factuur moeten tonen. Zo ontdek je vroeg of twee systemen hetzelfde woord “korting” anders behandelen.

Een fout in prijslogica is niet alleen financieel. Wanneer de productpagina, structured data, feed en checkout verschillende bedragen tonen, raakt dat vertrouwen en kan Merchant Center producten afkeuren.

Voorraad: “op voorraad” moet een definitie krijgen

AFAS kan een voorraadwaarde bevatten, maar verkoopbaarheid hangt mogelijk af van reserveringen, meerdere magazijnen, levertijd of backorders. Bepaal welke hoeveelheid Magento ontvangt en hoe vaak zij wordt bijgewerkt.

Realtime klinkt aantrekkelijk, maar is niet altijd nodig. Voor een langzaam verkopend artikel kan periodieke synchronisatie volstaan. Voor schaars assortiment met veel gelijktijdige orders kan vertraging juist overselling veroorzaken. Ontwerp op bedrijfsrisico, niet op een algemeen ideaal.

Communiceer bovendien eerlijk. Als de koppeling alleen een grove status kent, toon dan geen overdreven precieze leverbelofte.

Klanten en debiteuren

Niet iedere nieuwsbriefinschrijving of gastbestelling hoeft direct een uitgebreide debiteurenkaart te worden. Bepaal op welk moment een klantrecord ontstaat en hoe duplicaten worden voorkomen.

E-mail is niet altijd een veilige unieke sleutel. Zakelijke klanten kunnen meerdere inkopers delen, e-mailadressen wijzigen of al in AFAS bestaan. Gebruik een stabiele identificatie en leg matchingregels vast. Laat twijfelgevallen niet stilletjes samenvoegen.

Privacy speelt mee. Stuur alleen gegevens die nodig zijn, beperk toegang en bepaal hoe correcties en verwijderverzoeken door de keten lopen.

Het ordermoment bepaalt veel

Wanneer gaat een Magento-order naar AFAS? Direct na de bestelknop, na betaalbevestiging, na fraudebeoordeling of pas bij verzending? Er is geen universeel antwoord.

Een directe overdracht geeft snel zicht, maar kan veel geannuleerde of mislukte orders opleveren. Wachten op betaling past niet bij iedere betaalmethode of B2B-flow. Beschrijf per betaaltype de gewenste statusovergang.

Besteed extra aandacht aan wijzigingen nadat de order is doorgestuurd. Denk aan gedeeltelijke annulering, adrescorrectie, nalevering, refund en retour. Als wijzigingen slechts één kant op bewegen, lopen Magento en AFAS na verloop van tijd uiteen.

Foutafhandeling is onderdeel van het ontwerp

Een integratie zonder storingen bestaat niet. AFAS kan tijdelijk niet reageren, een record kan ongeldige data bevatten of een dubbele order kan worden aangeboden. De vraag is hoe zichtbaar en herstelbaar dit wordt.

Een goede foutmelding bevat context zonder gevoelige data prijs te geven: welk proces faalde, welke recordidentiteit betrokken is, wanneer opnieuw is geprobeerd en wie actie moet nemen. Een algemene rode melding “sync error” leidt al snel tot handmatig zoeken.

Laat berichten waar mogelijk idempotent verwerken: opnieuw aanbieden mag niet automatisch een dubbele order of betaling creëren. De integratiepartner bepaalt de technische uitvoering; de webshopmanager stelt het gewenste bedrijfsresultaat vast.

Test met verhalen uit de praktijk

Een testbestand met één perfect artikel bewijst weinig. Gebruik ten minste een nieuw product, prijswijziging met ingangsdatum, uitverkocht artikel, gastorder, bestaande zakelijke klant, mislukte betaling, gedeeltelijke retour en tijdelijke AFAS-storing.

Doorloop elk scenario van bron tot eindresultaat. Kijk niet alleen in logs, maar ook naar productpagina, checkout, orderstatus, financiële verwerking en klantcommunicatie. Noteer wie een afwijking ziet en hoe die wordt hersteld.

SEO en productfeeds na livegang

Integratiewijzigingen kunnen onverwacht titels, URL’s, voorraad en prijzen beïnvloeden. Crawl daarom vóór en na livegang een representatieve set producten. Vergelijk HTML, structured data, feed en checkout. Let op nieuwe lege pagina’s, gewijzigde URL keys en producten die onbedoeld worden uitgeschakeld.

Monitor de eerste weken niet alleen foutmeldingen. Bekijk ook aantallen actieve producten, prijsverschillen, voorraadconflicten en Merchant Center-afkeuringen. Een koppeling kan technisch groen zijn terwijl commerciële data langzaam verslechtert.

De kern: een koppeling is een gezamenlijke afspraak over waarheid

Magento en AFAS koppelen draait niet primair om velden doorgeven. Het draait om definities, eigenaarschap, timing en herstel. Begin bij echte bedrijfsprocessen, bescherm verrijkte productcontent en test uitzonderingen voordat klanten ze vinden.

Wil je de impact van een AFAS-koppeling op je Magento-catalogus, vindbaarheid en feeds laten beoordelen? Vraag een Magento-analyse aan. Wij leveren de integratiepartner een duidelijke briefing en controleren de zichtbare uitkomst na implementatie.