[Home](/en-us)›[Product](/en-us/product)›Integration Framework Extend & govern # Integration Framework Connect Transportial to any external system (ERPs, telematics, ordering platforms, and more) with a full REST API and App Store. [Start Free](https://portal.otms.transportial.com/auth/register)[Request a Demo](/en-us/contact) REST APIOpenAPIFTPEDIApp StoreSDKKafka REST Full OpenAPI spec FTP Embedded server EDI EDIFACT & file templates App Store UI extensions Integration · Data mapping ![Field mapping table with incoming field names such as firma, kontaktperson, email and telefon on the left, a type per field, outgoing paths such as customer.name and customer.contactDetails[0].value on the right, a regex column and Add field buttons](/assets/screens/integration-data-mapping.webp) Map any incoming field to a path in the OTM5 model, with types, regex and per-field options. 1. Incoming field from the partner file or API 2. Type and transformation per field 3. Outgoing path into the order, customer or shipment 4. Add fields, or generate the mapping with AI Modern logistics operations run on multiple systems. Transportial is designed to be connected. A full REST API with OpenAPI documentation, an embedded FTP server for legacy integrations, EDI file parsing, and an App Store for extending the UI. Every integration scenario is covered. ## What it does A code-level inventory of what Integration Framework covers, in the terms you will find inside the product. ### Four ways to connect * Preset connectors Built-in handlers for telematics, OEM rFMS, terminals, ferries, freight exchanges, accounting, CRM, payments, e-mail, messaging, calendars and more, listed in the [integrations catalog](/en-us/integrations). * Self-configurable Any API, webhook, FTP, SFTP, SQL connection, e-mail receiver or the virtual FTP server that Transportial hosts for you; JSON, XML or CSV; inbound and outbound. * API access REST API under /api with routes generated from the model, OpenAPI documentation rendered with ReDoc, API keys and app tokens, and a rate limit of 500 requests per minute. * File templates Parse and produce files with selectors: matrix (positions in a sheet), HTML, text-variable position and constants, for partners that only do files. ### Mapping without code * Field mappings Incoming field to outgoing path with type, regex, and options such as trim, capitalize, upper or lower case, remove spaces and identification fields. * Value mappings Translate partner codes to platform values, including provider-specific targets for Transics, Webfleet, Mapon, Squarell, telemetry slots and vehicle buttons. * Filters and triggers Comparison filters (==, !=, >, <, in, not in) with AND/OR; outbound triggers on any of the platform's trigger events with a condition. * Generate with AI Paste a sample file or an API response and the field mappings are drafted; or generate the whole integration from a description. ### Operate it like software * Trace view Logs, tasks, objects, requests, tests, matrix and HTML tabs, and a trace that links object → task → log → request. * Integration tests Input and expected JSON, assertions at error or warning level, exact-match, assertions-only or both, run all, with failure notifications. * Reliability Health watchdog raising stuck and silent alerts, failure and stall notifications by e-mail, sync windows that cap the slice but never the reach, load-balanced dispatch across Kafka workers, echo suppression so an integration never receives its own change, request logging modes all, errors or off, and secret redaction. * Authentication API key, access keys, basic, OAuth, bearer, OpenID, client keys and custom headers. ### Extend the platform * App Store Browse, install and configure apps with permissions, version history and hooks: webhook endpoints or UI hooks that add a dashboard tab or a menu tab. * Developer portal Apps, publishers, API keys, analytics, reviews and pricing models (free, freemium, one-time, subscription, usage-based per call, trip, shipment or vehicle), with supplier and developer self-registration. * Webhooks Outbound webhooks on trigger events; inbound webhooks for Stripe, Mollie, Adyen, Burger Ferry and Salesforce. * Action buttons Tenant-defined buttons on assets that call an integration, for instance to send a message to a board computer. ## How it works 1. ### Pick the type Preset for a known partner; self-configurable for a custom API or file exchange; API access for the partner's own client; file template for spreadsheets and fixed-position files. 2. ### Connect Endpoint, schedule, authentication and headers, or let Transportial host a virtual FTP folder for you. 3. ### Map Map fields to the OTM5 model, add value mappings and filters, or generate the mapping with AI from a sample. 4. ### Test Create test cases with expected output and assertions; run them on every change. 5. ### Run and watch Trace every object through tasks, logs and requests; the watchdog alerts when the integration stalls. Integrations · New integration ![New integration form with name, description and a type dropdown offering preset, self-configurable, API access and file template integration, plus a Generate with AI button](/assets/screens/integration-types.webp) Four integration types: preset connector, self-configurable, API access and file template. ## The framework beats one-off connectors Every carrier eventually gets asked for "the XML the customer's ERP sends". A one-off script handles it until the format changes. Transportial treats every connection as configuration on the same framework: connection, format, mapping, filters, triggers, tests and logs. Preset connectors are simply mappings the team ships and maintains; a tenant's own integration gets the same tracing and health monitoring. The framework also carries the operational safety: echo suppression stops loops between two systems, sync windows keep polling honest under load, and the same trigger events that drive automations drive outbound data. Integrations · Preset ![Preset integration selector listing transics, web_fleet, squarell, evogps, trimble, mapon, portbase, psa and dpworld](/assets/screens/integration-presets.webp) Presets: pick the connector, add credentials, done. ## Virtual FTP and file templates for the long tail Not every partner has an API. Transportial hosts an FTP server so a partner can drop files into a folder that belongs to your platform, and file templates parse fixed-position text, spreadsheets by cell and HTML. The same mapping engine then puts the data into orders, shipments and businesses. Integration · Configuration ![Preset integration configuration with schedule value and unit, URL and port, authentication type basic with username and password, add attribute and add header buttons and an on/off toggle](/assets/screens/integration-preset-config.webp) Schedule, endpoint, authentication and headers per connection. ## Concepts & terminology The words this module uses, with links to the full glossary where a term has its own page. [Open the glossary](/en-us/glossary) Preset integration A built-in connector for a named partner system, configured with credentials and options. Self-configurable integration A tenant-defined connection to any API, file server, database or mailbox with its own mapping. Field mapping The rule that copies an incoming field to a path in the platform model, with type, regex and options. Value mapping A translation table from partner codes to platform values. Virtual FTP An FTP server hosted by Transportial for your platform so partners can exchange files without their own server. Echo suppression Not sending a change back to the integration that caused it. EDI[Glossary](/en-us/glossary/edi) Electronic data interchange; Transportial exchanges JSON, XML and CSV on the framework and speaks EDIFACT to ferry and terminal partners. OTM5 The open model every mapping targets. ## Inside the product Integration · Trigger ![Self-configurable integration trigger with an interval, the trigger event after updating trip and a selector where status equals confirmed](/assets/screens/integration-trigger.webp) Outbound triggers: an event plus a condition decides when data is sent. ## Works with Connectors that feed or consume this module out of the box. [![](/assets/salesforce-logo.svg)Salesforce](/en-us/integration/salesforce)[DP World](/en-us/integration/dp-world)[PTV xRoute/xTour](/en-us/integration/ptv)[All integrations →](/en-us/integration) ## Built for Where this module carries the most weight, plus the free tools on the same topic. [logistics-service-providers](/en-us/solutions/logistics-service-providers)[freight-forwarders](/en-us/solutions/freight-forwarders)[shippers](/en-us/solutions/shippers) Technical details Integration tasks are dispatched across Kafka workers with load balancing, echo suppression and a health watchdog that raises stuck and silent alerts. API requests are rate-limited at 500 per minute. App Store apps extend the platform through webhook and UI hooks. ## Frequently asked questions ### Is there a public API? Yes. A REST API with OpenAPI documentation, API keys and app tokens, and a 500-requests-per-minute rate limit. An OTM5 converter tool helps with the model. ### Can we connect a system without an API? Yes. Use FTP or SFTP, the virtual FTP that Transportial hosts, an e-mail receiver, an SQL connection or file templates for spreadsheets and fixed-position files. ### Do you support EDI? The framework exchanges JSON, XML and CSV with any partner, and EDIFACT messages are used with ferry and terminal partners such as P&O Ferries and DP World. Generic EDIFACT or X12 order messages are mapped per partner. ### How do we know an integration is healthy? A watchdog raises stuck and silent alerts, failures and stalls notify by e-mail, and the trace view links every object to its tasks, logs and requests. ### Can integrations be tested before go-live? Yes. Test cases with input, expected output and assertions run individually or all at once, and a failing test can notify. ### Can third parties build on the platform? Yes. The App Store and developer portal let publishers ship apps with webhook and UI hooks and price them free, freemium, one-time, subscription or usage-based. ## Related features [View all features](/en-us/product) [Multi-Tenancy & White-LabelRun your own branded logistics platform, fully isolated, fully customizable, on your own domain.](/en-us/product/white-label)[Reporting & InsightsTurn operational data into decisions with configurable dashboards, TQL-powered queries, and a complete audit trail.](/en-us/product/reporting)[Message AutomationsSend the right message to the right person at exactly the right moment, triggered automatically by 75+ operational events.](/en-us/product/message-automations) View all features [Transport Order Management](/en-us/product/transport-orders)[Interactive Plan Board](/en-us/product/plan-board)[AI-Powered Trip Optimization](/en-us/product/trip-optimisation)[Fleet & Resource Management](/en-us/product/fleet-management)[3D Load Planning](/en-us/product/load-planning)[OpenMove Driver App](/en-us/product/driver-app)[Real-Time Vehicle Tracking](/en-us/product/vehicle-tracking)[Multi-Modal Routing](/en-us/product/routing)[Pricing Engine](/en-us/product/pricing-engine)[Invoicing & Financial Management](/en-us/product/invoicing)[Message Automations](/en-us/product/message-automations)[Document Management & Generation](/en-us/product/documents)[Integrated Email Inbox](/en-us/product/email-inbox)[In-App Chat](/en-us/product/chat)[Customer & Business Portal](/en-us/product/customer-portal)[Integration Framework](/en-us/product/integration-framework)[Reporting & Insights](/en-us/product/reporting)[Multi-Tenancy & White-Label](/en-us/product/white-label)[Security & Access Control](/en-us/product/security) ## Ready to put this to work? Start free with full platform access, or talk to our team about your specific operation. [Start Free](https://portal.otms.transportial.com/auth/register)[Book a Demo](/en-us/contact) --- Canonical page: https://transportial.com/en-us/product/integration-framework