​
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 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:
CampoDescripción
NombreNombre descriptivo de la plantilla
IdentificadorID único de la plantilla (usado para referencias)
Tipo de documentoExtensión del archivo (PDF, DOCX, etc.)
Fecha de creaciónCuándo fue cargada la plantilla
DocumentoEnlace para ver el archivo original
AccionesOpciones para editar o eliminar

​
Crear Nueva Plantilla

1

Preparar el documento

Crea tu documento (PDF o Word) incluyendo los IDs que necesites. Por ejemplo:
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}
2

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”
3

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

​
Editar Plantilla Existente

1

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”
2

Modificar la plantilla

Puedes cambiar: - Nombre de la plantilla
No puedes cambiar el archivo cargado. Para esto debes crear una plantilla nueva mejor
3

Guardar cambios

Haz clic en “Guardar” para aplicar los cambios.

​
Eliminar Plantilla

1

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
2

Verificar eliminación

La plantilla será eliminada permanentemente de la tabla.
Esta acción no se puede deshacer. Asegúrate de que la plantilla no esté siendo utilizada antes de eliminarla.

​
Mejores Prácticas para Plantillas

​
Estructura del Documento

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

​
Uso de IDs

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

​
Ejemplo de Plantilla Completa

# 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 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ónPermiso Requerido
Crear plantillasdoc-templates:create
Editar plantillasusers:update
Eliminar plantillasdoc-templates:delete
Ver plantillasAcceso básico a la interfaz

​
Solución de Problemas

​
IDs no se reemplazan

​
Error al cargar plantilla