## Visão geral

A área de **Configurações de Contratos** concentra dois grupos de ajustes da conta: os **padrões do
módulo** — valores aplicados aos novos contratos (nível de assinatura, idioma, validade do link,
retenção e região) — e a **identidade visual** dos documentos, definida no **designer de tema**.
No mesmo lugar você carrega o **certificado A1 da conta** (para a assinatura qualificada) e o **logo
do cabeçalho** dos contratos.

As configurações são **únicas por conta** (um conjunto por conta): o que você define aqui vira o
padrão para todos os contratos, e cada contrato pode ajustar pontos específicos caso a caso.

## Pré-requisitos

- Módulo de Contratos **habilitado** para a conta.
- Para **editar** as configurações, é preciso ter **permissão de administrador**. Agentes têm acesso
  somente de **leitura** (podem visualizar, mas não alterar).
- Para usar o nível **qualificado**, tenha um **certificado A1** (`.pfx`/`.p12`) vigente e a sua
  **senha** — na conta e/ou na empresa emissora.
- Para o **logo**, um arquivo **PNG ou JPEG** (são os formatos renderizados no PDF).

## Passo a passo

1. Em **Contratos**, abra a seção de **Configurações**.
2. Ajuste os **padrões do módulo** (nível de assinatura, idioma, validade do link, retenção, região
   e política de lembretes).
3. (Opcional) Carregue o **certificado A1 da conta** para habilitar a assinatura qualificada por
   padrão.
4. Defina a **identidade visual**: faça o **upload do logo do cabeçalho** ou **reutilize** um logo já
   existente (de uma empresa emissora ou da Biblioteca de Mídia).
5. Abra o **designer de tema** e ajuste cores, fontes, página, rodapé e assinaturas.
6. Use a **pré-visualização ao vivo**: a plataforma gera um **PDF de amostra** com o tema atual, sem
   salvar nada.
7. **Salve**. Os ajustes passam a valer para os próximos contratos.

## Configurações & opções

### Padrões do módulo

| Configuração | O que faz | Padrão |
|---|---|---|
| **Nível de assinatura padrão** | Nível aplicado a novos contratos: simples, avançado (com OTP) ou qualificado (A1). | Simples |
| **Idioma padrão** | Idioma do documento gerado. | Inglês |
| **Validade padrão do link** | Dias até o link de assinatura expirar. | 30 dias |
| **Retenção de documentos** | Por quantos anos os documentos assinados ficam guardados. | 5 anos |
| **Região / marco legal** | Região que define o enquadramento legal e a retenção aplicada. | BR |
| **Política de lembretes** | Habilita lembretes automáticos para signatários pendentes e, opcionalmente, vincula uma sequência de follow-up. | Habilitada |

Esses são apenas os **valores padrão**: a plataforma parte das configurações de código e aplica por
cima o que você definiu na conta. Ao gerar um contrato, você ainda pode ajustar o nível e os demais
pontos individualmente.

### Certificado A1 da conta

Para a assinatura **qualificada** (ICP-Brasil), é necessário um **certificado digital A1** — um
arquivo `.pfx`/`.p12` protegido por senha. Você pode carregar um **certificado A1 na conta**, que
funciona como **padrão** para a operação. Cada **empresa emissora** também pode ter o **seu próprio
A1**, que prevalece nos contratos emitidos por ela.

- O certificado é um dado **sensível**: é guardado de forma protegida e nunca é exibido de volta em
  tela.
- O certificado **A3** (token/cartão em hardware) **não** é suportado nesta versão — apenas o A1
  (arquivo).

### Identidade visual e logo do cabeçalho

O logo que aparece no cabeçalho do contrato segue uma **cascata**, de cima para baixo:

1. **Logo da empresa emissora** (se a empresa do contrato tiver um logo próprio).
2. **Logo padrão da conta** (o que você define aqui nas Configurações).
3. **Logo do tema** (uma URL externa de logo configurada no designer de tema).

