## Visión general

El área de **Configuración de Contratos** reúne dos grupos de ajustes de la cuenta: los **valores
predeterminados del módulo** — aplicados a los contratos nuevos (nivel de firma, idioma, validez del
enlace, retención y región) — y la **identidad visual** de tus documentos, definida en el
**diseñador de tema**. En el mismo lugar cargas el **certificado A1 de la cuenta** (para la firma
cualificada) y el **logo del encabezado** de los contratos.

La configuración es **única por cuenta** (un conjunto por cuenta): lo que defines aquí se vuelve el
valor predeterminado de todos los contratos, y cada contrato aún puede ajustar puntos específicos
caso por caso.

## Requisitos previos

- El módulo de Contratos **habilitado** para la cuenta.
- Para **editar** la configuración necesitas **permiso de administrador**. Los agentes tienen acceso
  de **solo lectura** (pueden ver, pero no cambiar).
- Para usar el nivel **cualificado**, ten un **certificado A1** (`.pfx`/`.p12`) vigente y su
  **contraseña** — en la cuenta y/o en la empresa emisora.
- Para el **logo**, un archivo **PNG o JPEG** (son los formatos que se renderizan en el PDF).

## Paso a paso

1. En **Contratos**, abre la sección de **Configuración**.
2. Ajusta los **valores predeterminados del módulo** (nivel de firma, idioma, validez del enlace,
   retención, región y política de recordatorios).
3. (Opcional) Carga el **certificado A1 de la cuenta** para habilitar la firma cualificada por
   defecto.
4. Define la **identidad visual**: **sube el logo del encabezado** o **reutiliza** un logo existente
   (de una empresa emisora o de la Biblioteca de Medios).
5. Abre el **diseñador de tema** y ajusta colores, fuentes, página, pie de página y firmas.
6. Usa la **vista previa en vivo**: la plataforma genera un **PDF de muestra** con el tema actual,
   sin guardar nada.
7. **Guarda**. Los ajustes pasan a aplicarse a los próximos contratos.

## Configuración y opciones

### Valores predeterminados del módulo

| Configuración | Qué hace | Predeterminado |
|---|---|---|
| **Nivel de firma predeterminado** | Nivel aplicado a los contratos nuevos: simple, avanzado (con OTP) o cualificado (A1). | Simple |
| **Idioma predeterminado** | Idioma del documento generado. | Inglés |
| **Validez predeterminada del enlace** | Días hasta que el enlace de firma caduca. | 30 días |
| **Retención de documentos** | Cuántos años se conservan los documentos firmados. | 5 años |
| **Región / marco legal** | Región que define el marco legal y la retención aplicada. | BR |
| **Política de recordatorios** | Habilita recordatorios automáticos para firmantes pendientes y, opcionalmente, vincula una secuencia de seguimiento. | Habilitada |

Estos son solo los **valores predeterminados**: la plataforma parte de la configuración de código y
aplica encima lo que definiste en la cuenta. Al generar un contrato, aún puedes ajustar el nivel y
los demás puntos individualmente.

### Certificado A1 de la cuenta

Para la firma **cualificada** (ICP-Brasil) se necesita un **certificado digital A1** — un archivo
`.pfx`/`.p12` protegido por contraseña. Puedes cargar un **certificado A1 en la cuenta**, que
funciona como **valor predeterminado** para la operación. Cada **empresa emisora** también puede
tener **su propio A1**, que prevalece para los contratos que ella emite.

- El certificado es un dato **sensible**: se almacena de forma protegida y nunca se muestra de vuelta
  en pantalla.
- El certificado **A3** (token/tarjeta en hardware) **no** es compatible en esta versión — solo el
  A1 (un archivo).

### Identidad visual y logo del encabezado

El logo que aparece en el encabezado del contrato sigue una **cascada**, de arriba hacia abajo:

1. **Logo de la empresa emisora** (si la empresa del contrato tiene su propio logo).
2. **Logo predeterminado de la cuenta** (el que defines aquí en Configuración).
3. **Logo del tema** (una URL externa de logo configurada en el diseñador de tema).

