> For the complete documentation index, see [llms.txt](https://docs.yoplanning.support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yoplanning.support/it/accademia-di-pianificazione/yoplanning-parametrage/gestion-des-options-ressources-materielles-et-immaterielles/procedure-de-connexion-a-la-federation-francaise-de-voile-ffv.md). # 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.yoplanning.support/it/accademia-di-pianificazione/yoplanning-parametrage/gestion-des-options-ressources-materielles-et-immaterielles/procedure-de-connexion-a-la-federation-francaise-de-voile-ffv.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.