---
title: "Installation"
weight: 10
description: "Téléchargement, installation, activation et mise à jour du module ScanPdf pour Dolibarr."
---

# Installation

## Téléchargement

Téléchargez le module depuis le [DoliStore](https://www.dolistore.com/) 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 :

    ```bash
    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](screenshots/activation-module.webp)

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