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.

Pré-requis serveur

Avant l'installation, vérifiez que votre serveur dispose des éléments suivants. Le module les contrôle au premier accès à la page de configuration et affiche un message d'erreur explicite si l'un d'eux manque.

• PHP 7.0 minimum
• Extensions PHP : intl, fileinfo, gd, mbstring
• Fonction PHP : finfo_open
• Le module Dolibarr Tâches planifiées (Cron) doit être activé pour le traitement en arrière-plan
• Les modules Tiers, Fournisseurs, Produits et Services doivent être activés
• Une connexion sortante vers https://ocr.cap-rel.fr (ou votre propre serveur d'OCR) doit être autorisée

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 email 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 blacklist s'affiche, suivez le lien proposé pour demander le déblocage de votre adresse IP.

Pour le détail complet des paramètres, voir Configuration.

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 dans 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 à 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 réactivation est nécessaire à 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.