Procédure de connexion à la Fédération Française de Voile (FFV)
Gestion des licences de Voile
Ce guide explique comment connecter Yoplanning à la Fédération Française de Voile (FFV) pour vendre, créer et contrôler les licences FFV directement depuis ton logiciel.
À quoi sert la connexion FFV ?
La connexion entre Yoplanning et l’API de la FFV permet :
De vendre des licences FFV en ligne depuis le module de réservation.
De vérifier automatiquement si un participant possède déjà une licence valide.
D’afficher un indicateur visuel sur les sessions.
De permettre au bureau (BE) de contrôler rapidement les licences.
De créer une licence FFV au nom du client après son achat.
Principe de fonctionnement
Vente de la licence en option
La licence FFV est vendue comme une option dans le module de réservation.
Quand un client achète une licence :
La licence est ajoutée à sa commande.
Un email automatique FFV est envoyé.
Le client complète ses informations personnelles.
Yoplanning envoie alors la demande de création à la FFV via l’API.
La licence est créée auprès de la FFV uniquement après validation des informations par le client.
Vérification des licences existantes
Même si le client n’achète pas de licence, Yoplanning peut interroger la FFV automatiquement.
Condition obligatoire :
Nom
Prénom
Date de naissance
Genre
Si ces 4 informations sont présentes, Yoplanning interroge la FFV pour récupérer les licences existantes.
Procédure côté FFV
La structure doit autoriser Yoplanning à agir en son nom.
Procédure officielle FFV : 👉 https://www.notion.so/ffvoile-dsi/Autoriser-une-solution-externe-agir-au-nom-d-une-structure-2f7ebc4120c880099d31c738169e0a9a
Configuration dans Yoplanning
Étape 1 : Demander l’activation du module FFV
Pour obtenir la mise en place du module FFV :
Contacter le support Yoplanning ([email protected]) pour demander l’activation du module FFV.
Fournir votre identifiant de structure FFV.
Notre équipe Yoplanning renseignera ensuite le ffv_structure_id dans les données de votre team.
Sans cet identifiant, l’intégration FFV ne peut pas fonctionner.
Étape 2 : Vérifier la création automatique du template email FFV
Une fois le module activé :
Un template d’email FFV est créé automatiquement pour la team.
Cet email contient le lien permettant au client de finaliser la création de sa licence.
Il est envoyé en même temps que l’email post-booking.
Il s’agit d’un email séparé.
Vous pouvez le consulter dans : Configuration → Emails
Étape 3 : Créer les ressources “Licences FFV”
Dans le menu de gauche :
Aller dans Ressources
Cliquer sur Ajouter
Créer une nouvelle ressource
Remplissez les champs demandés à votre guise, en respectant les champs obligatoires ci-dessous qui permettent de mapper les licences FFV.
Paramètres obligatoires :
Partner tag : sélectionner FFV
Model : saisir exactement l’une des valeurs suivantes :
⚠️ Respecter strictement l’orthographe.
Ensuite :
Renseigner le prix
Ajouter une description claire
Enregistrer
Bonne pratique : créer une ressource distincte par type de licence vendue.
Étape 4 : Configurer le produit
Dans le menu de gauche :
Aller dans Produits
Ouvrir le produit concerné
4.1 Rendre obligatoires les informations FFV
Dans la configuration des participants, rendre obligatoires :
Nom
Prénom
Date de naissance
Genre
Le champ Genre doit exister dans le fichier client.
Configuration → Fichier client
Ces 4 champs sont indispensables pour interroger la FFV.
4.2 Ajouter les licences FFV en option du produit
Toujours dans le produit :
Aller dans la section Options
Ajouter les ressources licences FFV créées précédemment
Enregistrer
C’est vous qui choisissez quelles licences proposer sur chaque produit.
Exemple :
Stage loisir → PASSFFV
Compétition → CLUB_JEUNE ou CLUB_ADULTE
Où voir le statut FFV dans Yoplanning ?
Un logo FFV apparaît à côté du nom du participant dans :
Session details
Manage participants
Participant list
Signification
🟢 Vert : licence valide pour la session 🟠 Orange : licence absente, expirée ou non conforme
Les dates d’expiration sont prises en compte automatiquement.
Bonnes pratiques
Toujours rendre obligatoires les 4 champs.
Vérifier l’orthographe exacte du model dans les ressources.
Tester un achat complet avant ouverture au public.
Vérifier le template email FFV après activation.
Limiter les licences proposées à celles réellement nécessaires.
Problèmes fréquents et solutions
Le logo FFV reste orange
Vérifier :
Les 4 informations sont-elles bien complètes ?
La licence est-elle expirée ?
L’identité correspond-elle exactement (orthographe, date, genre) ?
La licence ne se crée pas après achat
Vérifier :
Le client a-t-il complété le formulaire reçu par email ?
Le module FFV est-il bien activé ?
L’identifiant structure FFV a-t-il été fourni au support ?
La ressource contient-elle bien le partner tag FFV ?
Le model est-il strictement conforme ?
Les licences n’apparaissent pas dans le produit
Vérifier :
Les ressources existent dans Ressources
Elles sont bien ajoutées en option dans le produit
Le produit est bien celui utilisé par le module de réservation
Résumé
L’intégration FFV dans Yoplanning permet :
La vente en ligne des licences FFV
La vérification automatique des licences existantes
Un contrôle visuel simple pour le BE
Une connexion directe avec l’API officielle de la Fédération Française de Voile
Une configuration correcte garantit une gestion fluide, automatisée et conforme des licences FFV dans Yoplanning.pro.
Mis à jour