CAHIER DES CHARGES EFI

Transmission des déclarations au format

EFI XML

Direction Générale des Impôts

République de Côte d’Ivoire

Copyright © 2016 - Direction générale des Impôts - République de Côte d'Ivoire. Tous droits réservés
 Cahier des charges EFI - e-impots.gouv.ci

Evolutions du cahier des charges

sVersion Date Auteur Description
Première version mise à disposition des
1.0 12/10/2017 DGI – Projet e-impôts
contribuables sur e-impots.gouv.ci

Commentaires :

Ce document est une version de travail.

Les règles et modalités présentées dans ce cahier des charges sont donc susceptibles d’évoluer en fonction des
remarques des experts comptables impliqués dans le projet et de l’avancée des travaux de la Direction Générale des
Impôts.

2 / 13
 Cahier des charges EFI - e-impots.gouv.ci

Table des matières

Evolutions du cahier des charges................................................................................................. 2
Introduction ................................................................................................................................. 4
Contexte du projet e-impôts ......................................................................................................................................... 4
Présentation du document ........................................................................................................................................... 4
Fonctionnement de l’envoi de fichiers EFI ................................................................................... 5
Processus d’envoi des fichiers EFI ............................................................................................................................. 5
ETAPE 1 : Génération du fichier EFI XML par le contribuable .............................................................................. 5
ETAPE 2 : Injection du fichier XML sur e-impôts .................................................................................................. 6
ETAPE 3 : Contrôle de la cohérence du fichier lors de l’injection .......................................................................... 6
Structure de la norme EFI XML .................................................................................................... 6
Présentation de la structure ........................................................................................................................................ 6
Exemple de rendu au format XML ........................................................................................................................... 8
Définition du fichier XML .......................................................................................................................................... 8
Présentation du bloc declaration................................................................................................................................. 9
Contenu du bloc declaration ..................................................................................................................................... 9
Alimentation des données du bloc informations ...................................................................................................... 9
Présentation du bloc champs ...................................................................................................................................... 9
Alimentation des données du bloc champs............................................................................................................... 9
Présentation du bloc champ ........................................................................................................................................ 9
Alimentation des données du bloc champ .............................................................................................................. 10
Règles d’alimentation spécifiques .......................................................................................................................... 10
Annexes ...................................................................................................................................... 12
Liste des documents en annexes................................................................................................................................ 12
Contacts ..................................................................................................................................... 13
Support et assistance ................................................................................................................................................. 13
Adresse ................................................................................................................................................................... 13
Email ...................................................................................................................................................................... 13
Téléphone ............................................................................................................................................................... 13

3 / 13
 Cahier des charges EFI - e-impots.gouv.ci

Introduction
Contexte du projet e-impôts
Dans le cadre de la modernisation de ses services, le Gouvernement ivorien a lancé le projet e-impôts, mené et réalisé
par la Direction Générale des Impôts (DGI), avec pour objectif d’améliorer l’offre de service public et de simplifier les
procédures de déclaration et de paiement des impôts.

Le projet a abouti à la mise en place d’un portail web de téléprocédures : le site e-impôts (www.e-impots.gouv.ci). Grâce
à ce portail, les contribuables ont la possibilité de déclarer et payer leurs impôts et taxes de manière dématérialisée, sans
avoir à se rendre dans leur centre des impôts de rattachement ni dans leur banque.

En parallèle de la mise à disposition de formulaires de déclaration en ligne, la Direction Générale des Impôts a souhaité
automatiser l’injection des déclarations, par l’utilisation d’une technologie moderne et adaptée aux besoins des
contribuables.

L’ensemble des déclarations peuvent désormais être transmises sur e-impôts par un tout nouveau canal : l’EFI (Echange
de Formulaires Informatisés).

Présentation du document
Ce cahier des charges a pour objectif de présenter l’ensemble des spécifications fonctionnelles et techniques à respecter
par les contribuables pour utiliser le service de transmission par EFI dans le respect des normes établies par la Direction
Générale des Impôts.

Ce document s’adresse donc aux éditeurs des logiciels comptables et aux services informatiques des entreprises. La
lecture et la bonne compréhension du chapitre Structure de la norme EFI XML nécessite une connaissance de base du
langage XML.

A ce jour, le périmètre de l’EFI concerne l’ensemble des impôts disponibles sur e-impôts.

