---
title: "Installation"
weight: 10
description: "Guide d'installation du module Facturx pour Dolibarr."
---

# Installation

## Téléchargement

Téléchargez le module depuis sa [fiche DoliStore](https://www.dolistore.com/product.php?title=FacturX&extid=1511&l=fr). Vous recevez une archive ZIP prête à être installée.

## Installation

1. Connectez-vous à Dolibarr en tant qu'administrateur
2. Rendez-vous dans **Accueil > Configuration > Modules/Applications**
3. Cliquez sur **Déployer/Installer un module externe**
4. Sélectionnez le fichier ZIP téléchargé et validez

![Écran de déploiement d'un module externe dans Dolibarr](screenshots/deployer-module.webp)

## Prérequis

| Prérequis | Version minimale |
|-----------|-----------------|
| Dolibarr | 10.0 |
| PHP | 7.3 |
| Extension PHP GD | requise |
| Extension PHP zlib | requise |

Si une extension PHP manque, la page de configuration affichera un message d'erreur explicite.

## Activation

1. Rendez-vous dans **Accueil > Configuration > Modules/Applications**
2. Recherchez "Facturx" dans la catégorie **Financier** ou via le champ de recherche
3. Cliquez sur l'interrupteur pour activer le module

![Page d'activation du module Facturx dans la liste des modules Dolibarr](screenshots/activation-module.webp)

## Ce qui se passe à l'activation

Le module crée automatiquement :

- Les **champs complémentaires Chorus** sur les factures (code service, numéro de marché, numéro d'engagement, identifiant Chorus)
- Les **mêmes champs** sur les commandes (sauf l'identifiant Chorus)
- Un champ **Tiers payeur** sur les factures (visible uniquement en profil EXTENDED)

Ces champs sont visibles sur les fiches facture et commande. Ils peuvent être masqués via la [configuration](/facturx/configuration) si vous ne travaillez pas avec le secteur public.

## Vérification post-installation

Après activation, rendez-vous sur la fiche d'une facture client existante et régénérez le PDF. Si tout fonctionne, le PDF généré contient désormais les métadonnées Factur-X. Vous pouvez le vérifier avec un lecteur PDF capable d'afficher les pièces jointes embarquées (le fichier `factur-x.xml` apparaît dans les pièces jointes du PDF).

> **Attention :** Si des informations obligatoires manquent sur votre société ou votre client (numéro de TVA, adresse, etc.), le module affichera des messages d'erreur. Consultez la page [FAQ](/facturx/faq) pour résoudre ces problèmes.

## Mise à jour

1. Téléchargez la nouvelle version du module depuis le DoliStore
2. Installez-la via **Déployer/Installer un module externe** (comme pour l'installation initiale)
3. **Désactivez** puis **réactivez** le module dans la liste des modules

La désactivation/réactivation est nécessaire pour appliquer les éventuelles mises à jour de base de données et enregistrer les nouveaux hooks.

## Désinstallation

Pour désinstaller le module, désactivez-le depuis **Accueil > Configuration > Modules/Applications** en cliquant sur l'interrupteur. Les champs complémentaires Chorus restent en base de données mais ne sont plus affichés.