Magento koppelingen en webshop-integraties die blijven werken

Dubbele orders. Een order wordt verstuurd, het ERP verwerkt hem, maar het antwoord komt door een time-out niet aan. De koppeling probeert opnieuw en het magazijn pakt twee keer in. De oplossing is idempotentie: elke order krijgt een unieke sleutel, en het ontvangende systeem of de middleware controleert of die sleutel al verwerkt is. Dat moet in het ontwerp zitten, niet achteraf worden toegevoegd.

API-limieten. Elk systeem begrenst het aantal verzoeken. Exact Online hanteert limieten per minuut en per dag per administratie; de actuele waarden lees je uit de response-headers. Shopify werkt met een kostenbudget per query in de GraphQL Admin API. Een koppeling die voorraad van tienduizend artikelen elk kwartier één voor één bijwerkt, loopt daar vroeg of laat tegenaan. Werk met deltas (alleen wat gewijzigd is), batches en een wachtrij die netjes terugschakelt bij een 429-melding.

Voorraad is niet één getal. Magento 2 met Multi-Source Inventory kent een fysieke voorraad per bron en een verkoopbare hoeveelheid die rekening houdt met openstaande reserveringen. Als het ERP elke paar minuten de fysieke voorraad overschrijft terwijl er orders onderweg zijn, verkoop je producten die al weg zijn. Spreek af welk getal het ERP stuurt en hoe Magento reserveringen meeneemt.

Varianten en producttypen. Een configurable product in Magento bestaat uit een ouder en losse simple products. Veel ERP's kennen alleen losse artikelnummers. De mapping tussen artikelgroep, kleur, maat en de configurable in Magento is vaak het meest tijdrovende deel van de bouw, en het deel dat het vaakst breekt als iemand in het ERP een nieuwe variant aanmaakt.

Geld en btw. Kortingen per regel versus kortingen op de hele order, verzendkosten als aparte regel, afronding per regel of per totaal, btw-tarieven bij leveringen naar andere EU-landen onder de OSS-regeling: als de webshop en de boekhouding dit verschillend berekenen, sluit je administratie nooit op de cent. Leg vooraf per scenario vast hoe een order in de boekhouding moet landen, en test met echte orders uit je eigen historie.

Retouren en creditnota's. De heenweg wordt bijna altijd goed gebouwd. De terugweg, een gedeeltelijke retour met refund via Mollie en een creditnota in het ERP, is waar handwerk blijft hangen als het niet expliciet is ontworpen.

Stille fouten. De duurste koppeling is de koppeling die faalt zonder dat iemand het merkt. Elke flow heeft logging per bericht nodig, een melding bij fouten, en een plek waar iemand een mislukt bericht kan inzien en opnieuw kan aanbieden.

Magento kan prima productdata beheren voor één winkel in één taal. Het wringt zodra dezelfde productinformatie naar meerdere storeviews, marketplaces, een printcatalogus en een B2B-portal moet, of als meerdere mensen tegelijk aan verrijking werken. Een PIM zoals Akeneo of Pimcore wordt dan de bron voor content, terwijl het ERP de bron blijft voor prijs en voorraad. De koppeling naar Magento wordt eenrichtingsverkeer: het PIM levert, Magento toont.

Let bij een PIM-koppeling op attribuutsets en optiewaarden. Als het PIM een nieuwe kleur toevoegt die in Magento niet als optie bestaat, moet de koppeling die optie aanmaken of het product tegenhouden. Ook media verdienen aandacht: duizenden afbeeldingen elke nacht opnieuw uploaden is zonde van tijd en opslag. Synchroniseer alleen wat gewijzigd is. Voor kleinere catalogi bouwen we soms een eigen PIM in Laravel met Filament, als een standaardpakket meer is dan nodig.

Een Laravel-integratie zit tussen de systemen in. Webshop, ERP, WMS en PIM praten niet rechtstreeks met elkaar, maar met de middleware. Die vertaalt, valideert, zet berichten in een wachtrij en houdt per bericht bij wat er is gebeurd. Laravel heeft daar de bouwstenen voor: queues met retries en backoff, rate limiting per externe API, scheduled jobs, events en een beheeromgeving in Filament waarin je mislukte berichten kunt inzien en opnieuw kunt aanbieden.

Een Laravel koppeling is ook de logische keuze als het andere systeem geen nette API heeft: SFTP met CSV- of XML-bestanden, EDI, SOAP of een database die je alleen mag uitlezen. En als je een eigen Laravel-applicatie hebt, zoals een klantportaal, een WMS of een planningssysteem, dan is integreren met Exact Online, AFAS, Mollie of Sendcloud vanuit diezelfde codebase vaak eenvoudiger dan een extra platform ertussen.

De keerzijde: maatwerk vraagt onderhoud. API's van derden veranderen, tokens verlopen en PHP- en Laravel-versies moeten bijgehouden worden. Reken dat mee in de totale kosten, naast de bouw.