Cahier des charges du mode EDI du téléservice Simpl-IR de la Direction Générale des Impôts Déclaration des pensions ------ Version 2.0 OCTOBRE 2014
SUIVI DES VERSIONS Date N Version Motif de Mise à Jour 20/10/2014 2.0 Création Cahier des charges EDI Simpl-IR Pension Version 2.0 Page : 2/16
SOMMAIRE 1 INTRODUCTION... 4 1.1 OBJET DU DOCUMENT... 4 1.2 INTERET DU MODE EDI (ECHANGE DE DONNEES INFORMATIQUES)... 4 2 PROCESSUS DE LA SOLUTION EDI... 5 2.1 SCHEMA DU SCENARIO... 5 2.2 DESCRIPTION DU SCENARIO D ECHANGE... 6 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)... 12 3 STRUCTURE DU FICHIER D ECHANGE... 13 4 ANNEXE... 16 Cahier des charges EDI Simpl-IR Pension Version 2.0 Page : 3/16
1 INTRODUCTION 1.1 Objet du document Ce document a pour objectif d éclaircir et de préciser l ensemble des éléments techniques nécessaires aux éditeurs des logiciels comptables ou aux services informatiques des entreprises (développeurs) pour pouvoir générer les fichier XML représentant les formulaires de la déclaration des pensions à envoyer à la DGI à travers le canal EDI offert par l application Simpl-IR. 1.2 Intérêt du mode EDI (Echange de données informatiques) La DGI offre ce service pour soulager les adhérents et les adhérents délégués de la lourde charge de ressaisie massive des données déjà disponibles dans leur système d information au niveau des logiciels de paie notamment, et ce en leur permettant de transférer, au télé-service Simpl-IR, des fichiers reprenant les dites données, au lieu de les renseigner une à une au niveau de l interface du télé-service. Pour être acceptées et traitées, les données doivent être placées dans un fichier XML selon un format spécifié par la DGI. Les avantages de l EDI sont multiples, en particulier : Une plus grande facilité, en soulageant l utilisateur de la saisie manuelle. Un gain de rapidité par soumission directe et intégrale de l ensemble des données. Une nette amélioration de l exactitude des données : le transfert des données telles qu elles sont dans le système d information de l adhérent délégué sans risque d erreurs lors de la ressaisie. Une traçabilité relative aux phases de traitement du fichier XML. Cahier des charges EDI Simpl-IR Pension Version 2.0 Page : 4/16
2 PROCESSUS DE LA SOLUTION EDI 2.1 Schéma du scénario Ce schéma décrit le scénario de l envoi d un fichier en mode EDI par un adhérent/adhérent délégué, et son traitement par la DGI. En effet, à l entrée du système Simpl-IR, le fichier reçu subira des contrôles immédiats (flux en bleu), et s il est conforme, il subira par la suite des contrôles métier en asynchrone (flux en vert). Si ces derniers sont concluants, il sera sauvegardé et accessible en mode EFI, sinon il sera rejeté. Légende : Flux en Bleu : Actions instantanées Flux en Vert : Actions asynchrones (Batch) Cahier des charges EDI Simpl-IR Pension Version 2.0 Page : 5/16
2.2 Description du scénario d échange Le contribuable (ou son délégué) doit générer à partir de son logiciel de comptabilité, le fichier XML contenant sa déclaration au format attendu par la DGI. Ce format est unique et peut éventuellement faire l objet de modification d une année à l autre. Ce format est décrit dans le présent document et il est téléchargeable à partir du portail internet de la DGI www.tax.gov.ma Important : La génération précitée a lieu au niveau du système d information propre de l adhérent ou de son délégué et recourt à des logiciels qui demeurent sous leur seul contrôle. Elle ne fait partie, en aucun cas, du domaine de responsabilité de la DGI. L échange EDI englobe trois phases : Jointure du fichier XML Validation de format du fichier Contrôle du fichier 2.2.1 Jointure du fichier XML Une fois le contribuable (ou son délégué) génère le fichier XML contenant sa déclaration, il se connecte à l application Simpl-IR, et choisit dans le menu l option «Envoi de fichiers EDI». Une interface web s affiche lui permettant de choisir un ou plusieurs fichiers XML à partir de son ordinateur et de l (les) envoyer à l application SIMPL-IR. L utilisateur habilité à envoyer les fichiers XML via SIMPL IR doit avoir le profil «Rédacteur». Cahier des charges EDI Simpl-IR Pension Version 2.0 Page : 6/16
2.2.2 Validation du format du fichier XML Lors de la soumission du fichier XML par l adhérent ou l adhérent délégué, le Simpl-IR vérifie le format du dit fichier et sa conformité par rapport à celui spécifié par la DGI. Dans le cas où le format du fichier est incorrect, ce dernier est rejeté immédiatement et un message est affiché au contribuable l informant de ce rejet. Dans le cas ou plusieurs fichiers XML sont envoyés, Simpl-IR vérifie le format des fichiers un par un. A ce stade, Simpl-IR effectue également les contrôles suivants : - L'un des champs (nom et prénom) ou raison sociale doit être mentionné dans le fichier xml - La raison sociale, le nom et les prénoms mentionnés dans le fichier doivent correspondre à ceux du contribuable Cahier des charges EDI Simpl-IR Pension Version 2.0 Page : 7/16
Si le fichier est un fichier XML valide et conforme au format défini par la DGI et si les contrôles ci-dessus sont vérifiés il sera stocké dans la base de données Simpl-IR dans son format d origine avec sa date de réception. Un message de confirmation est alors affiché au contribuable. A ce stade le fichier est à l étape «en instance de traitement» ; état visible au niveau du tableau de bord des envois EDI (cf. point 2.2.6) 2.2.3 Contrôle du fichier XML Le système Simpl-IR déclenche à des intervalles réguliers, des traitements sur les fichiers XML qui sont à l étape «en instance de traitement». Ces traitements ont pour principal objet de valider le contenu du fichier d un point de vue fiscal avant de charger son contenu au niveau de la déclaration correspondante. Dans ce sens, le fichier XML subira des contrôles métier, en mode asynchrone, et le résultat y afférent est indiqué au niveau du tableau de bord (cf. point 2.2.6). Il est signalé à cet égard, que ce tableau est l outil du Simpl-IR qui permet au contribuable de suivre, étape par étape, le traitement et le sort des fichiers XML soumis. Lorsque les contrôles métiers détectent une erreur, le fichier est rejeté (Etat de traitement positionné à «Rejet») et le fichier d erreur dans la colonne commentaire indique l erreur relevée. Le contribuable devra alors régénérer un fichier XML valide, et le resoumettre en suivant les mêmes étapes que celles présentées plus haut. Autrement, le fichier est valide et ne comporte pas d anomalies majeures. Dans ce cas, il est accepté et l état de traitement est positionné à «Traité». Les éventuelles anomalies mineures constatées sont alors affichées au niveau de la colonne «Commentaire» du tableau de bord précité. Si le contribuable souhaite corriger ces anomalies, il peut opter pour régénérer et resoumettre un nouveau fichier XML. Ainsi, et dès que le fichier XML est traité avec succès, ses données sont intégrées dans la déclaration correspondante et le processus EDI est terminé. L adhérent trouvera ses données chargées dans la déclaration correspondante en mode EFI, positionnée à l état «brouillon». Il devra alors passer au mode EFI pour procéder aux différentes étapes du workflow de dépôt de la déclaration qui sont conformes au workflow classique du mode EFI, connu des adhérents : complétion de la saisie, validation, signature électronique et dépôt. 2.3 Liste des Contrôles du fichier XML Il est à distinguer entre deux niveaux de contrôles : Validation de format (immédiat) Et Contrôles du contenu fichier (en asynchrone) Cahier des charges EDI Simpl-IR Pension Version 2.0 Page : 8/16
2.3.1 Validation de format Comme précisé plus haut, la validation de format a pour objet la vérification de la conformité du format du fichier soumis par rapport à celui spécifié par la DGI. Cette validation est effectuée à la réception même du fichier, et un retour immédiat est affiché à l utilisateur. En cas de non satisfaction de l un des contrôles de validation, un message de rejet précisant la nature et l emplacement de l erreur est affiché dans la page d envoi. En cas de conformité du format, le fichier est enregistré par le Simpl-IR et son état est marqué «en instance de traitement». L état du fichier est visible au niveau du tableau de bord des envois EDI du téléservice Simpl-IR. En cas de non-conformité, un message d erreur est affiché. Le tableau ci-dessous récapitule les différents contrôles effectués ainsi que les messages d erreur qui seront affichés, le cas échéant : Contrôle à vérifier Messages d erreur en cas de rejet Le fichier spécifié n'est pas un fichier XML valide. Le fichier EDI doit être un fichier XML valide et bien défini. Le fichier que vous avez envoyé est vide L'un des champs (nom et prénom) ou raison sociale doit être mentionné dans le fichier xml La raison sociale, le nom et les prénoms mentionnés dans le fichier doivent correspondre à ceux du contribuable Le service EDI n existe pas pour l exercice fiscal de la déclaration en question. L identifiant fiscal contenu dans le fichier XML doit correspondre au contribuable déclarant ou délégataire. Le fichier doit contenir les balises et les valeurs conformément au format correspondant décrit dans le cahier de charge et exactement tel que spécifié dans l exemple. Le fichier spécifié n'est pas un fichier XML valide. Ou bien Le service EDI n existe pas pour l exercice fiscal choisi. Veuillez signaler ce problème au contact DGI.. L'identifiant fiscal contenu dans le fichier est invalide Format du fichier EDI (XML) invalide : +emplacement et nature de l erreur générés par le Parser XML La taille du fichier XML ne doit pas dépasser 15 Mo Fichier trop volumineux Cahier des charges EDI Simpl-IR Pension Version 2.0 Page : 9/16
Les types de données prévus dans les fichiers EDI sont : Numérique : pour les valeurs numériques ou montants Alphanumérique : pour les valeurs alphanumériques Date : pour les dates au format aaaa-mm-jj (exemple 2014-12-12) 2.3.2 Contrôles du contenu du fichier Ce sont des contrôles «métier» concernant la cohérence des données du fichier XML de la déclaration des pensions. En cas de non conformité par rapport à l un des contrôles, le fichier est rejeté, et le motif de rejet (message d erreur) est affiché dans le fichier d erreur accessible dans la colonne commentaire du tableau de bord de l EDI. Néanmoins, pour certains contrôles, qualifiés de non majeurs, le fichier est accepté même si les dits contrôles relèvent des anomalies. Ces anomalies sont affichées au niveau de la colonne commentaire du tableau de bord. Dans une telle situation, il appartient à l adhérent/adhérent délégué de procéder comme si le fichier ne comporte aucune anomalie et procéder au dépôt de sa déclaration ; ou au contraire, procéder à la rectification des données au niveau de son système d information et retransmettre un nouveau fichier XML. C est cette seconde option que préconise la DGI. Le fichier XML est rejeté si une règle métier n est pas vérifiée ou s il existe déjà au niveau de Simpl IR une déclaration à l état «En attente de validation» pour le même identifiant fiscal et le même exercice fiscal. En effet, une déclaration à l état «en attente de validation» est une déclaration pouvant correspondre à une version finalisée et il serait, par conséquent, hasardeux d écraser ses données par celles provenant du fichier XML. Dans une telle situation, le fichier est rejeté et l adhérent/adhérent délégué devra choisir entre les options suivantes: Renoncer à intégrer les données du fichier XML, s il juge que la déclaration présente dans le système à l état «en attente de validation» est celle qui doit être prise en compte. Ou Signifier clairement qu il souhaite remplacer les données de la déclaration par celles du fichier XML, et ce en remettant la déclaration existante en mode «brouillon». 2.4 Liste des états du fichier XML Le présent paragraphe a pour objet de présenter la liste des états d un fichier EDI XML. Ce fichier subit trois états, à savoir : «En instance de traitement», «Rejeté» ou «Accepté». Cahier des charges EDI Simpl-IR Pension Version 2.0 Page : 10/16
Ces états sont affichés dans le tableau de bord de l application «Suivi Traitement EDI», après réception du fichier et validation de son format. Le tableau ci-dessous les décrit plus en détail : Etat du Fichier EDI Signification En instance de Le fichier reçu avec un format valide est sauvegardé mais pas encore traitement traité. Les contrôles du contenu ne sont pas encore effectués. Rejeté Le fichier reçu n est pas conforme aux contrôles en vigueur,cela veut dire qu un contrôle métier n est pas vérifié ou qu une déclaration en attente de validation existe pour le même contribuable et exercice fiscal ou bien qu un problème technique dans le fichier envoyé empêche sa conversion en objet déclaration en état brouillon. Dans ce cas, le motif de rejet est affiché dans le tableau de bord de l EDI (suivi des traitements des fichiers EDI). Accepté Le fichier XML reçu est valide et son contenu a été chargé au niveau des données de la déclaration correspondante qui est accessible en mode EFI en état brouillon. Si une déclaration est existante à l état brouillon elle sera écrasé par le contenu EDI. Le contribuable doit entrer dans l application Simpl-IR mode EFI afin de valider et déposer sa déclaration. Cahier des charges EDI Simpl-IR Pension Version 2.0 Page : 11/16
2.5 Tableau de bord (suivi des traitements des fichiers EDI) Cet écran permettra de visualiser l état du fichier envoyé. L écran permettra de voir si le fichier a été traité ou pas encore, à travers la colonne «Etat du traitement». Un filtrage par rapport à une période donnée est également disponible. La colonne «Fichier d erreur» permet de télécharger le fichier contenant le motif du rejet du fichier EDI Cahier des charges EDI Simpl-IR Pension Version 2.0 Page : 12/16
3 STRUCTURE DU FICHIER D ECHANGE Le fichier EDI est un fichier XML contenant en plus des données relatives à la déclaration, une partie entête contenant l identifiant fiscal et l exercice fiscal de la déclaration. Le nom du fichier est libre, mais pour faciliter le suivi des fichiers XML par l adhérent/adhérent délégué, il est recommandé d attribuer des noms significatifs qui révèlent aisément le contribuable concerné, la déclaration en question et l année fiscale, entre autres. L adhérent/adhérent délégué devra s assurer qu il envoie un fichier XML correspondant au modèle qui convient au contribuable en question et à la bonne période d imposition. A chaque création d un nouveau modèle de déclaration ou mise à jour d un modèle existant, la DGI publie une mise à jour du cahier des charges (Le présent document), et fournit un exemple de fichier XML correspondant. Sur la base du cahier de charges et de l exemple, l éditeur du logiciel de comptabilité/le développeur pourra générer le fichier EDI en y intégrant les données propres du contribuable et en respectant la structure proposée par la DGI. Le fichier EDI est constitué de trois parties : Partie 0 : La définition du fichier XML Partie 1 : L entête du fichier EDI Partie 2 : Les données de la déclaration Partie 0 : Définition du fichier XML C est la cartouche d identification du fichier XML. <?xml version="1.0" encoding="utf-8"?> <DeclarationPension xmlns:xsi=http://www.w3.org/2001/xmlschema-instance> Partie 1 : Entête du fichier XML Cette partie Entête contient les informations suivantes : Exercice fiscal : dates de début et de fin de l exercice de la déclaration concernée Identifiant fiscal : IF du contribuable Exemple : Cahier des charges EDI Simpl-IR Pension Version 2.0 Page : 13/16
<?xml version="1.0" encoding="utf-8"?> <DeclarationPension xmlns:xsi=http://www.w3.org/2001/xmlschema-instance> <identifiantfiscal> 6658741</identifiantFiscal> <raisonsociale> Raison sociale</raisonsociale> <nom>alami</nom> <prenom>ahmed</prenom> <exercicefiscaldu>2014-01-01</exercicefiscaldu> <exercicefiscalau>2014-12-31</exercicefiscalau> <annee>2014</annee>> Partie 2 : Données de la déclaration Cette partie contient les données spécifiques à la déclaration et qui devront être intégrées au système. Exemple : <totalirpreleve>11.00</totalirpreleve> <totalmontantrevenunetimposable>350.00</totalmontantrevenunetimposable> <totalabattement>551.00</totalabattement> <totalautresdeductions>101.00</totalautresdeductions> <totalmontantbrut>1001.00</totalmontantbrut> <listpensions> <Pension> <irpreleve>10.36</irpreleve> <montantrevenunetimposable>349.80</montantrevenunetimposable> <abattement>550.20</abattement> <autresdeductions>100.36</autresdeductions> <montantbrut>1000.36</montantbrut> <employepension> <nom>aze</nom> <prenom>aze</prenom> <adressepersonnelle>azeaze</adressepersonnelle> <numcni>azeaze</numcni> <numce></numce> <nummatricule>aze</nummatricule> <numcnss>azeaze</numcnss> <situationfamilial> Cahier des charges EDI Simpl-IR Pension Version 2.0 Page : 14/16
<code>c</code> </situationfamilial> </employepension> </Pension> </listpensions> <refinfoscontribuableformulaire> <adresse></adresse> <numtp></numtp> <numtel></numtel> <email></email> <numfax></numfax> <numerocnss></numerocnss> <numerorc></numerorc> <formejuridique> <code>pp</code> </formejuridique> <commune> <code>111.03.01</code> </commune> </refinfoscontribuableformulaire> </DeclarationPension> Cahier des charges EDI Simpl-IR Pension Version 2.0 Page : 15/16
4 ANNEXE Le présent cahier de charge est complété par d autres documents annexes explicités ci-dessous : - Annexe 1, intitulé «Annexe1_EDI_PENSION_Correspondance_Balise_Déclaration_V1.0.doc» et représentant la correspondance entre les champs du formulaire de la déclaration et les balises XML à utiliser au niveau du fichier EDI - Annexe 2, intitulé Annexe2_EDI_PENSION_Simpl-IR_Codification_Référentiel_V1.0.doc» et représentant les éléments du référentiel (villes, taux, ) à utiliser dans le fichier EDI - Annexe 3, intitulé «Annexes3_EDI_PENSION_Exemple_V1.0.zip» et représentant un exemple de fichier EDI conforme à la présente version du cahier de charge. Cahier des charges EDI Simpl-IR Pension Version 2.0 Page : 16/16