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

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.

De 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.

Zet 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.

Hiermee 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.

Zet 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.

Hiermee bepaal je of een variant zonder categorie de categorie van het hoofdproduct krijgt. Standaard staat deze instelling uit.

Bepaalt 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.

Hiermee 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.

Zet 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.

Vul 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

Notifications

Kies 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

Notifications

Zet 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 behaviour

Dit 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 behaviour

Hier 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.

Dit 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 behaviour

Hier 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 behaviour

Dit 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.

Nog vragen?

Stel je vraag aan de supportassistent in je dashboard of maak een supportticket aan.

Naar support