ROYAUME DU MAROC

Cahier des charges

du mode EDI du tlservice
SIMPL-TVA

Relev des dductions

-----Version 1.0
24 Juillet 2015

ROYAUME DU MAROC

SUIVI DES VERSIONS

Date

N Version

24/07/2015

1.0

Cahier des charges EDI SIMPL-TVA Version 1.0

Motif de Mise Jour

Cration

Page : 2/15

ROYAUME DU MAROC

SOMMAIRE
1

INTRODUCTION .............................................................................................................................................. 4
1.1

OBJET DU DOCUMENT .................................................................................................................................... 4

1.2

INTERET DU MODE EDI (ECHANGE DE DONNEES INFORMATISE) ....................................................................... 4

PROCESSUS DE LA SOLUTION EDI ............................................................................................................. 5

2.1

SCHEMA DU SCENARIO .................................................................................................................................. 5

2.2

DESCRIPTION DU SCENARIO DECHANGE......................................................................................................... 5

2.3

LISTE DES CONTROLES DU FICHIER XML ....................................................................................................... 8

2.4

LISTE DES ETATS DU FICHIER XML .............................................................................................................. 10

2.5

TABLEAU DE BORD (SUIVI DES TRAITEMENTS DES FICHIERS EDI)................................................................... 11

STRUCTURE DU FICHIER DECHANGE ................................................................................................... 12

ANNEXE .......................................................................................................................................................... 15

Cahier des charges EDI SIMPL-TVA Version 1.0

Page : 3/15

ROYAUME DU MAROC

1 INTRODUCTION
1.1

Objet du document

Ce document a pour objectif dclaircir et de prciser lensemble des lments techniques ncessaires aux
diteurs des logiciels ou aux services informatiques des entreprises (dveloppeurs) pour pouvoir gnrer les
fichiers XML reprsentant les documents en pice jointe la dclaration de taxe sur la valeur ajoute
envoyer la DGI travers le canal EDI de lapplication SIMPL-TVA.

1.2

Intrt du mode EDI (Echange de donnes informatis)

La DGI offre ce service pour soulager les adhrents et les adhrents dlgus de la lourde charge de
ressaisie massive des donnes dj disponibles dans leur systme dinformation au niveau des logiciels
utilis pour la comptabilit notamment , et ce en leur permettant de transfrer, au tl-service SIMPL-TVA
des fichiers reprenant lesdites donnes, au lieu de les renseigner une une au niveau de linterface du tlservice.

Pour tre acceptes et traites, les donnes doivent tre places dans un fichier XML selon un format
spcifi par la DGI.

Les avantages de lEDI sont multiples, en particulier :

Une plus grande facilit, en soulageant lutilisateur de la saisie manuelle.

Un gain de rapidit par soumission directe et intgrale de lensemble des donnes issues du SI
propre ladhrent.

Une nette amlioration de lexactitude des donnes : le transfert des donnes telles quelles sont
dans le systme dinformation de la socit ou de ladhrent dlgu sans risque derreurs lors de la
ressaisie.

Une traabilit relative aux phases de traitement du fichier XML.

Cahier des charges EDI SIMPL-TVA Version 1.0

Page : 4/15

ROYAUME DU MAROC

2 PROCESSUS DE LA SOLUTION EDI

2.1

Schma du scnario

Ce schma dcrit le scnario de lenvoi dun fichier en mode EDI par un adhrent/adhrent dlgu, et son
traitement par la DGI. En effet, lentre du systme SIMPL-TVA, le fichier reu subira des contrles
immdiats (flux en bleu), et sil est conforme, il subira par la suite des contrles mtier en asynchrone (flux
en vert). Si ces derniers sont concluants, il sera sauvegard et accessible en mode EFI, sinon il sera rejet.
Lgende :

Flux en Bleu : Actions instantanes

Flux en Vert : Actions asynchrones

(Batch)

2.2

Description du scnario dchange

Le contribuable (ou son dlgu) doit gnrer partir de son systme dinformation, le fichier XML au format
attendu par la DGI. Ce format est unique et peut ventuellement faire lobjet de modification dune anne
lautre. Ce format est dcrit dans le prsent document et il est tlchargeable partir du portail internet de la
DGI www.tax.gov.ma
Important : La gnration prcite a lieu au niveau du systme dinformation propre de ladhrent ou
de son dlgu et recourt des logiciels qui demeurent sous leur seul contrle. Elle ne fait partie, en
aucun cas, du domaine de responsabilit de la DGI.

