> 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/pt/academia-yoplanning/yoplanning-parametrage/gestion-des-options-ressources-materielles-et-immaterielles/procedure-de-connexion-a-la-federation-francaise-de-voile-ffv.md). # Procedimento para conexão com a Federação Francesa de Vela (FFV) Este guia explica como conectar o Yoplanning à Federação Francesa de Vela (FFV) para vender, criar e controlar licenças da FFV diretamente do seu software. *** ### Qual é a finalidade da conexão FFV? A conexão entre o Yoplanning e a API do FFV permite: * Para vender licenças FFV online a partir do módulo de reservas. * Para verificar automaticamente se um participante já possui uma licença válida. * Exibir um indicador visual nas sessões. * Para permitir que o escritório (BE) verifique as licenças rapidamente. * Criar uma licença FFV em nome do cliente após a compra. *** ### Princípio de funcionamento #### Venda opcional de licença A licença FFV é vendida como uma **opção** no módulo de reservas. Quando um cliente compra uma licença: 1. A licença foi adicionada ao seu pedido. 2. **Um e-mail automático da FFV foi enviado.** 3. **O cliente completa suas informações pessoais.** 4. Em seguida, o Yoplanning envia a solicitação de criação para o FFV por meio da API. A licença é criada com o FFV somente após a validação das informações pelo cliente. *** #### Verificação de licenças existentes Mesmo que o cliente não compre uma licença, o Yoplanning pode consultar o FFV automaticamente. Condição obrigatória: * Nome * Primeiro nome * Data de nascimento * Gênero Se essas 4 informações estiverem presentes, o Yoplanning consulta o FFV para recuperar as licenças existentes. *** ### Procedimento no lado FFV **A organização deve autorizar a Yoplanning a agir em seu nome.** Procedimento oficial da FFV: 👉 *** ### Configuração no Yoplanning #### Passo 1: Solicite a ativação do módulo FFV Para implementar o módulo FFV: 1. Entre em contato com o suporte da Yoplanning () para solicitar a ativação do módulo FFV. 2. Forneça o ID da sua estrutura FFV. Nossa equipe da Yoplanning irá então inserir o `ffv_structure_id` nos dados da sua equipe. Sem esse identificador, a integração do FFV não pode funcionar. *** #### Etapa 2: Verifique a criação automática do modelo de e-mail FFV Assim que o módulo for ativado: * Um modelo de e-mail FFV é criado automaticamente para a equipe. * Este e-mail contém o link que permite ao cliente finalizar a criação de sua licença. * É enviado ao mesmo tempo que o e-mail de confirmação da reserva. * Este é um e-mail separado. Você pode visualizar isso em: Configurações → E-mails *** #### Etapa 3: Crie os recursos de “Licenças FFV” No menu à esquerda: 1. Acesse **Recursos** 2. Clique em **Adicionar** 3. Criar um novo recurso 4. Preencha os campos obrigatórios como desejar, respeitando os campos obrigatórios abaixo, que permitem o mapeamento das licenças FFV. Parâmetros obrigatórios: * **Etiqueta de parceiro**: selecione **FFV** * **Modelo**: Insira exatamente um dos seguintes valores: ``` PASSFFV PASSEPORT CLUB_JEUNE CLUB_ADULTE TEMPO_TEMPO_1J TEMPO_TEMPO_4J ``` ⚠️ Respeite rigorosamente a ortografia. Após : * Insira o preço * Adicione uma descrição clara. * Salvar Boa prática: crie um recurso separado para cada tipo de licença vendida. *** #### Etapa 4: Configure o produto No menu à esquerda: 1. Acesse **Produtos** 2. Abra o produto em questão. **4.1 Tornar obrigatórias as informações sobre FFV (Vegetais Frios e Frutas)** Nas configurações do participante, torne os seguintes campos obrigatórios: * Nome * Primeiro nome * Data de nascimento * Gênero O campo **Gênero** deve existir no cadastro do cliente. Configuração → Arquivo do cliente Esses 4 campos são essenciais para consultar o FFV. *** **4.2 Adicionar licenças FFV como um recurso opcional do produto** Ainda dentro do produto: 1. Acesse a seção **Opções**. 2. Adicione os recursos de licença FFV criados anteriormente. 3. Salvar Você escolhe quais licenças oferecer para cada produto. Exemplo : * Curso de lazer → PASSFFV * Competição → CLUBE\_JUVENIL ou CLUBE\_ADULTO *** ### Onde posso ver o status do FFV no Yoplanning? O logotipo da FFV aparece ao lado do nome do participante em: * Detalhes da sessão * Gerenciar participantes * Lista de participantes #### Significado 🟢 Verde: Licença válida para a sessão 🟠 Laranja: Licença ausente, vencida ou em desacordo com as normas As datas de validade são consideradas automaticamente. *** ### Melhores práticas * Torne sempre todos os 4 campos obrigatórios. * Verifique a grafia exata do modelo nos recursos. * Testar uma compra completa antes de disponibilizá-la ao público. * Verifique o modelo de e-mail do FFV após a ativação. * Limitar as licenças oferecidas àquelas que são verdadeiramente necessárias. *** ### Problemas comuns e soluções #### O logotipo da FFV permanece laranja. Verificar : * Todas as 4 informações estão completas? * A licença expirou? * A identidade corresponde exatamente (ortografia, data, gênero)? *** #### A licença não é criada após a compra. Verificar : * O cliente preencheu o formulário recebido por e-mail? * O módulo FFV está ativado corretamente? * O identificador da estrutura FFV foi fornecido para suporte? * O recurso contém a tag de parceiro FFV? * O modelo está em estrita conformidade? *** #### As licenças não aparecem no produto. Verificar : * Os recursos estão disponíveis em **Recursos**. * Eles foram, de fato, adicionados como uma opção no produto. * O produto é de fato o mesmo utilizado pelo módulo de reservas. *** ### Resumo A integração do FFV no Yoplanning permite: * Venda online de licenças FFV * Verificação automática de licenças existentes * Uma simples inspeção visual para o BE * Conexão direta com a API oficial da Federação Francesa de Vela. Uma configuração correta garante uma gestão eficiente, automatizada e em conformidade das licenças FFV no 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/pt/academia-yoplanning/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.