📚 Documentation Complète

Plateforme Mandataire
Automobile Multi-Territoires

Découvrez en détail comment fonctionne notre plateforme A2A (Agent-to-Agent) qui gère 100% des opérations d'un mandataire automobile sur plusieurs territoires.

10Agents IA
4Territoires
100%Automatisé
24/7Opérationnel

📑 Sommaire

01 Vue d'ensemble Architecture et fonctionnement général 02 Territoires & Taxes Calculs fiscaux par zone géographique 03 Fournisseurs & Import Gestion des stocks multi-sources 04 Catalogue & Variantes Gestion des véhicules et options 05 Pricing & Marges Calcul des prix de vente 06 Logistique & Transport Expédition maritime et aérienne 07 Workflow Commandes Du devis à la livraison 08 Agents IA Détail des 10 agents autonomes
01

Vue d'ensemble

Architecture globale de la plateforme

🏗️ Architecture A2A (Agent-to-Agent)

La plateforme Mandataire Auto repose sur une architecture moderne où 10 agents IA autonomes communiquent entre eux pour gérer l'intégralité des opérations d'un mandataire automobile.

Frontend
Site Web Client
Dashboard Admin
API REST
↓
Gateway
API Gateway
Action Gateway
↓
Orchestration
Orchestrator A2A
↓
Agents IA
Import
Product
Pricing
Tax
Logistics
Docs
CRM
SAV
↓
Données
PostgreSQL
Redis
Qdrant

⚡ Flux de données

  1. Requête client → Le client effectue une action (recherche, devis, commande)
  2. Gateway → La requête est authentifiée et routée
  3. Orchestrator → Détermine quels agents doivent intervenir
  4. Agents → Chaque agent spécialisé traite sa partie
  5. Consolidation → L'Orchestrator agrège les réponses
  6. Réponse → Le client reçoit le résultat final
02

Territoires & Taxes

Calculs fiscaux automatisés par zone géographique

La plateforme gère automatiquement les spécificités fiscales et réglementaires de chaque territoire. Chaque vente est calculée selon les règles locales.

🇬🇵

Guadeloupe

GP
TVA 8.5%
Octroi de Mer Selon véhicule
Octroi Régional 2.5%
Malus Écologique Barème national

Spécificités

  • Exonération possible véhicules propres
  • Délai moyen transport : 18-21 jours
  • Port principal : Pointe-à-Pitre
🇲🇶

Martinique

MQ
TVA 8.5%
Octroi de Mer Variable
Octroi Régional 2.5%
Taxe Additionnelle 0-1%

Spécificités

  • Règles similaires à la Guadeloupe
  • Délai moyen transport : 16-19 jours
  • Port principal : Fort-de-France
🇸🇽

Saint-Martin

SX
TVA 0%
Taxe Territoriale 5%
Droit de Douane Variable
Malus Non applicable

Spécificités

  • Zone franche fiscale
  • Pas de TVA française
  • Délai moyen : 20-25 jours
🇦🇮

Anguilla

AI
Import Duty 35%
Environmental Levy 3%
Customs Service 5%
VAT 0%

Spécificités

  • Territoire britannique
  • Conduite à gauche
  • Délai moyen : 25-30 jours

📊 Exemple de Calcul - Guadeloupe

Véhicule

Peugeot 3008 GT

Prix fournisseur : 32 000 €

Prix HT 32 000 €
+ Marge mandataire (8%) 2 560 €
+ Transport maritime 1 200 €
+ Assurance transport 180 €
= Base taxable 35 940 €
+ Octroi de Mer (7%) 2 516 €
+ Octroi Régional (2.5%) 899 €
+ TVA (8.5%) 3 355 €
PRIX FINAL TTC 42 710 €
03

Fournisseurs & Import

Gestion multi-sources des stocks véhicules

📥 Import de Stocks

L'Agent Import gère automatiquement l'ingestion des stocks depuis plusieurs sources :

📄

Import CSV/Excel

Upload de fichiers de stock au format standardisé

  • Mapping automatique des colonnes
  • Validation des données
  • Détection des doublons
🔌

API Fournisseurs

Connexion directe aux APIs des constructeurs

  • Synchronisation temps réel
  • Webhooks de mise à jour
  • Gestion des quotas API
🌐

Scraping Automatisé

Extraction depuis les portails fournisseurs

  • Planification quotidienne
  • Parsing intelligent
  • Historique des changements

🏭 Types de Fournisseurs

Constructeurs Directs

Accès aux stocks usine et véhicules en production

Délai : 2-4 mois

Grossistes Européens

Véhicules disponibles immédiatement

Délai : 2-4 semaines

Concessionnaires

Stocks locaux et véhicules d'occasion récente

Délai : 1-2 semaines

Fleet Managers

Véhicules de société, kilométrage contrôlé

Délai : immédiat
04

Catalogue & Variantes

Gestion des véhicules, versions et options

🚗 Structure du Catalogue

Marque Peugeot, Renault, Toyota...
Modèle 3008, Clio, Yaris...
Génération Phase 1, Phase 2...
Finition Active, Allure, GT...
Motorisation 1.2 PureTech, BlueHDi...
Transmission Manuelle, Auto, 4x4...
Options & Packs Navigation, Toit pano, Pack cuir...

📋 Gestion des Variantes

🎨 Couleurs

Gestion des teintes extérieures et intérieures

  • Couleurs de série (gratuites)
  • Teintes métallisées (+600€)
  • Teintes nacrées (+900€)
  • Couleurs spéciales (+1500€)

⚙️ Motorisations

Différentes configurations moteur

  • Essence (PureTech, TCe...)
  • Diesel (BlueHDi, dCi...)
  • Hybride (HEV, PHEV)
  • Électrique (100% EV)

