Installation

Installation

Téléchargement

Téléchargez le module depuis le DoliStore ou depuis votre espace client CAP-REL.

Installation du module

  1. Décompressez l'archive téléchargée

  2. Copiez le dossier scanpdf dans le répertoire htdocs/custom/ de votre installation Dolibarr

  3. Installez les dépendances Composer :

     cd htdocs/custom/scanpdf
 composer install --no-dev

Activation

  1. Connectez-vous en tant qu'administrateur Dolibarr
  2. Allez dans Accueil > Configuration > Modules/Applications
  3. Recherchez "ScanPdf" dans la liste (famille « Financier »)
  4. Cliquez sur le bouton d'activation

Page d'activation du module ScanPdf dans la liste des modules Dolibarr

Le module crée automatiquement les tables nécessaires en base de données et les répertoires de travail.

Vérifications automatiques

À l'activation, le module vérifie la présence des extensions PHP requises :

  • intl — Internationalisation (formats de dates multilingues)
  • fileinfo — Détection du type MIME des fichiers
  • gd — Manipulation d'images
  • mbstring — Gestion des chaînes multi-octets (UTF-8)

Si une extension est manquante, un message d'erreur est affiché sur la page de configuration. Installez l'extension concernée puis rechargez la page.

Migrations automatiques

Lors de l'activation (ou de la réactivation après mise à jour), le module effectue automatiquement les migrations suivantes :

  • Migration des constantes — Les anciennes constantes SCANINVOICES_* et SCANPAY_* sont copiées vers SCANPDF_*
  • Migration des produits par défaut — Les produits par défaut définis dans l'ancien module ScanInvoices sont récupérés
  • Correction des employés orphelins — Les employés rattachés à un établissement supprimé sont réaffectés

Aucune action manuelle n'est nécessaire.

Dépendances

Le module ScanPdf nécessite les modules Dolibarr suivants :

Module Raison
Tiers Gestion des fournisseurs
Fournisseurs Création de factures et commandes fournisseur
Produits/Services Association des lignes de facture à des produits
Tâches planifiées (Cron) Import automatique en arrière-plan
SmartAuth Authentification JWT pour l'interface ScanDocuments v2

Permissions

Le module définit quatre niveaux de permissions, configurables dans Accueil > Configuration > Utilisateurs > Permissions :

Permission Description
Lire Accès en lecture aux fonctionnalités ScanPdf
Créer/Modifier Import de documents et création d'objets Dolibarr
Supprimer Suppression des fichiers importés
Expert Accès aux outils de diagnostic (édition des regex, visualisation des patterns)

Mise à jour

  1. Remplacez le dossier scanpdf par la nouvelle version
  2. Relancez composer install --no-dev
  3. Désactivez puis réactivez le module dans Accueil > Configuration > Modules/Applications pour appliquer les migrations de base de données
ScanPdf Configuration