Arcchester: Documentation du module externe PDF Annexes (editeur arcchester)

2026-09-06T12:01:56Z

Documentation du module externe PDF Annexes (editeur arcchester)

New page

== 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.

{| class="wikitable"
|-
! É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 || [https://www.dolistore.com/product.php?id=3315 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 <code>FT_*.pdf</code>).
* '''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 [[Module Factur-X France|Factur-X France]] ne sont jamais altérées (option <code>PDFANNEXES_SKIP_IF_FACTURX</code>, 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 ==

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

== Configuration : vos CGV en deux minutes ==

# Ouvrir la configuration du module et envoyer votre PDF de CGV.
# Créer la règle « CGV » : documents ciblés = devis + commandes + factures, position = fin de document. Enregistrer.
# 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 ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.0.0 || Version initiale : fusion via le hook <code>afterPDFCreation</code>, 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 ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module PDF Annexes - Revision history

Arcchester: Documentation du module externe PDF Annexes (editeur arcchester)