Projet Intégration API

Saybus : moteur de calcul transport connecté à Google Places, ViaMichelin et MangoPay

Logo Dawap
Jérémy Chomel Dawap
  • Publié le : 3 janvier 2021
  • Temps de lecture : 23 minutes
  1. Présentation du client
  2. Méthode projet Dawap
  3. Contexte du projet et problèmes initiaux
  4. Objectifs métier et critères de succès
  5. Périmètre fonctionnel et gouvernance delivery
  6. Architecture technique retenue
  7. Conception du moteur de calcul et règles métier
  8. Formulaires de trajet et expérience utilisateur
  9. APIs intégrées dans le projet
  10. Workflow devis, réservation et paiement
  11. API REST de synchronisation SI groupe
  12. Observabilité, sécurité et maintien en condition opérationnelle
  13. Scénario terrain
  14. Résultats obtenus et impacts business
  15. Bilan et évolutions possibles
  16. Conclusion
Jérémy Chomel

Quand un devis transport dépend encore d’une succession de calculs manuels, chaque demande prend trop de temps et chaque approximation pèse sur la rentabilité. C’est exactement le problème que Saybus devait résoudre pour industrialiser sa réponse commerciale et fiabiliser ses réservations.

Le projet consistait à transformer des calculs dispersés en moteur métier capable de produire des estimations cohérentes, auditables et reliées au parcours de réservation. Sur ce type de sujet, notre expertise en Intégration API permet de lier des briques spécialisées à une vraie logique produit.

Cette étude de cas montre comment un socle de calcul bien cadré peut faire gagner du temps aux équipes, améliorer la qualité des devis et sécuriser toute la chaîne jusqu’au paiement.

1. Présentation du client

Comprendre le contexte business avant la solution

Saybus évolue dans un contexte où la rapidité de réponse commerciale et la fiabilité économique des trajets proposés ont un impact direct sur la qualité de service et la confiance accordée par les clients.

Le besoin n’était pas seulement d’automatiser des calculs. Il fallait aussi rendre le résultat plus lisible, plus cohérent et plus simple à exploiter pour les équipes qui gèrent ensuite la réservation et l’exécution.

Le projet devait donc créer un vrai moteur métier, capable de relier les APIs de calcul, les règles internes et le parcours de réservation dans un ensemble robuste.

2. Méthode projet Dawap

Analyse, priorisation, delivery agile et sécurisation du run

Le chantier a commencé par une phase d’analyse des règles de calcul réellement utilisées par les équipes, des sources d’erreur les plus fréquentes et des points de friction entre devis, réservation et paiement. Ce cadrage a permis de modéliser les scénarios les plus utiles avant d’industrialiser le reste.

Le backlog a ensuite été piloté dans Jira avec des sprints itératifs. Les user stories ont été priorisées selon leur valeur métier : fiabiliser d’abord le calcul des trajets et des coûts, puis structurer les formulaires, puis connecter proprement les étapes de réservation et de paiement.

Les mises en ligne ont été sécurisées par des tests, des environnements adaptés, une logique CI/CD et une montée progressive du périmètre. L’objectif était de bâtir un moteur fiable pour la production, pas seulement une preuve de concept.

3. Contexte du projet et problèmes initiaux

Passer d'un processus artisanal à une plateforme industrialisée

Avant le projet, la production des devis chez Saybus reposait sur des enchaînements manuels : recherche d'adresses, calcul de distances, estimation des péages, contrôle des temps de conduite et consolidation des coûts d'exploitation. La qualité du résultat dépendait fortement de l'expérience de la personne qui traitait la demande, ce qui créait une variabilité importante entre deux devis similaires.

Ce fonctionnement devenait un frein opérationnel. Les équipes perdaient du temps sur des tâches à faible valeur et ne pouvaient pas absorber sereinement les pics de demande. Le risque d'erreur sur les hypothèses de trajet ou de coûts augmentait mécaniquement avec le volume. L'enjeu du projet était donc double : accélérer le délai de réponse commercial et fiabiliser la cohérence économique des propositions envoyées aux clients.

La mission Dawap s'est concentrée sur la construction d'un moteur de calcul robuste, connecté à des APIs spécialisées, capable de couvrir des scénarios réels : trajets simples, allers-retours, navettes récurrentes et circuits multi-étapes. L'objectif était de fournir un socle durable, exploitable quotidiennement, et pas une démonstration ponctuelle.

4. Objectifs métier et critères de succès

Fiabilité du calcul, rapidité de réponse et pilotage des marges

Le cadrage a défini des objectifs clairs côté métier. Le premier consistait à réduire drastiquement le temps de production d'un devis sans dégrader sa précision. Le second visait la standardisation des règles de calcul pour limiter les écarts d'interprétation entre équipes. Le troisième portait sur la capacité à piloter la rentabilité en rendant les composants du prix lisibles, auditables et ajustables.

