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}}.
💡 ¿Necesitas más ayuda o quieres capacitarte?
Si el artículo no resolvió tu duda o buscas más formación, ingresa a nuestros Canales de Atención y Formación para:
- 📩 Canales de Contacto Directo: Encuentra el Chat, Teléfono y Correo disponible para tu país.
- 🎓 Visitar Buk Academy: Inscríbete en cursos y certificaciones.
👉 Ingresar a los Canales de Atención y Formación Buk