# Plantillas y marcadores

Marca dónde firma, pone iniciales, fecha o completa un campo cada firmante escribiendo marcadores [[esign:…]] en tu PDF.

No colocas las casillas de firma a mano. Escribe un **marcador** en el documento donde va un campo, por ejemplo
`[[esign:sign]]`, y eSign pone el campo ahí al enviarlo. Los marcadores funcionan en cualquier PDF con texto real (no
una imagen escaneada): plantillas PDF de EspoCRM, o PDF de Word o de cualquier otra herramienta. No se aceptan
archivos de Word: guárdalos antes como PDF.

## Dónde queda el campo

El campo empieza en el borde izquierdo del marcador y se apoya en su línea base: pon el marcador justo donde empieza la
línea de la firma.

En las plantillas PDF de EspoCRM, escribe los marcadores como texto blanco diminuto para que no se vean:

```html
<span style="color:#ffffff;font-size:2px;">[[esign:sign]]</span>
```

Los marcadores en texto de tamaño normal (4 pt o más) se tapan al enviar el documento, así que tampoco se ven.

## Los marcadores

| Marcador | Campo | Quién lo completa | Tamaño por defecto (puntos) |
|---|---|---|---|
| `[[esign:sign]]` o `[[esign:signature]]` | Firma | El firmante (obligatorio) | 170 × 30 |
| `[[esign:initials]]` | Iniciales | El firmante (obligatorio) | 60 × 26 |
| `[[esign:date]]` | Fecha de firma | Se completa al firmar | 110 × 16 |
| `[[esign:name]]` | Nombre del firmante | Se completa solo | 150 × 16 |
| `[[esign:email]]` | Correo del firmante | Se completa solo | 180 × 16 |
| `[[esign:text]]`, `[[esign:text:Telefono]]` | Texto, con etiqueta opcional | El firmante (obligatorio) | 140 × 16 |
| `[[esign:title]]` | Texto con la etiqueta "Title" (cargo) | El firmante (obligatorio) | 140 × 16 |
| `[[esign:company]]` | Texto con la etiqueta "Company" (empresa) | El firmante (obligatorio) | 140 × 16 |
| `[[esign:check:Acepto]]` o `[[esign:checkbox:Acepto]]` | Casilla, con etiqueta | El firmante (opcional) | 14 × 14 |

Cada firmante necesita al menos un `[[esign:sign]]`.

## Cómo se escribe un marcador

```text
[[esign:tipo:Etiqueta@N|w=ANCHO|h=ALTO]]
```

- **Sin espacios** en ningún lugar del marcador. En las etiquetas, escribe `_` en lugar de un espacio:
  `[[esign:check:Estoy_de_acuerdo]]` muestra "Estoy de acuerdo".
- `:Etiqueta` (opcional) da nombre a un campo de texto o a una casilla.
- `@N` (opcional) es para el firmante número N, contando a los firmantes en el orden en que se indican; sin él, el
  campo es del primer firmante. Ejemplo: `[[esign:sign@2]]`.
- `|w=` y `|h=` (opcionales) cambian el tamaño en puntos. El ancho va de 10 a 600 y el alto de 8 a 200; los campos
  siempre miden al menos 40 puntos de ancho y se mantienen lejos del borde derecho de la página.
- Respeta el orden: etiqueta, luego `@N`, luego los tamaños. Da igual usar mayúsculas o minúsculas.

### Ejemplos

| Marcador | Significa |
|---|---|
| `[[esign:sign]]` | El firmante 1 firma aquí. |
| `[[esign:sign@2\|w=120\|h=24]]` | El firmante 2 firma aquí, en una casilla de 120 × 24. |
| `[[esign:initials@2]]` | El firmante 2 pone sus iniciales aquí. |
| `[[esign:text:Telefono\|h=20]]` | El firmante 1 escribe un teléfono. |
| `[[esign:title\|w=100]]` | El firmante 1 escribe su cargo. |
| `[[esign:check:Acepto]]` | Una casilla opcional "Acepto". |

> [!NOTE]
> Los nombres de los marcadores (`sign`, `initials`, `text`…) se escriben siempre en inglés. Las etiquetas pueden ir
> en tu idioma, sin acentos ni espacios.

## Fechas

La fecha de firma se escribe como mes/día/año en inglés y como día/mes/año en español, según el idioma del documento.

## Cuando un documento no se puede enviar

eSign revisa los marcadores antes de enviar y explica qué falta (los mensajes están en inglés):

- *This document has no signature markers ([[esign:sign]])…*: el documento no tiene marcadores de firma. Si es una
  propuesta u otro documento que no se firma, usa Imprimir a PDF.
- *The PDF has a marker for signer 2, but only 1 signer(s) were given.*: hay un marcador para el firmante 2, pero
  solo se indicó un firmante.
- *Signer "…" has no [[esign:sign]] marker in the PDF.*: a ese firmante le falta su marcador de firma.

> [!TIP]
> En EspoCRM, las plantillas también pueden incluir `{{esign.sender.name}}`, `{{esign.signer.name}}` y la fecha de
> hoy; consulta [La app de EspoCRM](https://docs.sapiensandmachines.com/es/esign/app-de-espocrm#valores-para-las-plantillas).

## Cómo queda el PDF firmado

Cada firma se coloca a la izquierda de su casilla, con "Signed electronically by NOMBRE" (o "Initialed by NOMBRE") en
letra pequeña encima. La última página es un **certificado de finalización** con la huella del documento y el
historial de cada firmante (consulta [Lo que ven los firmantes](https://docs.sapiensandmachines.com/es/esign/experiencia-del-firmante#la-copia-firmada)).