Justificatifs dans les notes de frais

Quand Dolibarr produit le PDF d’une note de frais, le module ajoute les justificatifs à la suite, dans un ordre fixe :

1. les fichiers rattachés aux lignes, dans l’ordre des lignes. Un fichier rattaché à plusieurs lignes n’apparaît qu’une fois ;
2. en option, activée par défaut, les autres fichiers de l’onglet « Fichiers joints », sauf les documents produits par Dolibarr.

Photos et PDF

Une image plus large que haute est placée sur une page en paysage. Dans le PDF, les photos sont réenregistrées en JPEG et limitées à 2 400 pixels sur le plus grand côté. Le fichier déposé, lui, n’est pas modifié.

Les autres formats — photos HEIC des iPhone, documents Word… — ne sont pas convertis : ils sont listés comme non joints. Le redressement et la prise en charge des PNG et GIF demandent l’extension PHP GD ; sans elle, seuls les JPEG sont joints, tels quels.

Le repère sur chaque page

En haut de chaque page de justificatif, une ligne indique d’où il vient :

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

Référence de la note, numéro de ligne, date et montant TTC de la ligne, nom du fichier. Un fichier qui n’est rattaché à aucune ligne porte la mention « non rattaché à une ligne ». Le repère se désactive dans la configuration.

Un justificatif ne bloque jamais la note de frais

Chaque fichier est contrôlé avant d’être lu : fichier vide, taille maximale, format, PDF complet, PDF non chiffré. Un fichier refusé n’empêche pas la note d’être produite. Il est listé sur une dernière page, « Justificatifs non joints à ce document », avec la raison, et un message le signale à l’écran.

Sur Dolibarr 19 à 23, la bibliothèque PDF du cœur peut arrêter PHP sur certains PDF abîmés : l’utilisateur obtient une page blanche. Le module s’en protège. Le fichier fautif est mis de côté, une page explique ce qui s’est passé et ramène à la note de frais. À la génération suivante, le PDF est produit normalement et le fichier y figure comme non joint.

Le module ne vérifie pas que chaque ligne a un justificatif : une ligne sans fichier rattaché n’est pas signalée.

La capture montre le résultat : quatre pages du même PDF, côte à côte.

La première est la note de frais ER2610-0001 telle que Dolibarr la produit : trois lignes — un train Strasbourg – Paris à 68,00, une nuit d’hôtel à 102,65, un déjeuner client à 40,50 — pour un total TTC de 211,15.

Suivent les trois justificatifs, dans l’ordre des lignes : le billet de train et la facture d’hôtel, deux PDF, puis la photo du ticket de restaurant. Chaque page porte son repère, dont la date et le montant correspondent à la ligne de la note. Il n’y a pas de page « Justificatifs non joints à ce document » : les trois fichiers ont été joints.

ConfigurationModules/ApplicationsJustificatifs dans les notes de frais :

Sous les réglages, la liste des justificatifs mis de côté après une erreur de lecture. Un fichier mis de côté est reconnu à son contenu : il reste écarté tant que la liste n’a pas été vidée avec le bouton « Vider la liste ».

Les réglages sont propres à chaque entité en multi-société.

• Le PDF d’origine n’est jamais abîmé. La fusion est écrite dans un fichier à part ; le PDF produit par Dolibarr n’est remplacé qu’en cas de succès.
• Contrôle avant lecture de chaque justificatif : taille, format, PDF complet, PDF non chiffré. Une image de plus de 60 millions de pixels est écartée.
• Fichiers confinés au dossier de la note de frais : un fichier rattaché à une ligne n’est lu que s’il se trouve réellement dans ce dossier.
• Aucun droit nouveau. Les justificatifs sont ajoutés pour toute personne qui peut déjà générer le PDF de la note de frais.
• Page de configuration réservée aux administrateurs, et ses deux actions — enregistrer, vider la liste — exigent le jeton anti-CSRF de la session.

• Le dossier dolixjustif, en clair, sous licence GPL v3 ou ultérieure : descripteur, deux classes (le crochet de fin de génération du PDF et la fusion), page de configuration, icônes.
• Les traductions présentes dans langs/ : français (fr_FR), anglais (en_US) et allemand (de_DE).
• Un README.md et un ChangeLog.md.

Le module a besoin du module Notes de frais. Le descripteur exige Dolibarr 19.0 et PHP 7.4 au minimum ; les scénarios de test ont été exécutés sur 19.0.4, 20.0.4, 21, 22, 23.0.4 et 24.0.1.

• Aucune table créée. Le module ne contient pas de répertoire sql/.
• Il ne modifie ni les lignes, ni les montants, ni les fichiers déposés. Il lit la liste des fichiers de la note de frais ; la seule écriture est le PDF produit, complété.
• À l’activation, trois réglages sont enregistrés dans les constantes de Dolibarr.
• Si un PDF abîmé est mis de côté, sa trace est gardée dans un petit fichier, documents/dolixjustif/quarantaine_<entité>.json, et non en base.
• Aucune connexion sortante : rien n’est envoyé nulle part.
• À la désactivation, les PDF générés ensuite redeviennent ceux de Dolibarr. Les PDF déjà générés gardent leurs justificatifs jusqu’à leur prochaine génération. Les trois réglages et la liste des fichiers mis de côté restent ; vous pouvez les supprimer vous-même.