3. CONFIGURATION DU MODULE

Onglet Compte

La configuration du module est organisée en quatre onglets accessibles depuis la fiche du module (icône d'engrenage dans la liste des modules) :

f1.png

C'est l'onglet d'accueil de la configuration. Il sert à connecter votre Dolibarr au serveur d'OCR qui va analyser les PDF.

Paramètre

Description

Adresse du serveur d'OCR

URL du serveur. Par défaut https://ocr.cap-rel.fr , qui offre 5 analyses gratuites par mois. Vous pouvez aussi pointer vers un serveur auto-hébergé.

Adresse mail

Courriel du compte sur le serveur d'OCR. Reprend par défaut l'adresse mail de la société configurée dans Dolibarr.

Mot de passe du webservice

Au moins 6 caractères. Si l'adresse mail n'a pas encore de compte, il sera créé avec ce mot de passe. Si le compte existe déjà avec un autre mot de passe, un lien de réinitialisation s'affiche.

Après avoir saisi ces trois champs, cliquez sur « Vérifier la connexion ». Le module tente de se connecter, crée le compte si besoin, et enregistre automatiquement la clé d'API. Un message vert confirme la réussite.

L'adresse IP publique de votre serveur Dolibarr est affichée en haut de la page : conservez-la pour échanger avec le support en cas de problème de connexion.

Onglet Import des lignes

Cet onglet contrôle la manière dont les lignes détaillées de la facture sont extraites et importées.

f4.png

Paramètre

Description

Désactiver l'import automatique des lignes de factures

Si coché, la facture est créée avec une seule ligne globale (montant total + produit par défaut). Sinon, le module tente d'extraire ligne par ligne.

Création d'un produit dans la base Dolibarr

Si coché, un produit/service est créé automatiquement quand une ligne de facture mentionne une référence inconnue.

Mise à jour du libellé du produit à l'import

Si coché, le libellé du produit existant est remplacé par celui présent sur la facture à chaque import.

Mise à jour du prix d'achat fournisseur à l'import

Si coché, le prix unitaire hors taxe de chaque ligne importée devient le prix d'achat du produit chez ce fournisseur (onglet Fournisseurs de la fiche produit), pour une quantité de 1.

Choix Produits ou Services comme type créé par défaut

Type appliqué aux produits/services créés automatiquement.

Note : La création automatique de produits est utile pour les fournisseurs récurrents (papeterie, hébergement) où vous voulez retrouver l'historique par référence. Pour les achats ponctuels, désactiver l'option et utiliser le produit par défaut suffit.

Note sur le prix d'achat : seuls les produits identifiés par leur référence (ou créés pendant l'import) reçoivent le prix. Le produit/service par défaut du fournisseur, lui, n'est jamais modifié : c'est un article fourre-tout partagé par toutes les lignes non reconnues. Chaque nouvel import écrase le prix précédent pour ce couple produit/fournisseur ; l'historique reste consultable sur la fiche produit. Enregistrer ce prix permet aussi aux imports suivants de retrouver le produit grâce à sa référence fournisseur.

Onglet Réglages

Cet onglet rassemble les options de comportement général du module.

f2.png

Paramètre

Description

Référence à utiliser comme nom de pièce jointe

Choisissez « Référence de l'objet Dolibarr » (le PDF est renommé avec la référence interne, par exemple FACF2401-0001.pdf) ou « Référence de la facture fournisseur » (le PDF prend le numéro de facture présent sur le document).

Préfixe à ajouter au nom du fichier

Texte ajouté au début du nom de la pièce jointe attachée à la facture.

Produit utilisé par défaut pour la création de facture

Produit ou service utilisé pour créer la ligne unique d'une facture quand l'extraction détaillée des lignes est désactivée ou échoue.

Produit utilisé pour les frais de livraison

Produit/service associé automatiquement quand des frais de transport sont détectés sur la facture.

Désactiver l'affichage des messages d'alertes

Masque les avertissements pendant l'import. À n'utiliser qu'une fois le module rodé : sans alertes, vous perdez le détail en cas d'échec.

Forcer la date de règlement, le moyen et le compte selon la fiche tiers

Si coché, les conditions de règlement enregistrées sur la fiche tiers Dolibarr sont prioritaires sur les informations présentes sur la facture (date de paiement, mode, compte).

Astuce : un produit/service par défaut spécifique à un fournisseur peut être défini sur l'onglet ScanInvoices de sa fiche tiers. Il prend le pas sur le produit par défaut global de cet onglet.

Onglet ScanInvoices sur la fiche tiers

f5.png

Sur chaque fiche fournisseur, un onglet ScanInvoices est ajouté. Il permet de :

Partage (Import distant)

f3.png

Cet onglet active l'import automatique de factures déposées dans un dossier réseau (Nextcloud, Synology DAV). Une tâche planifiée Dolibarr passe régulièrement chercher les nouveaux fichiers et les soumet à l'OCR.

Paramètre

Description

Import de factures depuis un partage réseau

Case à cocher pour activer la fonctionnalité.

Type de partage

Nextcloud ou Synology DAV.

Adresse du partage réseau

URL complète du partage. Pour Nextcloud, au format https://cloud.exemple.fr/index.php/s/IDENTIFIANT

Port

Port de connexion si différent du port standard.

Identifiant et mot de passe

À renseigner si le partage est protégé par authentification.

Adresse mail

Adresse à laquelle envoyer les comptes rendus d'import automatique.

Une fois les paramètres saisis, cliquez sur « Vérifier la connexion » : le module liste le contenu du partage pour valider la configuration. La tâche planifiée associée s'exécute toutes les 3 heures par défaut.