Aprende a utilizar los filtros de transformación y estructuras de control directamente en el editor de plantillas de la plataforma. Este artículo contiene los códigos exactos (snippets) para automatizar fechas, montos en palabras y atributos personalizados siguiendo la guía técnica oficial.
Este artículo está dirigido a Administradores que gestionan el módulo de Documentos y Firma.
Requisitos Previos
- Acceso al módulo de Documentos y Firma.
- Permisos de Administrador o perfil con acceso a edición de plantillas.
- Estar dentro del Editor de Plantillas (Administrativo > Documentos y Firma > Plantillas > Crear/Editar).
Contenido - Paso a Paso
Copia y pega estos fragmentos en el editor de la plataforma para transformar los datos de tus colaboradores automáticamente.
1. Formato de Fechas y Tiempo
Para que las fechas no se vean como simples números, utiliza estos filtros:
- Fecha completa en palabras (Ej: "17 de Marzo"):
{{fecha_de_hoy | fecha_en_palabras: "%d de %B"}} - Formato específico (Ej: "31-12-2023"):
{{fecha_ingreso | formato_fecha: "dd-mm-yyyy"}} - Extraer solo el Mes (Ej: "03" para marzo):
{{fecha_de_hoy | detalle_fecha: "M"}} - Fecha a futuro (Ej: fecha en 3 meses):
{{fecha_de_hoy | fecha_n_meses_al_futuro: "3" | formato_fecha: "dd/mm/yyyy"}}
2. Montos en Palabras (Cláusulas Legales)
Utiliza estos filtros para cumplir con la normativa de escribir remuneraciones en texto:
- Sueldo con decimales y texto legal:
"El trabajador percibirá un sueldo base de {{empleado.sueldo | monto_con_decimales_a_palabras}}"Resultado: "...suma de quinientos mil pesos 00/100." - Convertir cualquier número a texto:
{{sueldo | palabras}}Resultado: "quinientos mil"
3. Formato de Moneda y Números
- Monto con símbolo de moneda y separadores:
{{empleado.sueldo | monto_con_formato}}Resultado: "$ 1.200.000" - Número con separador de miles y 2 decimales:
{{1000000 | formato_numero}}Resultado: "1.000.000,00"
4. Atributos Personalizados e Imágenes
Si utilizas atributos creados por ti o necesitas insertar imágenes dinámicas:
- Atributo Personalizado (Texto):
{{empleado.custom_empleado.nombre_del_atributo}} - Imagen o Firma Escaneada: (Es estrictamente necesario definir ancho y alto)
{{empleado.custom_empleado.firma_escaneada | imagen: "150", "80"}} - Logo de la Empresa:
{{empresa.logo | imagen: "200", "200"}}
Consideraciones Finales
- Regla de Oro: Todas las variables simples deben ir entre dobles llaves
{{ variable }}. - Sin Espacios: No dejes espacios entre la variable y el símbolo pipe
|(ejemplo:{{variable|filtro}}). - Cierres Obligatorios: Si usas condiciones lógicas, recuerda siempre cerrar con
{% endif %}. - Uso de Mayúsculas: Puedes forzar cualquier texto a mayúsculas usando:
{{empleado.apellido | convertir_a_mayusculas}}.
💡¿Aún tienes dudas?
Si este artículo no responde completamente tu consulta o necesitas apoyo en un caso particular, nuestro equipo está disponible a través de los canales de atención.
Chat | Teléfono | Correo
🎓 ¿Te interesa certificarte en Buk?
Te invitamos a realizar un curso de tu interés en Buk Academy, donde encontrarás contenidos guiados para profundizar en el uso de la plataforma y fortalecer tus conocimientos.