Fichiers XML pour Belcotax on web

Transcription

1 Fichiers XML pour Belcotax on web 1. Description 2. Structure 2.1 Général 2.2 Record Record Record Record Record 9 3. Contenu des zones 4. Validation et envoi 5. Exemple 6. Remarque 01/02/2008 Revenus 2007

2 1. Description Depuis deux ans, l application Belcotax-on-web permet l envoi de fichiers.xml, en plus du fichier.txt traditionnel. Un fichier.xml est facilement généré à partir d'une base de données relationnelle. En outre un fichier.xml peut être chargé dans un système de gestion de base de données comme MS ACCESS; cela facilite la lecture du fichier. Dans un fichier.xml, seules les zones utiles sont remplies alors que dans un fichier.txt toutes zones non utilisées sont remplies avec des zéros ou des blancs. Dans un fichier.txt, chaque record a une longueur de 1000 positions. Dans un fichier.xml, la longueur des records n'a pas d'importance, il est seulement important que chaque tag soit écrit correctement. 2. Structure 2.1 Général Un fichier.xml pour Belcotax-on-web a fondamentalement la même structure que celle d un fichier.txt : chaque fichier commence avec une record de début (record «0») dans lequel les données de l'envoi et celles de l'expéditeur sont mentionnées, et termine avec un record de fin (record «9») dans lequel sont repris les totaux de contrôle du fichier entier. Entre ces records de début et de fin sont repris un ou plusieurs «fichiers de données» (un fichier de données est composé d un ensemble de records «1», «2» et «8»). Un «fichier de données» commence avec un record de début (record «1») qui comprend les données du débiteur, et termine avec un record de fin (record «8») qui contient les totaux de contrôle du «fichier de données». Entre le record de début (record «1») et celui de fin (record «8») sont repris un ou plusieurs record(s) de données (record(s) «2») dans le(s)quel(s) sont mentionnées les données du bénéficiaire des revenus, ainsi que les montants et autres données relatives à une fiche. Cette structure de base est détaillée dans notre brochure Belcotax 2008 que vous pouvez télécharger sur la page «Documents et supports techniques» de notre site Sur cette même page, vous pouvez également télécharger le fichier.xsd Belcotax-2007 qui défini la mise en page (le lay-out) qu un fichier.xml doit avoir. Quelques règles de base importantes pour les fichiers.xml : Attention : les tags doivent être repris exactement tels que ci-dessous. Le tags sont repartis selon la structure suivante : <Verzendingen> <Verzending> <Aangiften> <Aangifte> <Opgaven> <Opgave32510>

3 <Fiche28110> < \ Fiche28110> < \ Opgave32510> <Opgave32520> <Fiche28120> < \ Fiche28120> < \ Opgave32520> < \ Opgaven> < \ Aangifte> < \ Aangiften> < \ Verzending> < \ Verzendingen> Pour tout record utilisé, l ensemble des tags correspondants doivent être repris, même s'ils ne comprennent pas de contenu significatif. Pour les records «0», «1», «8» et «9», tous les tags doivent toujours être mentionnés, même si ils ne sont pas complétés. Pour le(s) record(s) «2», les tags doivent être repris uniquement pour les fiches que vous souhaitez déposer. Pour les fiches déposées, tous les tags doivent être repris, même les tags pour des zones qui ne sont pas remplies. Pour les zones non remplies, soit seul le tag de début est mentionné, soit les tags de début et fin sont repris, mais sans contenu entre les deux tags. Les zones de date ont le format suivant : dd-mm-jjjj. Dans fichier.txt, la date est mentionnée sans signes de séparation (ddmmjjjj). Les montants sont mentionnés en eurocent, sans virgule ni point décimal, comme dans un fichier.txt. Les numéros nationaux sont mentionnés sans virgule ni point décimal. Pour les zones signées, seul le signe négatif doit être mentionné, à gauche du montant Le record 0 Tous les tags du record de début «0» commencent avec «<v00». Ils comprennent les informations concernant l'envoi et l'expéditeur Le record 1 Tous les tags du record de début de fichier de donnée «1» commencent avec «<a10». Ils comprennent les informations concernant la déclaration et le débiteur Le record 2 Les tags du record de donnée «2» sont communs à toutes les fiches et commencent avec «<f20». Ils comprennent les informations concernant le type de fiche et le bénéficiaire.

4 Les tags comprenant les données de détail des fiches commencent toujours avec le type de la fiche et ensuite le numéro de la zone. Par exemple, pour la fiche , les tags commencent avec «<f10_2» Le record 8 Tous les tags du record de fin de fichier de données «8» commencent avec «<r80». Ils comprennent les totaux de contrôle relatifs à la déclaration (ou fichier de données) qu ils ferment Le record 9 Tous les tags du fichier de fin «9» commencent avec «<r90». Ils comprennent les totaux de contrôle relatifs au fichier complet. 3. Le contenu des zones Les instructions relatives au contenu des zones sont reprises dans la brochure Belcotax Toute règle relative au contenu d une zone pour un fichier.txt est également applicable pour un fichier.xml. Il y a cependant une exception : le format des zones de date dans le fichier.xml est «dd-mmjjjj» (ddmmjjjj pour un fichier.txt). Tous les autres nombres et montants du fichier.xml sont écrits sans virgule, ni point décimal. Pour les zones numériques signées, on ne doit pas mentionner le signe pour les montants positifs ou nuls. Pour les montants négatifs, le signe doit être mentionné avant le montant. Les règles fiscales qui s appliquent pour les montants repris dans les différentes zones se trouvent dans l «Avis aux employeurs et autres débiteurs de revenus». 4. Validation et envoi Les fichiers.xml peuvent être validés en ligne, puis être envoyés via l application sécurisée Belcotax dont le lien est : Vous trouverez plus d'information au sujet du login vers l'application sécurisée dans la brochure Belcotax 2008, chapitre 1.3. Les instructions pour l utilisation de l'application Belcotax-on-web se trouvent dans le mode d'emploi que vous pouvez télécharger sur la page «Documents et support technique». 5. Exemple Sur la page «Documents et support technique» vous pouvez télécharger un exemple d'un fichier.xml (Belcotax-2007.xsd), dans lequel toutes les fiches possibles ont été reprises.

5 6. Remarque La mise en page (lay-out) d un fichier.xml pour Belcotax-on-web sera adaptée d'ici 2009 (années des revenus 2008). Il ne sera alors plus nécessaire de reprendre tous les tags, il suffira de mentionner les tags relatifs aux zones avec un contenu significatif. Cela permettra une forte réduction de la taille des fichiers et cela rendra aussi les fichiers.xml plus lisibles.