Concepts — Facturation fiscale¶

Cette section explique le vocabulaire et le fonctionnement du module.

Notions clés¶

FNE (Facture Normalisée Électronique) : système de certification des factures électroniques de la DGI de Côte d'Ivoire.
DGI : Direction Générale des Impôts de Côte d'Ivoire, autorité qui régit la FNE.
Clé API FNE : identifiant d'accès qui relie votre organisation à la plateforme FNE. Elle est obtenue lors de l'activation réglementaire.
Import : fichier de factures ou d'avoirs chargé dans le module. Un import regroupe et suit tous les documents d'un même fichier.
Transmission : envoi d'une facture ou d'un avoir à la FNE pour certification. Chaque transmission reçoit un statut (acceptée, rejetée, annulée, en échec).
Référence FNE : identifiant renvoyé par la FNE pour un document certifié, qui atteste de sa normalisation.
Avoir : document qui annule ou réduit une facture certifiée. Voir le glossaire.
Sticker : unité de certification consommée à chaque document transmis à la FNE. Le tableau de bord affiche le solde restant, en valeur.
Sauvegarde externe : copie automatique des PDF certifiés vers un stockage tiers (SFTP, Google Drive, Azure Blob), selon votre plan.
Collecte automatique : trajet inverse de la sauvegarde — le module va chercher vos fichiers sur un stockage SFTP ou Azure Blob et les importe sans intervention.

Le modèle¶

Un modèle assemble deux choses toujours liées :

un mappage d'import, qui décide des colonnes du fichier que vous chargez et de la manière de les lire ;
un template de document, qui décide de la mise en page du PDF certifié.

Chaque modèle porte :

un code, définitif, et un nom ;
une nature, définitive elle aussi, qui décide de la destination de l'import (vente, avoir, bordereau d'achat) ;
deux flux : le flux facture et le flux avoir, chacun avec son propre mappage et son propre template. Un flux avoir désigne le flux facture qu'il corrige.

Standard ou personnalisé¶

Un modèle est soit standard — il appartient à la plateforme, il est lisible par toutes les organisations mais modifiable par aucune —, soit personnalisé — il appartient à votre organisation.

On part rarement d'une feuille blanche : on clone un modèle standard, et le clone devient un modèle personnalisé, libre de toute modification.

Champs système et champs du modèle¶

Les colonnes d'un mappage viennent de deux sources :

les champs système, fournis par la plateforme et listés dans Paramètres › Champs système. Vous ne pouvez pas les créer ni les supprimer, mais chaque modèle peut les renommer, les rendre obligatoires, en changer l'ordre et leur donner ses propres formules.
les champs du modèle, que vous définissez vous-même dans le modèle. Ils n'existent que là.

Certains champs système sont structurels : le module ne sait pas lire un fichier sans eux, ils restent donc obligatoires et non modifiables.

Chaque champ a une portée, signalée par un badge : Facture pour ce qui décrit la facture entière, Ligne pour ce qui décrit une de ses lignes.

Formules¶

Un champ peut porter deux formules, propres au modèle :

une règle de validation, qui refuse une valeur non conforme à l'import ;
une formule de calcul, qui remplit le champ à partir des autres au lieu de le demander dans le fichier.

Le template de document¶

Le template décrit la page imprimée. Il se construit par glisser-déposer sur une feuille qui reproduit la mise en page réelle : un en-tête, un corps, un pied de page, et des blocs qu'on aligne côte à côte en rangées d'au plus quatre colonnes.

Quatre types de blocs se déposent librement : Texte (texte riche, avec des valeurs insérées entre accolades), Image (le logo de la société), Champs (des couples libellé/valeur) et Tableau de lignes.

Certains blocs sont verrouillés : mention fiscale, QR code FNE, totaux, récapitulatif des taxes, montant en lettres, numéros de page. La réglementation les impose ; ils ne se suppriment pas.

Langues¶

Un template déclare ses langues. Le français est toujours présent ; l'anglais s'ajoute d'une case à cocher. Chaque bloc de texte, chaque libellé de champ s'écrit alors dans les deux langues, et le module signale les blocs restés sans version anglaise, qui sortiraient en français.

Versions¶

Un template est versionné. Quand une facture est certifiée, la version du template qui l'a produite est épinglée sur elle : réimprimer la facture des mois plus tard redonne exactement le document que la FNE a certifié, même si le template a changé entre-temps. Les avoirs suivent la même règle.

Formats de fichiers et marque de modèle¶

Le module lit quatre formats : Excel, CSV, XML et JSON.

Un classeur Excel peut porter plusieurs documents. Les fichiers CSV, XML et JSON portent un seul document chacun.

Le module reconnaît un fichier à la marque de modèle qu'il contient — un identifiant écrit dans le fichier lui-même : une feuille de légende pour Excel, une première ligne #model: pour CSV, un attribut sur la racine pour XML et JSON. C'est cette marque, et non le nom du fichier, qui indique le modèle à appliquer. Vous n'avez donc aucune convention de nommage à respecter.

Import manuel : Excel seulement

L'écran Nouvel import n'accepte que des classeurs Excel (.xlsx, .xls). Les formats CSV, XML et JSON servent à la collecte automatique et aux échanges avec vos propres systèmes.

Sources d'alimentation¶

Les factures et avoirs entrent dans le module de quatre manières :

Manuel : import d'un classeur Excel via l'interface.
SFTP : collecte automatique des fichiers déposés sur un serveur SFTP.
Azure Blob Storage : collecte automatique des fichiers déposés dans un conteneur.
Minlessika : documents issus des autres modules de la plateforme.

Consultez aussi le glossaire de la plateforme.

Changelog¶

2.0 (1er août 2026) : ajout des modèles, des champs, des templates versionnés et de la marque de modèle.
1.0 (11 juillet 2026) : création du document.