Contratos - Modelo do Contrato da Viagem

O que é

Esta página reúne duas telas ligadas ao texto do contrato de uma excursão específica. A primeira, Template do Contrato, é onde você escolhe um modelo pronto ou escreve o texto que vai ser usado no contrato desta viagem, com um editor completo e uma lista de placeholders que puxam dados reais do cliente, da viagem e da sua empresa. A segunda, Snapshot do Contrato, é somente leitura e mostra o texto exato que um passageiro aceitou em uma versão específica do contrato, mesmo que o modelo tenha mudado depois.

Você chega ao editor de modelo clicando em Editar Template na página de Contratos da Excursão. Já o snapshot de uma versão é aberto a partir do Histórico de Versões, dentro da página de detalhes do contrato de um passageiro específico, quando você quer conferir o que exatamente foi assinado em uma data anterior (por exemplo, depois de uma reclamação ou de uma auditoria).

Como usar

Editar o modelo do contrato desta viagem

1. Na página de Contratos da excursão, clique em Editar Template no cabeçalho.
2. O editor abre com o texto atual do contrato desta viagem. Use a barra de ferramentas para formatar (negrito, itálico, cor, listas, tabelas).
3. No painel Placeholders, à direita, clique em qualquer variável (como {{cliente_nome}} ou {{excursao_data}}) para inseri-la na posição do cursor do editor. Os grupos (Empresa, Cliente, Excursão, Financeiro etc.) podem ser expandidos e recolhidos clicando no cabeçalho de cada um.
4. Para partir de um modelo pronto em vez de escrever do zero, clique em Modelos. A janela mostra os modelos padrão do sistema (Simples, Completo, Turismo Completo, Aventura, Religioso, Minimalista) e, logo abaixo, Seus Modelos Salvos - os modelos que a sua empresa já criou na biblioteca de modelos. Clique em qualquer card para carregar o texto no editor.
5. Use Preview para ver como o texto fica formatado com dados fictícios, ou PDF para abrir, em uma nova aba, o PDF de exemplo gerado com o texto atual do editor.
6. Clique em Dados para consultar quais valores fictícios foram usados no preview, agrupados por categoria (Cliente, Excursão, Financeiro etc.).
7. Ao terminar, clique em Salvar no início da barra de ferramentas.

Consultar uma versão já assinada por um passageiro

1. Na página de Contratos da excursão, abra o contrato do passageiro pelo dropdown de ações da linha dele.
2. Role até Histórico de Versões. Cada item mostra o número da versão, a data e o nome de quem aceitou, e se ela está Atual (verde) ou Invalidado (vermelho, com o motivo da invalidação).
3. Clique em Ver snapshot desta versão para abrir a página somente leitura com os dados do aceite (status, data, nome, CPF, IP), a lista de passageiros do grupo no momento daquele aceite e o texto completo do contrato como ele estava naquele dia.

O que você precisa saber antes

• Contrato já assinado é imutável. Depois que um passageiro aceita (ou assina eletronicamente) o contrato, o texto fica congelado. Editar o modelo desta viagem, mudar o valor da reserva ou trocar qualquer dado da excursão não altera o que aquele passageiro já assinou: o PDF baixado e a tela de detalhes continuam mostrando exatamente o texto do dia do aceite, não o modelo atual.

• Editar o modelo muda, na hora, o que os passageiros pendentes ainda vão ver e assinar - mas só quando você não usa o módulo de Assinatura Eletrônica. Nesse sistema tradicional, o contrato é montado a partir do modelo atual toda vez que a página é aberta, então salvar uma edição aqui já vale para o próximo passageiro que abrir o link de aceite.

• Com Assinatura Eletrônica ativa, o link já enviado também fica congelado. Assim que a solicitação de assinatura nasce, o sistema gera um PDF fixo que é o que o cliente vê no link - editar o modelo depois disso não muda esse PDF. Para um passageiro que ainda não assinou, refaça o contrato pela ação Refazer contrato, no dropdown de ações da linha dele na lista de Contratos da excursão: isso descarta a solicitação pendente, gera outra com o modelo e os dados atuais e invalida o link anterior (você precisa reenviar o novo link ao cliente). Essa ação não aparece para contrato já assinado - nesse caso o caminho é Invalidar assinatura, que pede uma assinatura nova ao cliente.

