[Home](/fr)›[Produit](/fr/product)›Cadre d’intégration Étendre et gouverner # 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. [Commencer gratuitement](https://portal.otms.transportial.com/auth/register)[Demander une démo](/fr/contact) REST APIOpenAPIFTPEDIApp StoreSDKKafka REST Full OpenAPI spec FTP Embedded server EDI EDIFACT & file templates App Store UI extensions Intégration · Mapping des données ![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) Associez n'importe quel champ entrant à un chemin du modèle OTM5, avec types, regex et options par champ. 1. Champ entrant issu du fichier ou de l'API du partenaire 2. Type et transformation par champ 3. Chemin sortant vers l'ordre, le client ou l'envoi 4. 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](/fr/integrations). * 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 1. ### 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. 2. ### Connectez Point de terminaison, planification, authentification et en-têtes, ou laissez Transportial héberger pour vous un dossier FTP virtuel. 3. ### 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. 4. ### Testez Créez des cas de test avec résultat attendu et assertions ; exécutez-les à chaque modification. 5. ### 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. Intégrations · Nouvelle intégration ![Formulaire de nouvelle intégration avec nom, description et une liste déroulante de types proposant intégration préréglée, configurable, accès API et modèle de fichier, ainsi qu'un bouton Générer par IA](/assets/screens/integration-types.webp) Quatre types d'intégration : connecteur préréglé, configurable, accès API et modèle de fichier. ## 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. Intégrations · Préréglage ![Sélecteur d'intégrations préréglées listant transics, web_fleet, squarell, evogps, trimble, mapon, portbase, psa et dpworld](/assets/screens/integration-presets.webp) Préréglages : choisissez le connecteur, ajoutez les identifiants, c'est fait. ## 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. Intégration · Configuration ![Configuration d'une intégration préréglée avec valeur et unité de planification, URL et port, type d'authentification basic avec nom d'utilisateur et mot de passe, boutons ajouter un attribut et ajouter un en-tête, et un interrupteur marche/arrêt](/assets/screens/integration-preset-config.webp) Planification, point de terminaison, authentification et en-têtes par connexion. ## Concepts et terminologie Les termes utilisés par ce module, avec des liens vers le glossaire complet lorsqu’un terme a sa propre page. [Ouvrir le glossaire](/fr/glossary) 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. EDI[Glossaire](/fr/glossary/edi) É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. OTM5[Glossaire](/fr/glossary/otm5) Le modèle ouvert que vise chaque mapping. ## Dans le produit Intégration · Déclencheur ![Déclencheur d'une intégration configurable avec un intervalle, l'événement déclencheur après mise à jour d'un trajet et un sélecteur où le statut est égal à confirmé](/assets/screens/integration-trigger.webp) Déclencheurs sortants : un événement et une condition décident du moment d'envoi des données. ## 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. [Tous les outils gratuits](/fr/tools) [Outil gratuitConvertisseur OTM5Transformez du CSV ou du JSON en ordres de transport OTM5](/fr/tools/otm5-converter) ## Fonctionne avec Connecteurs qui alimentent ou exploitent ce module, prêts à l’emploi. [![](/assets/integrations/zf-transics.svg)Transics / ZF](/fr/integration/transics)[![](/assets/integrations/exact.svg)Exact Online](/fr/integration/exact-online)[![](/assets/integrations/salesforce.svg)Salesforce](/fr/integration/salesforce)[![](/assets/integrations/portbase.svg)Portbase](/fr/integration/portbase)[![](/assets/integrations/dp-world.svg)DP World](/fr/integration/dp-world)[![](/assets/integrations/timocom.svg)Timocom](/fr/integration/timocom)[![](/assets/integrations/po-ferries.svg)P&O Ferries](/fr/integration/po-ferries)[![](/assets/integrations/ptv.svg)PTV xRoute/xTour](/fr/integration/ptv)[Toutes les intégrations →](/fr/integration) ## Conçu pour Là où ce module apporte le plus. [3PL et prestataires logistiques](/fr/solutions/logistics-service-providers)[Commissionnaires de transport](/fr/solutions/freight-forwarders)[Chargeurs et industriels](/fr/solutions/shippers) Détails techniques 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. ## Fonctionnalités associées [Voir toutes les fonctionnalités](/fr/product) [Multi-locataire et marque blancheExploitez votre propre plateforme logistique à votre marque, entièrement isolée, entièrement personnalisable, sur votre propre domaine.](/fr/product/white-label)[Reporting et analysesTransformez vos données opérationnelles en décisions grâce à des tableaux de bord configurables, des requêtes TQL et une piste d’audit complète.](/fr/product/reporting)[Automatisation des messagesEnvoyez le bon message à la bonne personne au bon moment, déclenché automatiquement par plus de 75 événements opérationnels.](/fr/product/message-automations) Voir toutes les fonctionnalités [Gestion des ordres de transport](/fr/product/transport-orders)[Tableau de planification interactif](/fr/product/plan-board)[Optimisation des trajets par IA](/fr/product/trip-optimisation)[Gestion de flotte et des ressources](/fr/product/fleet-management)[Planification de chargement 3D](/fr/product/load-planning)[Application chauffeur OpenMove](/fr/product/driver-app)[Suivi des véhicules en temps réel](/fr/product/vehicle-tracking)[Calcul d’itinéraires multimodal](/fr/product/routing)[Moteur de tarification](/fr/product/pricing-engine)[Facturation et gestion financière](/fr/product/invoicing)[Automatisation des messages](/fr/product/message-automations)[Gestion et génération de documents](/fr/product/documents)[Logiciel eCMR : lettres de voiture numériques](/fr/product/ecmr)[Boîte de réception e-mail intégrée](/fr/product/email-inbox)[Chat intégré](/fr/product/chat)[Portail clients et entreprises](/fr/product/customer-portal)[Cadre d’intégration](/fr/product/integration-framework)[Reporting et analyses](/fr/product/reporting)[Multi-locataire et marque blanche](/fr/product/white-label)[Sécurité et contrôle d’accès](/fr/product/security) ## Prêt à le mettre en pratique ? Commencez gratuitement avec un accès complet à la plateforme, ou parlez à notre équipe de votre activité. [Commencer gratuitement](https://portal.otms.transportial.com/auth/register)[Réserver une démo](/fr/contact) --- Canonical page: https://transportial.com/fr/product/integration-framework