Les critères de succès ont été pensés en conditions d'exploitation : diminution des corrections manuelles, meilleure traçabilité des hypothèses de calcul, réduction des litiges liés aux estimations, et stabilité des enchaînements devis -> réservation -> paiement. La réussite du projet dépendait autant de la qualité du code que de la capacité des équipes à s'approprier le système au quotidien.

Le dispositif devait aussi rester extensible. Saybus voulait pouvoir faire évoluer sa politique tarifaire, ses paramètres opérationnels et ses canaux de distribution sans devoir reconstruire la plateforme à chaque changement. Cette exigence a orienté les choix vers une approche API-first et un moteur métier paramétrable.

5. Périmètre fonctionnel et gouvernance delivery

Une trajectoire incrémentale orientée usage

Le périmètre traité couvre l'ensemble de la chaîne: saisie guidée du trajet, enrichissement géographique, calcul complet des coûts, génération du devis, validation client, paiement, puis exposition des données de réservation au SI du groupe. Chaque brique a été conçue pour fonctionner de façon autonome tout en s'intégrant à un workflow global cohérent.

La gouvernance projet a combiné ateliers métier, revues techniques et validation opérationnelle régulière. Les décisions n'étaient pas prises uniquement sur des considérations d'architecture, mais aussi sur l'impact concret en exploitation. Ce mode de pilotage a permis d'arbitrer rapidement les priorités et d'éviter les dérives de périmètre.

Le delivery a été séquencé en lots courts pour réduire les risques. Chaque étape devait livrer une valeur immédiatement testable : d'abord la qualité des adresses, puis la fiabilité des calculs, ensuite la fluidité du workflow et enfin la robustesse run. Cette méthode a sécurisé la montée en production tout en gardant une forte visibilité pour les décideurs.

6. Architecture technique retenue

Découpler les responsabilités pour améliorer robustesse et évolutivité

L'architecture repose sur une séparation nette entre interface utilisateur, moteur de calcul, orchestration des appels externes, couche de persistance et API de restitution. Ce découpage limite les effets de bord quand une règle métier évolue ou quand une API tierce change ses contraintes. Le système reste maintenable sans ralentir l'innovation fonctionnelle.

Le moteur central joue le rôle de source de vérité du calcul. Les connecteurs APIs alimentent ce moteur avec des données validées, puis les résultats sont restitués via des contrats applicatifs explicites. Ce design réduit le couplage avec les consommateurs externes et permet d'introduire de nouvelles capacités sans refonte globale.

L'architecture a également été pensée pour le run : logs corrélés, contrôles d'erreurs, statut des traitements et capacité de reprise. Ce volet exploitation est essentiel sur un projet où la qualité du service influence directement la conversion commerciale.

7. Conception du moteur de calcul et règles métier

Transformer des contraintes complexes en calcul reproductible

Le moteur intègre les dimensions structurantes du transport : distance, durée, péages, coûts carburant, coûts conducteurs, contraintes de disponibilité, éventuels frais d'hébergement et majorations spécifiques. L'enjeu n'était pas d'additionner des postes, mais de garantir un calcul cohérent pour des scénarios hétérogènes.

Chaque règle a été explicitée pour éviter l'effet boîte noire. Les équipes métier peuvent comprendre d'où vient le résultat et ajuster des paramètres sans casser la logique d'ensemble. Cette transparence a amélioré l'adoption interne et réduit les zones d'incertitude lors des arbitrages tarifaires.

Le moteur a été conçu pour préserver la stabilité tout en restant paramétrable. Cela permet d'intégrer de nouvelles politiques commerciales ou opérationnelles sans remettre en cause les fondations techniques.

8. Formulaires de trajet et expérience utilisateur

Un front orienté clarté pour fiabiliser la donnée d'entrée

L'interface propose plusieurs modes de saisie adaptés aux usages réels: trajet simple, aller-retour, navette et multi-étapes. Cette structuration guide l'utilisateur et évite les ambiguïtés qui dégradent ensuite la qualité du calcul. Le design produit a été pensé pour réduire le temps de saisie tout en conservant les informations nécessaires à la précision économique.

La normalisation des entrées adresses est un point clé. En améliorant la qualité des données à l'entrée, on réduit mécaniquement les erreurs dans la chaîne aval. Ce principe a fortement contribué à la fiabilité globale du système.

L'expérience utilisateur ne se limite pas à l'ergonomie visuelle. Elle repose aussi sur la capacité du système à répondre vite, à expliquer les résultats et à proposer un chemin fluide jusqu'à la réservation. C'est ce triptyque qui a permis de transformer un outil de calcul en levier de conversion.

