# Développez sur l'API qui fait tourner Roadmark.

> Développez sur l'API publique qu'utilisent les écrans, l'application chauffeur et les agents de Roadmark : chargements, soumissions, factures, webhooks et MCP.

URL: https://roadmark.ai/fr/developpeurs
Language: fr

Nos propres écrans, l'application chauffeur et chaque agent appellent la même API publique. Il n'y en a pas de privée. Tout ce que Roadmark peut faire à un chargement, à une soumission ou à une facture, votre code peut le faire aussi, avec les mêmes autorisations.

## Chaque dossier qu'utilise le produit est dans l'API.

Un seul modèle de ressources, celui-là même que lisent nos écrans. Rien dans l'application n'a une forme que votre code ne peut pas voir aussi.

- **loads** Un envoi, de la cueillette à la livraison, avec ses arrêts et son statut.
- **stops** Une cueillette, une livraison ou un arrêt intermédiaire, et sa plage de rendez-vous.
- **quotes** Une demande chiffrée, en ébauche ou envoyée, avec les raisons derrière le chiffre.
- **orders** La réservation d'un client avant qu'elle devienne un chargement.
- **customers** Les clients que vous facturez, leurs contrats et leurs contacts.
- **carriers** Les transporteurs que vous engagez, leurs assurances, leurs corridors et l'historique de leurs tarifs.
- **drivers** Heures de service, documents et paie, pour votre propre parc.
- **units** Camions et remorques, leur entretien et leur chargement en cours.
- **invoices** Ce que vous facturez à un client, et la date du paiement.
- **settlements** Ce qui est dû à un chauffeur ou à un transporteur, et la date du paiement.
- **documents** Preuves de livraison, confirmations de tarif et tout autre document joint à un chargement.
- **events** Chaque modification de chaque dossier, et qui ou quoi l'a faite.

## Les webhooks avisent vos systèmes dès qu'un chargement change.

Abonnez un point de terminaison aux événements qui vous intéressent. Chacun transporte l'identifiant du dossier et sa version : une nouvelle tentative tardive n'écrase jamais une donnée plus récente, et vous pouvez toujours récupérer le dossier complet avec les autorisations de votre propre clé.

- **quote.drafted** Un agent ou une personne crée une soumission pour un appel d'offres ou une demande reçue.
- **quote.sent** Une soumission est envoyée à un client.
- **load.status_changed** Un chargement passe de réservé à réparti, en transit, puis livré.
- **load.stop.arrived** Un appel de suivi, un balayage ou un événement du DCE indique l'arrivée à un arrêt.
- **tender.accepted** Un transporteur accepte une offre de chargement dans le portail transporteur ou par EDI.
- **invoice.issued** Une facture est créée à partir d'un chargement livré.
- **settlement.paid** Le règlement d'un chauffeur ou d'un transporteur est payé.
- **document.uploaded** Une preuve de livraison, une confirmation de tarif ou un autre document est ajouté à un chargement.

## Le même serveur MCP qu'utilisent Claude, ChatGPT et Gemini.

C'est un petit ensemble d'outils, en mots simples, pas une copie de toute l'API. Chaque appel s'exécute au nom de la personne connectée : il voit ses entreprises et ses clients, rien d'autre.

- **search_loads** Trouver des chargements par client, corridor, statut ou date, comme un répartiteur le demanderait.
- **get_load** Lire un chargement au complet : arrêts, statut, tarif et documents.
- **draft_quote** Chiffrer un corridor à partir des contrats et de l'historique des tarifs, et laisser le résultat en ébauche.
- **update_eta** Consigner une nouvelle HAP à partir d'un appel de suivi ou d'un retard, préparée pour approbation comme toute autre mise à jour.
- **list_invoices** Trouver les factures ouvertes, payées ou en souffrance d'un client.
- **find_customer** Consulter le contrat, les contacts et les chargements récents d'un client.

## Les agents que vous créez préparent le travail, et une personne l'approuve dans le même dossier.

Tout ce que vous développez sur l'API écrit dans les mêmes ébauches que nos propres agents. Rien de ce qu'il prépare ne parvient à un client, à un transporteur ou à un chauffeur tant que quelqu'un ne l'a pas approuvé dans Roadmark, et chaque action est attribuée à votre intégration, nommément.

## Un bac à sable avec un vrai groupe déjà dedans.

Les clés de test pointent vers Ashgrove Transportation Group, un espace de test avec des entreprises, des chargements, des clients et des transporteurs déjà chargés. Rien de ce que vous y faites n'atteint une entreprise réelle.

## Ce que demandent les développeurs.

- **Roadmark a-t-il une API publique?** Oui, et c'est la même API qu'appellent les écrans, l'application chauffeur et les agents de Roadmark; il n'y en a pas de privée. Tout ce que Roadmark peut faire à un chargement, à une soumission ou à une facture, votre code peut le faire aussi, avec les mêmes autorisations.
- **Quelles données l'API couvre-t-elle?** Chaque dossier qu'utilise le produit : chargements, arrêts, soumissions, commandes, clients, transporteurs, chauffeurs, unités, factures, règlements, documents et événements. C'est le même modèle de ressources que lisent les écrans.
- **Roadmark prend-il en charge les webhooks?** Oui. Abonnez un point de terminaison à des événements comme quote.sent, load.status_changed, tender.accepted ou invoice.issued. Chaque événement transporte l'identifiant et la version du dossier : une nouvelle tentative tardive n'écrase jamais une donnée plus récente.
- **Y a-t-il un serveur MCP?** Oui, le même qu'utilisent Claude, ChatGPT et Gemini. C'est un petit ensemble d'outils en mots simples, comme search_loads, draft_quote et list_invoices, et chaque appel s'exécute au nom de la personne connectée, qui ne voit que ses entreprises et ses clients.
- **Y a-t-il un bac à sable pour les tests?** Oui, et l'accès est gratuit. Les clés de test pointent vers Ashgrove Transportation Group, un espace de test avec des entreprises, des chargements, des clients et des transporteurs déjà chargés, et rien de ce que vous y faites n'atteint une entreprise réelle.
- **Y a-t-il des SDK?** Oui. Des clients typés sont disponibles pour Node.js, Python et Ruby. Vous pouvez aussi utiliser directement l’API REST et JSON.

## Pages connexes

- [Intégrations](https://roadmark.ai/fr/integrations) : DCE, EDI, bourses de fret et comptabilité
- [Connectez votre assistant IA](https://roadmark.ai/fr/assistants-ia) : Utilisez Roadmark depuis Claude, ChatGPT ou Gemini
- [Serveur MCP du TMS : connectez Roadmark à tout assistant IA](https://roadmark.ai/fr/integrations/modelcontextprotocol) : Le serveur MCP de Roadmark offre des outils de transport à tout client MCP : chaque appel agit au nom de la personne connectée, avec ses seuls accès.
- [Sécurité](https://roadmark.ai/fr/securite) : Isolation des entreprises, accès et vos données
- [Intégration EDI X12 : les 204, 990, 214 et 210 expliqués](https://roadmark.ai/fr/integrations/edi) : Ce que signifient les EDI 204, 990, 214 et 210, leur sens et leur moment d'envoi, la configuration des partenaires commerciaux et le suivi transmis en 214.

Les entreprises, personnes et chiffres des exemples produit sont fictifs. Ils illustrent des flux de travail, sans constituer des témoignages clients ni des résultats mesurés.