Crear presupuestos profesionales, personalizados y alineados con la identidad visual de tu marca es esencial para cualquier empresa. No solo mejora la imagen ante el cliente, sino que también fortalece la comunicación comercial. Si utilizas Dolibarr ERP & CRM para gestionar tus operaciones, ya sabrás que su sistema de generación de presupuestos es muy potente, pero los modelos por defecto no siempre cumplen con los requisitos específicos de cada empresa.

La buena noticia es que Dolibarr permite crear plantillas de presupuesto totalmente personalizadas, adaptadas a tus necesidades comerciales y estéticas.

En este artículo encontrarás una guía completa paso a paso para crear un presupuesto personalizado en Dolibarr, que incluye:

• Explicación de cómo funciona el sistema de presupuestos en Dolibarr

• Estructura de las plantillas PDF y su integración en el sistema

• Tutorial para crear y activar una nueva plantilla personalizada

• Cómo modificar el diseño, añadir logos o insertar campos personalizados

• Errores comunes que debes evitar

• Consejos para mantener y actualizar tus plantillas a lo largo del tiempo

Tanto si eres desarrollador, autónomo o empresario, esta guía te mostrará todo lo necesario para personalizar tus documentos sin necesidad de ser un experto en programación.

¿Cómo funciona el sistema de presupuestos en Dolibarr?

En Dolibarr, los presupuestos (también llamados "propuestas comerciales") se crean desde el módulo Comercial. A través de la interfaz, el usuario introduce la información del cliente, productos o servicios, precios, impuestos, etc.

Los datos se guardan en la base de datos, pero el documento PDF que se genera se basa en un archivo PHP de plantilla, que controla la estructura y el formato del documento.

El proceso es el siguiente:

1. El usuario crea un presupuesto desde la interfaz

2. Dolibarr utiliza un archivo PHP (modelo) para generar el PDF

3. La plantilla toma los datos de la base de datos y los presenta usando funciones FPDF

Dolibarr incluye modelos predeterminados (como crabe, azur, einstein), pero suelen ser genéricos. Por eso crear tu propia plantilla personalizada marca la diferencia.

¿Por qué personalizar una plantilla de presupuesto?

Las plantillas estándar cumplen su función, pero presentan varias limitaciones:

• Imagen de marca básica (logo, colores, tipografía)

• Estructura rígida del documento

• Falta de adaptaciones legales o fiscales por país

• No incluyen campos personalizados como referencias internas, códigos de proyecto, etc.

Con una plantilla personalizada puedes:

• Mejorar la presentación y profesionalismo de tus presupuestos

• Incluir información específica de tu negocio

• Traducir el documento según el mercado objetivo

• Establecer una presentación uniforme para todos los clientes

Paso 1: Preparar tu entorno de trabajo

Antes de empezar, necesitas acceso a los archivos de instalación de Dolibarr. Esto implica:

• Acceso al servidor o instalación local

• Permiso para editar archivos PHP

• Conocer la ruta de instalación (por ejemplo: /var/www/html/dolibarr/)

Las plantillas de presupuesto están en la carpeta:

⚠️ No edites directamente los modelos estándar. Haz una copia para evitar que tus cambios se pierdan en futuras actualizaciones.

Paso 2: Copiar y renombrar una plantilla existente

1. Ve a la carpeta htdocs/core/modules/propale/doc/

2. Elige una plantilla base, como pdf_crabe.modules.php

3. Haz una copia con el nombre pdf_miempresa.modules.php

4. Abre el archivo y cambia el nombre de la clase:

por:

5. Modifica también estas líneas:

6. Guarda el archivo.

Paso 3: Activar la plantilla personalizada en Dolibarr

1. Inicia sesión en Dolibarr

2. Ve a Inicio > Módulos > Propuestas comerciales

3. Haz clic en Configurar

4. En Modelos disponibles para generar PDF, busca miempresa

5. Actívalo

6. (Opcional) Establécelo como modelo predeterminado

Paso 4: Personalizar el diseño del PDF

La plantilla es un archivo PHP que utiliza la librería FPDF. Estas son las secciones clave:

a) Encabezado

• Logo

• Título del documento (“Presupuesto”, “Propuesta”, etc.)

• Datos de la empresa

b) Datos del cliente

• Nombre, dirección, NIF/CIF, contacto

c) Tabla de productos/servicios

• Columnas: descripción, cantidad, precio unitario, total

• Orden y anchura de las columnas

• Formato monetario

d) Totales

• Subtotal, impuestos, total general

• Descuentos, recargos si los hubiera

e) Pie de página

• Condiciones de pago

• Datos bancarios

• Datos fiscales obligatorios

• Avisos o notas legales

Paso 5: Incluir campos personalizados

Si has creado campos extra mediante el módulo "Campos adicionales", puedes incluirlos con este código:

Recuerda comprobar si el valor está vacío antes de imprimirlo para evitar errores.

Paso 6: Probar la plantilla

1. Crea un presupuesto o abre uno existente

2. Haz clic en Generar PDF

3. Elige tu plantilla personalizada

4. Verifica la presentación: márgenes, texto, datos, totales

Corrige cualquier detalle editando el archivo PHP nuevamente.

Paso 7: Garantizar compatibilidad con futuras actualizaciones

• No edites nunca los archivos del sistema

• Usa un sistema de control de versiones (como Git)

• Tras actualizar Dolibarr, revisa los cambios en las plantillas originales

Consejos avanzados

A) Añadir una imagen o marca de agua

B) Mostrar contenido condicional

C) Crear presupuestos multilingües

Carga los archivos de idioma:

Errores comunes que debes evitar

• Sobrescribir archivos originales del sistema

• No cambiar correctamente el nombre de la clase

• Olvidar activar la plantilla en el sistema

• Usar textos fijos en lugar de dinámicos

• No prestar atención al diseño y espaciado

¿Cuándo usar un módulo en lugar de una plantilla?

Si necesitas:

• Lógica avanzada

• Conexiones a APIs externas

• Opciones de diseño más complejas

...entonces desarrollar un módulo personalizado de Dolibarr será mejor que limitarte a una plantilla PDF.

Conclusión

Una plantilla de presupuesto personalizada en Dolibarr te permite:

• Reforzar la imagen profesional de tu marca

• Incluir campos únicos y lógica propia

• Mejorar la claridad y presentación de los documentos

• Asegurar una comunicación coherente con tus clientes

Con esta guía, puedes construir y mantener un sistema de presupuestos que se adapte 100% a tu negocio. Rápido, profesional y totalmente tuyo.