Alles over Magento 2
Magento 2: Verkooporders ophalen uit Magento 2
Haal bestellingen op uit Magento 2 met klantgegevens, adressen en orderregels en stuur ze door naar je ERP, boekhouding of ander systeem.
Bijgewerkt op 9 november 2026
Deze flow haalt bestellingen op uit Magento 2 en geeft ze als verkooporders door aan een andere applicatie, bijvoorbeeld je ERP of boekhouding. Gebruik deze flow als bestellingen in je webshop moeten worden verwerkt.
Zo werkt het
- APIcenter haalt de bestellingen op die na de datum bij Specify the Date from which you want to retrieve Orders in Magento zijn gewijzigd, de oudste eerst. Elke run verwerkt maximaal het aantal bestellingen dat je instelt bij Amount to process.
- Met Specify what Order statuses the Orders you want to retrieve must have kies je welke orderstatussen APIcenter ophaalt. Standaard is dat In behandeling.
- Met Use first create date sla je bestellingen over die voor een bepaalde datum zijn aangemaakt.
- Is de klant geen gast, dan haalt APIcenter ook de klantgegevens op uit Magento en voegt ze aan de bestelling toe.
- Van de bestelling geeft APIcenter het verzendadres en de verzendmethode apart door. De adresregels staan in aparte velden: adresregel 1, 2 en 3.
- De betaalmethode komt met de titel mee, als Magento die geeft.
- Orderregels die in Magento onder een andere orderregel vallen (parent item), slaat APIcenter over.
- Staat Add additional product details aan, dan haalt APIcenter bij elke orderregel het product op en voegt de productgegevens, een afbeeldingslink en een productlink toe.
- In de activiteit staat de bestelling met het nummer in Magento en de verwijzing (increment ID).
Wat je eerst nodig hebt
- Magento 2 is gekoppeld. Zie Magento 2 koppelen aan APIcenter.
- De andere applicatie van de integratie kan verkooporders ontvangen.
Tips
- Mist een bestelling in het doelsysteem? Controleer de status van de bestelling in Magento en de statussen die je bij Specify what Order statuses the Orders you want to retrieve must have hebt gekozen.
- Wil je alleen bestellingen met een bepaalde betaalstatus? Gebruik dan Use order payment states.
- Gebruik je PostNL in Magento? Kies dan bij Name of the plugin to use when retrieving orders de plugin PostNl. APIcenter haalt dan per bestelling de PostNL-gegevens op, zoals het afhaalpunt, de leverdatum en of het een avondlevering is. Zijn er geen PostNL-gegevens, dan staat er een waarschuwing bij de bestelling.
- Heb je velden nodig die niet standaard worden meegestuurd? Voeg ze toe onder Data mapping. Zie Data mapping.
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.
Zet dit aan om een bestelling die APIcenter al eerder heeft verwerkt opnieuw door te laten als de combinatie van order-, betaal- en fulfilmentstatus nog niet eerder is verwerkt. Staat dit uit, dan slaat APIcenter een bestelling die al is verwerkt altijd over. De statussen komen uit de velden die je in de mapping aan de status koppelt. Standaard staat dit uit.
Kies hiermee de orderstatussen van Magento waarvan APIcenter bestellingen ophaalt. De standaardwaarde is In behandeling. Kies je geen status, dan haalt APIcenter bestellingen met elke status op.
Use order payment states
FiltersKies hiermee welke betaalstatussen APIcenter verwerkt. Bestellingen met een andere betaalstatus slaat APIcenter over en meldt dat in het flowrapport. Het filter werkt op het veld dat je in de mapping aan de betaalstatus koppelt: is dat veld niet gekoppeld, dan wordt het filter overgeslagen. Kies je niets, dan worden alle betaalstatussen verwerkt. Er is geen standaardwaarde.
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 the endpoints of the target application
General flow settingHiermee codeer je de waarden in het adres (de URL) van de doelapplicatie, dus bij flows die gegevens versturen. 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.
Use administration mapping table
General flow settingZet dit aan om de administratie om te zetten met een koppeltabel tussen de twee applicaties. Wat er gebeurt met een waarde die niet in de tabel staat, bepaal je met What to do with a value that cannot be mapped using the mapping table. Standaard staat dit uit.
What to do with a value that cannot be mapped using the mapping table
General flow settingHier kies je wat er gebeurt met een administratie die niet in de koppeltabel staat. Bij Waarde negeren wordt de waarde leeggelaten, bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Standaardwaarde gebruiken wordt de standaardwaarde uit Default administration id gebruikt, als je die hebt ingeschakeld. Deze instelling werkt alleen als Use administration mapping table aanstaat. Standaard is Standaardwaarde gebruiken gekozen.
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.
Name of the plugin to use when retrieving orders
Plugin SettingsKies een plugin die bij het ophalen van orders wordt uitgevoerd. De gegevens van de plugin worden toegevoegd aan de opgehaalde orders. Er is nu één plugin beschikbaar: PostNl. Standaard is geen plugin gekozen.
Add additional product details
Product SettingsAPIcenter haalt bij elke orderregel met een SKU het product op in Magento en voegt de productgegevens toe aan de orderregel, samen met een afbeeldingslink en een productlink. Voor deze links gebruikt APIcenter het adres van je webshop. Dit kost per orderregel een extra aanroep naar Magento. Kan het product niet worden opgehaald, dan blijft de orderregel zonder productgegevens. Standaard staat dit aan.
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.
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.
Offset
Run behaviourDit is het aantal items dat de flow overslaat bij het ophalen. APIcenter werkt de waarde zelf bij na een run: is het aantal opgehaalde items gelijk aan Amount to process, dan wordt de waarde met dat aantal verhoogd, anders wordt hij teruggezet. Wijzig dit alleen als je de flow opnieuw vanaf een bepaald punt wilt laten ophalen. De standaardwaarde is 0.
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.
Specify the Date from which you want to retrieve Orders
Run behaviourIn Magento filtert de flow op de datum waarop een bestelling voor het laatst is gewijzigd (updated_at), niet op de besteldatum. APIcenter haalt bestellingen op die na deze datum zijn gewijzigd. De standaardwaarde is 2025-01-01T00:00:00. Valt een hele batch weg door Use first create date, dan zet APIcenter deze datum zelf door naar de laatste wijzigingsdatum van die batch.
Use first create date
Run behaviourAPIcenter verwerkt alleen bestellingen met een aanmaakdatum (created_at) op of na deze datum. Bestellingen die eerder zijn aangemaakt, slaat APIcenter over. 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.