Dolibarr ERP CRM Wiki

Module PDF Annexes

Module PDF Annexes

PDF Annexes est un module complémentaire pour Dolibarr ERP/CRM qui fusionne automatiquement vos annexes PDF — conditions générales de vente, fiches techniques, RIB, plaquettes — dans les PDF de vos devis, commandes et factures. Le document généré est un fichier unique, envoyé tel quel par email : plus de CGV oubliées ni expédiées dans une pièce jointe séparée.

Éditeur arcchester
Licence GPL v3
Compatibilité Dolibarr 18.0 à 24.x (validé sur Dolibarr 24.0.0)
PHP 7.4 à 8.3
Dépendances Aucune — le module utilise le moteur PDF déjà présent dans Dolibarr (TCPDI), sans librairie externe ni binaire serveur
Distribution Fiche sur le Dolistore

Fonctionnalités

  • Fusion native : le PDF officiel Dolibarr et vos annexes ne forment plus qu'un seul fichier, généré au même emplacement que d'habitude — aucun changement dans vos habitudes d'envoi.
  • Règles conditionnelles sans code :
    • par type de document : devis, commandes, factures ;
    • par montant TTC (minimum / maximum) — par exemple joindre une plaquette seulement au-delà de 5 000 € ;
    • par pays du tiers (« parmi FR, BE, CH » ou « hors de FR ») — par exemple des CGV export ;
    • par langue du document — CGV françaises ou anglaises selon la langue de la facture.
  • Position au choix : page de garde (avant le document) ou annexe (après).
  • Fiches techniques produits automatiques : les PDF attachés aux produits présents dans les lignes du document sont annexés d'eux-mêmes, une seule fois par produit, selon un motif de nom configurable (par exemple FT_*.pdf).
  • Validation à l'upload : chaque PDF est testé par le moteur de fusion au moment de l'envoi. Un fichier protégé ou incompatible est refusé immédiatement avec un message clair, au lieu d'échouer silencieusement plus tard.
  • Jamais bloquant : si une annexe pose problème à la génération, elle est simplement omise ; en cas d'échec de la fusion, le document natif reste intact.
  • Compatible Factur-X : les factures électroniques PDF/A-3 produites par le module Factur-X France ne sont jamais altérées (option PDFANNEXES_SKIP_IF_FACTURX, activée par défaut).
  • Compatible avec les modèles de document du cœur (azur, sponge, eratosthene…) sans aucune modification de ceux-ci.
  • Interface et documentation en français et en anglais.

Installation

  1. Télécharger le zip module_pdfannexes-x.y.z.zip depuis le Dolistore.
  2. Dans Dolibarr : Accueil → Configuration → Modules/Applications → Déployer/installer un module externe.
  3. Activer PDF Annexes dans la liste des modules (famille « Outils »).

Configuration : vos CGV en deux minutes

  1. Ouvrir la configuration du module et envoyer votre PDF de CGV.
  2. Créer la règle « CGV » : documents ciblés = devis + commandes + factures, position = fin de document. Enregistrer.
  3. C'est terminé. Chaque PDF généré contient désormais vos CGV, et l'envoi par email joint ce fichier unique.

Les règles suivantes se créent de la même manière, en ajoutant les conditions voulues (montant, pays, langue).

Limites connues

  • Les PDF protégés par mot de passe ne peuvent pas être fusionnés — ils sont refusés dès l'upload, avec un message explicite.
  • Les liens cliquables et les champs de formulaire des annexes sont aplatis lors de la fusion. Sans conséquence pour des CGV ou des fiches techniques.
  • La numérotation « Page X/Y » du document natif n'est pas recalculée après ajout des annexes.

Historique des versions

Version Apports principaux
1.0.0 Version initiale : fusion via le hook afterPDFCreation, règles conditionnelles (type, montant, pays, langue), position avant/après, fiches techniques produits, validation à l'upload, exclusion Factur-X, FR/EN

Ce module a été diffusé sous le nom « DoliSmart PDF » avant sa version 1.0.0 ; il a été renommé PDF Annexes pour éviter toute confusion avec l'application mobile DoliSmart, sans lien avec ce module.

Support

Retrieved from "https://wiki.dolibarr.org/index.php?title=Module_PDF_Annexes&oldid=67196"