Koppel leveranciersdata aan Akeneo. Zonder code.
Je leverancier stuurt een spreadsheet. Akeneo wil een productdocument met op elke waarde de juiste familie, het juiste kanaal, de juiste locale en de juiste valuta. SDM Portal is de mappinglaag daartussen: je bouwt die één keer per leverancier, en elk volgend bestand herhaalt dezelfde regels.
Connection
- ProtocolAkeneo REST API, /api/rest/v1
- AuthenticatieOAuth2 password grant: client ID, secret, gebruikersnaam, wachtwoord
- EditiesCommunity Edition 7 en Serenity, gedetecteerd bij de handshake
- StructuurFamilie
- SchrijvenND-JSON PATCH /products, tot 100 per batch
- Delta syncDocumenthash per product
Waar een Akeneo-leveranciersfeed echt vastloopt
Leveranciersbestanden zijn gemaakt voor mensen. Akeneo is gemaakt voor een schema. Het werk zit vooral in de afstand daartussen, en die afstand komt terug bij elk nieuw bestand.
Attributen zitten in families
Een leverancierskolom betekent niets tot je weet bij welke familie die hoort. Kies de familie en de attribuutrail beperkt zich tot de attributen van die familie, in de eigen volgorde van die familie.
Elke waarde heeft een dimensie
Akeneo-waarden dragen een locale en, bij scopable attributen, een kanaal. Een prijs is een collectie met een valuta. Een metrische waarde is een getal plus een eenheid. Zit daar één ding fout, dan wordt de waarde geweigerd.
Opties zijn codes, geen labels
Een selectwaarde moet uitkomen op een bestaande optiecode die past binnen de tekens die Akeneo accepteert. Leveranciersbestanden sturen in plaats daarvan labels als Navy Blue.
Hoe SDM Portal naar Akeneo schrijft
Je tekent de mapping op een canvas. Lastige regels beschrijf je in gewone taal en die worden één keer gecompileerd tot een vaste regel, zodat runs reproduceerbaar blijven. Hieronder staat wat de Akeneo-kant daarvan precies doet.
Mapping per familie
Kies de familie en de attribuutrail beperkt zich daartoe, met behoud van de attribuutvolgorde van die familie. Het identifier-attribuut valt weg en in plaats daarvan komt er een systeemveld esa_sku bij, zodat je SKU mapt als elke andere kolom, precies zoals bij Ergonode.
Locale op de verbinding
De ingeschakelde locales komen uit je eigen instantie. Locale is een eigenschap van de verbinding die je tekent, dus drie omschrijvingskolommen kunnen één attribuut in drie talen vullen. Een localiseerbaar attribuut neemt de locale van de verbinding over; een niet-localiseerbaar attribuut houdt de eerste waarde en geeft een waarschuwing.
Kanaal en valuta per profiel
In de publicatie-instellingen staan het kanaal en de standaardvaluta van het profiel, aangeboden uit je eigen kanalen en beperkt tot de valuta van dat kanaal. Een scopable waarde zonder ingesteld kanaal wordt met een waarschuwing weggelaten. Stel dit in vóór de goedkeuring: een wijziging verandert elke documenthash en dwingt een volledige nieuwe push.
Prijscollecties, multi-valuta
Valuta is ook een eigenschap van een verbinding. Meerdere bronkolommen, bijvoorbeeld price_eur en price_usd, komen samen in één prijscollectie op één attribuut. Verbindingen met een valuta mengen met verbindingen zonder valuta laat de dry-run mislukken in plaats van te gokken.
Metrische attributen
Een metrische waarde wordt geschreven als een getal plus de standaard metrische eenheid van het attribuut. Een attribuut zonder standaardeenheid laat de waarde vallen en meldt dat, in plaats van een getal zonder eenheid te schrijven.
Opties aanmaken met labels
Ontbrekende selectopties worden aangemaakt met labels per locale. Codes moeten passen binnen de tekens die Akeneo toestaat, en een ongeldige code wordt geweigerd met een voorstel voor een geldige code in plaats van stil herschreven, dus de code die je ziet is de code die aankomt.
Nieuwe attributen vanuit de editor
Maak attributen van het type text, textarea, number, date, simple select, multi select, boolean, price collection en metric aan zonder het canvas te verlaten. Elk type heeft een attribuutgroep nodig; metric heeft ook een familie en een standaardeenheid nodig. Het nieuwe attribuut wordt met een read-append PATCH aan de familie van het profiel toegevoegd, zodat er niets anders in die familie wordt aangeraakt.
Reference entities op Serenity
Een reference entity-attribuut gedraagt zich als een select en de collectievariant als een multi select. De optielijst bestaat uit de records van de gekoppelde entiteit, dus je mapt leverancierswaarden rechtstreeks op recordcodes.
Schrijfgedrag dat je kunt controleren
Producten gaan uit als ND-JSON-batches van maximaal 100. Elke regel komt terug als aangemaakt, bijgewerkt of geweigerd, en een weigering wordt per attribuut gemeld. Rate limits worden uit het antwoord gerespecteerd. Elk product draagt een documenthash, dus een nieuwe run van een ongewijzigd bestand schrijft niets. In de modi create en update wordt eerst gecontroleerd wat al bestaat, in blokken van 500 SKU's.
Wat we naar Akeneo kunnen schrijven
Select- en multi select-waarden worden gemapt op optiecodes, en ontbrekende opties kunnen met hun labels worden aangemaakt. Categorieën worden per product als een ontdubbelde set toegekend.
Wat de Akeneo-connector nog niet doet
We vertellen dit liever voordat je je aanmeldt dan dat je het in week twee ontdekt. Elk punt hieronder is een echte grens van de Akeneo-connector vandaag.
Product models en varianten
Variantassen zijn vandaag een Ergonode-functie. Op een Akeneo-profiel zijn de variantmarkers verborgen. Draagt een ouder flow ze nog, dan worden de kinderen als losse producten geschreven en worden de ouders overgeslagen met één samengevatte waarschuwing.
Media, tabellen, identifier
Afbeeldings- en media-attributen, tabelattributen en het identifier-attribuut zijn zichtbaar in de rail maar niet schrijfbaar. Ze blijven leesbaar zodat je de volledige familie ziet.
Reference entity-records
Records van een reference entity worden gelezen als opties, nooit aangemaakt. Hun label is de recordcode, dus de picker toont codes.
Workflowstatus
Akeneo kent geen workflowstatus op producten. Een statusmapping die uit een Ergonode-flow is meegekomen wordt genegeerd met één waarschuwing in plaats van de run te laten mislukken.
Custom fields op opties
Akeneo-opties hebben labels maar geen custom fields, dus de verrijkingsfuncties voor opties blijven verborgen op een Akeneo-profiel.
Attributen verwijderen
Een attribuut dat via de API is aangemaakt kan via de CE 7-API niet meer worden verwijderd. Maak ze dus bewust aan.
Vragen over Akeneo en SDM Portal
Welke Akeneo-versies ondersteunt SDM Portal?
Akeneo Community Edition 7 en Serenity. De editie en de versie worden tijdens de handshake van de connectie gedetecteerd en op de connectieregel getoond, zodat je precies ziet waarmee je verbonden bent.
Hoe authenticeert SDM Portal zich bij Akeneo?
Via een Akeneo API-connectie: client ID, client secret, gebruikersnaam en wachtwoord over de OAuth2 password grant. Het bearer token wordt per connectie gecachet en bij een 401 één keer vernieuwd. Inloggegevens worden versleuteld opgeslagen en gaan nooit mee in een geëxporteerde mapping.
Ondersteunt SDM Portal Akeneo product models en varianten?
Nog niet. Variantassen en bindings zijn vandaag een Ergonode-functie. Op een Akeneo-profiel zijn de variantmarkers verborgen, en een flow die ze nog draagt schrijft de kinderen als losse producten en slaat de ouders over met één waarschuwing.
Hoe gaat het met kanalen, locales en valuta?
Locale is een eigenschap van de mappingverbinding, dus drie omschrijvingskolommen kunnen één attribuut in drie talen vullen. Kanaal en standaardvaluta stel je per profiel in bij de publicatie-instellingen, aangeboden uit je eigen kanalen. Een prijsattribuut kan meerdere valuta tegelijk ontvangen door per verbinding een valuta te zetten.
Kan ik zien wat er gebeurt voordat er iets naar Akeneo wordt geschreven?
Ja. Een dry-run toont het resultaat rij voor rij, met waarschuwingen voor niet-gemapte waarden en weggelaten velden, en schrijft niets. Runs kunnen eerst naar een staging-Akeneo en daarna naar productie, en delta sync betekent dat alleen gewijzigde producten opnieuw worden gepusht.
Werk je met een ander PIM?
De editor, de transformaties en de workflow zijn gedeeld. Alleen het schrijfpad verschilt per PIM, dus elke connector heeft zijn eigen pagina.
Map Akeneo één keer. Daarna draait het vanzelf.
Start een werkruimte, koppel je Akeneo-instantie en map je eerste leveranciersbestand. Veertien dagen gratis, tijdens de proefperiode wordt niets van je kaart afgeschreven.