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

# Gestion

### Gestión de Plantillas de Documentos

La **Gestión de Plantillas de Documentos** es la interfaz donde puedes cargar, editar y administrar las plantillas que contienen los IDs documentados anteriormente. Estas plantillas se utilizan posteriormente con el [endpoint de exportación](https://docs.gotrebol.com/api-reference/exportación-de-verificaciones/exportar-datos-de-verificación-a-documento-personalizado) para generar documentos personalizados con la información extraída de las verificaciones.

### ¿Qué son las Plantillas de Documentos?

Las plantillas de documentos son archivos (PDF o Word) que contienen **IDs** (marcadores de posición) que serán reemplazados automáticamente con la información extraída de las verificaciones. Por ejemplo, si tienes un documento que dice "La empresa `{rut_co-1-businessName}` con NIT `{rut_co-1-nit}`", estos IDs serán reemplazados con los datos reales de la verificación.

### Acceso a la Gestión de Plantillas

Para acceder a la gestión de plantillas:

1. **Inicia sesión** en la aplicación web de Trébol
2. **Navega a Ajustes** (En el menú de la parte superior derecha)
3. **Selecciona "Plantillas de formatos" en el menú lateral**

### Funcionalidades Disponibles

#### Visualizar Plantillas Existentes

La interfaz muestra una tabla con todas las plantillas cargadas, incluyendo:

| **Campo**             | **Descripción**                                   |
| --------------------- | ------------------------------------------------- |
| **Nombre**            | Nombre descriptivo de la plantilla                |
| **Identificador**     | ID único de la plantilla (usado para referencias) |
| **Tipo de documento** | Extensión del archivo (PDF, DOCX, etc.)           |
| **Fecha de creación** | Cuándo fue cargada la plantilla                   |
| **Documento**         | Enlace para ver el archivo original               |
| **Acciones**          | Opciones para editar o eliminar                   |

#### Crear Nueva Plantilla

<Steps>
  <Step title="Preparar el documento">
    Crea tu documento (PDF o Word) incluyendo los IDs que necesites. Por ejemplo:

    ```markdown theme={"dark"}
    CERTIFICADO DE EMPRESA

    Razón Social: {rut_co-1-businessName}
    NIT: {rut_co-1-nit}
    Dirección: {rut_co-1-mainAddress}
    Teléfono: {public_address_cc_co-1-phone}
    Fecha de Constitución: {rut_co-1-constitutionDate}
    ```
  </Step>

  <Step title="Cargar la plantilla">
    En la interfaz de gestión: 1. Haz clic en **"Cargar nueva plantilla"** 2.
    Completa el formulario con: - **Nombre**: Nombre descriptivo de la plantilla -
    **Archivo**: Selecciona tu documento (PDF o Word) 3. Haz clic en **"Guardar"**
  </Step>

  <Step title="Verificar la carga">
    La plantilla aparecerá en la tabla con:

    * Un identificador único generado automáticamente
    * El tipo de documento detectado
    * La fecha de creación actual
  </Step>
</Steps>

#### Editar Plantilla Existente

<Steps>
  <Step title="Acceder a la edición">
    1. En la tabla de plantillas, haz clic en el menú de acciones (⋮) de una de ellas
    2. Selecciona **"Editar"**
  </Step>

  <Step title="Modificar la plantilla">
    Puedes cambiar: - **Nombre** de la plantilla

    <Warning>
      No puedes cambiar el archivo cargado. Para esto debes crear una plantilla
      nueva mejor
    </Warning>
  </Step>

  <Step title="Guardar cambios">
    Haz clic en **"Guardar"** para aplicar los cambios.
  </Step>
</Steps>

#### Eliminar Plantilla

<Steps>
  <Step title="Confirmar eliminación">
    1. En la tabla de plantillas, haz clic en el menú de acciones (⋮)
    2. Selecciona **"Eliminar"**
    3. Confirma la acción en el modal que aparece
  </Step>

  <Step title="Verificar eliminación">
    La plantilla será eliminada permanentemente de la tabla.

    <Warning>
      Esta acción no se puede deshacer. Asegúrate de que la plantilla no esté siendo utilizada antes de eliminarla.
    </Warning>
  </Step>
</Steps>

### Mejores Prácticas para Plantillas

#### Estructura del Documento

<Tip>
  **Organiza tu documento de manera clara:** - Usa títulos y subtítulos para
  organizar la información - Agrupa campos relacionados (datos de la empresa,
  contactos, etc.) - Incluye espacios suficientes para que los datos se vean
  bien al reemplazarse
</Tip>

#### Uso de IDs

<Tip>
  **Para usar los IDs correctamente:** - Copia exactamente los IDs de la
  documentación (incluyendo llaves `{}`) - Usa la numeración correcta (`-1`,
  `-2`, etc.) según el número de documentos - Para arrays, usa el índice
  correcto (`-0`, `-1`, etc.) - Prueba con diferentes verificaciones para
  asegurar que los IDs funcionen
</Tip>

#### Ejemplo de Plantilla Completa

```markdown theme={"dark"}
# CERTIFICADO DE EMPRESA

## INFORMACIÓN GENERAL

Razón Social: {rut_co-1-businessName}
NIT: {rut_co-1-nit}
Dígito de Verificación: {rut_co-1-verificationDigit}
País: {rut_co-1-country}
Departamento: {rut_co-1-department}
Ciudad: {rut_co-1-city}

## CONTACTO

Dirección Principal: {rut_co-1-mainAddress}
Correo Electrónico: {rut_co-1-emailAddress}
Teléfono 1: {rut_co-1-phone1}
Teléfono 2: {rut_co-1-phone2}

## FECHAS IMPORTANTES

Fecha de Constitución: {rut_co-1-constitutionDate}
Fecha de Registro: {rut_co-1-registrationDate}
Número de Matrícula: {rut_co-1-merchantNumber}

## ACTIVIDADES ECONÓMICAS

Actividad Principal: {rut_co-1-activities-0-description}
Código: {rut_co-1-activities-0-code}

## INFORMACIÓN ADICIONAL

Teléfono de Contacto: {public_address_cc_co-1-phone}
Dirección Comercial: {public_address_cc_co-1-businessAddress-address}
```

### Integración con el Endpoint de Exportación

Una vez que tienes tus plantillas cargadas, puedes usarlas con el [endpoint de exportación](https://docs.gotrebol.com/api-reference/exportación-de-verificaciones/exportar-datos-de-verificación-a-documento-personalizado) para generar documentos personalizados:

1. **Identifica la plantilla** que quieres usar (por su identificador)
2. **Llama al endpoint** `POST /verifications/{id}/export/{id_plantilla}`
3. **Recibe la url del archivo** y otros datos adicionales como el tiempo de expiracion del enlace(en milisegundos)
4. **Descarga el archivo** accediendo a la url obtenida del paso anterior

### Permisos Requeridos

Para gestionar plantillas, necesitas los siguientes permisos:

| **Acción**          | **Permiso Requerido**       |
| ------------------- | --------------------------- |
| Crear plantillas    | `doc-templates:create`      |
| Editar plantillas   | `users:update`              |
| Eliminar plantillas | `doc-templates:delete`      |
| Ver plantillas      | Acceso básico a la interfaz |

### Solución de Problemas

#### IDs no se reemplazan

<AccordionGroup>
  <Accordion title="Verificar sintaxis de IDs">
    * Asegúrate de que los IDs estén entre llaves `{}`
    * Verifica que no haya espacios extra dentro de las llaves
    * Confirma que el ID existe en la documentación
  </Accordion>

  <Accordion title="Verificar datos de la verificación">
    * Confirma que la verificación tiene items del tipo correcto - Verifica que
      los items tienen datos completos - Asegúrate de que la verificación está en
      estado "finished"
  </Accordion>

  <Accordion title="Verificar numeración">
    * Usa la numeración correcta (`-1`, `-2`, etc.)
    * Confirma que existe al menos un documento del tipo especificado
    * Para arrays, usa índices válidos (`-0`, `-1`, etc.)
  </Accordion>
</AccordionGroup>

#### Error al cargar plantilla

<AccordionGroup>
  <Accordion title="Formato de archivo">
    * Asegúrate de que el archivo sea PDF o Word (.docx) - Verifica que el
      archivo no esté corrupto - Confirma que el archivo no esté protegido con
      contraseña
  </Accordion>
</AccordionGroup>