• Entrar alguém novo no grupo desrespeita um contrato já assinado. Quando um comprador principal já assinou e depois você adiciona um dependente, troca o cliente vinculado a uma vaga, transfere um passageiro de excursão ou promove outro titular no mesmo grupo, o sistema invalida automaticamente o aceite anterior do titular (e dos dependentes do mesmo grupo). O contrato volta para pendente e a pessoa precisa assinar de novo, mesmo já tendo assinado antes.

• Se você salvar o editor vazio, o modelo não some. O texto que aparece quando você abre esta tela pela primeira vez vem, nesta ordem de prioridade: (1) o texto já editado e salvo especificamente para esta viagem; (2) o modelo que foi vinculado a esta viagem quando ela nasceu; (3) o modelo marcado como padrão da sua empresa; (4) um modelo padrão do próprio sistema, como último recurso. Salvar o campo vazio devolve a vez para o modelo herdado (item 2), não apaga o contrato da viagem.

Casos especiais

Substituir o texto por um modelo pronto

Se o editor já tiver mais de 50 caracteres de conteúdo, clicar em um card dentro da janela Modelos pede confirmação antes de substituir, avisando que "esta ação não pode ser desfeita". Isso vale só dentro do editor: nada é gravado até você clicar em Salvar, então ainda dá para sair sem salvar se mudar de ideia depois de trocar o modelo.

Restaurar o template padrão

O botão Restaurar, também com confirmação, substitui o conteúdo do editor pelo modelo padrão do sistema (o mesmo usado como último recurso na ordem de prioridade acima). Como qualquer edição no editor, só passa a valer de fato depois de Salvar.

Versão sem snapshot de texto (aceites antigos)

Aceites feitos antes do sistema de versionamento existir não têm um registro de snapshot completo. Nesse caso, o contrato exibido nas telas de visualização e no PDF é montado a partir do modelo atual, e não de uma cópia congelada, porque não existe o que congelar para essas versões.

Erros comuns e como resolver

• Editor perde a formatação ao trocar de tema claro/escuro - Causa: reinicialização do editor de texto ao detectar mudança de tema. Solução: o próprio sistema preserva o conteúdo digitado ao reinicializar; se algo parecer perdido, aguarde o editor recarregar antes de continuar editando.
• "Não foi possível gerar a nova versão do contrato." - Causa: falha ao gerar a nova solicitação de assinatura eletrônica ao tentar refazer o contrato de um passageiro. Solução: a solicitação anterior é mantida automaticamente nesse caso (nada se perde); tente novamente em alguns minutos.
• "Este contrato já foi assinado." - Causa: você tentou refazer um contrato que já está assinado. Solução: use Invalidar assinatura em vez de Refazer contrato - só ela pede um novo aceite para contrato já concluído.
• Página do snapshot retorna erro 404 - Causa: o número de versão na URL não existe para aquele passageiro, ou o passageiro informado não pertence a esta excursão. Solução: volte à página de detalhes do contrato e abra o snapshot pelo link Ver snapshot desta versão, no Histórico de Versões.

Onde encontrar

• URL do editor de modelo: /admin/excursoes/{excursao}/contratos/template
• URL do snapshot de versão: /admin/excursoes/{excursao}/contratos/{passageiro}/versao/{versao}
• Caminho no menu: Excursões > (abrir excursão) > Contratos > Editar Template
• Permissão necessária: editar as viagens (o snapshot de versão pede apenas ver as viagens)
• Módulo necessário: Contratos Digitais

Veja também

• Contratos da Excursão
• Modelos de Contrato
• Editor de Modelo de Contrato
• Variáveis Dinâmicas
• Assinatura Digital