Skip to main content

Installation

Prérequis

  • Dolibarr : Version 11 ou ultérieure.
  • PHP : 7.0 ou version ultérieure.
  • Extensions PHP requises : intl, fileinfo, gd, mbstring.
  • Fonction PHP requise : finfo_open.
  • Modules Dolibarr activés : Tiers, Fournisseurs, Produits, Services, Tâches planifiées (Cron).
  • Accès Internet sortant vers le serveur d'OCR (par défaut https://ocr.cap-rel.fr).

Ces éléments sont contrôlés par le module au premier accès à la page de configuration ; un message d'erreur explicite s'affiche si l'un d'eux manque.

Installation

Téléchargement

Le module est disponible sur le DoliStore CAP-REL : https://shop.cap-rel.fr/ Téléchargez l'archive « module_scaninvoices-x.y.z.zip » correspondant à la dernière version compatible avec votre Dolibarr.

Installation du module
      1. Connectez-vous à Dolibarr avec un compte administrateur.
      2. Rendez-vous dans Accueil > Configuration > Modules/Applications.
      3. Cliquez sur l'onglet « Déployer/Installer un module externe ».
      4. Sélectionnez l'archive .zip téléchargée, puis validez.
      5. Dolibarr décompresse l'archive et l'installation se fait automatiquement.

Activation

  1. Dans Accueil > Configuration > Modules/Applications, recherchez « ScanInvoices » dans la liste (catégorie Financier).
  2. Cliquez sur l'interrupteur pour activer le module.
  3. Au premier clic, Dolibarr crée les tables nécessaires en base et installe les permissions.

Le module est désormais accessible depuis le menu Facturation > Factures fournisseur, où trois nouvelles entrées apparaissent : Imports, Import manuel et Import automatique.

Vérification post-installation

  1. Sur la ligne du module, cliquez sur l'icône d'engrenage pour ouvrir la configuration.
  2. La page de configuration affiche votre adresse IP publique (utile pour le support en cas de blocage réseau).
  3. Renseignez votre adresse mail et un mot de passe, puis cliquez sur « Vérifier la connexion ». Si tout va bien, un message « Connexion avec le serveur établie » apparaît et une clé d'API est créée pour votre compte.
  4. Si une erreur de liste noire (blacklist) s'affiche, suivez le lien proposé pour demander le déblocage de votre adresse IP.

Permissions utilisateur

Le module définit trois permissions :

  • Lire les données ScanInvoices.
  • Créer ou modifier des objets ScanInvoices.
  • Supprimer des objets ScanInvoices.

Pour qu'un utilisateur non administrateur puisse importer des factures, attribuez-lui ces droits ainsi que ceux nécessaires pour gérer les tiers, fournisseurs, produits et factures fournisseur, depuis Accueil > Utilisateurs et groupes.

Mise à jour

  1. Téléchargez la nouvelle archive depuis le DoliStore.
  2. Désactivez ScanInvoices dans Accueil > Configuration > Modules/Applications.
  3. Déployez la nouvelle archive comme lors de l'installation initiale.
  4. Réactivez le module : Dolibarr applique les éventuelles mises à jour de base de données et enregistre les nouveaux hooks.

Important : la désactivation puis la réactivation sont nécessaires à chaque mise à jour pour que les évolutions du schéma de base soient appliquées et que les nouveaux menus apparaissent.

Désinstallation

Désactivez simplement le module depuis la liste des modules. Les données importées (factures, tiers créés) restent dans Dolibarr et ne sont pas supprimées.

Back to top