Aide
Réponses aux questions qui reviennent le plus. La documentation complète de chaque module est sur le wiki Dolibarr.
Questions générales
Où trouver le zip après un achat sur le Dolistore ?
Dans votre compte Dolistore, ouvrez la rubrique Commandes. Chaque commande payée donne accès au téléchargement du zip. Vous y trouverez aussi la référence de commande, celle que je vous demande quand vous ouvrez une demande de support.
Comment installer un module ?
Allez dans Accueil, Configuration, Modules, puis dans l'onglet « Déployer/installer un module externe ». Envoyez le zip, puis activez le module dans la liste. Si l'envoi est refusé, c'est que le dossier custom de Dolibarr n'est pas accessible en écriture. Dans ce cas, copiez le dossier contenu dans le zip vers htdocs/custom par FTP ou SSH.
Que faire après une mise à jour du module ?
Remplacez les fichiers du module, puis désactivez-le et réactivez-le dans Configuration, Modules. C'est la réactivation qui applique les changements de base de données et de droits. Vos réglages et vos données sont conservés.
Quelles informations donner dans une demande ?
- la version du module et celle de Dolibarr (Accueil, Configuration, À propos)
- le message d'erreur exact ou une capture d'écran
- ce que vous faisiez juste avant
- le type d'hébergement (mutualisé, serveur, Docker)
J'ai perdu mon téléphone, comment me connecter ?
Utilisez un de vos 10 codes de secours à la place du code de l'application. Si vous n'en avez plus, demandez à un administrateur de réinitialiser votre 2FA depuis l'administration du module. Vous en configurerez une nouvelle à la connexion suivante.
Quelles applications fonctionnent avec la 2FA ?
Toutes les applications TOTP fonctionnent, par exemple Google Authenticator, Microsoft Authenticator, Authy, 1Password, Bitwarden, Aegis ou FreeOTP. Le QR code est généré sur votre serveur, sans passer par un service tiers. Chaque utilisateur peut aussi choisir une clé de sécurité comme la YubiKey, ou la biométrie de son appareil (Windows Hello, Touch ID, Face ID).
Peut-on imposer la 2FA à tous les utilisateurs ?
Oui, il suffit de cocher une case dans l'administration du module. Les utilisateurs qui n'ont pas encore de second facteur sont invités à le configurer dès leur prochaine connexion. Le tableau de bord montre où en est l'adoption, et vous pouvez réinitialiser la 2FA d'un compte ou lui imposer un nouvel enrôlement.
La clé YubiKey ou Windows Hello ne fonctionne pas
Les clés de sécurité et la biométrie (WebAuthn / FIDO2) ne marchent que si Dolibarr est ouvert en HTTPS. C'est une règle des navigateurs, le module n'y peut rien. Tant que vous êtes en HTTP, utilisez l'application TOTP ou les codes de secours.
Je suis sur Dolibarr 16, 17 ou 18, dois-je mettre à jour ?
Oui, installez la version 6.0.3 ou une version plus récente. Avant elle, Dolibarr 16 à 18 ne demandait pas le second facteur, parce que le contrôle reposait sur un point d'accroche qui n'existe qu'à partir de Dolibarr 19. Après avoir remplacé les fichiers, désactivez puis réactivez le module.
Je me suis bloqué moi-même, comment faire ?
La pause dure 5 minutes la première fois, puis elle s'allonge à chaque récidive jusqu'au plafond que vous avez fixé. Attendez la fin de la pause, ou connectez-vous depuis une autre adresse, puis débloquez la vôtre dans l'écran des blocages en cours. Pour que ça ne se reproduise pas, ajoutez votre adresse à la liste blanche avec le bouton « ajouter mon IP actuelle ».
La ville affichée sur la carte est fausse
La géolocalisation par adresse IP reste approximative, surtout sur les réseaux mobiles, où l'adresse peut être rattachée à une autre ville de l'opérateur. La « source de connexion » indique l'opérateur et le type de réseau (fixe, mobile, hébergeur ou VPN), ce qui aide à savoir si la ville est fiable. Pour vos bureaux ou votre VPN, déclarez la vraie position dans « Lieux déclarés », elle passe alors avant les bases publiques.
Les adresses IP sont-elles envoyées à un service extérieur ?
Non. La géolocalisation passe par une base installée sur votre serveur, DB-IP Lite qui est gratuite, ou MaxMind GeoLite2 avec votre clé. Les cartes des e-mails d'alerte sont dessinées sur votre serveur aussi. Il n'y a ni clé d'API ni abonnement.
Pourquoi aucune alerte le premier jour ?
La première connexion de chaque compte est apprise en silence, elle devient l'appareil et le pays connus. Ensuite, une alerte ne part que pour un nouvel appareil ou un nouveau pays. Ça évite de recevoir une vague de fausses alertes le jour de l'installation.
Où trouver la corbeille ?
Elle est accessible de trois façons, sur toutes les pages. Juste après une suppression, le message propose le lien « Annuler cette suppression ». L'icône corbeille en haut à droite affiche le nombre d'éléments récupérables. Vous la trouvez aussi dans le menu Outils, Corbeille. Si vous voulez un onglet dans la barre du haut, il s'active dans les réglages du module.
Restaurer une facture remet-il ses paiements ?
Non. La facture revient avec ses lignes, ses champs supplémentaires, ses catégories, ses liens et ses fichiers joints. Ses paiements, ses écritures comptables et ses mouvements de stock ne reviennent pas. L'écran de vérification vous le rappelle avant que vous confirmiez.
Combien de temps les éléments restent-ils en corbeille ?
Ils restent 30 jours par défaut, et vous pouvez changer cette durée pour chaque type d'élément. Une purge automatique passe chaque jour et efface ce qui a dépassé le délai. Vous pouvez aussi vider la corbeille à la main.
Une suppression n'apparaît pas dans la corbeille
Le module capture les suppressions faites par Dolibarr. Il ne voit pas celles faites directement en SQL, ni celles d'un module qui contourne les triggers de Dolibarr, et la page de réglages liste les modules installés qui sont dans ce cas. Certains types ne sont pas encore couverts, comme les documents fournisseurs, les adhérents, les expéditions, les contrats, les notes de frais et les tickets.
Dans quels champs DocFinder cherche-t-il ?
Il cherche dans le numéro du document, le nom du client, la désignation des lignes, la référence et le libellé des produits, les notes publiques et privées, ainsi que le téléphone, l'e-mail et le nom des contacts. Chaque champ s'active ou se désactive dans les réglages, tout comme le périmètre (devis, factures ou les deux).
Comment retrouver un document à partir d’un numéro de téléphone ?
Tapez le numéro tel que vous l'avez sous les yeux. « 06 12 34 56 78 », « 06.12.34.56.78 » ou « +33 6… » donnent le même résultat. Les devis et factures du client s'affichent, avec le contact correspondant sous son nom.
Un utilisateur ne voit pas DocFinder
Il lui manque le droit d'accès. Vous pouvez le lui donner depuis la carte « Accès utilisateurs » dans les réglages du module, sans ouvrir chaque fiche utilisateur. Chacun ne voit ensuite que les documents qu'il a déjà le droit de lire dans Dolibarr.
Mon client peut-il ouvrir le PDF normalement ?
Oui. Par défaut, le PDF s'ouvre d'un double-clic, sans mot de passe. Seules la modification, l'extraction et l'assemblage sont bloqués. Vous choisissez si l'impression et la copie de texte restent autorisées.
Les restrictions peuvent-elles être retirées ?
Sans mot de passe d'ouverture, les lecteurs courants comme Adobe Acrobat ou Foxit respectent les restrictions, mais un outil spécialisé peut les retirer. Si le document doit rester vraiment confidentiel, définissez un mot de passe d'ouverture. Le PDF est alors chiffré, et personne ne peut le lire sans ce mot de passe.
La signature en ligne marche-t-elle avec un devis protégé ?
Oui. Votre client signe en ligne et sa signature est posée dans le cadre « Bon pour accord » du devis, y compris avec les modèles InfraS PackPlus. Le PDF d'origine et le PDF signé sont ensuite protégés à nouveau. La génération en masse depuis les listes continue aussi de fonctionner.
Et les factures Factur-X ?
Elles sont protégées si votre serveur dispose de qpdf ou de pikepdf, qui conservent le fichier XML embarqué. Avec le moteur intégré, le module les laisse telles quelles pour ne pas perdre le XML. Sachez aussi qu'un PDF chiffré n'est plus conforme PDF/A.
Une facture peut-elle partir deux fois ?
Non. Il n'y a qu'une facture par abonnement et par période, et une clé unique en base le garantit. Même si la génération se lance deux fois, la période déjà facturée est ignorée.
Faut-il une tâche planifiée (cron) ?
Ce n'est pas obligatoire. Sans cron, les factures dues sont générées pendant qu'un utilisateur autorisé à créer des factures navigue dans Dolibarr. Si vous préférez une génération à heure fixe, le tableau de bord affiche l'état de l'automatisation et la ligne de crontab exacte à ajouter.
Les relances partent-elles toutes seules ?
Non. Le module propose des relances par paliers, à 30, 60 et 180 jours par défaut, chacune avec son modèle d'e-mail. Rien ne part sans votre accord. Depuis l'écran des impayés, vous pouvez relancer plusieurs factures d'un coup.
Une facture a été générée sans PDF
Elle est signalée « PDF manquant » dans le journal et sur la fiche de l'abonnement, avec un bouton « Générer le PDF ». Depuis la version 1.4.1, si le modèle PDF de la facture modèle n'existe plus, le module prend le modèle par défaut des factures, puis un autre modèle actif. Un PDF manquant est aussi généré au moment de l'envoi par e-mail.
L'échéance des factures est trop lointaine
L'échéance dépend des conditions de règlement. Vous pouvez les choisir pour chaque abonnement, ou en imposer une à toutes les factures générées depuis les réglages, y compris un jour fixe du mois comme « le 10 du mois ». L'échéance est recalculée avant la validation, donc le PDF porte la bonne date.
La sauvegarde native de Dolibarr échoue, BackupGuard va-t-il fonctionner ?
Dans la plupart des cas, oui. BackupGuard exporte la base en PHP et n'a pas besoin de mysqldump, qui manque souvent ou qui est interdit sur les hébergements mutualisés et dans les conteneurs Docker. Dès l'activation, le tableau de bord du module affiche un diagnostic de votre serveur.
Comment ouvrir une sauvegarde sans Dolibarr ?
Les sauvegardes chiffrées suivent le format standard de la commande openssl, donc elles s'ouvrent sur n'importe quelle machine avec cette commande :
openssl enc -d -aes-256-cbc -pbkdf2 -in sauvegarde.zip.enc -out sauvegarde.zip
Le zip obtenu contient database.sql, manifest.json et le dossier documents.
Où envoyer les sauvegardes ?
Une copie locale est toujours faite. Vous pouvez y ajouter, en même temps, un espace WebDAV (Nextcloud, ownCloud, kDrive, Infomaniak), un stockage compatible S3 (AWS, Scaleway, OVH, Backblaze B2, Wasabi, MinIO), un serveur FTP ou FTPS, et un serveur SFTP si l'extension PHP ssh2 est présente. Le bouton « Tester la connexion » écrit puis supprime un fichier témoin, et vous montre l'erreur réelle du serveur distant si ça ne passe pas.
Mon hébergement n'a pas de cron
Utilisez l'URL de déclenchement avec clé secrète, que vous trouverez dans les réglages. Un service de cron externe, ou n'importe quel appel quotidien de cette adresse, suffit. La tâche planifiée de Dolibarr et un script en ligne de commande restent disponibles si vous en avez besoin.
Peut-on restaurer sur un autre serveur ?
Oui. Installez un Dolibarr neuf avec seulement BackupGuard, puis lancez la restauration depuis le navigateur. Le module analyse le fichier sans rien modifier et fait d'abord une sauvegarde de sécurité de l'état actuel. Si la restauration s'arrête en route, le bouton « Revenir à l'état d'avant » vous ramène au point de départ. Pour les très grosses bases, un script en ligne de commande est fourni.
La mise à jour de Dolibarr marche-t-elle en Docker ?
Dans un conteneur, les fichiers de Dolibarr viennent de l'image et seraient écrasés la prochaine fois qu'elle est recréée. Le module vous montre donc la marche à suivre au lieu de modifier les fichiers. Sur un hébergement ou un serveur classique, la mise à jour se fait depuis le navigateur, après une sauvegarde complète, et vous pouvez revenir aux fichiers d'avant.
Le bouton Excel n'apparaît pas sur une liste
Il y a trois choses à vérifier. L'utilisateur doit avoir le droit « Exporter une liste », qui est accordé par défaut aux nouveaux utilisateurs. La liste ne doit pas faire partie des listes exclues dans les réglages. Enfin, elle doit venir d'un module qui suit les conventions de Dolibarr. Quand tout est bon, le bouton apparaît dans la barre de titre, à côté de la pagination.
Combien de lignes peut-on exporter ?
Pour « toute la liste filtrée », la limite est de 5 000 lignes par défaut, et vous pouvez la monter jusqu'à 50 000. Les données passent par petits morceaux et, au-delà d'un certain seuil, le fichier est écrit en flux, donc un hébergement ordinaire suffit.
Les montants seront-ils des nombres dans Excel ?
Oui. Les montants deviennent de vrais nombres et les dates de vraies dates Excel, alors que les références restent du texte, si bien que « 2026-001 » ne se transforme jamais en date. En CSV, le fichier est en UTF-8 avec BOM, Excel l'ouvre directement, et vous choisissez le séparateur.
Peut-on savoir qui a exporté quoi ?
Oui. Le journal des exports, dans les réglages du module, indique pour chaque fichier l'utilisateur, la liste, la date et le nombre de lignes. Les fichiers eux-mêmes ne sont pas gardés, ils sont supprimés dès le téléchargement ou au bout d'une heure.