Installation
Téléchargement
Téléchargez le module depuis sa fiche DoliStore. Vous recevez une archive ZIP prête à être installée.
Installation
- Connectez-vous à Dolibarr en tant qu'administrateur
- Rendez-vous dans Accueil > Configuration > Modules/Applications
- Cliquez sur Déployer/Installer un module externe
- Sélectionnez le fichier ZIP téléchargé et validez
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
- Rendez-vous dans Accueil > Configuration > Modules/Applications
- Recherchez "Facturx" dans la catégorie Financier ou via le champ de recherche
- Cliquez sur l'interrupteur pour activer le module
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 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 pour résoudre ces problèmes.
Mise à jour
- Téléchargez la nouvelle version du module depuis le DoliStore
- Installez-la via Déployer/Installer un module externe (comme pour l'installation initiale)
- 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.