9. APIs intégrées dans le projet

Des blocs spécialisés orchestrés autour du moteur métier

API Cartographie & géolocalisation

Google Places est utilisé pour l'autocomplétion, la normalisation et la fiabilisation des adresses. Cette étape garantit des points de départ et d'arrivée cohérents avant calcul, ce qui réduit fortement les écarts sur les estimations de trajet.

Voir nos solutions API Cartographie & géolocalisation

Voir nos solutions Google Maps Platform

API Paiements

L'intégration MangoPay sécurise la phase de confirmation de réservation et fiabilise la transition entre simulation, validation et exécution. Le paiement devient une étape intégrée au workflow, avec une meilleure traçabilité pour les équipes.

Voir nos solutions API Paiements

Voir nos solutions MangoPay

Création d'API sur mesure

Une API métier sur mesure expose les devis et réservations au SI du groupe avec des contrats stables. Cette couche sert d'interface de synchronisation entre le moteur de calcul et les applications partenaires.

Voir nos solutions de création d'API sur mesure

API Authentification & sécurité

La sécurisation des échanges API et la gestion des accès garantissent que seules les applications autorisées consomment les données sensibles de réservation et de devis. Cette base est indispensable pour exploiter le service à l'échelle.

Voir nos solutions API Authentification & sécurité

Connecteur itinéraire métier

ViaMichelin est exploité pour le calcul d'itinéraire, des distances, des durées et des coûts routiers nécessaires au moteur de devis transport. La route dédiée n'étant pas exposée dans ce référentiel, le lien renvoie vers l’univers cartographie et géolocalisation.

Connecteur ViaMichelin

10. Workflow devis, réservation et paiement

Fermer la boucle de bout en bout sans rupture

Une fois le calcul finalisé, l'utilisateur obtient un devis détaillé et peut passer à la validation sans ressaisie. Cette continuité limite les abandons entre simulation et réservation. Le workflow a été pensé pour maintenir la confiance utilisateur: clarté des informations, étapes explicites et cohérence des montants affichés.

La phase de paiement est intégrée au parcours métier, pas greffée en fin de chaîne. Cette intégration évite les décalages entre statut commercial et statut financier. Les équipes disposent ainsi d'une meilleure visibilité sur les réservations effectivement confirmées.

Le résultat opérationnel est un processus plus fluide pour le client et plus pilotable pour l'exploitation. Les transitions entre front, moteur et back-office sont harmonisées, ce qui réduit la friction globale.

11. API REST de synchronisation SI groupe

Exposer les données utiles au bon niveau de granularité

Le projet inclut une API REST permettant au système du groupe de récupérer les réservations et informations nécessaires à l'orchestration opérationnelle. Cette exposition évite les exports manuels et fiabilise l'alignement entre outils commerciaux et outils d'exploitation.

Les contrats API ont été définis pour rester robustes face aux évolutions: champs explicites, statuts maîtrisés et comportements d'erreur prévisibles. Cette discipline réduit les effets de bord quand les intégrations partenaires évoluent.

En pratique, cette API est un accélérateur d'industrialisation. Elle transforme la plateforme Saybus en composant connecté de l'écosystème SI, capable d'échanger de manière stable avec des applications tierces.

12. Observabilité, sécurité et maintien en condition opérationnelle

Concevoir un service exploitable au quotidien

L'observabilité a été traitée comme une exigence de premier plan : suivi des appels API, journalisation corrélée des étapes critiques, et visibilité sur les échecs de calcul ou de synchronisation. Cette approche permet de réduire fortement le temps de diagnostic en production.

Un diagnostic plus rapide

Les mécanismes de sécurité couvrent les accès, les échanges inter-applicatifs et la protection des données de réservation. Le système est conçu pour préserver l'intégrité des flux tout en restant compatible avec les contraintes de performance.

Une plateforme pensée pour durer

Le maintien en condition opérationnelle repose sur des procédures de reprise claires et des points de contrôle réguliers. Cette discipline garantit que la plateforme reste fiable dans la durée, même quand les volumes ou les règles métier évoluent.

13. Scénario terrain

Un devis transport qui doit rester rentable jusqu’au paiement

Le scénario clé était le devis transport où chaque variable compte : point de départ, destination, distance, capacité, marge, conditions commerciales et passage au paiement. Si le calcul change en cours de parcours ou si une donnée de réservation diverge, la rentabilité et la confiance client sont immédiatement fragilisées.

Le moteur a donc été conçu comme une API métier sur mesure, avec des règles explicites, des statuts lisibles et des contrôles avant exposition aux systèmes du groupe. La partie paiement a été pensée avec la même exigence de continuité, notamment autour des patterns Mangopay.

