Justificantes en los informes de gastos

Cuando Dolibarr genera el PDF de un informe de gastos, el módulo añade los justificantes a continuación, en un orden fijo:

1. los archivos vinculados a las líneas, en el orden de las líneas. Un archivo vinculado a varias líneas solo aparece una vez;
2. como opción, activada por defecto, los demás archivos de la pestaña «Documentos», salvo los documentos generados por Dolibarr.

Fotos y PDF

Una imagen más ancha que alta se coloca en una página horizontal. En el PDF, las fotos se vuelven a guardar en JPEG y se limitan a 2400 píxeles en el lado más largo. El archivo subido, en cambio, no se modifica.

Los demás formatos —fotos HEIC de iPhone, documentos Word…— no se convierten: se listan como no incluidos. El enderezado y la compatibilidad con PNG y GIF necesitan la extensión PHP GD; sin ella, solo se incluyen los JPEG, tal cual.

La referencia en cada página

En la parte superior de cada página de justificante, una línea indica de dónde procede (aquí en francés):

Justificatif — ER2610-0001 — ligne 1 · 07/10/2026 · 68,00 € — billet_train.pdf

Referencia del informe, número de línea, fecha e importe con IVA de la línea, nombre del archivo. En español, la línea dice «Justificante — … — línea 1 …». Un archivo que no está vinculado a ninguna línea lleva la mención «no vinculado a una línea». La referencia se desactiva en la página de configuración.

Un justificante nunca bloquea el informe de gastos

Cada archivo se comprueba antes de leerlo: archivo vacío, tamaño máximo, formato, PDF completo, PDF no cifrado. Un archivo rechazado no impide que se genere el informe. Se lista en una última página, «Justificantes no adjuntados a este documento», con el motivo, y un mensaje lo indica en pantalla.

En Dolibarr 19 a 23, la biblioteca PDF del núcleo puede detener PHP con algunos PDF dañados: el usuario obtiene una página en blanco. El módulo se protege de ello. El archivo defectuoso se aparta, y una página explica lo ocurrido y lleva de vuelta al informe de gastos. En la siguiente generación, el PDF se genera con normalidad y el archivo figura en él como no incluido.

El módulo no comprueba que cada línea tenga un justificante: una línea sin archivo vinculado no se señala.

La captura muestra el resultado: cuatro páginas del mismo PDF, una al lado de otra.

La primera es el informe de gastos ER2610-0001 tal como lo genera Dolibarr: tres líneas —un tren Estrasburgo-París a 68,00, una noche de hotel a 102,65, una comida con un cliente a 40,50— por un total con IVA de 211,15.

Después vienen los tres justificantes, en el orden de las líneas: el billete de tren y la factura del hotel, dos PDF, y después la foto del ticket del restaurante. Cada página lleva su referencia, cuya fecha e importe corresponden a la línea del informe. No hay página «Justificantes no adjuntados a este documento»: los tres archivos se incluyeron.

ConfiguraciónMódulosJustificantes en los informes de gastos:

Debajo de los ajustes, la lista de los justificantes apartados tras un error de lectura. Un archivo apartado se reconoce por su contenido: sigue descartado hasta que la lista se vacía con el botón «Vaciar la lista».

Los ajustes son propios de cada entidad en multiempresa.

• El PDF original nunca se daña. La fusión se escribe en un archivo aparte; el PDF generado por Dolibarr solo se sustituye si tiene éxito.
• Comprobación antes de leer cada justificante: tamaño, formato, PDF completo, PDF no cifrado. Una imagen de más de 60 millones de píxeles se descarta.
• Archivos confinados a la carpeta del informe de gastos: un archivo vinculado a una línea solo se lee si está realmente en esa carpeta.
• Ningún permiso nuevo. Los justificantes se añaden para cualquier persona que ya pueda generar el PDF del informe de gastos.
• Página de configuración reservada a los administradores, y sus dos acciones —guardar, vaciar la lista— exigen el token anti-CSRF de la sesión.

• La carpeta dolixjustif, en código legible, bajo licencia GPL v3 o posterior: descriptor, dos clases (el hook de fin de generación del PDF y la fusión), página de configuración, iconos.
• Las traducciones presentes en langs/: francés (fr_FR), inglés (en_US), alemán (de_DE) y español (es_ES).
• Un README.md y un ChangeLog.md.

El módulo necesita el módulo Informe de gastos. El descriptor exige Dolibarr 19.0 y PHP 7.4 como mínimo; los escenarios de prueba se ejecutaron en 19.0.4, 20.0.4, 21, 22, 23.0.4 y 24.0.1.

• No se crea ninguna tabla. El módulo no contiene carpeta sql/.
• No modifica ni las líneas, ni los importes, ni los archivos subidos. Lee la lista de archivos del informe de gastos; lo único que escribe es el PDF generado, completado.
• Al activarlo, se guardan tres ajustes en las constantes de Dolibarr.
• Si se aparta un PDF dañado, se guarda constancia en un pequeño archivo, documents/dolixjustif/quarantaine_<entidad>.json, y no en la base de datos.
• Ninguna conexión saliente: no se envía nada a ninguna parte.
• Al desactivarlo, los PDF generados a partir de entonces vuelven a ser los de Dolibarr. Los PDF ya generados conservan sus justificantes hasta su siguiente generación. Los tres ajustes y la lista de archivos apartados se conservan; puede eliminarlos usted mismo.