Ir al contenido

Personalización de la plantilla de factura: editor HTML y CSS basado en las plantillas DEFAULT y BLUE

• Número de visualizaciones: 9934 • 4 min de lectura

Una plantilla personalizada para la impresión de facturas permite cambiar el diseño y el aspecto de los documentos generados por el sistema. Esta opción resulta útil para quienes desean adaptar las facturas a la identidad visual de su empresa. Después de pegar el código HTML y CSS, la plantilla estará lista para utilizarse tanto en documentos nuevos como en documentos existentes.

¡ATENCIÓN! La gestión de plantillas está disponible únicamente para usuarios con permisos de administrador. Las plantillas pueden ser creadas y editadas por personas con el rol del sistema de administrador principal o administrador, ya que esto requiere acceso a los ajustes de la cuenta.

¿Cómo abrir el editor de plantillas de facturas?

Para crear una plantilla de factura personalizada basándose en las plantillas del sistema:

  1. Ve a la sección Ajustes > Ajustes de cuenta > Plantillas de factura Menú Ajustes de cuenta con la opción Plantillas de factura
  2. Desplázate hasta la parte inferior de la página, hasta la sección Propia plantilla de factura, y haz clic en el botón Añadir nueva plantilla. Botón Añadir nueva plantilla en la sección Propia plantilla de factura
¡NOTA! La posibilidad de crear plantillas personalizadas está disponible en los planes Estándar y Profesional

¿Dónde descargar los archivos de la plantilla desde GitHub?

El sistema utiliza plantillas en formato Handlebars (HBS). Hay varias plantillas del sistema disponibles, entre ellas DEFAULT (diseño básico) y BLUE (variante con un toque de color azul). Descarga los archivos correspondientes y copia su contenido:

  1. descarga el archivo HTML de la plantilla DEFAULT: default.hbs.html — copia todo su contenido;
  2. descarga el archivo CSS de la plantilla DEFAULT: default.css — copia todo su contenido;
  3. si quieres utilizar la variante BLUE en lugar de DEFAULT, descarga el archivo CSS: blue.css — utilízalo en lugar del archivo CSS de Default en el paso 2.

También encontrarás todas las plantillas de ejemplo en el repositorio de GitHub.

¿Cómo pegar el código HTML y CSS de la plantilla?

  1. En el editor de plantillas, pega el código HTML copiado en el campo superior (campo HTML). También puedes utilizar la opción Elegir plantilla ejemplar. Campo HTML del editor de plantillas de factura con el código de la plantilla pegado
  2. Pega el código CSS copiado en el campo inferior (campo CSS). Campo CSS del editor de plantillas de factura con el código de estilos pegado
  3. Realiza tus modificaciones en el código.
  4. Haz clic en Guardar para confirmar los cambios.
¡NOTA! La vista previa de la plantilla estará disponible únicamente después de guardar los cambios. El sistema generará un documento de ejemplo que podrás revisar antes de utilizar la plantilla en tus facturas reales.
Vista previa de la plantilla de factura personalizada después de guardar los cambios
¡IMPORTANTE! No intercambies los campos de posición: no pegues el CSS en el campo superior ni el HTML en el campo inferior. El sistema no mostrará ningún error, pero la factura tendrá un aspecto incorrecto. El error será únicamente visual y difícil de detectar.

En la imagen a continuación, se muestra el editor con los campos HTML (superior) y CSS (inferior) resaltados:

¿Cómo cambiar la plantilla DEFAULT para que tenga el aspecto de la plantilla BLUE?

La plantilla BLUE se diferencia de la DEFAULT por la combinación de colores y requiere un cambio adicional en el código HTML: mover un elemento específico a otra ubicación. A continuación, se muestra el elemento que debe trasladarse.

HTML responsable de mostrar el nombre y el número del documento antes del cambio.

Código HTML con el nombre y número del documento antes del cambio a la plantilla BLUE

HTML después del cambio.

Código HTML con el nombre y número del documento trasladado para la plantilla BLUE

Descarga el archivo blue.css y copia su contenido.

  1. En el editor de plantillas, pega el código blue.css en el campo inferior (campo CSS); este sustituirá al CSS predeterminado.
  2. En el campo superior (campo HTML), mueve el elemento seleccionado a la ubicación indicada en la imagen anterior.
  3. Haz clic en Guardar.

¿Qué conviene saber sobre el funcionamiento de las plantillas?

La plantilla creada de esta forma es una plantilla nueva e independiente, aunque se base en una de las plantillas del sistema.

Los documentos creados anteriormente conservan la plantilla con la que fueron creados. Cambiar la plantilla por defecto en los ajustes de la cuenta o de la sección afecta únicamente a los documentos nuevos. La plantilla de un documento archivado solo cambiará si se selecciona manualmente durante la edición de ese documento.

¡ATENCIÓN! La plantilla se puede asignar en los ajustes generales de la cuenta y a una sección específica. Sin embargo, no se puede asignar una plantilla a un contratista concreto ni a un tipo de documento. Al generar un documento, el sistema comprueba primero la plantilla asignada a la sección y, si no existe, utiliza la plantilla predeterminada de la cuenta.

¡ATENCIÓN! Si utilizas en la plantilla fuentes externas (por ejemplo, Google Fonts) o imágenes alojadas fuera del sistema, pueden aumentar el tiempo de generación del PDF. El límite de tiempo para generar un documento es de 30 segundos; si un recurso externo no está disponible o responde lentamente, es posible que la generación del PDF no se complete correctamente.

¿Te ha resultado útil esta entrada?

Compartir

Comentarios