Book a DemoGet Started Free
Home›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 FreeRequest a Demo
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

Inside the product

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.

  1. 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.

    Preset integration selector listing transics, web_fleet, squarell, evogps, trimble, mapon, portbase, psa and dpworld

  2. 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, consignments and businesses.

  3. Integration · Trigger

    Outbound triggers: an event plus a condition decides when data is sent.

    Self-configurable integration trigger with an interval, the trigger event after updating trip and a selector where status equals confirmed
Preset integration selector listing transics, web_fleet, squarell, evogps, trimble, mapon, portbase, psa and dpworldSelf-configurable integration trigger with an interval, the trigger event after updating trip and a selector where status equals confirmed

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.

    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

  2. Connect

    Endpoint, schedule, authentication and headers, or let Transportial host a virtual FTP folder for you.

    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

  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.

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 buttonPreset 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

What it does

Everything this module does, named the way you will find it in 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 catalogue.

  • 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, capitalise, 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, consignment 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.

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.

Try it free first

Free tools that do part of what Integration Framework does, no account needed. When doing it one by one gets old, the module does it for every order automatically.

OTM5 Converter

Transform CSV or JSON into OTM5 transport orders

Live Freight Map

Cargo ships, cargo flights and rail freight, live

Truck Parking Map

Find truck parking in Europe and North America, along your route

All free tools

Works with

Connectors that feed or consume this module out of the box.

Transics / ZFExact OnlineSalesforcePortbaseDP WorldTimocomP&O FerriesPTV xRoute/xTour

All integrations

Built for

3PL & Logistics ProvidersFreight ForwardersShippers & Manufacturers

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.

Concepts & terminology

The words this module uses, with links to the full glossary where a term has its own page.
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.
EDIGlossary
Electronic data interchange; Transportial exchanges JSON, XML and CSV on the framework and speaks EDIFACT to ferry and terminal partners.
OTM5Glossary
The open model every mapping targets.
Open the glossary

Related features

View all features