# Procedura di connessione alla Federazione francese di vela (FFV) Questa guida spiega come collegare Yoplanning alla Federazione Francese di Vela (FFV) per vendere, creare e gestire le licenze FFV direttamente dal tuo software. *** ### Qual è lo scopo del collegamento FFV? La connessione tra Yoplanning e l'API FFV consente di: * Per vendere online le licenze FFV dal modulo di prenotazione. * Per verificare automaticamente se un partecipante possiede già una licenza valida. * Per visualizzare un indicatore visivo delle sessioni. * Per consentire all'ufficio (BE) di verificare rapidamente le licenze. * Creare una licenza FFV a nome del cliente dopo il suo acquisto. *** ### Principio operativo #### Vendita di licenze opzionali La licenza FFV viene venduta come **opzione** nel modulo di prenotazione. Quando un cliente acquista una licenza: 1. La licenza viene aggiunta al suo ordine. 2. **È stata inviata un'e-mail automatica da FFV.** 3. **Il cliente inserisce i propri dati personali.** 4. Yoplanning invia quindi la richiesta di creazione al FFV tramite l'API. La licenza viene creata con il FFV solo dopo la convalida delle informazioni da parte del cliente. *** #### Verifica delle licenze esistenti Anche se il cliente non acquista una licenza, Yoplanning può interrogare automaticamente il FFV. Condizione obbligatoria: * Nome * Nome * Data di nascita * Genere Se queste 4 informazioni sono presenti, Yoplanning interroga il FFV per recuperare le licenze esistenti. *** ### Procedura dal lato FFV **L'organizzazione deve autorizzare Yoplanning ad agire per suo conto.** Procedura ufficiale FFV: 👉 *** ### Configurazione in Yoplanning #### Passaggio 1: Richiedere l'attivazione del modulo FFV Per ottenere la configurazione del modulo FFV: 1. Contatta l'assistenza clienti di Yoplanning () per richiedere l'attivazione del modulo FFV. 2. Fornisci l'ID della tua struttura FFV. Il nostro team Yoplanning inserirà quindi il `ffv_structure_id` nei dati del tuo team. Senza questo identificativo, l'integrazione FFV non può funzionare. *** #### Passaggio 2: Verificare la creazione automatica del modello di email FFV Una volta attivato il modulo: * Per il team viene creato automaticamente un modello di email FFV. * Questa email contiene il link che consente al cliente di finalizzare la creazione della propria licenza. * Viene inviata contemporaneamente all'email di conferma della prenotazione. * Si tratta di un'email separata. Puoi visualizzarlo in: Impostazioni → Email *** #### Passaggio 3: Creare le risorse "Licenze FFV" Nel menu a sinistra: 1. Vai a **Risorse** 2. Fai clic su **Aggiungi** 3. Crea una nuova risorsa 4. Compila i campi richiesti a tuo piacimento, rispettando i campi obbligatori sottostanti che consentono la mappatura delle licenze FFV. Parametri richiesti: * **Tag del partner**: seleziona **FFV** * **Modello**: Inserire esattamente uno dei seguenti valori: ``` PASSFFV PASSEPORT CLUB_JEUNE CLUB_ADULTE TEMPO_TEMPO_1J TEMPO_TEMPO_4J ``` ⚠️ Attenersi rigorosamente all'ortografia. Dopo : * Inserisci il prezzo * Aggiungi una descrizione chiara * Salva Buona prassi: creare una risorsa separata per ogni tipo di licenza venduta. *** #### Passaggio 4: Configurare il prodotto Nel menu a sinistra: 1. Vai a **Prodotti** 2. Apri il prodotto in questione **4.1 Rendere obbligatorie le informazioni FFV** Nelle impostazioni dei partecipanti, rendi obbligatori i seguenti campi: * Nome * Nome * Data di nascita * Genere Il campo **Genere** deve essere presente nel file del cliente. Configurazione → File client Questi 4 campi sono essenziali per interrogare la FFV. *** **4.2 Aggiungere le licenze FFV come funzionalità opzionale del prodotto** Sempre all'interno del prodotto: 1. Vai alla sezione **Opzioni** 2. Aggiungi le risorse di licenza FFV create in precedenza 3. Salva Sei tu a scegliere quali licenze offrire per ciascun prodotto. Esempio : * Corso per il tempo libero → PASSFFV * Competizione → CLUB GIOVANILE o CLUB ADULTO *** ### Dove posso visualizzare lo stato del mio conto FFV in Yoplanning? Il logo FFV appare accanto al nome del partecipante in: * Dettagli della sessione * Gestire i partecipanti * Elenco dei partecipanti #### Senso 🟢 Verde: Licenza valida per la sessione 🟠 Arancione: Licenza mancante, scaduta o non conforme Le date di scadenza vengono prese in considerazione automaticamente. *** ### migliori prassi * Rendete sempre obbligatori tutti e 4 i campi. * Verifica l'ortografia esatta del modello nelle risorse. * Testare un prodotto completo prima della sua apertura al pubblico. * Dopo l'attivazione, verifica il modello di email FFV. * Limitare le licenze offerte a quelle realmente necessarie. *** ### Problemi comuni e soluzioni #### Il logo FFV rimane arancione Controllo : * Tutte e 4 le informazioni sono complete? * La licenza è scaduta? * L'identità corrisponde esattamente (ortografia, data, genere)? *** #### La licenza non viene creata dopo l'acquisto. Controllo : * Il cliente ha compilato il modulo ricevuto via e-mail? * Il modulo FFV è stato attivato correttamente? * È stato fornito l'identificativo della struttura FFV al supporto? * La risorsa contiene il tag partner FFV? * Il modello è rigorosamente conforme? *** #### Le licenze non compaiono nel prodotto Controllo : * Le risorse sono disponibili nella sezione **Risorse**. * Vengono effettivamente aggiunti come opzione nel prodotto. * Il prodotto è effettivamente quello utilizzato dal modulo di prenotazione. *** ### Riepilogo L'integrazione di FFV in Yoplanning consente: * Vendita online di licenze FFV * Verifica automatica delle licenze esistenti * Una semplice ispezione visiva per il BE * Collegamento diretto all'API ufficiale della Federazione francese di vela. Una configurazione corretta garantisce una gestione fluida, automatizzata e conforme delle licenze FFV in Yoplanning.pro.