Integratieframework
Koppel Transportial aan elk extern systeem — ERP's, telematica, orderplatformen en meer — met een volledige REST API en App Store.
![Veldmappingtabel met inkomende veldnamen zoals firma, kontaktperson, email en telefon links, een type per veld, uitgaande paden zoals customer.name en customer.contactDetails[0].value rechts, een regex-kolom en knoppen Veld toevoegen](/assets/screens/integration-data-mapping.webp)
- Inkomend veld uit het partnerbestand of de API
- Type en transformatie per veld
- Uitgaand pad naar de order, klant of zending
- Velden toevoegen, of de mapping genereren met AI
Moderne logistieke operaties draaien op meerdere systemen. Transportial is ontworpen om verbonden te zijn. Een volledige REST API met OpenAPI-documentatie, een ingebedde FTP-server voor legacy-integraties, EDI-bestandsparsing en een App Store voor UI-uitbreidingen — elk integratiescenario is gedekt.
Wat het doet
Een inventaris op codeniveau van wat Integratieframework omvat, in de termen die u in het product terugvindt.
Vier manieren om te koppelen
- Preset-connectors
Ingebouwde handlers voor telematica, OEM rFMS, terminals, ferry's, vrachtbeurzen, boekhouding, CRM, betalingen, e-mail, messaging, agenda's en meer, opgenomen in de integratiecatalogus.
- Zelf configureerbaar
Elke API, webhook, FTP, SFTP, SQL-verbinding, e-mailontvanger of de virtuele FTP-server die Transportial voor u host; JSON, XML of CSV; inkomend en uitgaand.
- API-toegang
REST API onder /api met routes gegenereerd vanuit het model, OpenAPI-documentatie weergegeven met ReDoc, API-sleutels en app-tokens, en een limiet van 500 verzoeken per minuut.
- Bestandssjablonen
Parseer en produceer bestanden met selectors: matrix (posities in een werkblad), HTML, tekstvariabelepositie en constanten, voor partners die alleen met bestanden werken.
Mappen zonder code
- Veldmappings
Inkomend veld naar uitgaand pad met type, regex, en opties zoals trimmen, hoofdletter, hoofd- of kleine letters, spaties verwijderen en identificatievelden.
- Waardemappings
Vertaal partnercodes naar platformwaarden, inclusief leveranciersspecifieke doelen voor Transics, Webfleet, Mapon, Squarell, telemetrieslots en voertuigknoppen.
- Filters en triggers
Vergelijkingsfilters (==, !=, >, <, in, not in) met AND/OR; uitgaande triggers op elk trigger-event van het platform met een conditie.
- Genereren met AI
Plak een voorbeeldbestand of een API-antwoord en de veldmappings worden opgesteld; of genereer de hele integratie vanuit een beschrijving.
Beheer het als software
- Traceweergave
Tabbladen voor logs, taken, objecten, verzoeken, tests, matrix en HTML, en een trace die object → taak → log → verzoek koppelt.
- Integratietests
Invoer en verwachte JSON, asserties op fout- of waarschuwingsniveau, exacte match, alleen asserties of beide, alles uitvoeren, met notificaties bij falen.
- Betrouwbaarheid
Een health-watchdog die alerts geeft bij vastlopen en stilte, notificaties per e-mail bij falen en stilstand, syncvensters die de slice begrenzen maar nooit het bereik, load-balanced dispatch over Kafka-workers, echo-onderdrukking zodat een integratie nooit zijn eigen wijziging ontvangt, logmodi alles, fouten of uit, en het maskeren van geheimen.
- Authenticatie
API-sleutel, toegangssleutels, basic, OAuth, bearer, OpenID, clientsleutels en eigen headers.
Breid het platform uit
- App Store
Blader, installeer en configureer apps met permissies, versiegeschiedenis en hooks: webhook-endpoints of UI-hooks die een dashboardtabblad of menutabblad toevoegen.
- Developerportaal
Apps, uitgevers, API-sleutels, analytics, beoordelingen en prijsmodellen (gratis, freemium, eenmalig, abonnement, gebruiksgebaseerd per aanroep, rit, zending of voertuig), met zelfregistratie voor leveranciers en ontwikkelaars.
- Webhooks
Uitgaande webhooks op trigger-events; inkomende webhooks voor Stripe, Mollie, Adyen, Burger Ferry en Salesforce.
- Actieknoppen
Door de tenant gedefinieerde knoppen op assets die een integratie aanroepen, bijvoorbeeld om een bericht naar een boordcomputer te sturen.
Zo werkt het
Kies het type
Preset voor een bekende partner; zelf configureerbaar voor een eigen API of bestandsuitwisseling; API-toegang voor de eigen client van de partner; bestandssjabloon voor spreadsheets en bestanden met vaste posities.
Koppel
Endpoint, schema, authenticatie en headers, of laat Transportial een virtuele FTP-map voor u hosten.
Map
Koppel velden aan het OTM5-model, voeg waardemappings en filters toe, of genereer de mapping met AI vanuit een voorbeeld.
Test
Maak testcases met verwachte uitvoer en asserties; voer ze bij elke wijziging uit.
Draai en bewaak
Traceer elk object door taken, logs en verzoeken; de watchdog geeft een alert wanneer de integratie stilvalt.
Het framework verslaat eenmalige connectors
Elke vervoerder krijgt uiteindelijk de vraag om "de XML die het ERP van de klant verstuurt". Een eenmalig script handelt het af totdat het formaat verandert. Transportial behandelt elke koppeling als configuratie op hetzelfde framework: verbinding, formaat, mapping, filters, triggers, tests en logs. Preset-connectors zijn simpelweg mappings die het team levert en onderhoudt; de eigen integratie van een tenant krijgt dezelfde tracing en gezondheidsbewaking.
Het framework draagt ook de operationele veiligheid: echo-onderdrukking stopt lussen tussen twee systemen, syncvensters houden het pollen eerlijk onder belasting, en dezelfde trigger-events die automatiseringen aansturen, sturen ook uitgaande gegevens aan.
Virtuele FTP en bestandssjablonen voor de lange staart
Niet elke partner heeft een API. Transportial host een FTP-server zodat een partner bestanden kan afleveren in een map die bij uw platform hoort, en bestandssjablonen parseren tekst met vaste posities, spreadsheets per cel en HTML. Dezelfde mappingengine zet de gegevens vervolgens in orders, zendingen en bedrijven.
Begrippen & terminologie
De woorden die deze module gebruikt, met links naar de volledige woordenlijst waar een begrip een eigen pagina heeft.
- Preset-integratie
- Een ingebouwde connector voor een benoemd partnersysteem, geconfigureerd met inloggegevens en opties.
- Zelf configureerbare integratie
- Een door de tenant gedefinieerde verbinding met elke API, bestandsserver, database of mailbox met een eigen mapping.
- Veldmapping
- De regel die een inkomend veld kopieert naar een pad in het platformmodel, met type, regex en opties.
- Waardemapping
- Een vertaaltabel van partnercodes naar platformwaarden.
- Virtuele FTP
- Een FTP-server die Transportial voor uw platform host, zodat partners bestanden kunnen uitwisselen zonder eigen server.
- Echo-onderdrukking
- Een wijziging niet terugsturen naar de integratie die hem veroorzaakte.
- EDIWoordenlijst
- Electronic data interchange; Transportial wisselt JSON, XML en CSV uit op het framework en spreekt EDIFACT met ferry- en terminalpartners.
- OTM5Woordenlijst
- Het open model waar elke mapping op gericht is.
Een kijkje in het product
Werkt met
Koppelingen die deze module standaard voeden of gebruiken.
Transics / ZF
Exact Online
SalesforceGebouwd voor
Waar deze module het meeste gewicht in de schaal legt, plus de gratis tools over hetzelfde onderwerp.
Integratietaken worden verdeeld over Kafka-workers met load balancing, echo-onderdrukking en een health watchdog die vastgelopen en stille integraties meldt. API-verzoeken zijn begrensd op 500 per minuut. App Store-apps breiden het platform uit via webhook- en UI-hooks.
Veelgestelde vragen
Is er een openbare API?
Ja. Een REST API met OpenAPI-documentatie, API-sleutels en app-tokens, en een limiet van 500 verzoeken per minuut. Een OTM5-convertertool helpt met het model.
Kunnen we een systeem zonder API koppelen?
Ja. Gebruik FTP of SFTP, de virtuele FTP die Transportial host, een e-mailontvanger, een SQL-verbinding of bestandssjablonen voor spreadsheets en bestanden met vaste posities.
Ondersteunen jullie EDI?
Het framework wisselt JSON, XML en CSV uit met elke partner, en EDIFACT-berichten worden gebruikt met ferry- en terminalpartners zoals P&O Ferries en DP World. Generieke EDIFACT- of X12-orderberichten worden per partner gemapt.
Hoe weten we of een integratie gezond is?
Een watchdog geeft alerts bij vastlopen en stilte, fouten en stilstand worden per e-mail gemeld, en de traceweergave koppelt elk object aan zijn taken, logs en verzoeken.
Kunnen integraties vóór livegang getest worden?
Ja. Testcases met invoer, verwachte uitvoer en asserties draaien afzonderlijk of allemaal tegelijk, en een falende test kan een notificatie geven.
Kunnen derden op het platform bouwen?
Ja. Met de App Store en het developerportaal kunnen uitgevers apps leveren met webhook- en UI-hooks en ze gratis, freemium, eenmalig, per abonnement of gebruiksgebaseerd prijzen.
Alle functies bekijken
Klaar om dit in te zetten?
Gratis starten met volledige platformtoegang, of praat met ons team over uw specifieke operatie.