Alles over Akeneo
Akeneo: Producten ophalen uit Akeneo
Haal producten en varianten op uit Akeneo, met kenmerken, categorieën, afbeeldingen en bijlagen, en stuur ze door naar een andere applicatie.
Bijgewerkt op 9 november 2026
Deze flow haalt producten op uit Akeneo en stuurt ze naar een andere applicatie, bijvoorbeeld een webshop. Gebruik deze flow als Akeneo het leidende systeem is voor je productinformatie.
Zo werkt het
- APIcenter haalt alleen producten op die in Akeneo zijn gewijzigd na de datum bij From what date do you want to retrieve product information?. APIcenter werkt die datum zelf bij na elke run.
- Per run haalt APIcenter maximaal het aantal producten op dat je instelt bij Amount to process.
- Bij elk product haalt APIcenter ook de attributen, categorieën en afbeeldingen of bestanden op die het product gebruikt.
Producten en varianten
- Een product zonder hoofdproduct gaat door als een product, met de SKU uit Akeneo.
- Een variant is een product met een hoofdproduct (in Akeneo een productmodel). De SKU van het hoofdproduct wordt de SKU van het product. De SKU van de variant wordt de variant-SKU.
- De eigenschappen waarmee de varianten van elkaar verschillen, zoals kleur of maat, komen bij de variant als aparte attributen mee. Ze staan niet ook bij de overige kenmerken. Deze eigenschappen komen uit de familievariant van het hoofdproduct in Akeneo.
- Voor een variant maakt APIcenter ook een alternatieve titel van de eigenschappen en hun waarden, bijvoorbeeld
color: Blue - size: XL.
Waarden van kenmerken
Elke waarde van een product in Akeneo gaat door als kenmerk, met de naam (de code van het attribuut in Akeneo) en de waarde. Voor sommige soorten attributen zet APIcenter de waarde om:
- Keuzelijst met één optie: het label van de optie in de standaardtaal.
- Keuzelijst met meerdere opties: de labels in de standaardtaal, gescheiden door een komma.
- Prijs: het bedrag in de standaardvaluta.
- Afbeelding: APIcenter downloadt de afbeelding uit Akeneo en geeft hem door bij de afbeeldingen van het product, met naam, bestandsnaam, type en een tijdelijke link.
- Bestand: werkt hetzelfde als een afbeelding, maar het bestand gaat door bij de bijlagen van het product.
- Alle andere soorten: de waarde zoals Akeneo die geeft.
Een vertaalbaar attribuut geeft APIcenter door met de waarde in de standaardtaal als hoofdwaarde. De waarden in andere talen gaan mee als vertalingen. De standaardtaal en de standaardvaluta stel je in bij Default language (local) to use en Default currency prices.
Categorieën
APIcenter geeft de categorieën van een product door, met de naam in de standaardtaal en de naam van de bovenliggende categorie. De vertalingen van beide namen gaan mee. Ook de bovenliggende categorieën van de categorieën van het product worden doorgegeven, tot aan de bovenste categorie.
Gegevens die je kunt gebruiken
Naast de kenmerken, afbeeldingen, bijlagen en categorieën geeft de flow deze velden van het product door: de UUID, de SKU, de variant-SKU, het hoofdproduct, de familie, of het product actief is, en de aanmaak- en wijzigingsdatum. Welke velden je naar de andere applicatie stuurt, bepaal je onder Data mapping. Zie Data mapping.
Wat je eerst nodig hebt
- Akeneo is gekoppeld. Zie Akeneo koppelen aan APIcenter.
- De andere applicatie van de integratie kan producten ontvangen.
Tips
- Wil je alleen een deel van de producten doorgeven? Gebruik dan de filteropties van de flow. Zie Filteropties.
- Wil je een eerdere periode opnieuw ophalen? Zet de datum bij From what date do you want to retrieve product information? terug. De flow haalt dan de producten die na die datum zijn gewijzigd opnieuw op.
- Ontbreekt een afbeelding of een bestand in het doelsysteem? Kijk in de activiteit van de flow en controleer in Akeneo of het mediabestand bestaat.
Hieronder vind je alle instellingen van deze flow, elk met een eigen uitleg.
Instellingen
De instellingen die je in het dashboard ziet, met wat elke instelling doet.
Default category name
CategoriesDe naam van de standaardcategorie die APIcenter gebruikt als Enable use of default category aan staat en een product of variant geen categorie heeft (of als je Force use of default category aanzet). De categorie krijgt geen bovenliggende categorie. Standaard is de naam Import API Center.
Enable use of default category
CategoriesZet deze instelling aan om een standaardcategorie te gebruiken voor producten of varianten zonder categorie. De naam van die categorie vul je in bij Default category name. Heeft een product al een categorie, dan blijft die staan, tenzij je Force use of default category aanzet. Standaard staat deze instelling uit.
Force category on variant as parent
CategoriesHiermee bepaal je of de categorie van het hoofdproduct ook wordt gezet op een variant zonder categorie. Standaard staat deze instelling uit. Dit werkt alleen als Set category on variant as parent aan staat.
Force use of default category
CategoriesZet deze instelling aan om de standaardcategorie altijd te gebruiken, ook als het product al een categorie heeft. De categorie van het product wordt dan vervangen door de standaardcategorie. Dit werkt alleen als Enable use of default category aan staat. Standaard staat deze instelling uit.
Set category on variant as parent
CategoriesHiermee bepaal je of een variant zonder categorie de categorie van het hoofdproduct krijgt. Standaard staat deze instelling uit.
Stop flow when mapping of fields fails
Datamapper SettingsBepaalt wat er gebeurt als een veld bij het mappen van de gegevens niet kan worden omgezet. Staat de instelling aan, dan stopt de flow met een foutmelding. Staat de instelling uit, dan gaat de flow verder en wordt dat veld overgeslagen. Standaard staat deze instelling aan.
Enable URL Encoding of data in the endpoints of the source application
General flow settingHiermee codeer je de waarden in het adres (de URL) van de bronapplicatie, dus bij flows die gegevens ophalen. Dit werkt alleen als Enable URL encoding of data in endpoints aanstaat. Standaard staat dit uit.
Enable URL encoding of data in endpoints
General flow settingZet dit aan als er speciale tekens in de data staan die in het adres (de URL) van een verzoek terechtkomen, zoals in een SKU of categorienaam. De waarden worden dan URL-gecodeerd, zodat het verzoek niet misgaat. Met Enable URL Encoding of data in the endpoints of the source application en Enable URL Encoding of data in the endpoints of the target application bepaal je voor welke kant dit geldt. Standaard staat dit uit.
Notifications Email address
NotificationsVul hier het e-mailadres in waarnaar APIcenter meldingen stuurt over mislukte activiteiten van deze flow. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan gebruikt APIcenter bij Direct het e-mailadres van je account. Er is geen standaardwaarde.
Notifications frequency
NotificationsKies hoe vaak APIcenter meldt dat activiteiten van deze flow zijn mislukt. Bij Direct volgt de melding zodra een activiteit mislukt. Bij Elke 30 minuten, Elk uur, Dagelijks en Wekelijks stuurt APIcenter een overzicht van de mislukte activiteiten die nog niet gemeld zijn. Dit werkt alleen als Receive Notifications aan staat. Standaard is dit Direct.
Receive Notifications
NotificationsZet dit aan om een melding te krijgen als een activiteit van deze flow mislukt. Met Notifications frequency bepaal je hoe vaak je de melding krijgt, en met Notifications Email address en Notifications Slack webhook waar die naartoe gaat. Standaard staat dit uit.
Amount to process
Run behaviourDit is het maximale aantal items dat de flow in één run ophaalt en verwerkt. Verhoog het aantal als er veel gegevens zijn, verlaag het als een run te lang duurt. De standaardwaarde is 10.
Dit is de datum vanaf wanneer de flow producten uit Akeneo ophaalt. APIcenter vraagt Akeneo om de producten die na deze datum zijn gewijzigd (het veld voor de wijzigingsdatum van het product in Akeneo). Na elke run werkt APIcenter de datum zelf bij. Zet je de datum terug, dan haalt de flow producten opnieuw op. De standaardwaarde is 2026-01-01T00:00:00: producten die voor die datum zijn gewijzigd, worden dan niet opgehaald. Kies bij de eerste keer een datum van voor je oudste product dat je wilt ophalen.
Last execution time
Run behaviourHier staat het moment waarop de flow voor het laatst is gestart. APIcenter vult dit zelf in na elke run en gebruikt het om te bepalen wanneer de flow weer mag draaien. Je hoeft dit normaal niet te wijzigen. De standaardwaarde is 1980-01-01T00:00:01: de flow heeft dan nog niet gedraaid.
Maximum number of pages to retrieve
Run behaviourDit is het maximale aantal pagina's dat de flow in één run ophaalt. Het aantal items per pagina stel je in bij Use page size. De standaardwaarde is 20.
Run at specific times
Run behaviourHier kies je vaste tijden van de dag waarop de flow ook moet starten. Je kunt meerdere tijden kiezen, in stappen van 15 minuten. Er is geen standaardwaarde.
Use page size
Run behaviourDit is het aantal items dat de flow per API-verzoek ophaalt. Samen met Maximum number of pages to retrieve bepaalt dit hoeveel items één run kan ophalen. De standaardwaarde is 50.