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:
La licenza viene aggiunta al suo ordine.
È stata inviata un'e-mail automatica da FFV.
Il cliente inserisce i propri dati personali.
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: 👉 https://www.notion.so/ffvoile-dsi/Autoriser-une-solution-externe-agir-au-nom-d-une-structure-2f7ebc4120c880099d31c738169e0a9a
Configurazione in Yoplanning
Passaggio 1: Richiedere l'attivazione del modulo FFV
Per ottenere la configurazione del modulo FFV:
Contatta l'assistenza clienti di Yoplanning (support@yoplanning.com) per richiedere l'attivazione del modulo FFV.
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:
Vai a Risorse
Fai clic su Aggiungi
Crea una nuova risorsa
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:
⚠️ 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:
Vai a Prodotti
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:
Vai alla sezione Opzioni
Aggiungi le risorse di licenza FFV create in precedenza
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.
Ultimo aggiornamento