# Procedimiento de conexión con la Federación Francesa de Vela (FFV) Esta guía explica cómo conectar Yoplanning con la Federación Francesa de Vela (FFV) para vender, crear y controlar licencias de la FFV directamente desde su software. *** ### ¿Cuál es la finalidad de la conexión FFV? La conexión entre Yoplanning y la API de FFV permite: * Para vender licencias FFV en línea desde el módulo de reservas. * Para comprobar automáticamente si un participante ya tiene una licencia válida. * Para mostrar un indicador visual en las sesiones. * Para permitir que la oficina (BE) revise rápidamente las licencias. * Para crear una licencia FFV a nombre del cliente después de su compra. *** ### Principio de funcionamiento #### Venta de licencia opcional La licencia FFV se vende como una **opción** en el módulo de reservas. Cuando un cliente compra una licencia: 1. La licencia se añade a su pedido. 2. **Se ha enviado un correo electrónico automático de FFV.** 3. **El cliente completa su información personal.** 4. A continuación, Yoplanning envía la solicitud de creación a FFV a través de la API. La licencia se crea con el FFV únicamente después de que el cliente valide la información. *** #### Verificación de las licencias existentes Aunque el cliente no adquiera una licencia, Yoplanning puede consultar el FFV automáticamente. Condición obligatoria: * Nombre * Nombre de pila * Fecha de nacimiento * Género Si se encuentran presentes estos 4 datos, Yoplanning consulta al FFV para recuperar las licencias existentes. *** ### Procedimiento por parte de FFV **La organización debe autorizar a Yoplanning a actuar en su nombre.** Procedimiento oficial de FFV: 👉 *** ### Configuración en Yoplanning #### Paso 1: Solicitar la activación del módulo FFV. Para obtener la configuración del módulo FFV: 1. Póngase en contacto con el servicio de asistencia de Yoplanning () para solicitar la activación del módulo FFV. 2. Proporcione su ID de estructura FFV. Nuestro equipo de Yoplanning introducirá entonces el `ffv_structure_id` en los datos de su equipo. Sin este identificador, la integración de FFV no puede funcionar. *** #### Paso 2: Verificar la creación automática de la plantilla de correo electrónico FFV. Una vez activado el módulo: * Se crea automáticamente una plantilla de correo electrónico FFV para el equipo. * Este correo electrónico contiene el enlace que permite al cliente finalizar la creación de su licencia. * Se envía al mismo tiempo que el correo electrónico posterior a la reserva. * Este es un correo electrónico aparte. Puedes verlo en: Configuración → Correos electrónicos *** #### Paso 3: Crear los recursos de “Licencias FFV” En el menú de la izquierda: 1. Ir a **Recursos** 2. Haz clic en **Agregar** 3. Crear un nuevo recurso 4. Rellene los campos obligatorios como desee, respetando los campos que se indican a continuación y que permiten asignar las licencias FFV. Parámetros requeridos: * **Etiqueta de socio**: seleccione **FFV** * **Modelo**: Introduzca exactamente uno de los siguientes valores: ``` PASSFFV PASSEPORT CLUB_JEUNE CLUB_ADULTE TEMPO_TEMPO_1J TEMPO_TEMPO_4J ``` ⚠️ Respete estrictamente la ortografía. Después : * Introduzca el precio * Añade una descripción clara * Ahorrar Buenas prácticas: cree un recurso independiente para cada tipo de licencia vendida. *** #### Paso 4: Configurar el producto En el menú de la izquierda: 1. Ir a **Productos** 2. Abra el producto en cuestión. **4.1 Hacer obligatoria la información sobre vehículos de combustible flexible (FFV)** En la configuración de participantes, haga que lo siguiente sea obligatorio: * Nombre * Nombre de pila * Fecha de nacimiento * Género El campo **Género** debe existir en el archivo del cliente. Configuración → Archivo de cliente Estos 4 campos son esenciales para consultar el FFV. *** **4.2 Agregar licencias FFV como una característica opcional del producto** Aún dentro del producto: 1. Ve a la sección **Opciones** 2. Agregue los recursos de licencia FFV creados previamente. 3. Ahorrar Usted elige qué licencias ofrecer para cada producto. Ejemplo : * Curso de ocio → PASSFFV * Competición → CLUB JUVENIL o CLUB DE ADULTOS *** ### ¿Dónde puedo ver el estado de FFV en Yoplanning? El logotipo de FFV aparece junto al nombre del participante en: * Detalles de la sesión * Gestionar participantes * Lista de participantes #### Significado 🟢 Verde: Licencia válida para la sesión 🟠 Naranja: Licencia faltante, vencida o no cumple con los requisitos Las fechas de caducidad se tienen en cuenta automáticamente. *** ### Mejores prácticas * Siempre haga que los 4 campos sean obligatorios. * Verifique la ortografía exacta del modelo en los recursos. * Probar una compra completa antes de que salga al público. * Comprueba la plantilla de correo electrónico de FFV después de la activación. * Limitar las licencias ofrecidas a las que sean realmente necesarias. *** ### Problemas y soluciones comunes #### El logotipo de FFV sigue siendo naranja. Controlar : * ¿Están completas las 4 piezas de información? * ¿Ha caducado la licencia? * ¿Coincide exactamente la identidad (ortografía, fecha, género)? *** #### La licencia no se crea después de la compra. Controlar : * ¿El cliente completó el formulario recibido por correo electrónico? * ¿Está activado correctamente el módulo FFV? * ¿Se ha proporcionado el identificador de estructura FFV para su compatibilidad? * ¿El recurso contiene la etiqueta de socio de FFV? * ¿El modelo cumple estrictamente con las especificaciones? *** #### Las licencias no aparecen en el producto. Controlar : * Los recursos están disponibles en **Recursos**. * Efectivamente, se han añadido como opción al producto. * El producto es, efectivamente, el que utiliza el módulo de reservas. *** ### Resumen La integración de FFV en Yoplanning permite: * Venta online de licencias FFV * Verificación automática de las licencias existentes * Una simple inspección visual para el BE * Conexión directa a la API oficial de la Federación Francesa de Vela. Una configuración correcta garantiza una gestión fluida, automatizada y conforme a la normativa de las licencias FFV en Yoplanning.pro.