4 / 13
 Cahier des charges EFI - e-impots.gouv.ci

Fonctionnement de l’envoi de fichiers EFI

Processus d’envoi des fichiers EFI
Le processus d’envoi de fichiers par EFI se déroule en 3 étapes :

Etape 1 : Génération du fichier EFI XML par le contribuable

Etape 2 : Injection du fichier XML sur e-impôts
Etape 3 : Contrôle de la cohérence du fichier lors de l’injection

ETAPE 1 : Génération du fichier EFI XML par le contribuable

Afin d’envoyer des fichiers par EFI sur e-impôts, le contribuable doit générer un fichier au format EFI XML qu’il est
possible de générer de deux manières :
A) Automatiquement à partir d’un système d’information ;
B) Manuellement à partir du fichier EXCEL mis à disposition par la DGI.

A) Génération automatique à partir d’un système d’information

La solution recommandée par la Direction Générale des Impôts, est la génération automatique d’un fichier XML à partir
du système d’information du contribuable.

Le présent cahier des charges et les différents documents annexés fournissent l’ensemble des informations nécessaires
à la constitution de fichiers conformes.

La norme EFI XML est établie et maintenue par la Direction Générale des Impôts, qui se réserve le droit d’y apporter
d’éventuelles modifications.
Toute évolution future sera présentée et discutée auprès des contribuables utilisant la solution EFI, de manière
suffisamment anticipée pour permettre la prise en compte des évolutions demandées.

IMPORTANT
Il revient au contribuable de mener, par ses propres soins ou par les soins d’une tierce partie, les travaux
nécessaires à la mise en place et à la maintenance d’un module capable de générer les fichiers des déclarations
respectant la norme EFI XML établie par la Direction Générale des Impôts.

B) Génération manuelle à partir d’un fichier EXCEL

Afin de garantir une accessibilité du service EFI à l’ensemble des entreprises, la Direction Générale des Impôts met à
disposition des fichiers EXCEL permettant de saisir manuellement les déclarations afin de les convertir au format XML.

Ainsi la génération du fichier XML depuis le fichier EXCEL s’effectue comme suit :

5 / 13
 Cahier des charges EFI - e-impots.gouv.ci

1. Ouverture fichier ;
2. Saisie des données ;
3. Lancement en un clic de la macro afin de générer le XML;
4. Création automatique du fichier formaté selon la norme EFI XML de la DGI.

La Direction Générale des Impôts s’assure de la maintenance du modèle de fichiers EXCEL. Ce fichier sera mis à la
disposition des entreprises directement sur le portail e-impôts.

QUAND UTILISER LE FICHIER EXCEL POUR GENERER SON FICHIER ?

En cas d’impossibilité à implémenter un programme de génération automatique de fichiers XML
depuis votre système
En cas d’incident technique survenant sur votre programme de génération automatique de fichiers
XML
En cas de faible volume de données à déclarer facilement reportable manuellement

Attention : ce fichier n’est pas un outil comptable et n’offre aucune fonctionnalité en dehors de la saisie et de l’export
XML. Il est nécessaire de calculer et contrôler ses données en amont.

ETAPE 2 : Injection du fichier XML sur e-impôts

L’utilisateur se connecte à son espace personnel e-impôts sur le site www.e-impots.gouv.ci

Une fois sur l’espace entreprise, l’utilisateur charge le XML à l’étape 3 de la déclaration grâce au bloc : « Informations
sur la transmission des déclarations par EFI » (un clic permet de dérouler le bloc).

ETAPE 3 : Contrôle de la cohérence du fichier lors de l’injection

Lorsque l’utilisateur a chargé son XML et qu’il clique sur « Importer des données » plusieurs contrôles de cohérences
s’effectuent.

Ces différents contrôles vérifient notamment que le fichier XML respecte la norme EFI XML de la DGI, que les
informations correspondent notamment à la déclaration sur laquelle l’utilisateur se situe, que les données envoyées
respectent également les contrôles de cohérence classiques (par exemple : des contrôles s’effectuent sur des données
qui doivent nécessairement être positives)

Si l’injection se déroule correctement un message de confirmation prévient le contribuable que l’injection s’est déroulée
correctement.

En revanche, différents messages d’erreurs peuvent apparaitre si les contrôles ne sont pas vérifiés. Ces différents
messages préviennent le contribuable des raisons de l’échec afin que ce dernier puisse corriger son XML.

