Préparation d'un fichier XML pour le reporting des activités avec l'étranger concernant les services, les transferts et les marchandises. Ed.

Please download to get full document.

View again

of 19
335 views
PDF
All materials on our website are shared by users. If you have any questions about copyright issues, please report us to resolve them. We are always happy to assist you.
Document Description
Préparation d'un fichier XML pour le reporting des activités avec l'étranger concernant les services, les transferts et les marchandises Ed Banque nationale de Belgique, Bruxelles Tous droits réservés.
Document Share
Documents Related
Document Transcript
Préparation d'un fichier XML pour le reporting des activités avec l'étranger concernant les services, les transferts et les marchandises Ed. 2006 Banque nationale de Belgique, Bruxelles Tous droits réservés. La reproduction de cette publication, en tout ou en partie,à des fins éducatives et non commerciales est autorisée avec mention de la source. Table des matières 1. Introduction 5 2. Enquêtes concernées par le présent document 7 3. Définition des données Données d'administration Données de déclaration XML definition Introduction General Principles Structure content part About CSSR admin parameters XML Schema Balance of payments Dataset Form Operation Currency Code Country Code All XML Schema definitions together Example Delivery 17 3 1. Introduction Les déclarations statistiques adressées à la BNB 1 sont collectées sous forme informatique à l'aide d'une application Internet appelée CSSR 2. Cette application permet: l'envoi de fichier par au format XML; l'encodage de la déclaration à l'aide du formulaire internet; le téléchargement sécurisé de fichiers au sein du formulaire internet au format CSV et le téléchargement sécurisé de fichiers par internet au format XML. Le but de ce document est de décrire la préparation d'un fichier XML pour le reporting des activités avec l'étranger à la balance des paiements, concernant les services, les transferts et les marchandises. Pour la préparation d'un fichier au format CSV, il faut se reporter à la documentation de chaque enquête. Pour la préparation d'un fichier XML pour le reporting des valeurs mobilières 3, il faut se reporter à la documentation adéquate. Pour les entreprises d'assurances et les fonds de pension, le format de fichier XML est spécifique et est décrit dans une documentation éditée par la CBFA 4.. Pour la préparation d'un fichier au format XML pour le reporting des investissements directs et investissements divers , il faut se reporter à la documentation adéquate. 1 BNB: Banque nationale de Belgique. 2 CSSR: Central Server for Statistical Reporting (serveur central pour les déclarations statistiques) 3 également appelé reporting du portefeuille 4 CBFA: Commission bancaire, financière et des assurances 5 2. Enquêtes concernées par le présent document Seules les enquêtes identifiées dans le tableau ci-dessous appliquent les règles mentionnées dans ce document. IDENTIFIANT DE L'ENQUÊTE/FORMULAIRE 5 F01CDC F01DGS F01PKI F02BRO F02CCI F02INS F02INV F02OPC F02PSF F02RIN F02STB F02TRA F03AVS F03CMS F03MER F03OCT F03TRP F13CON F23CON S03CCR NOM DE L'ENQUÊTE Activités avec l'étranger - centres de coordination Activités avec l'étranger - tous services Activités avec l'étranger - établissements de crédit Activités avec l'étranger - intermédiaires d'assurances Activités avec l'étranger - cartes de paiements Activités avec l'étranger - entreprises d'assurances Activités avec l'étranger - sociétés de gestion de fortune Activités avec l'étranger - organismes de placement collectif Activités avec l'étranger - fonds de pensions Activités avec l'étranger - entreprises de réassurances Activités avec l'étranger - sociétés de bourse Activités avec l'étranger - tourisme Activités avec l'étranger - audiovisuel Activités avec l'étranger - services spécifiques Activités avec l'étranger - marchandises - traders Activités avec l'étranger - transferts du secteur privé Activités avec l'étranger - transport Activités avec l'étranger - construction: entreprises de construction Activités avec l'étranger - construction: maîtres d'ouvrage Activités avec l'étranger - crédits commerciaux 5 Pour les enquêtes dont il est question ici, l'identifiant du formulaire est toujours identique à l'identifiant de l'enquête. Pour d'autres types d'enquêtes, il y a parfois plusieurs formulaires au sein d'une enquête. 7 3. Définition des données Le fichier XML contient deux types de données: les données d'administration et les données de déclaration. 3.1 Données d'administration Ces données servent à administrer les fichiers envoyés, identifier l'expéditeur, identifier le contenu, préciser par quelle voie l'accusé de réception et le rapport de validation doivent être envoyés à l'expéditeur. Ces données sont les suivantes: DONNÉE DESCRIPTION FORMAT EXEMPLE admin creation_time date de création du fichier yyyy-mm-dd hh:mm:ss :05:32 sender kbo numéro d'entreprise (ou numéro de TVA) Num (10) name nom de la personne de contact texte libre Durand Robert adresse de la personne de contact texte libre be telephone numéro de téléphone texte libre 02/ fax numéro de fax texte libre 02/ _response adresse pour l'envoi de l'accusé de réception par la BNB texte libre be transform_response le rapport de validation de la déclaration doit être envoyé en format lisible ( true ) ou en format html machine ( false ) bolean: true false true transform_acknowledgement l'accusé de réception est en format lisible par l'homme ( true ) ou en format XML ( false ) - uniquement pour option strong secure - bolean: true false true secure_response le rapport de validation doit être encrypté ('true ) ou non encrypté ( false ) - uniquement pour option strong secure - bolean: true false false 9 DONNÉE DESCRIPTION FORMAT EXEMPLE secure_acknowledgement l'accusé de réception doit être encrypté ('true ) ou non encrypté ( false ) - uniquement pour option strong secure - bolean: true false 'true lang langue de contact X(2) valeurs: nl = Nederlands fr = Français de = Deutsch en = English fr xsi:type domaine d'application = balance des paiements texte BbpAcquisitionDataset survey identifiant de l'enquête texte F01CDC per période de reporting yyyy-mm form_code identifiant du formulaire texte F01CDC nihil précise s'il n'y a pas eu de transactions pour la période ( true ) ou s'il y en a eu ( false ) bolean: true false true rien à déclarer 3.2 Données de déclaration Les données de la déclaration décrivent les transactions à déclarer à la statistique de la balance des paiements selon les codifications décrites dans la documentation de chaque enquête. DONNÉE DESCRIPTION FORMAT EXEMPLE rub code d'identification de la nature de la transaction X(1)N(4) B2001 cntry code d'identification du pays de la contrepartie non résidente X(2) GB cur code d'identification de la monnaie de la transaction X(3) 'EUR rev montant des revenus (créances et dettes 1 ) dans la monnaie mentionnée N(18) chr montant des charges dans la N(18) monnaie mentionnée 2 1 Les enquêtes relatives aux créances et dettes commerciales ne relèvent pas des revenus et des charges mais bien des créances et des dettes. 2 Ce champ n'est pas utilisé dans le relevé des dettes et créances commerciales. 10 4. XML definition Revision History Revision May 2005 Table of Contents 4.1. Introduction 4.2. General Principles Structure content part About CSSR admin parameters 4.3. XML Schema Balance of payments - Dataset Description XML Schema Definition Details Form Description XML Schema Definition Details Operation Description XML Schema Definition Details Currency Code Description XML Schema Definition Details Country Code Description XML Schema Definition Details 4.4. All XML Schema definitions together 4.5. Example Delivery 11 4.1 Introduction The reporting for the project 'Balance of Payments' is done via the Central Server for Statistical Reporting (CSSR). In this document only specific information related to the reporting itself is described. For general information about usage and functionality of CSSR, we refer to its website 8 To give a quick summary, a cssr document is divided into two parts : Admin part : containing definitions to control the processing of the transfer. This part is independent of the reporting it contains ; Content part : an application specific part containing the actual data to report. It is the content part that is further described in this document. A first section will describe the general principles of how the data are structured. Then a detailed description is given of the XMLSchema at which the content element of the XML document must satisfy. Small examples will be given with their associated definition of the part it highlights. A subsequent section will give the complete XML Schema, followed by a last section with an example of a valid cssr document containing a fictional reporting. 4.2 General Principles Structure content part The data to report is organized into surveys which are further divided into 1 or more forms. Most surveys will contain only one form. Each XML document concerns one survey for a specific reporting period. It is not required to include all forms of the survey in one XML document. Survey and forms are identified by codes. These codes are not enumerated here but are described in an additional document. For example the survey Activities Abroad : Co-ordination Centres has for survey code F01CDC. The survey contains just one form with the same code. Operations are the raw data that is collected and is associated with some form. It is identified - although not uniquely - by a rubric, country and currency code and can have a revenue and/or charges value. Just as with survey and form codes, the rubric codes are elaborated in an additional document About CSSR admin parameters Concerning some CSSR admin parameters, we have : - as content_type = 'BbpAcquisitionDataset'; - the test parameter is not applicable; - as lang processing parameter may be used, as default 'English' is assumed. 8 by following Statistics Declarations Summary 12 4.3 XML Schema This schema needs definitions defined elsewhere in CSSR Balance of payments Dataset Description Definition of a dataset corresponding to one survey. A survey can contains multiple forms, although most of them will contain only one form. The content element. content xmlns= http://www.nbb.be/cssr xmlns:xsi= http://www.w3.org/2001/xmlschema-instance xsi:type= bbpacquisitiondataset survey= surveycode per= the form elements /content XML Schema Definition xsd:complextype xmlns:xsd= http://www.w3.org/2001/xmlschema name= bbpacquisitiondataset xsd:complexcontent xsd:extension base= cssr:content xsd:sequence xsd:element name= form type= cssr:bbpform maxoccurs= unbounded / /xsd:sequence xsd:attribute name= survey type= xsd:string use= required / xsd:attribute name= per type= xsd:gyearmonth use= required / /xsd:extension /xsd:complexcontent /xsd:complextype Details Content : complex Inheriting elements and attributes from the definition of cssr:content ATTRIBUTES NAME TYPE REQUIRED DEFAULT VALUE DESCRIPTION survey xsd:string Yes Code to identify the survey per xsd:gyearmonth Yes Reporting period to which the data relates to CONTENT : A SEQUENCE OF THE FOLLOWING ELEMENTS IN STRICT ORDER NAME TYPE MIN MAX DESCRIPTION form cssr:bbpform 1 N 13 4.3.2 Form Description A form includes directly raw operations It is also the minimal unit of reporting, so when one operation must be updated it is obliged to resend the complete form. When there is nothing to declare for some form, it must be reported as nihil. form element form code= formcode ... op elements... /form XML Schema Definition xsd:complextype xmlns:xsd= http://www.w3.org/2001/xmlschema name= bbpform xsd:sequence xsd:element name= op type= cssr:bbpoperation minoccurs= 0 maxoccurs= unbounded / /xsd:sequence xsd:attribute name= code type= xsd:string use= required / xsd:attribute name= nihil type= xsd:boolean default= false / /xsd:complextype Details ATTRIBUTES NAME TYPE REQUIRED DEFAULT VALUE DESCRIPTION code xsd:string Yes Code to identify a form nihil xsd:boolean No false Used to denote that the form is a nihil declaration (true) or not (false). For a nihil declaration no operations may be reported. CONTENT : A SEQUENCE OF THE FOLLOWING ELEMENTS IN STRICT ORDER NAME TYPE MIN MAX DESCRIPTION op cssr:bbpoperation 0 N Operation Description An operation is the smallest unit inside a form to report. It is identified - but not necessary uniquely - by its rubric, country and currency code. op rub= 22000 cntry= fr cur= eur revenue= 188 charges= 1059 / XML Schema Definition xsd:complextype xmlns:xsd= http://www.w3.org/2001/xmlschema name= bbpoperation xsd:simplecontent xsd:extension base= xsd:string 14 xsd:attribute name= rub type= xsd:string use= required / xsd:attribute name= cntry type= cssr:isocountry use= optional / xsd:attribute name= cur type= cssr:isocurrency use= optional / xsd:attribute name= rev type= xsd:integer use= optional / xsd:attribute name= chr type= xsd:integer use= optional / /xsd:extension /xsd:simplecontent /xsd:complextype Details Content : simple Inheriting elements and attributes from the definition of xsd:string ATTRIBUTES NAME TYPE REQUIRED DEFAULT VALUE DESCRIPTION rub xsd:string Yes rubric code cntry cssr:isocountry No country code cur cssr:isocurrency No currency code rev xsd:integer No revenue chr 1 xsd:integer No charges Currency Code Description Currency Code according to ISO For example : 'EUR' and 'USD'. Invalid examples are, 'eur' because it is in capitals defined and ' EUR' because leading and trailing spaces are significant XML Schema Definition xsd:simpletype xmlns:xsd= http://www.w3.org/2001/xmlschema name= isocurrency xsd:restriction base= xsd:string xsd:pattern value= [a-z]{3} / /xsd:restriction /xsd:simpletype 1 Not applicable for survey S03CCR 15 Details Restriction based on xsd:string Country Code Description Country Code according to ISO For example : 'US', 'FR' and 'NL'. Invalid examples are, 'us' because it is in capitals defined and ' US' because leading and trailing spaces are significant XML Schema Definition xsd:simpletype xmlns:xsd= http://www.w3.org/2001/xmlschema name= isocountry xsd:restriction base= xsd:string xsd:pattern value= [a-z]{2} / /xsd:restriction /xsd:simpletype Details Restriction based on xsd:string 4.4 All XML Schema definitions together The following XML Schema contains all definitions specific for the reporting. References to types for which the prefix is xsd, refers to the one made in the XML Schema specifications. 1 [2] xsd:schema xmlns:xsd= http://www.w3.org/2001/xmlschema targetnamespace= http://www.nbb.be/cssr elementformdefault= qualified attributeformdefault= unqualified xsd:complextype name= bbpacquisitiondataset xsd:complexcontent xsd:extension base= cssr:content xsd:sequence xsd:element name= form type= cssr:bbpform maxoccurs= unbounded / /xsd:sequence xsd:attribute name= survey type= xsd:string use= required / xsd:attribute name= per type= xsd:gyearmonth use= required / /xsd:extension /xsd:complexcontent /xsd:complextype xsd:complextype name= bbpform xsd:sequence xsd:element name= op type= cssr:bbpoperation minoccurs= 0 maxoccurs= unbounded / 1 in other words it is defined by xmlns:xsd= http://www.w3.org/2001/xmlschema 16 /xsd:sequence xsd:attribute name= code type= xsd:string use= required / xsd:attribute name= nihil type= xsd:boolean default= false / /xsd:complextype xsd:complextype name= bbpoperation xsd:simplecontent xsd:extension base= xsd:string xsd:attribute name= rub type= xsd:string use= required / xsd:attribute name= cntry type= cssr:isocountry use= optional / xsd:attribute name= cur type= cssr:isocurrency use= optional / xsd:attribute name= rev type= xsd:integer use= optional / xsd:attribute name= chr type= xsd:integer use= optional / /xsd:extension /xsd:simplecontent /xsd:complextype xsd:simpletype name= isocurrency xsd:restriction base= xsd:string xsd:pattern value= [a-z]{3} / /xsd:restriction /xsd:simpletype xsd:simpletype name= isocountry xsd:restriction base= xsd:string xsd:pattern value= [a-z]{2} / /xsd:restriction /xsd:simpletype /xsd:schema 4.5 Example Delivery The following example is pure fictional and is not complete. It just demonstrates how operations must be reported. cssr_document xmlns= http://www.nbb.be/cssr admin creation_time= t10:20:00.000 sender kbo= contact name mr. X /name communication xmlns:xsi= http://www.w3.org/2001/xmlschema-instance xsi:type= / communication xmlns:xsi= http://www.w3.org/2001/xmlschema-instance xsi:type= telephone number= / /contact /sender receiver / processing_parameters transform_response true /transform_response /processing_parameters description a sample dataset /description /admin content xmlns:xsi= http://www.w3.org/2001/xmlschema-instance xsi:type= bbpacquisitiondataset survey= f01cdc per= form code= f01cdc op rub= b2001 cntry= fr cur= eur rev= 268 chr= 145 / op rub= b2001 cntry= gb cur= gbp rev= 1545 chr= 544 / op rub= b1101 cntry= nl cur= eur rev= 45 chr= 99 / op rub= f6001 cntry= ar cur= usd rev= 8755 chr= 4541 / /form 17 /content /cssr_document The next example is pure fictional. It contains a nihil declaration of the same form as in the previous example and it contains the minimal information needed in the admin part. cssr_document xmlns= http://www.nbb.be/cssr admin creation_time= t10:20:00.000 sender kbo= / /admin content xmlns:xsi= http://www.w3.org/2001/xmlschema-instance xsi:type= bbpacquisitiondataset survey= f01cdc per= form xmlns= http://www.nbb.be/cssr code= f01cdc nihil= true / /content /cssr_document 18 Pour de plus amples informations Si vous souhaitez obtenir de plus amples informations à propos de ce manuel et de la méthodologie, vous pouvez vous adresser au service Balance des paiements Tél Fax Editeur responsable Jean-Jacques Vanhaelen Chef du département de la Statistique générale Banque nationale de Belgique boulevard de Berlaimont, 14 BE-1000 Bruxelles Illustrations: Gettyimages Photodisc Gettyimages Digital Vision Banque nationale de Belgique Mise en pages: BNB Balance des paiements Couverture: Prepress & Image NBB Publié en septembre 2005.
Similar documents
View more...
Search Related
We Need Your Support
Thank you for visiting our website and your interest in our free products and services. We are nonprofit website to share and download documents. To the running of this website, we need your help to support us.

Thanks to everyone for your continued support.

No, Thanks
SAVE OUR EARTH

We need your sign to support Project to invent "SMART AND CONTROLLABLE REFLECTIVE BALLOONS" to cover the Sun and Save Our Earth.

More details...

Sign Now!

We are very appreciated for your Prompt Action!

x