# Procédure de connexion à la Fédération Française de Voile (FFV) 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 : 1. La licence est ajoutée à sa commande. 2. **Un email automatique FFV est envoyé.** 3. **Le client complète ses informations personnelles.** 4. 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 :\ 👉 *** ### Configuration dans Yoplanning #### Étape 1 : Demander l’activation du module FFV Pour obtenir la mise en place du module FFV : 1. Contacter le support Yoplanning () pour demander l’activation du module FFV. 2. 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 : 1. Aller dans **Ressources** 2. Cliquer sur **Ajouter** 3. Créer une nouvelle ressource 4. 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 : ``` PASSFFV PASSEPORT CLUB_JEUNE CLUB_ADULTE TEMPO_TEMPO_1J TEMPO_TEMPO_4J ``` ⚠️ 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 : 1. Aller dans **Produits** 2. 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 : 1. Aller dans la section **Options** 2. Ajouter les ressources licences FFV créées précédemment 3. 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.yoplanning.support/yoplanning-academie/yoplanning-parametrage/gestion-des-options-ressources-materielles-et-immaterielles/procedure-de-connexion-a-la-federation-francaise-de-voile-ffv.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.