Akeneo Magento koppeling

Wat je tussen Akeneo en Magento koppelt

De stroom loopt van Akeneo naar Magento. Akeneo is leidend voor wat een product is: teksten, attributen, varianten, afbeeldingen en categorieën. Magento toont het en verkoopt het. De koppeling leest via de REST API van Akeneo en schrijft via de REST API van Magento 2.

Producten worden aan elkaar gekoppeld op de SKU. In Akeneo is de identifier sinds november 2022 optioneel en is de uuid de sleutel. Een product zonder identifier heeft in Magento geen SKU, dus de koppeling slaat het over en zet het op de controlelijst. Hoe productdata in het algemeen loopt staat op productdata koppelen.

Welk systeem is leidend, per gegeven

Wat Akeneo en Magento anders bewaren

Locale en kanaal tegenover website, store en store view

Akeneo bewaart een waarde per locale, per kanaal of allebei. Magento bewaart een waarde op het standaardniveau en daarnaast per store view, met een vinkje "Use Default Value" voor elke view die erft. De koppeling legt een tabel vast: kanaal ecommerce met nl_NL is store view nl, met de_DE is het store view de.

Magento schrijft per store view met een eigen aanroep: de store code staat in de URL. Een catalogus van 6.000 producten in 3 talen is per volledige ronde dus 6.000 aanroepen op het standaardniveau en 18.000 per store view, 24.000 in totaal. Daarom gaan in een gewone ronde alleen gewijzigde producten mee, en per store view alleen de velden die per taal verschillen. Een veld dat de koppeling per store view schrijft, erft daarna niet meer van het standaardniveau. Een prijs of status die per ongeluk op store-viewniveau wordt gezet, blijft dus hangen als het standaardniveau later verandert.

Optiecodes tegenover optie-ID's

Een keuzeattribuut bevat in Akeneo de code van de optie: blue. Magento slaat een keuze op als een optie-ID van die installatie, zoals 168. Dezelfde optie heeft op een testomgeving een ander ID dan op productie. De koppeling leest bij de start alle opties uit Magento, maakt ontbrekende opties aan met de labels per store view uit Akeneo, en bewaart de tabel van code naar ID per omgeving.

Productmodellen tegenover configurable products

Akeneo bouwt varianten op met een family variant van 1 of 2 niveaus en maximaal 10 assen per niveau. Een as mag in Akeneo een keuzelijst zijn, maar ook een maat met eenheid, een ja/nee-veld, een getal of tekst. Magento heeft één niveau: een configurable product met simple products eronder. Een as moet daar een attribuut zijn met scope Global, van het type Dropdown, Visual Swatch of Text Swatch, met een verplichte waarde.

Daaruit volgen twee regels. Een model met twee niveaus, kleur en dan maat, wordt in Magento één configurable met beide assen. De attributen die in Akeneo op het kleurniveau staan, zoals de afbeeldingen per kleur, zet de koppeling op elke simple van die kleur. En een as die geen keuzelijst is, zoals een lengte van 82 CENTIMETER, wordt in Magento eerst een optie. Zie varianten koppelen.

Familie tegenover attribute set

Een familie in Akeneo bepaalt welke attributen een product heeft en welke verplicht zijn per kanaal. Een attribute set in Magento bepaalt welke attributen op het product staan, ingedeeld in groepen. Het ID van een set, attribute_set_id, verschilt per installatie. De koppeling vergelijkt families en sets voor elke ronde. Een attribuut dat in Akeneo bij de familie hoort en in de set ontbreekt, wordt eerst aan de set toegevoegd of gemeld, en niet stil weggelaten.

De technische werkelijkheid van deze combinatie

De getallen zijn op 3 oktober 2026 nagelezen in de documentatie van Akeneo en Adobe Commerce.

Asynchroon schrijven. Magento heeft bulk-endpoints onder /async/bulk/V1/. Een aanroep met een lijst producten krijgt direct een bulk_uuid terug; de producten worden daarna verwerkt door een consumer via RabbitMQ. Per product is de status op te vragen: 1 is gelukt, 2 is mislukt en mag opnieuw, 3 is mislukt en vraagt eerst een correctie, 4 is nog open en 5 is geweigerd. Ook de bulkroute bevat de store code, dus ook hier telt elke store view apart. De 24.000 schrijfacties uit het voorbeeld zijn in blokken van 100 producten 240 aanroepen. Dat vraagt wel dat de consumers op de server draaien; staan ze uit, dan blijven de berichten in de wachtrij staan zonder foutmelding.

Lezen uit Akeneo. Paginering met een paginanummer stopt na het 10.000ste product. De koppeling gebruikt search_after en een filter op updated en op completeness voor het kanaal, zodat een product van 80% niet in Magento komt.

Afbeeldingen. Een afbeelding gaat naar Magento als base64 in content.base64_encoded_data, met types voor de rol: image, small_image, thumbnail. Akeneo levert een bestandscode, geen publieke URL. De koppeling downloadt het bestand en stuurt het mee. Een product wordt zonder het veld media_gallery_entries bijgewerkt: een lege lijst [] verwijdert volgens Adobe alle afbeeldingen uit alle store views. Meer over grote volumes in grote catalogus inladen.

Wat een standaardkoppeling hier niet doet

Akeneo levert zelf de Akeneo Connector for Adobe Commerce, een module die in Magento draait op cron. Op 3 oktober 2026 stond in de documentatie van Akeneo:

• Eén richting. Van het PIM naar Adobe Commerce, niet terug.
• Verwijderen gaat niet mee. Adobe Commerce blijft leidend voor verwijderen; een product dat uit Akeneo verdwijnt blijft in Magento staan.
• Assen van het type meerkeuze, tekst of getal worden niet ondersteund.
• Bestandsattributen komen alleen als tekstveld mee.
• Versies. De Enterprise-connector vraagt Magento 2.4.4 of hoger en PHP 8.0 of hoger.

Omdat de module op de Magento-server draait, gebruikt hij de cron en de rekenkracht van de webshop. Een gebouwde koppeling draait buiten de webshop, volgt jouw families en assen, en legt vast wat er met een verwijderd product gebeurt.

Als het misgaat

Een product dat blijft falen bewaart de koppeling met de oorspronkelijke inhoud, en na een correctie in Akeneo gaat het opnieuw mee. Voor livegang draait de koppeling als dry run tegen de testomgeving: hij laat per product en per store view zien wat hij in Magento zou aanmaken of wijzigen.

Wij hosten en bewaken de koppeling en passen hem aan als Akeneo of Magento een interface wijzigt, zoals bij een nieuwe Magento-versie. De systeemkant staat op Akeneo koppeling, de platformkant op Magento koppeling, en alle stromen op koppelingen. Verwante combinaties: Akeneo Shopify koppeling en Akeneo WooCommerce koppeling. Vertel hoeveel producten, families en store views je hebt.