Structure de la norme EFI XML

Présentation de la structure
La norme de fichier EFI XML de la DGI définit la structure à respecter lors de la confection des fichiers par le
contribuable.
Cette structure est basée sur un nœud racine (niveau 0) contenant les 6 sous-niveaux d’éléments présentés ci-dessous :

6 / 13
 Cahier des charges EFI - e-impots.gouv.ci

NIVEAU 0 NIVEAU 1 NIVEAU 2 NIVEAU 3

NCC

Code taxe
INFORMATIONS
Mois
FICHIER XML

Exercice
DECLARATION

Code champ
DETAIL CHAMPS
DECLARATION (1 à N champ)
Valeur champ

Eléments complexes (groupe Eléments simples (alimentation

Légende :
de données) des données)

Deux types d’éléments sont distingués :

Les éléments complexes : ce sont des groupes de données qui contiennent eux-mêmes d’autres groupes de
données et/ou des éléments simples et constituent ainsi la structure de la déclaration (tableaux, champs) ;
Les éléments simples : ce sont les éléments XML unitaires qui sont valorisés dans le fichier avec les différentes
données à renseigner sur la déclaration (codes, montants, listes déroulantes, etc.).

7 / 13
 Cahier des charges EFI - e-impots.gouv.ci

Exemple de rendu au format XML

L’exemple ci-dessous présente un exemple de fichier fictif pour une déclaration de l’AIRSI qui comprendrait deux
champs :

Définition du fichier XML

Tous les fichiers XML des déclarations doivent débuter par : <?xml version="1.0" encoding="UTF-8"?>

Le fichier est ensuite systématiquement défini par une balise <EFI>, qui est l’élément racine du fichier XML.

8 / 13
 Cahier des charges EFI - e-impots.gouv.ci

Présentation du bloc declaration

Contenu du bloc declaration

Le bloc declaration contient toutes les informations qui permettent d’identifier de manière unique la déclaration d’un
contribuable.

Le bloc informations est un élément contenant une séquence d’éléments :

Tous les éléments de ce bloc sont obligatoires et uniques ;
Ils doivent être présentés dans l’ordre prévu

Nom de l’élément Elément parent Type d’élément Répétition possible

declaration EDI Complexe Non
codeTaxe declaration Simple Non
ncc declaration Simple Non
mois declaration Simple Non
exercice declaration Simple Non
champs declaration Complexe Oui

Alimentation des données du bloc informations

Nom de l’élément Règles d’alimentation
informations Bloc contenant les différents éléments d’identification de l’annexe
ncc C’est numéro de compte du contribuable, constitué de 7 chiffres + 1 lettre, associé à la
déclaration concernée.
codeTaxe C’est le code spécifique de la taxe concernée (la liste est disponible en annexe).
periode C’est le mois associé à la déclaration concernée.
exercice C’est l’année associée à la déclaration concernée.
champs Bloc contenant l’ensemble des informations sur les différents champs du tableau concerné

Présentation du bloc champs

Le bloc champs contient toutes les informations qui viennent valoriser la déclaration. Celles-ci sont ainsi réparties dans
un ou plusieurs blocs champ :

Chaque bloc champ peut être répété autant de fois que nécessaire afin que tous les champs de la déclaration
soient renseignés ;

Nom de l’élément Elément parent Type d’élément Répétition possible

champs declaration Complexe Non
champ champs Complexe Oui

Alimentation des données du bloc champs

Nom de l’élément Règles d’alimentation
champs Bloc contenant 1 à N éléments tableau
champ Bloc contenant le code et la valeur d’un champ de la déclaration

Présentation du bloc champ

Le bloc Champ est un élément contenant une séquence (xs:sequence) d’éléments :
Le code et la valeur sont uniques ;
Ces deux éléments doivent obligatoirement être présentés dans l’ordre prévu.

9 / 13
 Cahier des charges EFI - e-impots.gouv.ci

Nom de l’élément Elément parent Type d’élément Répétition possible

champ champs Complexe Non
code champ Simple Non
valeur champ Simple Non

Alimentation des données du bloc champ

Nom de l’élément Règles d’alimentation

