Voordat je begint: je hebt beheerderstoegang tot je PIM nodig om een koppeling te maken - voor Akeneo is dat een connection onder System > Connections met lees- en bewerkrechten op producten, en een WISEPIM-project dat je met een kopie van de catalogus mag vullen.
Spreek af wie welk veld bezit
Doe dit voordat je iets koppelt. Elk pijnlijk moment in een opstelling met twee systemen komt uit dezelfde bron: beide systemen denken dat ze hetzelfde veld bezitten, en wie het laatst schreef wint. Leg de verdeling eerst op papier vast, dan is de rest van deze gids alleen nog configuratie.
1
Schrijf de verdeling op, veld voor veld
Een gedeeld document met twee kolommen is genoeg. De rijen die het meeste denkwerk vragen, zijn de velden die je PIM technisch wel heeft maar die niemand bijhoudt - een lege
meta_description in Akeneo is een veld dat WISEPIM hoort te bezitten, niet een veld dat je leeg blijft synchroniseren.2
Koppel je PIM
Volg de installatie voor Akeneo, of zoek de jouwe op de pagina ondersteunde platformen. Koppel hem vóór al het andere: alleen gekoppelde integraties verschijnen in de import- en exportmodals.
3
Draai de verbindingstest voordat je erop vertrouwt
Klik op Verbinding testen bij de integratie en repareer je referenties nu meteen. Een koppeling die wel authenticeert maar geen bewerkrechten op producten heeft, importeert vrolijk en faalt pas op de terugweg - precies de dure plek om daarachter te komen.
4
Heb je een maatwerk-PIM, kijk dan naar de API-route
Geen integratietegel voor jouw systeem? De WISEPIM REST API leest en schrijft producten programmatisch, en dat is de route voor een zelfgebouwde PIM. De rest van deze gids geldt onverkort - alleen het transport verandert.
Importeer zo dat de PIM je content nooit kan overschrijven
De eerste import is makkelijk. Bij de tweede raken catalogi beschadigd: je PIM exporteert een product met een leeg beschrijvingsveld, WISEPIM heeft er al een goede beschrijving in staan, en de verkeerde instelling maakt van je verrijking een lege regel. Zet de standaarden één keer goed in de Importinstellingen, dan gedraagt elke terugkerende run zich hetzelfde.
1
Kies hoe duplicaten worden opgelost
Conflictoplossing bepaalt wat er gebeurt als een binnenkomend product al in WISEPIM bestaat. Deze projectbrede instelling geldt voor platform- en integratie-imports, dus dit is degene die op elke pull uit je PIM van toepassing is. Overschrijven vervangt elk veld van het gematchte product - in een opstelling met een slimme laag is dat de optie die je AI-content wist. Lees de drie opties in de Importinstellingen en kies bewust.
2
Zet de omgang met lege velden op overslaan
Lege velden overslaan houdt de bestaande waarde in WISEPIM ongewijzigd wanneer het binnenkomende veld leeg is. Precies die ene instelling zorgt dat een magere PIM-export elke nacht kan binnenstromen zonder de velden te wissen die WISEPIM bezit.
3
Importeer eerst een klein deel
Voeg een importfilter toe zodat de eerste run een paar honderd producten binnenhaalt in plaats van de hele catalogus, en controleer die daarna. Een verrassing in de mapping ontdek je liever op een steekproef dan op 40.000 records.
4
Controleer de structuur, niet alleen het aantal producten
Bij een eerste platformimport haalt WISEPIM je categorieën en attributen mee naast de producten, dus open de categorieboom en de attribuutlijst en leg ze naast je PIM. Een aantal producten dat klopt, kan nog steeds een ingeklapte tak verbergen. Zie producten importeren.
5
Laat sjabloonstandaarden de rest invullen
Velden die je PIM niet meestuurt, vallen terug op de standaarden uit je Productsjabloon. Die standaarden gelden alleen wanneer een product wordt aangemaakt en nooit wanneer het wordt bijgewerkt, dus een nachtelijke her-import kan een echte waarde niet stilletjes door een standaard vervangen.
De verkeerde winkel geïmporteerd, of de verkeerde scope? Open de importtaak in de Process Tracker en kies Terugdraaien, voordat je er verrijking bovenop zet.
Verrijken, poort ervoor, en dan terugsturen
Nu verdient de laag zichzelf terug. Er zijn twee verrijkingstools, en de keuze ertussen is exact weer de eigendomsvraag: vul je gaten die je PIM heeft laten liggen, of vervang je content die je PIM bezit?
1
Vul gaten met Automatisch invullen
Automatisch invullen schrijft alleen de velden die leeg zijn en laat bestaande content met rust, wat het de veilige standaard maakt als de content van je PIM het waard is om te houden. Het draait op de standaardprompts van je project, dus stel die eerst in bij Enrich-prompts.
2
Gebruik Bulk verrijken alleen waar je hebt afgesproken te overschrijven
Bulk verrijken overschrijft altijd de velden die je kiest. Dat is juist voor een reeks waarvan niemand de teksten verdedigt, en verkeerd voor alles waarvan je PIM nog de auteur is - draai het dus op een gefilterde selectie, nooit uit gewoonte op “alle producten”.
3
Zet Quality Guard vóór de terugweg
Quality Guard draait automatisch bij elke export, sync of publicatie, dus de regels die je activeert worden de poort waarachter je PIM zit. Regels met de ernst Blokkeren houden falende producten vast in quarantaine in plaats van ze te versturen, en dat is precies het gedrag dat je wilt wanneer de bestemming je bronsysteem is.
4
Push er een handvol terug en open ze in de PIM
Filter op een paar representatieve producten, exporteer ze naar je PIM en lees het resultaat in de PIM zelf. Bevestig op die steekproef dat de velden die je verwachtte te zien veranderen ook echt veranderden, en dat de velden die je PIM bezit dat niet deden.
5
Laat Onveranderde overslaan daarna de routine dragen
Onveranderde overslaan staat standaard aan voor platform-exports, dus na de eerste volledige push stuurt elke sync alleen de producten die daadwerkelijk zijn gewijzigd. Sla de opzet op als exportsjabloon, dan is de terugkerende taak één klik.
Bedien de kanalen waar je PIM toch nooit aan toekwam
De rondgang is maar de helft van het argument voor een slimme laag. De andere helft is alles wat je vanuit WISEPIM kunt publiceren zonder je PIM er ook maar bij te betrekken - en meestal is dit waar de opzet zich het eerst terugbetaalt, want hiervoor is geen rondgang nodig om veilig te zijn.
1
Publiceer een gehoste feed voor een kanaal dat je PIM niet bereikt
Maak in Feed Hub een feed op basis van een kanaalpreset - Google Shopping, Meta, prijsvergelijkers, affiliate-netwerken, BMEcat voor groothandels en meer. Elke feed krijgt een URL die het kanaal op zijn eigen schema ophaalt, dus er hoeft niets via je PIM terug te reizen om live te gaan.
2
Sluit uit wat nog niet klaar is, bij de feed
De filterregels van Feed Hub laten producten vallen die onder een kwaliteitsdrempel zitten, geen prijs hebben of geen afbeelding, nog voordat ze het kanaal bereiken. Dat is een tweede poort, los van die voor je PIM.
3
Plan de lus in plaats van eraan te denken
Bouw een automatisering met de trigger Na Import, zodat een verse pull uit je PIM wordt verrijkt op het moment dat hij landt, en sluit af met een notificatie. De volledige bouw staat in Bouw een pipeline die zichzelf draait.
4
Bewaak beide richtingen vanaf één bord
Integratiegezondheid toont de laatste sync, het foutpercentage en de laatste fout per kanaal over een voortschrijdende periode van 30 dagen. In een opstelling met twee systemen is dit de pagina die je vertelt dat de lus is gebroken, meestal voordat iemand verouderde content opmerkt.
Hoe weet je of het werkte
Een gezonde slimme laag is stil: imports die alleen masterdata wijzigen, exports die de meeste producten overslaan omdat er niets veranderde, en feeds waar je PIM-team nooit over heeft hoeven nadenken.
Wanneer het niet werkt
De nachtelijke import wiste de beschrijvingen die de AI had geschreven
De nachtelijke import wiste de beschrijvingen die de AI had geschreven
Twee instellingen bepalen dit, allebei in de Importinstellingen: conflictoplossing, waar Overschrijven elk veld van een gematcht product vervangt, en de omgang met lege velden, waar Lege velden overslaan een bestaande waarde beschermt tegen een lege binnenkomende waarde. Repareer eerst de instellingen en herstel de content daarna met een verrijkingsronde in plaats van met de hand.
De helft van de producten uit mijn PIM is nooit aangekomen
De helft van de producten uit mijn PIM is nooit aangekomen
Controleer de validatiemodus. Strikt wijst elke rij af met ontbrekende verplichte velden of ongeldige formaten, en daar struikelt een echte PIM-export regelmatig over; Standaard importeert de geldige rijen en rapporteert wat is overgeslagen. Kijk ook of een importfilter de pull versmalt. Beide staan in de Importinstellingen.
De import werkt, maar terugsturen wordt geweigerd
De import werkt, maar terugsturen wordt geweigerd
Dat patroon komt vrijwel altijd door rechten en niet door referenties: de koppeling mag lezen maar niet schrijven. Bevestig voor Akeneo dat de gebruikersgroep van de connection producten en productattributen mag lezen én bewerken, en klik daarna opnieuw op Verbinding testen.
De export draaide en meldde dat er niets is verstuurd
De export draaide en meldde dat er niets is verstuurd
Met Onveranderde overslaan aan worden producten die sinds de laatste export naar die bestemming niet zijn gewijzigd, expres overgeslagen. Zet het uit om een volledige her-push te forceren, wat je wilt na het wijzigen van de instellingen van de bestemming. Zie producten exporteren.
Verrijkte producten blijven hangen en bereiken de PIM nooit
Verrijkte producten blijven hangen en bereiken de PIM nooit
Een Quality Guard-regel met de ernst Blokkeren plaatst een product in quarantaine in plaats van het te exporteren. Open de quarantaine, lees de reden van de fout, herstel het onderliggende veld in bulk en geef de batch vrij. Op een grote catalogus kan één blokkeerregel de hele terugweg ophouden, dus beoordeel de impact voordat je er een activeert.
Gerelateerd
Akeneo-integratie
Maak de koppeling, voeg de referenties toe en synchroniseer je catalogus beide kanten op.
Producten exporteren
Elke bestemming, elk sjabloon en de optie Onveranderde overslaan in detail.
Van platform wisselen zonder dataverlies
De andere route: het oude systeem verlaten in plaats van er een laag bovenop te zetten.
Bouw een pipeline die zichzelf draait
Maak van de lus importeren-verrijken-exporteren een automatisering die je nooit met de hand start.