O **logo padrão da conta** pode ser enviado por **upload** (arquivo) ou **reutilizado** a partir de
um logo já existente — por exemplo, o logo de uma empresa emissora ou um arquivo da **Biblioteca de
Mídia** — sem precisar reenviar os bytes. Ao **remover** o logo da conta, o cabeçalho volta a usar o
logo da empresa ou a URL do tema. O logo é mantido **separado** do tema em JSON.

### Designer de tema do documento

O **designer de tema** controla toda a aparência do PDF. O tema efetivo é resolvido como uma
**cascata**: padrão do sistema ← **conta** ← **empresa emissora** ← **template** ← ajustes não
salvos do designer. Quando um contrato é **enviado**, o tema é **congelado** no documento, de modo
que um contrato já assinado nunca muda de aparência depois.

Você ajusta, entre outros:

- **Cabeçalho**: posição do logo e exibir/ocultar nome, documento (CNPJ/CPF) e endereço da empresa.
- **Marca e cores**: cor primária, secundária, de destaque, de títulos e de texto; **fonte**
  (Helvetica, Times ou Courier) e tamanhos do corpo e do título.
- **Página**: tamanho (A4 ou Carta), orientação, margens, borda e marca d'água.
- **Rodapé**: numeração de página (posição e formato) e aviso legal.
- **Assinaturas**: layout, ordem dos papéis, exibir testemunhas e mostrar o selo A1.

A **pré-visualização ao vivo** renderiza um **PDF de amostra** (com empresa de exemplo, cláusulas
estilizadas, tabela de itens e um conjunto completo de assinaturas) **sem salvar** nada. Se você
indicar uma empresa e/ou um template, o preview reflete a cascata completa, exatamente como sairia
em um envio real. Se a geração falhar, o preview degrada para um aviso de uma página — ele **nunca**
deixa de responder.

## Casos de uso

- **Padronizar o visual** de todos os contratos com a sua marca (cores, fonte e logo).
- Habilitar o nível **qualificado por padrão** em uma operação que sempre exige A1.
- Ajustar a **validade do link** e a **política de lembretes** para acelerar o fechamento.
- Manter **logos diferentes por empresa emissora**, com o logo da conta como **fallback**.

## Dicas, limites e boas práticas

- Mantenha o **certificado A1 vigente** — um certificado expirado impede novas assinaturas
  qualificadas.
- **Confira a aparência no preview antes de enviar**: o tema de um contrato enviado fica **congelado**
  e não muda depois.
- Use **cores em hexadecimal** e mantenha a fonte entre **Helvetica, Times ou Courier** (sempre
  seguras no PDF). Logos em **PNG ou JPEG**.
- **Apenas administradores** alteram estas configurações; agentes têm acesso somente de leitura.

## Solução de problemas

- **Não consigo editar as configurações**: você precisa de **permissão de administrador**; agentes
  só visualizam.
- **A pré-visualização aparece como um aviso de "indisponível"**: a geração da amostra falhou; tente
  novamente e revise os ajustes do tema.
- **O logo não aparece no contrato**: confira a **cascata** (empresa → conta → URL do tema) e use um
  arquivo **PNG/JPEG** válido.
- **A assinatura qualificada está indisponível**: confirme que há um **A1 válido** na conta ou na
  empresa emissora selecionada.

## Veja também

- [Visão geral de Contratos e Assinatura Eletrônica](/hc/ajuda/articles/contracts-esignature-overview-pt-br)
- [Empresas emissoras e certificado digital A1](/hc/ajuda/articles/contracts-esignature-empresas-emissoras-certificado-a1-pt-br)
- [Templates, variáveis e auto-preenchimento](/hc/ajuda/articles/contracts-esignature-templates-variaveis-auto-fill-pt-br)
- [Assinatura interna e externa](/hc/ajuda/articles/contracts-esignature-assinatura-interna-externa-pt-br)
- [Página pública do contrato e validador](/hc/ajuda/articles/contracts-esignature-pagina-publica-e-validador-pt-br)