champ Bloc contenant l’ensemble des informations permettant d’identifier un champ précis et de
le valoriser
code C’est le code du champ concerné pour un bloc Champ donné.
Il permet au module EFI d’identifier le champ déclaré.
Ce code est alimenté sur base du référentiel établi par la DGI :
Seuls les codes de champs existants dans ce référentiel seront acceptés

valeur C’est la valeur à donner au champ identifié par le code défini au sein du même élément
champ.
L’élément valeur peut contenir différents formats de données selon le champ concerné :
Montants : les montants sont servis en FCFA, sans décimales ni séparateurs de
milliers ;
Dates : les dates sont servies au format JJ/MM/AAAA

Exemple : si dans le système d’information du comptable, le champ

« mtn_retenue » a la valeur 12 000 000, alors l’élément champ
correspondant du fichier XML contiendra :
<code>mtn_retenue</code>
<valeur>12000000</valeur>

Règles d’alimentation spécifiques

Les codes attribués à chaque tableau et à chaque champ ainsi que les contraintes de format propres à chaque champ sont
détaillés dans les documents annexés au présent cahier des charges.

Les contraintes propres à chaque champ peuvent être de plusieurs natures :

Contrainte de type de donnée (numérique, alphanumérique, date) ;
Contrainte de longueur ;
Référentiel de valeurs autorisés : certains champs doivent être alimentés sur base de transcodification établie
dans la l’annexe des référentiels jointe en annexe.

Règles d’alimentation des dates

Les dates sont alimentées au format « JJ/MM/AAAA ».

Exemple (pour un champ d’un tableau à renseigner avec une date) :

<champ>
<code>date</code>
<valeur>28/03/2014</valeur>
</champ>

Règles d’alimentation des NCC

Les NCC sont alimentées avec le format qui leur est propre : 7 chiffres +1 lettre.

Exemple:

<champ>

10 / 13
 Cahier des charges EFI - e-impots.gouv.ci

<code>ncc</code>
<valeur>1234567A</valeur>
</champ>

11 / 13
 Cahier des charges EFI - e-impots.gouv.ci

Annexes
Les documents joints en annexes du présent cahier des charges fournissent l’ensemble des informations nécessaires à
l’élaboration de la structure des fichiers EFI au format XML, ainsi qu’à leur alimentation selon la codification établie
par la DGI.

Liste des documents en annexes

MACRO DE GENERATION Fichiers EXCEL vierges faisant office de base de référence commune entre la
DES EFI Direction Générale des Impôts et les entreprises pour le contenu des
déclarations.
Excel de génération par macro des XML
EXEMPLES DE XML Fichiers XML faisant office d’exemple de ce qui est attendu par la Direction
FONCTIONNELS Générale des Impôts.
Les données y étant servies sont totalement fictives. Elles sont alimentées à titre
d’exemple destiné aux techniciens et ne revêtent aucune cohérence comptable
particulière.
Fichiers XML à joindre
LISTE DES CODES Fichier excel présentant les codes des champs et les règles de contrôle associées
SPECIFIQUE A CHAQUE
pour chacune des annexes de déclaration.
XML
Fichier excel avec un onglet par pour chaque annexe qui
présente les champs et leurs règles de contrôle
LISTE DES REFERENTIELS Fichier EXCEL de transcodification listant les données codifiées à utiliser pour
la valorisation de certains champs.
Seules les valeurs prévues dans ce référentiel pourront être servies lors de
l’alimentation des champs concernés.
Combiner les tables RefCodeEmploi / RefSituationFamille /
RefRegime / RefNationalite / refSexe / RefExpatrie /
RefRegime301
LCODIFICATION POUR LES Fichier EXCEL listant pour chaque déclaration les tableaux et les champs, avec
TAXES leur codification EFI et les contraintes (format, longueur, etc.) à respecter.

12 / 13
 Cahier des charges EFI - e-impots.gouv.ci

Contacts
Support et assistance
Le support technique et l'assistance utilisateur est assurée par la cellule e-impôts.

Adresse Email Téléphone

Cellule e-impôts e-impots@dgi.gouv.ci Téléphone : +225 20 21 10 90 / 20 21
BP V 103 Abidjan, Cité 90 81 / 20 21 71 08
administrative, tour E Cellulaire : 42 252 525 / 07 637 637
/ 07 347 347

Direction Générale des Impôts

République de Côte d’Ivoire

13 / 13