FAQ

Le PDF n'est pas généré, que faire ?

Vérifiez les points suivants :

Le module DoliPDF est bien activé dans la liste des modules
Vous utilisez un modèle de document au format ODT (DoliPDF ne fonctionne pas avec les modèles PDF natifs de Dolibarr)
En mode distant : l'adresse du serveur, l'email et la clé d'API sont correctement renseignés
En mode local : la commande LibreOffice est correcte et LibreOffice est installé sur le serveur
Si l'option Lancer DoliPDF que sur les documents validés est activée, vérifiez que le document est bien au statut "Validé"

J'obtiens l'erreur "Erreur de transfert du fichier PDF"

Cette erreur indique que le fichier PDF a été reçu du serveur DoliPDF mais que la vérification d'intégrité MD5 a échoué. Le fichier a pu être altéré pendant le transfert. Tentez de régénérer le document. Si l'erreur persiste, vérifiez la connectivité réseau entre votre serveur Dolibarr et le serveur DoliPDF.

J'obtiens l'erreur "Erreur DoliPDF"

Cette erreur générique indique que le serveur DoliPDF n'a pas pu effectuer la conversion. Les causes possibles sont :

Clé d'API invalide ou expirée
Serveur DoliPDF temporairement indisponible
Fichier ODT corrompu ou dans un format non supporté
Adresse du serveur DoliPDF incorrecte

Consultez les logs Dolibarr (fichier dolibarr.log) pour obtenir des détails supplémentaires sur l'erreur.

Pour identifier la cause, utilisez le bouton Tester la connexion de l'onglet Configuration : il vérifie l'adresse du serveur et la clé d'API sans convertir de document, et affiche un message qui nomme le problème.

Comment obtenir ma clé d'API ?

Si vous n'avez pas encore de compte, ouvrez-le depuis l'onglet Ouvrir un compte de la configuration du module : la clé est enregistrée automatiquement dès que votre commande est réglée (voir la configuration).

Si vous avez déjà un compte :

Rendez-vous sur le serveur DoliPDF (par défaut https://pdf.cap-rel.fr)
Connectez-vous avec votre compte
Accédez au menu Jetons d'API
Cliquez sur Nouveau
Copiez la clé générée dans la configuration du module

La conversion est refusée : "aucune formule active"

Le serveur DoliPDF ne convertit les documents que pour un compte dont la formule est réglée, et dans la limite de documents de cette formule. Le message d'erreur contient un lien Commander une formule qui ouvre la page de commande.

Puis-je utiliser mon propre serveur DoliPDF ?

Oui. Renseignez l'adresse de votre serveur dans le champ Adresse du serveur dolipdf de la configuration. Votre serveur doit exposer une API compatible avec le protocole DoliPDF. Depuis la version 1.0.18, le module appelle les adresses /api/v1/pdf (conversion) et /api/v1/ping (test de connexion) : vérifiez que votre serveur les expose avant de mettre à jour.

Le mode local ne fonctionne pas

Vérifiez que :

L'option Utilisation de Libreoffice installé localement est activée
La commande indiquée dans Commande locale est correcte et exécutable par l'utilisateur du serveur web (par exemple www-data)
LibreOffice est bien installé sur le serveur et accessible en ligne de commande
L'utilisateur du serveur web a les droits d'écriture dans le répertoire de destination des fichiers PDF

Le PDF est régénéré à chaque modification de ligne

Par défaut, Dolibarr régénère le document à chaque ajout ou modification de ligne article, ce qui déclenche une conversion DoliPDF. Pour éviter ce comportement, activez l'option Désactiver la création du fichier PDF à chaque ajout / modification de ligne article dans la configuration du module.

DoliPDF fonctionne-t-il avec les documents PDF natifs de Dolibarr ?

Non. DoliPDF convertit uniquement les fichiers ODT en PDF. Si vous utilisez les modèles PDF natifs de Dolibarr (comme crabe, sponge, etc.), Dolibarr génère directement le PDF sans passer par DoliPDF.

Quelles versions de Dolibarr sont supportées ?

DoliPDF est compatible avec Dolibarr 14 et supérieur (vérifié jusqu'à Dolibarr 24), avec PHP 7.4 minimum. Le module inclut une couche de rétro-compatibilité pour les versions antérieures à Dolibarr 16.0 (classe FormSetup).