Configuration
La configuration du module est accessible depuis Accueil > Configuration > Modules > Dolipdf, onglet Configuration.
Mode de conversion
DoliPDF propose deux modes de conversion, qui peuvent être utilisés séparément.
Mode distant (par défaut)
Le fichier ODT est envoyé à un serveur DoliPDF qui effectue la conversion en PDF. Ce mode est le plus simple à mettre en place.
| Paramètre | Description |
|---|---|
| Adresse du serveur dolipdf | URL du serveur de conversion. La valeur par défaut est https://pdf.cap-rel.fr. |
| Adresse email de votre compte | Adresse email associée à votre compte sur le serveur DoliPDF. |
| Clé d'API sur le serveur dolipdf | Clé d'authentification du service. Elle est enregistrée automatiquement quand vous ouvrez votre compte depuis l'onglet Ouvrir un compte. Exemple de format : 1\|lUr8Tj4fHZZZmpwAAAMpBBBDb8KCCC5Iw5DDD2sH. |
Ouvrir votre compte depuis Dolibarr
Vous n'avez pas encore de compte DoliPDF ? Ouvrez-le sans quitter Dolibarr, et sans rien copier :
- Ouvrez l'onglet Ouvrir un compte de la configuration du module. Il affiche les informations de votre société qui seront transmises (raison sociale, email, pays, SIREN, adresse), lues dans Accueil > Configuration > Société
- Cliquez sur Ouvrir mon compte sur pdf.cap-rel.fr, puis sur Continuer vers le paiement : la page de commande s'ouvre dans un nouvel onglet, avec ces informations déjà remplies. Choisissez votre formule, corrigez ce qui doit l'être, puis payez
- Revenez sur l'onglet Ouvrir un compte : il se met à jour tout seul dès que le paiement est reçu, et la clé d'API est enregistrée dans la configuration du module. Le bouton J'ai payé, vérifier maintenant force la vérification si besoin
Un email vous est envoyé à l'adresse de la commande pour choisir le mot de passe de votre espace sur le serveur DoliPDF, où vous retrouvez vos factures et vos clés d'API.
Si l'adresse email de la commande correspond déjà à un compte, la formule est ajoutée à ce compte et aucune nouvelle clé n'est créée : saisissez alors la clé existante de ce compte.
Vous avez déjà un compte ? Créez une clé depuis le menu Jetons d'API puis Nouveau de votre espace sur le serveur DoliPDF, et collez-la dans le champ Clé d'API de l'onglet Configuration.
Tester la connexion
Le bouton Tester la connexion, sous les paramètres de l'onglet Configuration, vérifie en quelques secondes que la conversion distante fonctionnera, sans convertir de document ni consommer votre formule. Il contrôle l'adresse du serveur (complète et en https), la présence et le format de la clé d'API, puis interroge le serveur DoliPDF.
Le résultat s'affiche en haut de la page :
- Connexion OK : le serveur répond et accepte la clé. Le message rappelle le compte utilisé et, si le serveur le communique, le nombre de conversions encore disponibles
- Avertissement : la clé est valide, mais aucune formule n'est active ou la formule est épuisée. Un lien mène à la page de commande
- Erreur : le message nomme la cause (adresse absente ou en http, clé manquante ou incomplète, serveur injoignable avec le détail réseau, clé refusée, compte verrouillé, erreur du serveur) et l'action à mener
Mode local (LibreOffice)
Si vous disposez de LibreOffice installé sur votre serveur, vous pouvez effectuer la conversion localement sans envoyer vos documents sur un serveur externe.
| Paramètre | Description |
|---|---|
| Utilisation de Libreoffice installé localement sur votre serveur | Active le mode de conversion local. |
| Commande locale à lancer pour générer le PDF à partir du fichier ODT | Commande système exécutée pour la conversion. Renseignez ce champ uniquement si vous activez le mode local. |
Attention : Lorsque le mode local est désactivé, DoliPDF empêche automatiquement toute exécution locale de LibreOffice, même si la constante Dolibarr
MAIN_ODT_AS_PDFest renseignée. Cela évite les conversions locales involontaires.
Options
Notifications
| Paramètre | Description |
|---|---|
| Afficher les notifications en haut à droite lors de la génération des fichiers PDF | Active l'affichage d'un message de confirmation ou d'erreur après chaque conversion. |
Gestion des fichiers
| Paramètre | Description |
|---|---|
| Supprimer le fichier odt lorsque le pdf a bien été généré | Supprime automatiquement le fichier ODT source une fois la conversion en PDF réussie. Cela permet de ne conserver que le fichier PDF final. |
Performance
| Paramètre | Description |
|---|---|
| Désactiver la création du fichier PDF à chaque ajout / modification de ligne article | Empêche la régénération automatique du PDF lorsque vous ajoutez ou modifiez une ligne sur un document (facture, devis, commande). Le PDF est alors généré uniquement lors de l'action explicite de génération du document. |
| Lancer DoliPDF que sur les documents validés | Limite la conversion PDF aux documents ayant le statut "Validé". Les documents en brouillon ne déclenchent pas de conversion. Cette option permet d'économiser l'utilisation du service DoliPDF distant. |
Données transmises et vie privée
Pour assurer son service, le module transmet les informations suivantes.
Lors de chaque conversion en mode distant
- Le contenu du fichier ODT à convertir, envoyé au serveur DoliPDF configuré (par défaut
https://pdf.cap-rel.fr), accompagné de votre clé d'API et de l'adresse email de votre compte - Un identifiant technique d'installation (
DOLIPDF_UUID) : un identifiant aléatoire généré une seule fois, stocké dans la base Dolibarr, qui permet de distinguer deux installations sans révéler leur identité - Le nom de votre société tel que renseigné dans la configuration Dolibarr (menu Accueil > Configuration > Société), transmis dans le champ User-Agent de la requête HTTP
- La langue de votre Dolibarr, pour que le serveur DoliPDF rédige ses messages dans cette langue
Le mode de conversion local (LibreOffice) n'effectue aucune requête vers l'extérieur : vos documents restent sur votre serveur.
Lors d'un test de connexion
- Votre clé d'API, envoyée au serveur DoliPDF configuré, avec le nom de votre société (champ User-Agent) et la langue de votre Dolibarr. Aucun document n'est transmis
Lors de l'ouverture d'un compte
- Les informations de votre société affichées par l'onglet Ouvrir un compte (raison sociale, email, pays, SIREN, adresse), envoyées au serveur DoliPDF configuré pour préremplir la page de commande. Rien n'est envoyé tant que vous ne cliquez pas sur Ouvrir mon compte
Lors de la vérification des mises à jour
Comme tout module Dolibarr doté d'une adresse de vérification de version, le module interroge https://cap-rel.fr/dolibarr/ver.php et transmet à cette occasion :
- La version du module installée
- La version de Dolibarr (
DOL_VERSION) - Une empreinte non réversible (
md5) du répertoire de données Dolibarr, utilisée uniquement pour distinguer les installations dans les statistiques de téléchargement
Si votre politique de confidentialité l'exige, vous pouvez bloquer cette vérification au niveau de votre pare-feu sortant : le fonctionnement du module n'en est pas affecté.