> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualizar un Template

> Actualiza el nombre, el formato de salida o reemplaza el archivo .tpl subido de un Template directamente desde la interfaz de Lerian Console.

Usa esta página cuando un Template deba seguir disponible, pero haya que cambiar algo de su nombre, formato de salida, diseño o archivo fuente.

## Objetivo

***

Actualizar el Template reutilizable que usarán los futuros Reports.

Por ejemplo, actualiza un Template cuando el responsable del informe cambia las columnas CSV requeridas, el archivo debe generarse como XML en lugar de TXT, o el nombre del Template es demasiado genérico para que los operadores lo identifiquen con seguridad.

## Cuándo usarlo

***

Usa esta tarea cuando:

* el Template aún es necesario;
* el nombre o el formato de salida es incorrecto;
* un archivo `.tpl` subido debe ser reemplazado;
* un Template del Template Builder necesita ediciones a nivel de bloque;
* los futuros Reports deben usar el Template corregido.

No uses esta tarea para cambiar un Report ya generado. Los Reports generados son archivos históricos. Corrige la configuración de origen y genera un nuevo Report.

## Antes de empezar

***

Comprueba qué tipo de Template estás editando:

* **Template subido**: actualiza el nombre, el formato de salida o reemplaza el archivo `.tpl`.
* **Template del Template Builder**: abre el builder, edita los bloques y guarda el `.tpl` generado.

Confirma que el cambio está pensado para futuros Reports. Los Reports ya generados a partir del Template anterior se quedan sin cambios.

<Warning>
  Reemplazar un archivo `.tpl` afecta cada Report futuro generado a partir de este Template. Valida el nuevo archivo antes de usarlo para un ciclo de reporting.
</Warning>

## Paso a paso

***

<Steps>
  <Step title="Abre la página Templates">
    Ve a **Templates** y localiza el Template que necesitas actualizar.
  </Step>

  <Step title="Abre la acción de edición">
    Haz clic en los tres puntos (<Icon icon="ellipsis-vertical" />) en la columna **Actions** y selecciona **Edit**.
  </Step>

  <Step title="Edita los campos del Template">
    En **Edit Template**, actualiza los campos que cambiaron. Para Templates subidos, puedes cambiar **Template Name**, **Output Format** y **Template File (.tpl)**.
  </Step>

  <Step title="Guarda los cambios">
    Haz clic en **Update Template**.
  </Step>

  <Step title="Genera un Report de prueba">
    Genera un nuevo Report con el Template actualizado y confirma que la salida coincide con la estructura esperada.
  </Step>
</Steps>

<Note>
  Los Templates creados con **Template Builder** se abren en el builder al editarse. Los Templates subidos como archivos `.tpl` se abren en el wizard de subida/edición.
</Note>

## Guía de campos

***

| Campo                    | Qué cambiar                                                                                                                      | Ejemplo                                           |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| **Template Name**        | Etiqueta obligatoria en la Console para los operadores. Se mapea a `name` en la Console y a `description` en la API de Reporter. | `Monthly tax XML`                                 |
| **Output Format**        | Tipo de archivo para futuros Reports. Usa `csv`, `xml`, `html`, `txt` o `pdf`.                                                   | `xml`                                             |
| **Template File (.tpl)** | Archivo de reemplazo opcional. Si se proporciona, debe ser `.tpl`, mayor que 0 bytes y no superior a 5 MB.                       | Reemplazar `tax-v1.tpl` por `tax-v2.tpl`          |
| Bloques del builder      | Estructura visual para Templates creados con el builder. Para guardar se requiere al menos un bloque válido.                     | Añadir un bloque **Aggregation** **Total amount** |

## Resultado esperado

***

El Template permanece en la página **Templates** con la configuración actualizada. Los futuros Reports generados a partir de él usan el nuevo nombre, formato de salida y estructura del Template.

## Errores comunes y puntos de atención

***

<AccordionGroup>
  <Accordion title="Esperar que los Reports antiguos cambien">
    Actualizar un Template no reescribe los Reports ya generados. Genera un nuevo Report tras corregir el Template.
  </Accordion>

  <Accordion title="Reemplazar el archivo sin comprobar el formato de salida">
    Si la estructura del archivo `.tpl` y **Output Format** no coinciden con el formato de entrega esperado, los operadores pueden generar el tipo de archivo incorrecto.
  </Accordion>

  <Accordion title="Renombrar sin contexto operativo">
    Nombres como `Template 1` o `New Template` son difíciles de distinguir al generar informes. Usa un nombre que incluya el propósito o el período del informe.
  </Accordion>
</AccordionGroup>

## Pasos siguientes

***

* Usa [Generar un Report](/es/lerian-console/reporter-console/generating-a-report) para probar el Template actualizado.
* Usa [Corregir un Report](/es/lerian-console/reporter-console/editing-a-report) si el problema se detectó en un Report generado.
* Usa [Eliminar un Template](/es/lerian-console/reporter-console/deleting-a-template) solo si el Template ya no se necesita.

<Card title="API equivalente" type="tip" horizontal>
  [Endpoint Update templates](/es/reference/reporter/update-templates)
</Card>