Cahier des charges EDI SIMPL-TVA Version 1.0

Page : 5/15

ROYAUME DU MAROC

Lchange EDI englobe trois phases :

Jointure du fichier XML

Validation de format du fichier

Contrle du fichier

2.2.1

Jointure du fichier XML

Une fois le contribuable (ou son dlgu) gnre le fichier XML contenant les lments de son relev de
dduction relatif une dclaration TVA, il doit le compresser (sous format .zip) et puis il se connecte
lapplication SIMPL-TVA, et choisit dans le menu loption Envoi EDI . Une interface web saffiche lui
permettant de choisir un ou plusieurs fichiers XML partir de son ordinateur et de lenvoyer lapplication
SIMPL-TVA.
Lutilisateur habilit envoyer les fichiers XML via SIMPL-TVA doit avoir le profil Rdacteur .

2.2.2

Validation du format du fichier XML

Lors de la soumission du fichier XML par ladhrent ou ladhrent dlgu, le SIMPL-TVA vrifie le format
dudit fichier et sa conformit par rapport celui spcifi par la DGI. Dabord le fichier doit tre sous format
.zip , et aussi le fichier xml doit tre un fichier valide. Dans le cas o le format du fichier est incorrect, ce

Cahier des charges EDI SIMPL-TVA Version 1.0

Page : 6/15

ROYAUME DU MAROC

dernier est rejet immdiatement et un message est affich au contribuable linformant de ce rejet (cf. cran
ci-dessous).
Dans le cas ou plusieurs fichiers XML sont envoys, Simpl-TVA vrifie le format des fichiers un par un.

A ce stade, SIMPL-TVA effectue galement les contrles suivants :

- Les champs : identifiant fiscal, priode, anne et rgime doivent tre mentionn dans le fichier xml

Si le fichier est un fichier XML valide et conforme au format dfini par la DGI et si les contrles ci-dessus
sont vrifis il sera stock dans la base de donnes SIMPL-TVA dans son format dorigine avec sa date de
rception. Un message de confirmation est alors affich au contribuable.

A ce stade le fichier est ltape en attente de traitement ; tat visible au niveau du tableau de bord des
envois EDI (cf. point 2.5)

Cahier des charges EDI SIMPL-TVA Version 1.0

Page : 7/15

ROYAUME DU MAROC

2.2.3

Contrle du fichier XML

Le systme SIMPL-TVA dclenche des intervalles rguliers, des traitements sur les fichiers XML qui sont
ltat en attente de traitement. Ces traitements ont pour principal objet de valider le contenu du fichier
selon le format indiqu avant de charger son contenu au niveau de la dclaration correspondante.
Dans ce sens, le fichier XML subira des contrles mtier, en mode asynchrone, et le rsultat y affrent est
indiqu au niveau du tableau de bord (cf. point 2.5). Il est signal cet gard, que ce tableau est loutil du
SIMPL-TVA qui permet au contribuable de suivre, tape par tape, le traitement et le sort des fichiers XML
soumis.
Lorsque les contrles mtiers dtectent une erreur, le fichier est rejet (Etat de traitement positionn
Rejet ) et le fichier derreur dans la colonne commentaire indique lerreur releve. Le contribuable devra
alors rgnrer un fichier XML valide, et le resoumettre en suivant les mmes tapes que celles prsentes
plus haut.
Autrement, le fichier est valide et ne comporte pas danomalies majeures. Dans ce cas, il est accept et
ltat de traitement est positionn Trait . Les ventuelles anomalies mineures constates sont alors
affiches au niveau de la colonne Commentaire du tableau de bord prcit. Si le contribuable souhaite
corriger ces anomalies, il peut opter pour rgnrer et resoumettre un nouveau fichier XML.
Ainsi, et ds que le fichier XML est trait avec succs, ses donnes sont intgres dans la dclaration
correspondante et le processus EDI est termin. Ladhrent trouvera ses donnes relatives au relev
charges dans la dclaration correspondante en mode EFI, positionne ltat brouillon . Il devra passer
en mode EFI pour diter sa dclaration et ce niveau Il peut diter le (ou les ) relev travers le bouton
Grer et apportes les modifications dsires. Ensuite il pourra procder aux diffrentes tapes du
workflow de dpt de la dclaration qui sont conformes au workflow classique du mode EFI, connu des
adhrents : compltion de la saisie, validation, signature lectronique et dpt.

2.3

Liste des Contrles du fichier XML

Il est distinguer entre deux niveaux de contrles :