Cette approche relie calcul, réservation et exploitation : le devis n'est pas une estimation isolée, mais une décision commerciale traçable, contrôlable et suffisamment robuste pour être automatisée.

14. Résultats obtenus et impacts business

Des gains mesurables sur productivité, cohérence et conversion

Des devis plus rapides à produire

Après mise en production, Saybus a bénéficié d'un cycle de traitement plus court entre demande et devis exploitable. Les équipes ont réduit les manipulations manuelles et gagné en homogénéité sur les règles de calcul, ce qui limite les écarts de qualité entre dossiers.

Une rentabilité mieux lue

La meilleure lisibilité des composants de prix a aussi renforcé la maîtrise des marges. Les décideurs disposent d'une base de calcul plus explicite pour arbitrer politiques tarifaires et stratégies commerciales.

Un parcours plus fluide jusqu'au paiement

Sur le parcours client, la fluidité devis -> réservation -> paiement a amélioré la qualité perçue du service. Le projet a donc produit une valeur concrète à la fois côté exploitation et côté expérience utilisateur.

15. Bilan et évolutions possibles

Un socle robuste prêt pour de nouveaux scénarios

Le projet Saybus a atteint ses objectifs structurants: industrialiser le calcul, fiabiliser les décisions commerciales et connecter proprement la chaîne métier au SI du groupe. La plateforme livrée n'est pas un simple configurateur, mais un outil opérationnel durable construit pour évoluer.

Les prochaines étapes naturelles portent sur l'enrichissement des règles de scoring, l'extension à de nouveaux cas d'usage transport et l'amélioration continue des indicateurs de pilotage. Le socle actuel permet ces évolutions de manière incrémentale, sans remettre en question l'architecture centrale.

Cette étude de cas illustre une logique reproductible pour les organisations qui veulent structurer leurs flux critiques avec des APIs : cadrage métier rigoureux, architecture découplée, observabilité native et gouvernance orientée résultats. Elle complète le projet plateforme Saybus, centré sur l’expérience de réservation et le pilotage web.

16. Conclusion

Pourquoi ce projet donne envie de travailler avec Dawap

Ce projet montre qu’un bon moteur métier ne se résume pas à agréger des APIs. Il doit surtout rendre les calculs plus fiables, plus compréhensibles et plus utiles pour les équipes comme pour les clients finaux.

Pour Saybus, le gain tient autant dans la rapidité de réponse que dans la cohérence économique des devis et dans la fluidité du passage vers la réservation.

Si vous devez construire un moteur de calcul ou relier plusieurs services métier avec ce niveau d’exigence, notre accompagnement en Intégration API, en création d’API sur mesure et en développement web sur mesure permet d’avancer avec méthode.

Jérémy Chomel
Cadrage projet

Vous avez un sujet proche de ce projet ?

On peut vous aider à qualifier le contexte, prioriser les risques, clarifier les flux ou cadrer une trajectoire réaliste autour de Intégration API.

Contacter un expert Voir Intégration API
Plateforme Bus Booking pour réservation d'autocars, calculateur et back-office Développement web Saybus / Réunir : Bus Booking Voir le projet
  • 05 avril 2022
  • Lecture ~32 min

Saybus devait transformer une demande d’autocar en commande exploitable sans perdre calcul, paiement ni suivi interne. Dawap a conçu une plateforme avec Google Places, ViaMichelin, Stripe, empreinte bancaire, documents PDF, facturation et back-office pour piloter chaque dossier jusqu’à l’exploitation.

Visuel éditorial de Kheoos Hub pour l’interconnexion catalogue produits Intégration API Kheoos Hub : OMS API multi-marketplaces Voir le projet
  • 7 mars 2021
  • Lecture ~23 min

Kheoos avait besoin de centraliser commandes, catalogue et statuts venant d’Amazon, Fnac, Cdiscount et eBay vers l’ERP. Dawap a construit un middleware OMS avec supervision et reprises maîtrisées pour réduire les écarts de flux et rendre le run multi-marketplaces plus lisible.

Visuel éditorial de 1UP Sourcing, hub intelligent de sourcing multi-fournisseurs Intégration API 1UP Sourcing : marge et achats marketplace Voir le projet
  • 12 mai 2021
  • Lecture ~27 min

1UP Sourcing devait rapprocher fournisseurs, marketplaces et ERP Odoo pour décider quoi acheter sans travailler à l’instinct. Dawap a conçu un hub API qui compare disponibilité, marge réelle et potentiel de vente afin de prioriser les achats et nourrir les arbitrages marketplace.

Cadrage opérationnel

Identifions le premier lot utile, les risques et les dépendances avant de lancer.

Dawap peut relire votre contexte métier, vos outils en place, vos contraintes de production et les points de friction à traiter en priorité pour cadrer un sujet Intégration API exploitable, testable et maintenable.