> ## 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 una plantilla

> Actualiza el nombre, el formato de salida o el archivo .tpl subido de una plantilla directamente desde la Lerian Console, sin eliminar y volver a crear la plantilla.

Usa esta página cuando se recomienda que una plantilla siga disponible, pero algo de su nombre, formato de salida, diseño o archivo de origen necesite cambiar.

## Objetivo

***

Actualiza la plantilla reutilizable que usarán los informes futuros.

Por ejemplo, actualiza una plantilla cuando el responsable del informe cambia las columnas CSV requeridas. Actualízala cuando el formato de salida deba ser XML en lugar de TXT. Actualízala cuando el nombre de la plantilla es demasiado genérico para que los operadores lo identifiquen con seguridad.

## Cuándo usarlo

***

Usa esta tarea cuando:

* todavía necesitas la plantilla.
* el nombre o el formato de salida es incorrecto.
* un archivo `.tpl` subido necesita un reemplazo.
* una plantilla de Template Builder necesita ediciones en el nivel de bloque.
* se recomienda que los informes futuros usen la plantilla corregida.

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

## Antes de empezar

***

Revisa el tipo de plantilla que debes editar:

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

Confirma que el cambio se aplica a los informes futuros. Los informes ya generados a partir de la plantilla anterior permanecen sin cambios.

<Warning>
  Reemplazar un archivo `.tpl` afecta a todos los informes futuros generados a partir de esta plantilla. Valida el archivo nuevo antes de usarlo en un ciclo de generación de informes.
</Warning>

## Paso a paso

***

<Steps>
  <Step title="Abre la página Templates">
    Ve a **Templates** y localiza la plantilla 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 de la plantilla">
    En **Edit Template**, actualiza los campos que cambiaron. En el caso de las plantillas subidas, 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 informe de prueba">
    Genera un nuevo informe con la plantilla actualizada y confirma que la salida coincide con la estructura esperada.
  </Step>
</Steps>

<Note>
  Las plantillas creadas con **Template Builder** se abren en el constructor al editarlas. Las plantillas subidas como archivos `.tpl` se abren en el asistente de carga y edición.
</Note>

## Guía de campos

***

| Campo                    | Qué cambiar                                                                                                                    | Ejemplo                                           |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- |
| **Template Name**        | Etiqueta requerida 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 los informes futuros. Usa uno de `csv`, `xml`, `html`, `txt` o `pdf`.                                     | `xml`                                             |
| **Template File (.tpl)** | Archivo de reemplazo opcional. Si se proporciona, debe ser `.tpl`, mayor de 0 bytes y no mayor de 1 MiB.                       | Reemplaza `tax-v1.tpl` por `tax-v2.tpl`           |
| Bloques del constructor  | Estructura visual para las plantillas creadas con el constructor. Guardar requiere al menos un bloque válido.                  | Agrega un bloque **Total amount** **Aggregation** |

## Resultado esperado

***

La plantilla permanece en la página **Templates** con la configuración actualizada. Los informes futuros generados a partir de ella usan el nuevo nombre, el formato de salida y la estructura de la plantilla.

## Errores comunes y puntos de atención

***

<AccordionGroup>
  <Accordion title="Esperar que los informes antiguos cambien">
    Actualizar una plantilla no reescribe los informes ya generados. Genera un nuevo informe después de corregir la plantilla.
  </Accordion>

  <Accordion title="Reemplazar el archivo sin revisar 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 durante la generación de informes. Usa un nombre que incluya el propósito o el período del informe.
  </Accordion>
</AccordionGroup>

## Próximos pasos

***

* Usa [Generar un informe](/es/products/reporter/console/generating-a-report) para probar la plantilla actualizada.
* Usa [Corregir un informe](/es/products/reporter/console/editing-a-report) si encontraste el problema en un informe generado.
* Usa [Eliminar una plantilla](/es/products/reporter/console/deleting-a-template) solo si ya no necesitas la plantilla.

<Card title="Equivalente en la API" type="tip" horizontal>
  [Endpoint de actualización de plantillas](/es/reference/products/reporter/update-templates)
</Card>