Documentacion KSIDol > Modulos KSIDol > Perfiles de documentos

Guia del modulo: Perfiles de documentos

Guía de uso no técnica: para qué sirve el módulo, cómo utilizarlo y cómo se articula con Dolibarr.

Documentos afectadosFacturas y presupuestos

Personalización PDFLogotipo, nombre, e-mail, encabezado, pie

PerfilesUno o varios por entidad

CompatibilidadDolibarr 18 a 24

1. Descripcion del modulo

El módulo Perfiles de documentos (DocProfilesTools) le permite definir una o varias "identidades de documento" y aplicarlas automáticamente a sus facturas y presupuestos en formato PDF. Cada perfil reúne un logotipo, un nombre a mostrar, una dirección de correo electrónico, un texto de encabezado y un texto de pie de página. En el momento de generar el documento, el módulo sustituye estos elementos durante la impresión y luego restablece sus datos habituales: el resto de Dolibarr no se modifica. Resulta útil cuando edita documentos con una presentación concreta (una marca, un nombre comercial, una entidad, una mención específica) sin querer tocar la configuración general de su empresa. El módulo no crea nuevos tipos de documentos: se apoya en los objetos nativos de Dolibarr (terceros, facturas, presupuestos, plantillas PDF y la ficha de su empresa) y se limita a dar una nueva apariencia a sus documentos existentes.

Centralizar varias presentaciones de documentos en "perfiles" reutilizables.
Mostrar automáticamente el logotipo, el nombre, el correo, el encabezado y el pie correctos en facturas y presupuestos.
Seguir siendo 100 % compatible con el funcionamiento estándar de Dolibarr (no se modifica ningún dato contable).
Se configura por completo desde una única página de administración reservada al administrador.

2. Crear y gestionar perfiles de documentos

Un perfil es una ficha que describe la apariencia que se dará a sus documentos. Puede crear tantos como necesite y gestionarlos desde la página de configuración del módulo.

Dar una etiqueta al perfil para localizarlo fácilmente.
Definir el nombre a mostrar en el PDF (útil si debe diferir del nombre de su empresa), así como un nombre de empresa y una dirección de correo electrónico.
Subir un logotipo propio del perfil; en su defecto, se reutiliza automáticamente el logotipo de su empresa.
Introducir un texto de encabezado y un texto de pie de página personalizados.
Vincular, opcionalmente, un tercero (cliente) al perfil.
Indicar la plantilla de factura y la plantilla de presupuesto asociadas al perfil.
Activar o desactivar un perfil y asignarlo a una entidad (contexto multiempresa).
Consultar la lista de perfiles existentes, modificarlos o eliminarlos (los archivos del perfil se limpian entonces).

3. Aplicar el perfil en las facturas y los presupuestos (plantillas PDF)

El módulo proporciona plantillas PDF que mantienen el diseño estándar de Dolibarr, pero le inyectan automáticamente el contenido del perfil activo en el momento de la impresión.

Una plantilla de factura "Sponge" en versión DocProfiles.
Plantillas de presupuesto "Azur", "Crabe", "Cyan" y "Sponge" en versión DocProfiles.
Al generarse, el PDF toma el logotipo, el nombre mostrado, el correo, el encabezado y el pie del perfil activo.
El perfil aplicado es el primer perfil activo de la entidad actual.
Estas plantillas se eligen desde la ficha de factura o de presupuesto, como cualquier plantilla de Dolibarr.
Una opción "Forzar las plantillas DocProfiles" permite definirlas de una vez como plantillas predeterminadas de las facturas y los presupuestos.

4. Configuración y herramientas de mantenimiento

Todo se controla desde una única página de administración, accesible solo para los administradores a través del menú Herramientas (entrada "DocProfiles Tools (Setup)").

Acceso reservado al administrador, desde el menú Herramientas de Dolibarr.
Botón de reparación que crea o actualiza automáticamente el almacenamiento de los perfiles si es necesario.
Botón de instalación de las plantillas, que copia en el lugar adecuado las plantillas PDF suministradas con el módulo.
En la instalación, el módulo crea automáticamente sus carpetas de almacenamiento y un "Perfil predeterminado" precargado con el logotipo y los datos de su empresa.
Elección de la plantilla de factura y de la plantilla de presupuesto propuestas en listas desplegables alimentadas por las plantillas disponibles.

5. Nota y viñeta en la ficha del tercero

El módulo también permite mostrar una nota personalizada (advertencia, instrucción interna) en la ficha de un cliente, con algunos ajustes de apariencia.

Mostrar una nota personalizada directamente en la ficha de un tercero.
Introducir y guardar esta nota desde la ficha de cliente (almacenada en un campo complementario "KSI Note").
Ajustar la apariencia de la viñeta: posición en la pantalla, ancho, opacidad, texto predeterminado.
Función auxiliar: el punto de enganche (hook) de la ficha del tercero no está registrado de forma predeterminada por el módulo; la visualización de la viñeta requiere, por tanto, la activación manual de este hook.

6. Vinculos con Dolibarr

El modulo no funciona de forma aislada: se integra con los bloques nativos de Dolibarr.

Facturas : Proporciona una plantilla PDF de factura que adopta la identidad del perfil (logotipo, nombre, correo, encabezado, pie) al generar el documento, sin modificar la factura ni los datos contables.
Presupuestos / Propuestas comerciales : Proporciona plantillas PDF de presupuesto (Azur, Crabe, Cyan, Sponge) que aplican el perfil activo en el momento de la edición.
Terceros (clientes) : Un perfil puede vincularse a un tercero; el módulo también puede mostrar una nota personalizada en la ficha del cliente y memorizar esta nota en un campo complementario del tercero.
Plantillas de documentos (PDF) : Las plantillas del módulo amplían las plantillas PDF nativas de Dolibarr (Sponge, Azur, Crabe, Cyan) y pueden definirse como plantillas predeterminadas de las facturas y los presupuestos.
Ficha de su empresa (emisor) : El módulo lee el logotipo y los datos de su empresa para alimentar el perfil predeterminado, y luego sustituye temporalmente esta información durante la impresión antes de restablecerla.
Multientidad : Los perfiles se gestionan por entidad: cada empresa/entidad dispone de sus propios perfiles activos.
Campos complementarios (extrafields) : El módulo se apoya en campos complementarios del tercero para almacenar la nota personalizada y, potencialmente, la asociación de un perfil con un cliente.