Contratos - Visão Geral do Módulo

O que é

O módulo Contratos Digitais é o módulo do Viagilize responsável por gerar, enviar e arquivar contratos de cada passageiro com aceite eletrônico. Ele funciona como uma central única em /admin/contratos, onde a empresa acompanha todos os contratos de todas as excursões em um só lugar, com estatísticas de aceite, filtros por excursão, status e período, busca por nome, CPF ou e-mail, e ações rápidas para ver o contrato ou baixar o PDF assinado.

O usuário normalmente chega nesta página quando precisa verificar quem já aceitou ou ainda não aceitou o contrato, exportar uma planilha de aceites, ajustar o modelo padrão (template) ou as configurações do contrato (dados da empresa, logo, assinatura digitalizada) antes de uma temporada de viagens.

Como usar

1. Vá em Módulos > Contratos Digitais no sidebar (ou abra a URL /admin/contratos).
2. Confira os quatro cartões do topo: Total de Contratos, Aceitos, Pendentes e Taxa de Aceite. Eles consideram apenas passageiros titulares e ignoram reservas canceladas ou reembolsadas.
3. Use a barra de filtros logo abaixo para refinar a listagem:
   • Busca - nome, CPF ou e-mail do passageiro.
   • Excursão - seleciona uma excursão específica.
   • Status - Aceitos ou Pendentes.
   • Data início - corta pela data da reserva.
4. Em cada cartão de passageiro use as ações:
   • Ver Contrato - abre a tela detalhada com cláusulas e status do aceite.
   • Baixar PDF - aparece somente quando o aceite já foi registrado.
   • Menu de três pontos para ir até a Excursão ou o Cliente.
5. Para baixar a base completa filtrada, clique em Exportar CSV no canto superior direito. O arquivo gerado mantém os mesmos filtros aplicados na tela.

Casos especiais

Configurar o módulo pela primeira vez

Antes de gerar links de aceite, vá em Contratos > Configurações para preencher os dados da empresa (razão social, CNPJ, endereço), enviar a logo e a assinatura digitalizada que aparecem no PDF. Depois, em Contratos > Templates, escolha ou personalize o modelo padrão usado pelas excursões.

Comprador com várias compras na mesma excursão

Quando o mesmo comprador faz duas ou mais reservas para a mesma excursão, o módulo consolida automaticamente em um único contrato por comprador. O valor exibido soma as orders distintas e os dependentes aparecem listados sob o titular, sem necessidade de gerar contratos separados.

Cancelamentos não aparecem

Reservas com status cancelado ou reembolsado não entram na listagem nem nas estatísticas. Se o passageiro foi cancelado por engano, reative a reserva para que o contrato volte a ser exibido.

Dependentes ficam sob o titular

Dependentes (passageiros com dependente_id preenchido) não geram uma linha própria - eles são cobertos pelo contrato do titular. Para ver os dependentes, abra Ver Contrato do titular.

Erros comuns e como resolver

• "Esta funcionalidade requer o módulo Contratos Digitais" - Causa: módulo contratos-digitais não está ativo no plano da sua empresa. Solução: entrar em contato com o suporte ou ativar o módulo na área de billing.
• "Nenhum contrato encontrado" - Causa: os filtros aplicados não retornam resultados ou ainda não existem passageiros titulares ativos. Solução: clicar em Limpar filtros na barra superior ou cadastrar uma reserva.
• Botão "Baixar PDF" não aparece no cartão - Causa: o passageiro ainda não aceitou o contrato (não há aceite_data). Solução: reenviar o link de aceite pelo painel da excursão até o passageiro assinar.

Onde encontrar

• URL: /admin/contratos
• Caminho no menu: Módulos > Contratos Digitais
• Permissão necessária: ver os contratos (gerenciar modelos exige gerenciar modelos de contrato)
• Módulo necessário: contratos-digitais

Veja também

• Templates de Contrato - biblioteca de modelos reutilizáveis.
• Configurar Template de Contrato - passo a passo para definir o modelo padrão da excursão.
• Gerar e Enviar Links - como disparar o aceite para o passageiro.
• Assinatura Digital - como o aceite eletrônico é registrado e sua validade jurídica.
• Variáveis Dinâmicas - placeholders disponíveis nos modelos.
• PDF e Cartão de Embarque - saída em PDF e geração do cartão.