> For the complete documentation index, see [llms.txt](https://academy.trowelapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.trowelapp.com/administracion/configuracion/plantillas.md).

# Plantillas

En **Administración / Configuración / Plantillas** puedes preparar textos reutilizables para **presupuestos**, **contratos** y **pedidos**. Así no escribes de cero la portada, la introducción o las condiciones en cada documento.

<figure><img src="https://963952606-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBUxUisD1XczEOsk8Fzt%2Fuploads%2Fgit-blob-f4c9216bbffd699af8dfbc05c5fda9631edeefd4%2Fconfig-plantillas-listado.png?alt=media" alt="Listado de plantillas en configuración"><figcaption><p>Configuración de plantillas.</p></figcaption></figure>

## Orden habitual de impresión (presupuesto)

1. Portada
2. Introducción
3. Partidas (presupuesto o contrato/pedido, según el caso)
4. Condiciones
5. *(Solo Diseño 2)* bloque de **Firmas**, si lo activas al exportar

## Contenidos de una plantilla de presupuesto

Al editar una plantilla de presupuesto verás pestañas según el tipo de contenido:

| Pestaña           | Para qué sirve                                          |
| ----------------- | ------------------------------------------------------- |
| **Portada**       | Primera página del PDF (presentación del documento).    |
| **Introducción**  | Texto previo al listado de partidas.                    |
| **Condiciones**   | Condiciones al final del documento.                     |
| **Encabezado**    | Franja superior de las páginas del cuerpo *(Diseño 2)*. |
| **Pie de página** | Franja inferior de las páginas *(Diseño 2)*.            |
| **Firmas**        | Espacio para firmas al final *(Diseño 2)*.              |

<figure><img src="https://963952606-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBUxUisD1XczEOsk8Fzt%2Fuploads%2Fgit-blob-da4f37dcff81bc5f7283c004de3848d91bc148ae%2Fconfig-plantillas-editor.png?alt=media" alt="Editor de plantilla con pestañas y palabras clave"><figcaption><p>Editando una plantilla: editor de texto y palabras clave a la derecha.</p></figcaption></figure>

{% hint style="info" %}
**Encabezado**, **Pie de página** y **Firmas** solo se personalizan si tu organización usa el **Diseño 2** de exportación PDF. Si usas Diseño 1, el PDF sigue el encabezado y pie estándar de ese diseño. Puedes cambiar el diseño en [Presupuesto (configuración)](/administracion/configuracion/presupuesto.md).
{% endhint %}

### Altura del encabezado y del pie

En encabezado y pie puedes indicar la **altura en milímetros** que debe reservar el PDF.

* Si hay **contenido** (texto o imágenes), se usa esa altura.
* Si dejas el contenido **vacío** (o solo espacios / párrafos en blanco), Trowel **no aplica** esa altura personalizada: vuelve al tamaño por defecto del Diseño 2.

Así evitas dejar un hueco en blanco grande cuando has borrado el texto de la plantilla.

### Copiar el diseño por defecto del encabezado

En la pestaña **Encabezado**, la barra del editor incluye el botón **Copiar diseño por defecto**.

Sirve para partir del mismo layout que usa el PDF cuando **no** personalizas el encabezado (tres columnas: datos del emisor, logo y datos del proyecto/cliente), pero ya con **palabras clave** editables.

<figure><img src="https://963952606-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBUxUisD1XczEOsk8Fzt%2Fuploads%2Fgit-blob-a846e1b5fcff0cd650479705e11f207bab0fc38d%2Fconfig-plantillas-encabezado-copiar-diseno.png?alt=media" alt="Botón Copiar diseño por defecto en la barra del editor de encabezado"><figcaption><p>Botón «Copiar diseño por defecto» en la pestaña Encabezado.</p></figcaption></figure>

* Si el editor está vacío, inserta el diseño de golpe.
* Si ya hay contenido, Trowel te pide confirmación antes de **reemplazarlo**.

Después puedes cambiar textos, quitar bloques o ajustar el tamaño del logo (ver más abajo) sin empezar de cero.

{% hint style="success" %}
El diseño copiado ya incluye un tamaño de logo razonable (`%logo:h=15%`). Si lo necesitas más grande o más pequeño, cambia solo el número de milímetros.
{% endhint %}

## Palabras clave

En el margen derecho del editor tienes **palabras clave** agrupadas (general, emisor, cliente, proyecto, contrato, políticas, etc.). Al insertarlas en el texto, el PDF las sustituye por los datos reales del proyecto, del cliente o de tu empresa.

Ejemplos frecuentes:

| Palabra clave                           | Qué imprime                                                                                  |
| --------------------------------------- | -------------------------------------------------------------------------------------------- |
| `%projectName%`                         | Nombre del proyecto                                                                          |
| `%projectCode%`                         | Código del proyecto                                                                          |
| `%client%` / `%clientBusinessName%`     | Cliente / razón social                                                                       |
| `%clientVatNumber%`                     | CIF/NIF del cliente                                                                          |
| `%clientRepresentativeName%`            | Nombre del representante de la sociedad (ficha de la empresa)                                |
| `%clientRepresentativeDocumentNumber%`  | DNI del representante                                                                        |
| `%issuerName%`, `%issuerVatNumber%`, …  | Datos fiscales del emisor                                                                    |
| `%budgetHeaderData%`                    | Texto libre de «Cabecera de presupuesto» (configuración del tenant)                          |
| `%logo%`, `%alt-logo%`, `%client-logo%` | Logos (empresa / alternativo / cliente). Ver tamaño más abajo                                |
| `%contractualSalesBudget%`              | Total de ejecución del presupuesto en la exportación (mismo criterio que el resumen del PDF) |
| `%currentDate%` / `%exportDate%`        | Fecha en formato largo / corto                                                               |

{% hint style="success" %}
Los datos del **representante de la sociedad** (nombre y DNI) se mantienen en la [ficha de la empresa](/administracion/empresas/creacion.md). Una vez rellenados, las palabras clave correspondientes los llevan a contratos y presupuestos sin copiarlos a mano.
{% endhint %}

### Tamaño del logo (y otras imágenes por palabra clave)

Las palabras `%logo%`, `%alt-logo%` y `%client-logo%` insertan la imagen en el PDF. Por defecto, la altura máxima coincide con la **altura reservada** del encabezado o del pie (o un valor razonable en portada / otros textos).

Si quieres **limitar** altura y/o anchura, añade el tamaño en **milímetros** dentro de la propia palabra clave:

| Qué quieres         | Ejemplo            | Resultado                                      |
| ------------------- | ------------------ | ---------------------------------------------- |
| Solo altura máxima  | `%logo:h=15%`      | El logo no supera 15 mm de alto                |
| Solo anchura máxima | `%logo:w=40%`      | El logo no supera 40 mm de ancho               |
| Altura y anchura    | `%logo:h=15,w=40%` | Respeta ambos máximos (mantiene la proporción) |

También vale con el logo alternativo o el del cliente: `%alt-logo:h=20%`, `%client-logo:w=35%`, etc.

**Cómo insertarlo sin memorizar la sintaxis**

1. En el panel de **Palabras clave**, localiza Logo / Logo alternativo / Logo cliente.
2. Debajo verás chips de **Tamaño (mm)** (`:h=15`, `:w=40`, `:h=15,w=40`).
3. Pulsa el chip: se copia la palabra completa (por ejemplo `%logo:h=15%`) y la pegas en el editor.

<figure><img src="https://963952606-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBUxUisD1XczEOsk8Fzt%2Fuploads%2Fgit-blob-668b59b709b0920de55e08b13d06cb84d026dd9d%2Fconfig-plantillas-logo-tamano-chips.png?alt=media" alt="Chips de Tamaño (mm) bajo la palabra clave del logo"><figcaption><p>Chips «Tamaño (mm)» bajo la palabra clave del logo.</p></figcaption></figure>

{% hint style="info" %}

* Los números van en **milímetros** (puedes escribir `15` o `15mm`).
* Si no pones tamaño, se mantiene el comportamiento anterior (tope = altura de la franja).
* Valores inválidos o a cero se ignoran: el PDF sigue generándose con el tamaño por defecto.
* La imagen **no se estira**: se reduce para caber en los máximos y conserva la proporción.
  {% endhint %}

## Cómo se usan en un proyecto

1. Crea o edita la plantilla aquí.
2. En el presupuesto del proyecto, abre **Acciones / Introducción y condiciones** (o el diseño de plantillas del presupuesto).
3. Elige la **plantilla a aplicar** en la pestaña deseada. Después puedes seguir editando el texto del proyecto sin cambiar la plantilla maestra.

En el diseño del propio presupuesto (Encabezado con Diseño 2) también tienes **Copiar diseño por defecto** y los chips de tamaño del logo, con el mismo comportamiento.

Más detalle: [Portada, introducción y condiciones](/presupuestos/exportacion/pdf/portada-introduccion-y-condiciones.md).