Validation de format (immdiat)

Et

2.3.1

Contrles du contenu fichier (en asynchrone)

Validation de format

Comme prcis plus haut, la validation de format a pour objet la vrification de la conformit du format du
fichier soumis par rapport celui spcifi par la DGI. Cette validation est effectue la rception mme du
fichier, et un retour immdiat est affich lutilisateur. En cas de non satisfaction de lun des contrles de
validation, un message de rejet prcisant la nature et lemplacement de lerreur est affich dans la page
denvoi. En cas de conformit du format, le fichier est enregistr par le SIMPL-TVA et son tat est marqu
en attente . Ltat du fichier est visible au niveau du tableau de bord suivi des envois EDI du tlservice
SIMPL-TVA.
En cas de non-conformit, un message derreur est affich.

Cahier des charges EDI SIMPL-TVA Version 1.0

Page : 8/15

ROYAUME DU MAROC

Le tableau ci-dessous rcapitule les diffrents contrles effectus ainsi que les messages derreur qui seront
affichs, le cas chant :

Contrle vrifier

Messages derreur en cas de rejet

Le fichier EDI doit tre un fichier XML valide, bien dfini et

compress en format zip

Fichier non valide.

(soit le fichier nest en format zip, ou fichier

vide)

Lidentifiant fiscal contenu dans le fichier XML doit

correspondre au contribuable dclarant ou dlgataire.

Le fichier doit contenir les balises et les valeurs

conformment au format correspondant dcrit dans le
cahier de charge et exactement tel que spcifi dans
lexemple.
La taille du fichier XML ne doit pas dpasser 1
Mo(compress) (150Mo)

Identifiant fiscal incorrect !

(l'identifiant fiscal contenu dans le
fichier est invalide)

Format du fichier EDI (XML) invalide :

+emplacement et nature de lerreur
gnrs par le Parser XML

Fichier trop volumineux

Les types de donnes prvus dans les fichiers EDI sont :

Numrique : pour les valeurs numriques ou montants

Alphanumrique : pour les valeurs alphanumriques

Date : pour les dates au format AAAA-MM-JJ (exemple 2015-01-12)

2.3.2

Contrles du contenu du fichier

Ce sont des contrles mtier concernant la cohrence des donnes du fichier xml du relev des
dductions.
En cas de non conformit par rapport lun des contrles, le fichier est rejet, et le motif de rejet (message
derreur) est affich dans la colonne commentaire du tableau de suivi des envois EDI. Nanmoins, pour
certains contrles, qualifis de non majeurs, le fichier est accept mme si les dits contrles relvent des
anomalies. Ces anomalies sont affiches au niveau de la colonne commentaire du tableau de bord. Dans
une telle situation, il appartient ladhrent/adhrent dlgu de procder comme si le fichier ne comporte
aucune anomalie et procder au dpt de sa dclaration ; ou au contraire, procder la rectification des

Cahier des charges EDI SIMPL-TVA Version 1.0

Page : 9/15

ROYAUME DU MAROC

donnes au niveau de son systme dinformation et retransmettre un nouveau fichier XML. Cest cette
seconde option que prconise la DGI.

Le fichier XML est rejet si une rgle mtier nest pas vrifie ou sil nexiste pas de dclaration TVA au
niveau de SIMPL-TVA ltat Brouillon pour le mme identifiant fiscal et la mme priode.

2.4

Liste des tats du fichier XML

Le prsent paragraphe a pour objet de prsenter la liste des tats dun fichier EDI XML. Ce fichier subit trois
tats, savoir : En attente de traitement , Rejet ou Accept .
Ces tats sont affichs dans le tableau de bord de lapplication Suivi Traitement EDI , aprs rception du
fichier et validation de son format.

Le tableau ci-dessous les dcrit plus en dtail :

Etat du Fichier EDI

Signification

En attente

Le fichier reu avec un format valide est sauvegard mais pas encore
trait. Les contrles du contenu ne sont pas encore effectus.

Rejet

Le fichier reu nest pas conforme aux contrles en vigueur ,cela veut dire
quun contrle mtier nest pas vrifi ou quune dclaration en attente de
validation existe pour le mme contribuable et exercice fiscal ou bien
quun problme technique dans le fichier envoy empche sa conversion
en objet dclaration en tat brouillon.
Dans ce cas, le motif de rejet est affich dans le tableau de bord de lEDI
(suivi des envois des fichiers EDI).

Trait

