Ctrlk
Go to Yoplanning.pro
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 :

  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 : 👉 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 :

  1. Contacter le support Yoplanning (support@yoplanning.com) 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 :

⚠️ 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.

PrécédentDéfinir un ordre pour les options de vos produits.SuivantLes Honoraires (Paramétrage)

Mis à jour