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: 👉 https://www.notion.so/ffvoile-dsi/Autoriser-une-solution-externe-agir-au-nom-d-une-structure-2f7ebc4120c880099d31c738169e0a9a


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 ([email protected]) 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:

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

Última actualización