📦 Packs Options

Regroupements d'options avec remise

  • Pack Confort
  • Pack Technologie
  • Pack Sécurité
  • Pack Design

🔧 Options Unitaires

Options à la carte

  • Toit panoramique
  • Sièges chauffants
  • Caméra 360°
  • Jantes alu 19"

👁️ Règles d'Affichage Catalogue

Les véhicules affichés sur le site client sont filtrés selon ces critères :

✅ Stock disponible confirmé
✅ Prix fournisseur valide
✅ Marge minimale atteinte (5%)
✅ Véhicule livrable sur territoire
⚠️ Homologation compatible (si requis)
⚠️ Délai de livraison < 6 mois
05

Pricing & Marges

Calcul automatisé des prix de vente

💰 Composition du Prix

🏭

Prix Fournisseur HT

Prix d'achat négocié avec le fournisseur

Ex: 28 000 €
+
📈

Marge Mandataire

Pourcentage configurable par catégorie

5% à 15%
+
🚢

Frais de Transport

Maritime, assurance, dédouanement

1 200 - 2 500 €
+
📋

Taxes Territoriales

TVA, Octroi de Mer, etc.

Selon destination
=
🎯

Prix Client TTC

Prix affiché sur le site

42 710 €

📊 Règles de Marge

Catégorie Marge Min Marge Cible Marge Max
Citadines 5% 8% 12%
Compactes 6% 9% 14%
SUV / Crossover 7% 10% 15%
Premium / Luxe 8% 12% 18%
Utilitaires 4% 6% 10%
06

Logistique & Transport

Gestion du transport maritime et aérien

🚢 Modes de Transport

🚢

Transport Maritime

Mode principal pour les véhicules

  • Conteneur 40' : 2-3 véhicules
  • RoRo : Chargement direct
  • Délai : 16-25 jours
  • Coût moyen : 1 200 - 1 800 €
✈️

Transport Aérien

Pour pièces urgentes uniquement

  • Pièces détachées : < 100 kg
  • Délai : 3-5 jours
  • Coût : Élevé (8-15 €/kg)

🗺️ Routes Maritimes

Départ Destination Compagnie Fréquence Durée
Le Havre 🇫🇷 Pointe-à-Pitre 🇬🇵 CMA CGM Hebdo 18 jours
Le Havre 🇫🇷 Fort-de-France 🇲🇶 CMA CGM Hebdo 16 jours
Anvers 🇧🇪 Philipsburg 🇸🇽 MSC Bi-mensuel 22 jours
Rotterdam 🇳🇱 Blowing Point 🇦🇮 Maersk Mensuel 28 jours

📦 Processus de Livraison

1

Commande Validée

Paiement acompte reçu

J+0
2

Récupération Véhicule

Enlèvement chez fournisseur

J+3 à J+7
3

Pré-acheminement

Transport vers port d'embarquement

J+7 à J+10
4

Embarquement

Chargement sur navire

J+10 à J+14
5

Transit Maritime

Traversée atlantique

14-21 jours
6

Dédouanement

Formalités douanières

2-5 jours
7

Livraison Client

Remise des clés !

J+35 à J+45
07

Workflow Commandes

Du premier contact à la livraison

🔍

1. Recherche

  • Client recherche un véhicule
  • Filtres par budget, marque, type
  • Comparaison des offres
→
📝

2. Devis

  • Demande de devis personnalisé
  • Calcul prix selon territoire
  • PDF généré automatiquement
→
✅

3. Commande

  • Validation du devis
  • Acompte 30%
  • Bon de commande signé
→
🏭

4. Sourcing

  • Commande fournisseur
  • Confirmation disponibilité
  • Planification transport
→
🚢

5. Transport

  • Expédition maritime
  • Tracking temps réel
  • Notifications client
→
🎉

6. Livraison

  • Solde de paiement
  • Remise des documents
  • Garantie activée
08

Agents IA

Les 10 agents autonomes de la plateforme

🎯

Orchestrator

Coordination

Chef d'orchestre de la plateforme. Reçoit toutes les requêtes et détermine quels agents doivent intervenir.

Routing intelligent Workflow management Agrégation réponses
📥

Agent Import

Ingestion Stocks

Gère l'import des stocks depuis multiples sources : CSV, APIs, scraping. Normalise et valide les données.

Multi-formats Validation Déduplication
🚗

Agent Product

Matching Produits

Fait correspondre les références fournisseurs avec le catalogue normalisé. Enrichit les données produits.

Matching IA Enrichissement Normalisation
⚙️

Agent Configurator

Compatibilités

Vérifie les compatibilités entre options, motorisations et finitions. Empêche les configurations invalides.

Règles métier Validation options Suggestions
💰

Agent Pricing

Calcul Prix

Calcule les prix de vente en appliquant marges, remises et promotions selon les règles configurées.

Marges dynamiques Promotions Compétitivité
📊

Agent Tax

Fiscalité

Calcule les taxes applicables selon le territoire de destination : TVA, Octroi de Mer, Import Duty, etc.

Multi-territoires Règles fiscales Mise à jour auto
🚢

Agent Logistics

Transport

Gère le transport maritime/aérien, calcule les délais et coûts, suit les expéditions en temps réel.

ETA calcul Tracking Optimisation routes
📄

Agent Docs

Documents

Génère automatiquement tous les documents : devis, bons de commande, factures, certificats.

PDF génération Templates Signatures
👥

Agent CRM

Relation Client

Gère les prospects, clients et relances automatiques. Segmente et qualifie les leads.

Lead scoring Relances auto Segmentation
🛠️

Agent SAV

Support

Gère les tickets de support, les garanties et les réclamations. Assure le suivi après-vente.

Ticketing Garanties Satisfaction