---
title: "Installation"
weight: 10
description: "Installer, activer et mettre à jour le module de facture normalisée électronique dans Dolibarr."
---

# Installation

Avant de commencer, vérifiez que votre dossier auprès de la DGI est ouvert :
voir [Inscription auprès de la DGI](/capcifne/inscription-dgi). Vous pouvez
installer le module sans, mais vous ne pourrez rien certifier.

## Téléchargement

Le module est distribué sur la place de marché
[Dolistore](https://www.dolistore.com). Vous recevez une archive ZIP prête à être
déployée.

## Déploiement

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 l'archive ZIP téléchargée et validez.

## Activation

1. Restez dans **Accueil > Configuration > Modules/Applications**.
2. Cherchez "Facture normalisée électronique" dans la famille **Financier**, ou
   saisissez son nom dans le champ de recherche.
3. Cliquez sur l'interrupteur pour activer le module.

## Ce que l'activation met en place

L'activation crée, sans rien écraser de ce que vous auriez déjà configuré :

- **Les deux tables du registre** : les certifications et leur journal.
- **Les champs complémentaires** nécessaires à la traduction d'une facture vers
  le format FNE :
  - sur la fiche **tiers** : NCC du client, régime de l'acheteur, régime
    d'exonération du client, gabarit de facturation ;
  - sur la fiche **produit** : régime d'exonération du produit ;
  - sur les **familles** (catégories) de produits : régime d'exonération de la
    famille.
- **Les trois permissions** du module (voir [Permissions](/capcifne/permissions)).
- **Le menu** du haut, avec l'accueil du module et le registre des certifications.
- **L'onglet FNE** sur les factures clients et l'onglet **Bordereau FNE** sur les
  factures fournisseurs.
- **Une colonne Référence FNE** dans la liste des factures clients, et le rappel
  de cette référence sur la fiche facture.
- **Les valeurs par défaut** des réglages qui en ont une : environnement de
  **Test**, adresse d'essai publiée par la DGI, délai de 15 minutes avant
  réouverture d'un envoi, délai d'attente de 30 secondes, seuil d'alerte du stock
  de stickers à 50, simulation avant envoi activée.

Aucune valeur d'exemple n'est écrite pour l'adresse de production, les clés
d'API, le point de vente, l'établissement ou le NCC. Ces champs restent vides, et
c'est volontaire : une valeur d'exemple oubliée fait refuser toutes vos factures.

## Vérification après installation

1. Ouvrez **Accueil > Configuration > Modules/Applications**, puis la
   configuration du module (l'icône en forme d'engrenage).
2. Allez dans l'onglet **Diagnostic**.

Cette page n'appelle jamais la plateforme FNE : elle vérifie localement votre
configuration et votre registre. Juste après l'installation, elle doit indiquer
l'environnement **Test**, l'adresse d'essai de la DGI comme adresse admise, et
signaler que l'identité de votre dossier est incomplète. C'est le résultat
attendu : il reste à faire la [configuration](/capcifne/configuration).

Vérifiez aussi que les deux tables du registre sont lisibles : la section
**Registre de certification** de cette page doit afficher des compteurs, pas le
message "Table illisible".

## Mise à jour

1. Téléchargez la nouvelle archive et déployez-la comme pour l'installation
   initiale.
2. **Désactivez** puis **réactivez** le module dans la liste des modules.

La désactivation suivie d'une réactivation est nécessaire : c'est elle qui
applique les mises à jour de la base de données et réenregistre les onglets, les
menus et les permissions. Elle ne touche pas à votre configuration, ni au contenu
du registre.

## Désactivation et désinstallation

Pour désactiver le module, basculez son interrupteur dans **Accueil >
Configuration > Modules/Applications**.

> [!WARNING]
> **Le registre de certification n'est pas supprimé, et ne doit jamais l'être.**
> Il est la seule mémoire de ce que vous avez déjà envoyé à la DGI : aucune
> interface de programmation ne permet de demander à l'administration si une
> facture existe déjà chez elle. Perdre le registre, c'est renvoyer à la DGI des
> factures déjà certifiées, sans moyen de le savoir ni de le corriger autrement
> que par des avoirs.
>
> Le registre contient aussi les réponses brutes de la plateforme, et ce sont
> elles qui portent les identifiants d'articles sans lesquels **aucun avoir n'est
> possible**.

Les champs complémentaires posés sur les tiers, les produits et les familles
restent également en base après la désactivation. Ils cessent simplement d'être
affichés.

Incluez les deux tables du registre dans vos sauvegardes de base de données, au
même titre que vos factures.