Contratos Digitais - Configurações

O que é

A página Configurações do Contrato centraliza os padrões usados pelo módulo Contratos Digitais. Tudo o que é definido aqui passa a valer como valor inicial para as próximas excursões criadas: se o modelo padrão ou a exigência de contrato mudarem, apenas excursões novas herdam os novos padrões (excursões já cadastradas mantêm a configuração que tinham no momento da criação).

O administrador normalmente chega nesta tela em dois momentos: ao ativar o módulo pela primeira vez, para deixar logo, assinatura e modelo padrão prontos antes de cadastrar excursões; e quando precisa ajustar identidade visual do contrato (logo, cor primária, rodapé legal) sem mexer no conteúdo de cada modelo.

Como usar

1. Vá em Contratos Digitais > Configurações no sidebar.
2. No card Configurações Padrão, defina os automatismos:
   • Exigir contrato por padrão - quando ativo, novas excursões nascem com contrato digital obrigatório (o passageiro precisa aceitar para concluir a compra).
   • Modelo de contrato padrão - selecione um item da lista (apenas templates ativos aparecem). Se deixar em Usar modelo marcado como padrão, o sistema usa o template que estiver com a flag de padrão na tela de Modelos.
3. No card Logo do Contrato:
   • Ative Usar logo do sistema para reaproveitar a logo da Identidade Visual. O preview da logo atual aparece logo abaixo do toggle.
   • Desative o toggle para fazer upload de uma logo exclusiva dos contratos (campo Logo para Contratos, formatos PNG/JPG/JPEG/WEBP até 5 MB).
   • Ajuste Altura da logo no contrato no slider (30px a 150px). O valor escolhido aparece em tempo real ao lado do rótulo.
4. No card Assinatura/Carimbo da Empresa, faça upload da imagem (PNG recomendado, com fundo transparente). Para inserir essa imagem em um modelo, use o placeholder {{empresa_assinatura}} no editor do template.
5. No card Rodapé do Contrato:
   • Ative Habilitar rodapé customizado para abrir o editor TinyMCE.
   • Escreva o texto (negrito, itálico, sublinhado, alinhamento e listas disponíveis). Uma sugestão pronta com a Lei 14.063/2020 fica logo abaixo do editor.
   • Para que o rodapé apareça no documento, o template precisa conter o placeholder {{contrato_rodape}}.
6. No card Opções Visuais:
   • Defina a Cor primária do contrato (usada em cabeçalhos, linhas e títulos). O botão Restaurar padrão volta para #1a1a2e.
   • Ative Mostrar QR Code no contrato para incluir um QR Code de validação ao final do documento.
7. Clique em Salvar na barra de ações fixa do rodapé.

Casos especiais

empresa sem logo cadastrada na Identidade Visual

Se você ativar Usar logo do sistema mas você ainda não tem logo, um aviso amarelo aparece com link direto para a tela de Identidade Visual. Cadastre a logo lá antes de salvar, ou desative o toggle para fazer upload exclusivo do contrato.

Trocar logo ou assinatura

Ao salvar um arquivo novo, o sistema apaga automaticamente o arquivo antigo do disco. Se quiser apenas remover a assinatura sem subir outra, use o botão de remoção do componente de upload (endpoint DELETE /admin/contratos/configuracoes/assinatura).

Sobrescrita por excursão

As configurações desta página são valores padrão para criação. Cada excursão tem seu próprio campo de modelo e flag de obrigatoriedade, que podem ser ajustados na edição da excursão sem afetar as demais.

Assinatura desenhada à mão (canvas)

O upload de assinatura aceita também o formato base64 vindo de canvas (quando o template estiver configurado para coleta digital). O sistema detecta o formato automaticamente e salva como PNG.

Erros comuns e como resolver

• "Nenhuma logo configurada no sistema" - Causa: toggle "Usar logo do sistema" ativo mas você não tem logo cadastrada. Solução: acessar Identidade Visual e cadastrar, ou desativar o toggle para subir logo exclusiva.
• Logo cortada/distorcida no contrato gerado - Causa: altura configurada incompatível com o arquivo enviado. Solução: ajustar o slider de altura entre 30px e 150px ou enviar uma imagem com proporção mais próxima a 3:1 (largura:altura).
• Rodapé não aparece no PDF - Causa: o template do contrato não tem o placeholder {{contrato_rodape}} ou o toggle de rodapé está desligado. Solução: ativar o toggle e editar o modelo em Modelos ou Editar Template para inserir o placeholder.
• Assinatura da empresa não aparece - Causa: o template não usa {{empresa_assinatura}}. Solução: editar o template e inserir o placeholder no local desejado.
• "Dados de imagem inválidos." - Causa: falha ao decodificar base64 da assinatura desenhada. Solução: redesenhar a assinatura ou usar o upload de arquivo padrão.

Onde encontrar

• URL: /admin/contratos/configuracoes
• Caminho no menu: Contratos Digitais > Configurações
• Permissão necessária: ver os contratos
• Módulo necessário: contratos-digitais

Veja também

• Templates de Contrato
• Configurar Template de Contrato
• Variáveis Dinâmicas
• Assinatura Digital
• Contratos Digitais - Módulo Adicional