Cadre d’intégration
Connectez Transportial à n’importe quel système externe (ERP, télématique, plateformes de commande, etc.) grâce à une API REST complète et à l’App Store.
![Tableau de mapping des champs avec, à gauche, des noms de champs entrants comme firma, kontaktperson, email et telefon, un type par champ, à droite des chemins sortants comme customer.name et customer.contactDetails[0].value, une colonne regex et des boutons Ajouter un champ](/assets/screens/integration-data-mapping.webp)
- Champ entrant issu du fichier ou de l'API du partenaire
- Type et transformation par champ
- Chemin sortant vers l'ordre, le client ou l'envoi
- Ajoutez des champs, ou générez le mapping par IA
Les exploitations logistiques modernes reposent sur de nombreux systèmes. Transportial est conçu pour être connecté : une API REST complète avec documentation OpenAPI, un serveur FTP intégré pour les intégrations historiques, l’analyse de fichiers EDI et un App Store pour étendre l’interface. Chaque scénario d’intégration est couvert.
Ce que fait le module
Tout ce que fait ce module, nommé comme vous le trouverez dans le produit.
Quatre façons de se connecter
- Connecteurs préréglés
Des gestionnaires intégrés pour la télématique, le rFMS constructeur, les terminaux, les ferries, les bourses de fret, la comptabilité, le CRM, les paiements, l'e-mail, la messagerie, les calendriers et bien plus, listés dans le catalogue d'intégrations.
- Configurable
N'importe quelle API, webhook, FTP, SFTP, connexion SQL, récepteur d'e-mails ou le serveur FTP virtuel que Transportial héberge pour vous ; JSON, XML ou CSV ; en entrée comme en sortie.
- Accès API
API REST sous /api avec des routes générées à partir du modèle, documentation OpenAPI rendue avec ReDoc, clés API et jetons d'application, et une limite de 500 requêtes par minute.
- Modèles de fichiers
Analysez et produisez des fichiers avec des sélecteurs : matrice (positions dans une feuille), HTML, position de variable texte et constantes, pour les partenaires qui ne travaillent qu'avec des fichiers.
Un mapping sans code
- Mapping des champs
Du champ entrant au chemin sortant avec type, regex et options comme supprimer les espaces en début et fin, mettre une majuscule initiale, en majuscules ou en minuscules, supprimer les espaces et champs d'identification.
- Mapping des valeurs
Traduisez les codes du partenaire en valeurs de la plateforme, y compris des cibles propres aux fournisseurs pour Transics, Webfleet, Mapon, Squarell, les entrées télémétriques et les boutons du véhicule.
- Filtres et déclencheurs
Filtres de comparaison (==, !=, >, <, in, not in) avec AND/OR ; déclencheurs sortants sur n'importe quel événement déclencheur de la plateforme, assortis d'une condition.
- Génération par IA
Collez un fichier d'exemple ou une réponse d'API et le mapping des champs est ébauché ; ou générez toute l'intégration à partir d'une description.
Exploitez-le comme un logiciel
- Vue de traçage
Onglets journaux, tâches, objets, requêtes, tests, matrice et HTML, et un traçage qui relie objet → tâche → journal → requête.
- Tests d'intégration
JSON d'entrée et attendu, assertions au niveau erreur ou avertissement, correspondance exacte, assertions seules ou les deux, exécution de tous les tests, avec notifications d'échec.
- Fiabilité
Un chien de garde qui émet des alertes de blocage et de silence, des notifications d'échec et de blocage par e-mail, des fenêtres de synchronisation qui limitent la tranche mais jamais la portée, une répartition de charge entre nœuds de traitement Kafka, la suppression d'écho pour qu'une intégration ne reçoive jamais sa propre modification, des modes de journalisation des requêtes tout, erreurs ou désactivé, et le masquage des secrets.
- Authentification
Clé API, clés d'accès, basic, OAuth, bearer, OpenID, clés client et en-têtes personnalisés.
Étendez la plateforme
- App Store
Parcourez, installez et configurez des applications avec permissions, historique des versions et hooks : points de terminaison webhook ou hooks d'interface qui ajoutent un onglet au tableau de bord ou au menu.
- Portail développeurs
Applications, éditeurs, clés API, statistiques, avis et modèles de tarification (gratuit, freemium, paiement unique, abonnement, à l'usage par appel, trajet, envoi ou véhicule), avec inscription en libre-service des fournisseurs et des développeurs.
- Webhooks
Webhooks sortants sur les événements déclencheurs ; webhooks entrants pour Stripe, Mollie, Adyen, Burger Ferry et Salesforce.
- Boutons d'action
Des boutons définis par le client sur les actifs, qui appellent une intégration, par exemple pour envoyer un message à un ordinateur de bord.
Comment ça marche
Choisissez le type
Préréglé pour un partenaire connu ; configurable pour une API sur mesure ou un échange de fichiers ; accès API pour le propre client du partenaire ; modèle de fichier pour les tableurs et les fichiers à positions fixes.
Connectez
Point de terminaison, planification, authentification et en-têtes, ou laissez Transportial héberger pour vous un dossier FTP virtuel.
Associez
Associez les champs au modèle OTM5, ajoutez des mappings de valeurs et des filtres, ou générez le mapping par IA à partir d'un exemple.
Testez
Créez des cas de test avec résultat attendu et assertions ; exécutez-les à chaque modification.
Exécutez et surveillez
Tracez chaque objet à travers tâches, journaux et requêtes ; le chien de garde vous alerte lorsque l'intégration se bloque.
Le framework fait mieux que les connecteurs ponctuels
Tôt ou tard, chaque transporteur se voit demander « le XML qu'envoie l'ERP du client ». Un script ponctuel fait l'affaire jusqu'à ce que le format change. Transportial traite chaque connexion comme une configuration sur le même framework : connexion, format, mapping, filtres, déclencheurs, tests et journaux. Les connecteurs préréglés ne sont que des mappings que l'équipe livre et maintient ; l'intégration propre d'un client bénéficie du même traçage et de la même surveillance.
Le framework apporte aussi la sécurité opérationnelle : la suppression d'écho empêche les boucles entre deux systèmes, les fenêtres de synchronisation maintiennent un interrogement fiable sous charge, et les mêmes événements déclencheurs qui pilotent les automatisations pilotent les données sortantes.
FTP virtuel et modèles de fichiers pour la longue traîne
Tous les partenaires n'ont pas d'API. Transportial héberge un serveur FTP pour qu'un partenaire puisse déposer des fichiers dans un dossier appartenant à votre plateforme, et les modèles de fichiers analysent du texte à positions fixes, des tableurs cellule par cellule et du HTML. Le même moteur de mapping place ensuite les données dans les ordres, les envois et les entreprises.
Concepts et terminologie
Les termes utilisés par ce module, avec des liens vers le glossaire complet lorsqu’un terme a sa propre page.
- Intégration préréglée
- Un connecteur intégré pour un système partenaire donné, configuré avec des identifiants et des options.
- Intégration configurable
- Une connexion définie par le client vers n'importe quelle API, serveur de fichiers, base de données ou boîte aux lettres, avec son propre mapping.
- Mapping de champ
- La règle qui copie un champ entrant vers un chemin du modèle de la plateforme, avec type, regex et options.
- Mapping de valeurs
- Une table de correspondance entre les codes du partenaire et les valeurs de la plateforme.
- FTP virtuel
- Un serveur FTP hébergé par Transportial pour votre plateforme, afin que les partenaires puissent échanger des fichiers sans disposer de leur propre serveur.
- Suppression d'écho
- Ne pas renvoyer une modification à l'intégration qui en est à l'origine.
- EDIGlossaire
- Échange de données informatisé ; Transportial échange du JSON, du XML et du CSV sur le framework et utilise EDIFACT avec les partenaires ferries et terminaux.
- OTM5Glossaire
- Le modèle ouvert que vise chaque mapping.
Dans le produit
Essayez d'abord gratuitement
Des outils gratuits qui font une partie de ce que fait Cadre d’intégration, sans compte. Quand le faire un par un devient lassant, le module le fait automatiquement pour chaque ordre.
Fonctionne avec
Connecteurs qui alimentent ou exploitent ce module, prêts à l’emploi.
Transics / ZF
Exact Online
Salesforce
Portbase
DP World
Timocom
P&O Ferries
PTV xRoute/xTourConçu pour
Là où ce module apporte le plus.
Les tâches d’intégration sont réparties entre des workers Kafka avec équilibrage de charge, suppression des échos et un watchdog de santé qui lève des alertes en cas de blocage ou de silence. Les requêtes API sont limitées à 500 par minute. Les applications de l’App Store étendent la plateforme via des webhooks et des points d’ancrage dans l’interface.
Questions fréquentes
Existe-t-il une API publique ?
Oui. Une API REST avec documentation OpenAPI, clés API et jetons d'application, et une limite de 500 requêtes par minute. Un outil de conversion OTM5 aide à prendre en main le modèle.
Pouvons-nous connecter un système sans API ?
Oui. Utilisez FTP ou SFTP, le FTP virtuel hébergé par Transportial, un récepteur d'e-mails, une connexion SQL ou des modèles de fichiers pour les tableurs et les fichiers à positions fixes.
Prenez-vous en charge l'EDI ?
Le framework échange du JSON, du XML et du CSV avec n'importe quel partenaire, et des messages EDIFACT sont utilisés avec des partenaires ferries et terminaux comme P&O Ferries et DP World. Les messages d'ordre EDIFACT ou X12 génériques sont mappés partenaire par partenaire.
Comment savoir si une intégration fonctionne bien ?
Un chien de garde émet des alertes de blocage et de silence, les échecs et blocages sont notifiés par e-mail, et la vue de traçage relie chaque objet à ses tâches, journaux et requêtes.
Peut-on tester les intégrations avant la mise en production ?
Oui. Des cas de test avec entrée, résultat attendu et assertions s'exécutent individuellement ou tous ensemble, et un test en échec peut envoyer une notification.
Des tiers peuvent-ils développer sur la plateforme ?
Oui. L'App Store et le portail développeurs permettent aux éditeurs de publier des applications avec des hooks webhook et d'interface, et de les proposer gratuitement, en freemium, en paiement unique, par abonnement ou à l'usage.
Voir toutes les fonctionnalités
Prêt à le mettre en pratique ?
Commencez gratuitement avec un accès complet à la plateforme, ou parlez à notre équipe de votre activité.