Alles over Rithum
Rithum: Verkooporders ophalen uit Rithum
Haal bestellingen op uit Rithum als verkooporders en stuur ze door naar een andere applicatie.
Bijgewerkt op 9 november 2026
Deze flow haalt bestellingen op uit Rithum en geeft ze als verkooporders door aan een andere applicatie. Gebruik deze flow als bestellingen in Rithum binnenkomen en een ander systeem ze moet verwerken.
Zo werkt het
- APIcenter haalt de bestellingen in batches op uit Rithum. Elke run verwerkt maximaal het aantal dat je instelt bij Amount to process.
- APIcenter vraagt alleen bestellingen op die in Rithum zijn gewijzigd na de datum in Use last order date. De bestellingen komen oplopend op wijzigingsdatum binnen. Een bestelling die in Rithum wordt aangepast, haalt APIcenter dus opnieuw op. APIcenter geeft hem niet nog een keer door, tenzij de combinatie van statussen is veranderd en de pass-through hieronder aan staat.
- Bij elke bestelling haalt APIcenter in dezelfde aanvraag de orderregels, leveringen (fulfillments), aanpassingen, eigen velden, orderkenmerken, labels, exports en kanaaldocumenten op.
- Met Process orders with states, Use order payment states en Process items with fulfilment state(s) kies je welke bestellingen APIcenter doorgeeft. Kies je niets, dan worden alle waarden verwerkt.
- Een bestelling die APIcenter al heeft doorgegeven, wordt niet opnieuw doorgegeven. Staat Pass through orders based on states aan, dan geeft APIcenter de bestelling opnieuw door als de combinatie van de drie statussen nog niet eerder is verwerkt.
- Probeer je een mislukte bestelling opnieuw met het order-ID, dan haalt APIcenter die ene bestelling op bij Rithum.
Wat de data mapping omvat
Standaard geeft APIcenter onder andere door:
- Het order-ID (ID), het ordernummer (SiteOrderID) en de orderreferentie (SellerOrderID).
- De aanmaakdatum (CreatedDateUtc) en de wijzigingsdatum (UpdatedDateUtc).
- De valuta, het totaalbedrag, de btw en de verzendkosten van de bestelling.
- De orderstatus (CheckoutStatus), de betaalstatus (PaymentStatus) en de verzendstatus (ShippingStatus).
- De betaalmethode en de promotiecode.
- De klant: e-mailadres, gebruikers-ID van de koper, naam, bedrijf, telefoonnummer, factuuradres en verzendadres.
- Per orderregel: SKU, omschrijving, aantal, stuksprijs, btw en verzendkosten.
- De levering: vervoerder, verzendklasse, trackingnummer en distributiecentrum.
Je kunt de mapping aanpassen onder Data mapping. Zie Data mapping.
Wat je eerst nodig hebt
- Rithum is gekoppeld. Zie Rithum koppelen aan APIcenter.
- De andere applicatie van de integratie kan verkooporders ontvangen.
Tips
- Moet je bestellingen verder filteren? Zie Filters.
- Ontbreekt een bestelling in het doelsysteem? Controleer de status van de bestelling in Rithum, de gekozen statussen in deze flow en de datum in Use last order date.
- Krijg je een fout? Zie Rithum: veelvoorkomende fouten.
Je vindt alle instellingen van deze flow hieronder, elk met een eigen uitleg.
Instellingen
De instellingen die je in het dashboard ziet, met wat elke instelling doet.
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.
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.
Dit filter werkt op het veld ShippingStatus van Rithum, de verzendstatus van de bestelling. Alleen bestellingen waarvan dat veld overeenkomt met je keuze worden doorgegeven; de andere slaat APIcenter over en meldt dat in het flowrapport. Kies je niets, dan worden alle waarden verwerkt.
Process orders with states
FiltersDit filter werkt op het veld CheckoutStatus van Rithum, de orderstatus van de bestelling. Alleen bestellingen waarvan dat veld overeenkomt met je keuze worden doorgegeven; de andere slaat APIcenter over en meldt dat in het flowrapport. Het filter werkt alleen als in de mapping een veld is gekoppeld aan de orderstatus (standaard CheckoutStatus). Kies je niets, dan worden alle waarden verwerkt.
Use order payment states
FiltersDit filter werkt op het veld PaymentStatus van Rithum, de betaalstatus van de bestelling. Alleen bestellingen waarvan dat veld overeenkomt met je keuze worden doorgegeven; de andere slaat APIcenter over en meldt dat in het flowrapport. Kies je niets, dan worden alle waarden verwerkt.
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.
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.
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 last order date
Run behaviourBij Rithum vraagt APIcenter bestellingen op die zijn gewijzigd (UpdatedDateUtc) na deze datum, niet op aanmaakdatum. APIcenter geeft een bestelling die al is doorgegeven niet opnieuw door, ook niet als hij daarna in Rithum wordt aangepast. APIcenter werkt de datum zelf bij na elke run. De standaardwaarde is 2025-01-01T00:00:00.000Z: bestellingen die voor die datum zijn gewijzigd, worden niet opgehaald.