# Intégrations

Brancher FedaPay, Yango Fleet ou un GPS Traccar sur votre parc : les familles de services, les états, et comment tester, activer, couper ou retirer.

Les intégrations relient le parc aux services qu'il utilise déjà. Elles se règlent dans **Réglages**, section **Intégrations**, et sont réservées au **Gérant**.

Les emails envoyés par Flot Pilot et le stockage des photos et des pièces sont fournis par Flot Pilot : il n'y a rien à brancher pour eux.

## Ce que vous pouvez brancher

Les services sont rangés en trois familles. Un parc a un seul service actif par famille.

| Famille | Service | Ce qu'il apporte |
| --- | --- | --- |
| **Encaissement** | [FedaPay](https://docs.flotpilot.com/integrations/fedapay/) | Les versements des chauffeurs par MTN MoMo, Moov Money et Celtiis Cash, sur le compte FedaPay du parc |
| **Données de flotte** | [Yango Fleet](https://docs.flotpilot.com/integrations/yango/) | Le lien avec votre parc Yango. Pour l'instant, le test de connexion seulement |
| **Suivi GPS** | [Traccar](https://docs.flotpilot.com/integrations/traccar/) | Le lien avec le serveur Traccar qui reçoit vos boîtiers |
| **Suivi GPS** | Cloud Tracking (Yunzhixing) | Marqué **Bientôt** : pas encore configurable (voir plus bas) |

Si un autre service de la même famille est déjà actif, la ligne l'indique (« remplacerait… »). Activer le nouveau coupe l'ancien, sans effacer sa configuration.

## Lire l'état d'un service

Chaque service porte un badge :

| État | Ce qu'il veut dire |
| --- | --- |
| **Non configurée** | Rien n'est saisi |
| **À tester** | Les clés sont enregistrées, la connexion n'a pas été testée depuis |
| **Vérifiée, à activer** | Le dernier test a réussi : il reste à cliquer sur **Activer** |
| **Active** | Le service tourne. Pour FedaPay, le badge précise **Active · test** ou **Active · live** selon la clé |
| **Erreur** | Le dernier test a échoué ; la raison s'affiche sous le service |
| **Bientôt** | Annoncé, pas encore configurable |

Une fois configuré, un service affiche ce qui a été saisi (les secrets par leurs quatre derniers caractères seulement) et la date du **Dernier test**.

## Brancher un service

1. Dans **Réglages**, ouvrez la section **Intégrations**.
2. Sur la ligne du service, cliquez sur **Configurer**. Le formulaire rappelle ce qu'il faut savoir avant de brancher, et le lien **Documentation** ouvre celle du fournisseur.
3. Remplissez les champs. La page de chaque service dit où les trouver.
4. Cliquez sur **Enregistrer**. L'écran confirme : « Configuration enregistrée. Testez la connexion avant d’activer. »
5. Cliquez sur **Tester**. Le résultat s'affiche sous le service : l'état passe à **Vérifiée, à activer**, ou à **Erreur** avec la raison.
6. Cliquez sur **Activer**. L'écran confirme que le service est actif.

Un service ne s'active qu'après un test réussi.

## Modifier un service

1. Cliquez sur **Modifier**. Le formulaire se rouvre.
2. Changez ce qui doit l'être. Un champ secret affiche seulement ses quatre derniers caractères : laissez-le vide pour garder la valeur enregistrée, ou tapez une nouvelle valeur pour la remplacer.
3. Cliquez sur **Enregistrer**, puis testez et activez de nouveau.

Tout enregistrement remet le service à **À tester** et le coupe, même s'il était actif. Pour une clé FedaPay live, l'autorisation des débits réels est aussi à redonner.

## Couper un service

**Couper** arrête le service. L'écran confirme que la configuration est conservée : vous pouvez le réactiver plus tard avec **Activer**, sans rien ressaisir.

Un test qui échoue coupe aussi un service actif : on ne laisse pas tourner une intégration cassée.

## Retirer un service

1. Cliquez sur **Modifier**.
2. En bas du formulaire, cliquez sur **Retirer et effacer les clés**, puis confirmez.

La configuration et les clés sont supprimées. Les paiements déjà passés gardent leur référence.

## Vos clés

Les clés sont chiffrées avant d'être enregistrées et ne sont jamais réaffichées en entier. Chaque service ne demande que ce dont il a besoin : FedaPay, par exemple, ne demande jamais la clé secrète du compte.

## Cloud Tracking (Yunzhixing)

Cloud Tracking est la plateforme de l'application du même nom, fournie avec de nombreux boîtiers GPS. Elle est marquée **Bientôt** : elle n'a pas d'accès public documenté, et ses identifiants sont détenus par l'installateur du boîtier. En attendant, un boîtier peut être redirigé vers un serveur [Traccar](https://docs.flotpilot.com/integrations/traccar/).

Source : https://docs.flotpilot.com/integrations/