Alles over TritonX
TritonX: Verkooporders ophalen uit TritonX
Lees kassatransacties uit bestanden op een server en stuur ze als verkooporder, met regels, kortingen en klant, naar een ander systeem.
Bijgewerkt op 9 november 2026
Deze flow leest kassatransacties uit bestanden op een server en stuurt ze als verkooporder naar een andere applicatie. Gebruik deze flow als TritonX de transacties als bestand aanlevert.
Zo werkt het
- APIcenter leest de bestanden uit de map bij File location op de FTP- of SFTP-server. Alleen bestanden van het bestandstype dat bij de verbinding staat worden gelezen, en bestanden die al volledig zijn verwerkt worden overgeslagen. Per run leest APIcenter maximaal het aantal bestanden bij Maximum number of pages to retrieve.
- De regels in de bestanden worden gegroepeerd op transactienummer (
transaction_id). Regels zonder transactienummer worden genegeerd. - Elke run verwerkt het aantal transacties dat je instelt bij Amount to process. Een bestand dat nog niet helemaal is verwerkt, gaat bij de volgende run verder.
- Een transactie die APIcenter al eerder heeft verwerkt, wordt overgeslagen. Met Pass through transactions processed before laat je die opnieuw door.
- De velden van de transactie zelf zijn het transactienummer, het bonnummer, de waarde, de datum, de winkel, de kassamedewerker, het unieke id, de formulegroep, het externe id en het bedrijf. De andere velden horen bij de regels.
- De regels staan op volgorde van
mainline. Een regel met een artikel (item_id) en eenmainlinedie deelbaar is door 10000 is een artikelregel. De regels daarna, tot de volgende artikelregel en met dezelfde waarde voorreturn, zijn de kortingen van die artikelregel. - APIcenter telt de kortingen op en trekt ze af van de stuksprijs. Het resultaat staat in
unit_price_with_discounts. Bij een retourregel is het totaal van de kortingen negatief. - Heeft de transactie een extern id (
external_id), dan zoekt APIcenter de klant in TritonX op dat extern id. De klant staat dan bij de transactie, met het standaard factuuradres en het standaard afleveradres. - Wil je verwerkte bestanden verplaatsen? Zet dan Archive processed files aan en vul Archive folder name in.
- Het transactienummer identificeert de transactie in de activiteit van deze flow.
Wat je eerst nodig hebt
- TritonX is gekoppeld, met de gegevens van de FTP- of SFTP-server en het bedrijfs-ID. Zie TritonX koppelen aan APIcenter.
- De map met de transactiebestanden bestaat op de server.
- De andere applicatie van de integratie kan verkooporders ontvangen.
Tips
- Komen er geen orders binnen? Controleer de map bij File location en het bestandstype van de verbinding.
- Zet je Archive processed files aan zonder map bij Archive folder name, dan stopt de flow met een foutmelding.
- Voeg extra velden 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.
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.
Archive folder name
File SettingsDe naam van de map waar verwerkte bestanden naartoe worden verplaatst. Deze instelling werkt alleen als Archive processed files aan staat. Is die aan en is hier niets ingevuld, dan stopt de flow met een foutmelding.
Archive processed files
File SettingsVerplaatst verwerkte bestanden naar een archiefmap op de server, nadat ze volledig zijn verwerkt. Zet dit aan om te voorkomen dat bestanden in de map blijven staan. Vul dan ook Archive folder name in, anders stopt de flow met een foutmelding. Standaard staat deze instelling uit.
File location
File SettingsDe map op de server waar de bestanden worden opgehaald. APIcenter zorgt zelf voor een slash aan het einde van het pad. Vul het pad in zoals het op de FTP- of SFTP-server staat.
Bij Verkooporders ophalen uit TritonX gaat het om transacties. Staat dit uit, dan slaat APIcenter een transactie over waarvan het transactienummer al eerder is verwerkt. Zet je dit aan, dan mag APIcenter zo'n transactie opnieuw doorgeven. De standaardwaarde is uit.
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.
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 Slack webhook
NotificationsVul hier de Slack-webhook van je Slack-werkruimte in om meldingen over mislukte activiteiten ook in Slack te ontvangen. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan stuurt APIcenter geen Slack-melding. 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 behaviourBij Klanten ophalen uit TritonX is dit het maximale aantal klanten per run. Bij Verkooporders ophalen uit TritonX is dit het maximale aantal transacties per run. Een transactie kan uit meerdere regels bestaan. 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 behaviourBij Verkooporders ophalen uit TritonX is dit het maximale aantal bestanden dat APIcenter per run van de server ophaalt, en geen aantal pagina's. Bestanden die al volledig zijn verwerkt, tellen niet mee. 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.