Le fichier XML reu est valide et son contenu a t charg au niveau des
donnes de la dclaration correspondante qui est accessible en mode EFI
en tat brouillon. Si une dclaration est existante ltat brouillon elle sera
crase par le contenu EDI. Le contribuable doit entrer dans lapplication
SIMPL-TVA mode EFI afin de valider et dposer sa dclaration.

Cahier des charges EDI SIMPL-TVA Version 1.0

Page : 10/15

ROYAUME DU MAROC

2.5

Tableau de bord (suivi des traitements des fichiers EDI)

Cet cran permettra de visualiser ltat du fichier envoy. Lcran permettra de voir si le fichier a t trait ou
pas encore, travers la colonne Etat traitement . Un filtrage par rapport une date de rception donne
est galement disponible.
La colonne commentaire permet dindiquer le motif du rejet du fichier EDI sil y a lieu.

Cahier des charges EDI SIMPL-TVA Version 1.0

Page : 11/15

ROYAUME DU MAROC

3 STRUCTURE DU FICHIER DECHANGE

Le fichier EDI est un fichier XML contenant en plus des donnes relatives la dclaration, une partie entte contenant lidentifiant fiscal, le rgime, lanne et la priode de la dclaration.
Le nom du fichier est libre, mais pour faciliter le suivi des fichiers XML par ladhrent/adhrent dlgu, il
est recommand dattribuer des noms significatifs qui rvlent aisment le contribuable concern, la
dclaration en question et lanne fiscale, entre autres.
Ce fichietr XML devra tre zipp avant envoi la DGI

Ladhrent/adhrent dlgu devra sassurer quil envoie un fichier XML correspondant au modle qui
convient au contribuable en question et la bonne priode dimposition.
A chaque modification apportes au modle de relev de dduction, la DGI publie une mise jour du cahier
des charges (Le prsent document), et fournit un exemple de fichier XML correspondant.
Sur la base du cahier de charges et de lexemple, lditeur du logiciel de comptabilit/le dveloppeur pourra
gnrer le fichier EDI en y intgrant les donnes propres du contribuable et en respectant la structure
propose par la DGI.

Le fichier EDI est constitu de trois parties :

Partie 1 : Lentte du fichier EDI

Partie 2 : Les donnes relatives au relev de dduction de la dclaration TVA

Partie 1 : Entte du fichier XML

Cette partie Entte contient les informations suivantes :

Identifiant fiscal : IF du contribuable

Anne

Priode

Rgime

Exemple :

<DeclarationReleveDeduction>
<identifiantFiscal>16</identifiantFiscal>

Cahier des charges EDI SIMPL-TVA Version 1.0

Page : 12/15

ROYAUME DU MAROC

<annee>2015</annee>
<periode>6</periode>
<regime>1</regime>

Partie 2 : Donnes relatives au relev de dduction

Cette partie contient les donnes spcifiques au relev jointes la dclaration qui devront tre intgres au
systme.
Exemple :

<releveDeductions>
<rd>
<ord>1</ord>
<num>5</num>
<des>facture de l'eau </des>
<mht>10.10</mht>
<tva>10.11</tva>
<ttc>10.12</ttc>
<refF>
<if>1122</if>
<nom>REDAL</nom>
<ice>ice</ice>
</refF>
<tx>10.00</tx>
<mp>
<id>1</id>
</mp>
<dpai>2013-01-01</dpai>
<dfac>2013-12-01</dfac>
</rd>

Cahier des charges EDI SIMPL-TVA Version 1.0

Page : 13/15

ROYAUME DU MAROC

<rd>
<ord>2</ord>
<num>1</num>
<des>Designation1</des>
<mht>10.10</mht>
<tva>10.11</tva>
<ttc>10.12</ttc>
<refF>
<if>1122</if>
<nom>Design consulting</nom>
<ice>ice</ice>
</refF>
<tx>10.00</tx>
<mp>
<id>1</id>
</mp>
<dpai>2014-01-01</dpai>
<dfac>2014-01-01</dfac>
</rd>

</releveDeductions>
</DeclarationReleveDeduction>

Cahier des charges EDI SIMPL-TVA Version 1.0

Page : 14/15

ROYAUME DU MAROC

ANNEXE

Le prsent cahier de charge est complt par dautres documents annexes explicits ci-dessous :
Annexe 1, intitul Annexe1_EDI_Simpl-TVA_Correspondance_Balise_RD_V1.0.doc.

Cahier des charges EDI SIMPL-TVA Version 1.0

Page : 15/15