FAQ

FAQ

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

Vérifiez les points suivants :

  1. Le module DoliPDF est bien activé dans la liste des modules
  2. Vous utilisez un modèle de document au format ODT (DoliPDF ne fonctionne pas avec les modèles PDF natifs de Dolibarr)
  3. En mode distant : l'adresse du serveur, l'email et la clé d'API sont correctement renseignés
  4. En mode local : la commande LibreOffice est correcte et LibreOffice est installé sur le serveur
  5. 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.

Comment obtenir ma clé d'API ?

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

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.

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 11.0 et supérieur. Le module inclut une couche de rétro-compatibilité pour les versions antérieures à Dolibarr 16.0 (classe FormSetup).

Utilisation