El **logo predeterminado de la cuenta** se puede agregar por **carga** (un archivo) o **reutilizar**
desde un logo existente — por ejemplo el logo de una empresa emisora o un archivo de la **Biblioteca
de Medios** — sin volver a subir los bytes. Al **quitar** el logo de la cuenta, el encabezado vuelve
a usar el logo de la empresa o la URL del tema. El logo se mantiene **separado** del tema en JSON.

### Diseñador de tema del documento

El **diseñador de tema** controla toda la apariencia del PDF. El tema efectivo se resuelve como una
**cascada**: predeterminado del sistema ← **cuenta** ← **empresa emisora** ← **plantilla** ← ajustes
no guardados del diseñador. Cuando un contrato se **envía**, el tema se **congela** en el documento,
de modo que un contrato firmado nunca cambia de apariencia después.

Entre otros, ajustas:

- **Encabezado**: posición del logo y mostrar/ocultar el nombre, el documento (CNPJ/CPF) y la
  dirección de la empresa.
- **Marca y colores**: color primario, secundario, de acento, de títulos y de texto; **fuente**
  (Helvetica, Times o Courier) y los tamaños del cuerpo y del título.
- **Página**: tamaño (A4 o Carta), orientación, márgenes, borde y marca de agua.
- **Pie de página**: numeración de página (posición y formato) y aviso legal.
- **Firmas**: diseño, orden de los roles, mostrar testigos y mostrar el sello A1.

La **vista previa en vivo** renderiza un **PDF de muestra** (con empresa de ejemplo, cláusulas con
estilo, una tabla de ítems y un conjunto completo de firmas) **sin guardar** nada. Si indicas una
empresa y/o una plantilla, la vista previa refleja la cascada completa, tal como saldría en un envío
real. Si la generación falla, la vista previa degrada a un aviso de una página — **nunca** deja de
responder.

## Casos de uso

- **Estandarizar la apariencia** de todos los contratos con tu marca (colores, fuente y logo).
- Habilitar el nivel **cualificado por defecto** en una operación que siempre exige A1.
- Ajustar la **validez del enlace** y la **política de recordatorios** para acelerar el cierre.
- Mantener **logos distintos por empresa emisora**, con el logo de la cuenta como **respaldo**.

## Consejos, límites y buenas prácticas

- Mantén el **certificado A1 vigente** — un certificado caducado impide nuevas firmas cualificadas.
- **Revisa la apariencia en la vista previa antes de enviar**: el tema de un contrato enviado queda
  **congelado** y no cambia después.
- Usa **colores en hexadecimal** y mantén la fuente entre **Helvetica, Times o Courier** (siempre
  seguras en el PDF). Logos en **PNG o JPEG**.
- **Solo los administradores** cambian esta configuración; los agentes tienen acceso de solo lectura.

## Solución de problemas

- **No puedo editar la configuración**: necesitas **permiso de administrador**; los agentes solo
  visualizan.
- **La vista previa aparece como un aviso de "no disponible"**: la generación de la muestra falló;
  inténtalo de nuevo y revisa los ajustes del tema.
- **El logo no aparece en el contrato**: revisa la **cascada** (empresa → cuenta → URL del tema) y
  usa un archivo **PNG/JPEG** válido.
- **La firma cualificada no está disponible**: confirma que haya un **A1 válido** en la cuenta o en
  la empresa emisora seleccionada.

## Ver también

- [Visión general de Contratos y Firma Electrónica](/hc/ajuda/articles/contracts-esignature-overview-es)
- [Empresas emisoras y certificado digital A1](/hc/ajuda/articles/contracts-esignature-empresas-emissoras-certificado-a1-es)
- [Plantillas, variables y autocompletado](/hc/ajuda/articles/contracts-esignature-templates-variaveis-auto-fill-es)
- [Firma interna y externa](/hc/ajuda/articles/contracts-esignature-assinatura-interna-externa-es)
- [Página pública del contrato y validador](/hc/ajuda/articles/contracts-esignature-pagina-publica-e-validador-es)