1 Aanmaak van een XML bestand voor de aangifte van de lijst van ingezeten klanten en aantal verrichtingen Ed. 20072 Nationale Bank van België, Brussel...
5. Structuur van de tabel : identificatie van de kolommen
7
6. Voorbeeld van tabel
8
7. Beschrijving van de gegevens
9
7.1 7.2
Administratieve gegevens Aangiftegegevens
9 10
8. XML Definition
11
8.1 Introduction 8.2 General Principles 8.2.1 Structure of content part 8.2.2 About CSSR admin parameters 8.3 XML Schema 8.3.1 'Client list' Dataset 8.3.2 'Client list' table 8.3.3 Table Number 8.3.4 Definition of a reported cell 8.3.5 Sequential number 8.3.6 Base 8.3.7 All XML Schema definitions together 8.4 Example Delivery
3
12 12 12 13 13 13 14 15 15 16 16 17 18
1. Inleiding 1
De statistische aangiften gericht aan de NBB worden elektronisch ingezameld met behulp van een Internet 2 toepassing genaamd CSSR . Deze toepassing laat toe : ─ het versturen van bestanden in XML formaat via e-mail ; ─ het encoderen van de aangifte met behulp van een webformulier ; ─ het beveiligd uploaden van bestanden met behulp van het webformulier in CSV formaat en ─ het beveiligd uploaden van bestanden in XML formaat via Internet. Dit document beschrijft hoe u een XML bestand moet aanmaken voor de rapportering van de lijst van ingezeten klanten en het aantal verrichtingen. Het is belangrijk te weten dat de rapportering gebaseerd is op de volgende concepten : ─ enquête, ─ tabel, ─ lijn, ─ kolom en ─ cel. Deze begrippen worden hierna toegelicht en aan de hand van een concreet voorbeeld geïllustreerd.
1 NBB : Nationale Bank van België 2 CSSR : Central Server for Statistical Reporting (Centrale server voor de statistische aangiften)
5
2. Uitsluitingen Voor de aanmaak van een bestand in CSV formaat dient men beroep te doen op de specifieke documentatie van iedere enquête. Voor de aanmaak van een XML bestand voor het rapporteren van de "activiteiten met het buitenland betreffende diensten, overdrachten en goederen", dient men beroep te doen op de adequate documentatie.
3. Enquêtes waarvoor dit document van belang is Enkel de enquêtes en de tabellen die hieronder worden geïdentificeerd, maken gebruik van de regels vermeld in dit document. IDENTICATIE VAN DE
NAAM VAN DE ENQUÊTE
ENQUÊTE
L01PKI
Lijst van ingezeten klanten en aantal verrichtingen
6
4. Identificatie van de tabel De enquête hierboven vereist de rapportering van één enkele tabel. Het gaat om tabel 0010. Het is noodzakelijk de vorm van deze tabel in elk rapport te respecteren . Tabel 00.10
Lijst van ingezeten klanten en aantal verrichtingen
5. Structuur van de tabel : identificatie van de
kolommen Iedere tabel is samengesteld uit lijnen en kolommen. In een tabel worden de verschillende records voorgesteld onder de vorm van opeenvolgende lijnen geïdentificeerd door opeenvolgende nummers. In een kolom zal men altijd het zelfde soort informatie vinden in de verschillende opeenvolgende records. De kolommen zijn bij conventie geïdentificeerd door een kolomnummer dat dezelfde betekenis heeft in iedere tabel. Een gegeven is opgenomen in een cel op de kruising van een lijn en een kolom. De kolommen dragen de volgende nummers : 99
Ondernemingsnummer (of BTW-nummer) van de klant
50
Aantal betalingen uitgevoerd naar het buitenland
60
Aantal betalingen ontvangen uit het buitenland
7
6. Voorbeeld van tabel Dit voorbeeld is afkomstig van de enquête L01PKI, tabel 0010 : "lijst van ingezeten klanten en aantal verrichtingen".
KLANT ONDERNEMINGS-NUMMER
AANTAL BETALINGEN UITGEVOERD NAAR HET BUITENLAND
AANTAL BETALINGEN ONTVANGEN UIT HET BUITENLAND
99
50
60
1
0203201340
500000
500001
2
0489987365
10
20
Lijn 1 van dit voorbeeld bevat een record betreffende de onderneming met nummer 0203201340, die 500 000 betalingen naar het buitenland heeft uitgevoerd en 500 001 betalingen uit het buitenland heeft ontvangen. De cel gesitueerd op de kruising van lijn "1" en kolom "99" bevat de melding "0203201340". Qua concepten heeft men : ─ enquête : "L01PKI" ─ tabel : "0010" ─ lijn : "1" ─ kolom : "99" ─ waarde van de cel gedefinieerd door lijn "1" en kolom "99" : "0203201340".
8
7. Beschrijving van de gegevens Het XML bestand bevat twee types gegevens : - administratieve gegevens en - aangiftegegevens.
7.1
Administratieve gegevens
Deze gegevens dienen om de verstuurde bestanden te beheren, de afzender te identificeren, de inhoud te identificeren en te preciseren langs welk kanaal het ontvangstbewijs en het validatierapport naar de afzender moeten verstuurd worden. De gegevens zijn de volgende : GEGEVEN
BESCHRIJVING
FORMAAT
VOORBEELD
admin creation_time
creatiedatum van het bestand
yyyy-mm-dd hh:mm:ss
"2006-01-10 12:05:32"
sender kbo
ondernemingsnummer (BTW-nummer) of identificatie van de OKI
Num(10)
"0402325689"
Tekst
"BE2003069561CBF"
name
naam van de contactpersoon
vrije tekst
"Durand Robert"
Email
E-mailadres van de contactpersoon
vrije tekst
"robert.durant@enterprise. be"
telephone
telefoonnummer
vrije tekst
"02/355.15.15"
fax
faxnummer
vrije tekst
"02/355.80.10"
email_response
E-mailadres voor het versturen van het ontvangstbewijs door de NBB
vrije tekst
"robert.durant@entreprise. be"
transform_response
het validatierapport van de aangifte moet ofwel in leesbaar formaat ('true") ofwel in html machineformaat ("false") verstuurd worden
boolean : "true" "false"
"true"
transform_acknowledgement
het ontvangstbewijs moet ofwel in door mens leesbaar formaat ('true") ofwel ofwel in XML formaat ("false") zijn.
boolean : "true" "false"
"true"
9
GEGEVEN
BESCHRIJVING
FORMAAT
VOORBEELD
secure_response
het validatierapport moet ofwel versleuteld worden ('true") ofwel niet versleuteld worden ("false") - enkel voor de optie "strong secure".
boolean : "true" "false"
"false"
secure_acknowledgement
het ontvangstbewijs moet ofwel versleuteld worden ('true") ofwel niet versleuteld worden ("false") - enkel voor de optie "strong secure
boolean : "true" "false"
'true"
lang
communicatietaal
X(2) waarden : "nl" = Nederlands "fr" = Français "de" = Deutsch "en" = English
"nl"
xsi:type
toepassingsdomein = betalingsbalans
tekst
"PrtAcquisitionDataset "
enquête
identificatie van de enquête
tekst
" L01PKI"
per
rapporteringsperiode
yyyy-mm
"2007-01"
tblnr
identificatie van de tabel
tekst
"0010"
bas
rapporteringsbasis
N(2) waarde "99" verplicht
"99"
nihil
preciseert of de transacties plaatsgehad hebben voor de periode
boolean : "true" "false"
"true" (=niets aan te geven)
7.2
Aangiftegegevens
De aangiftegegevens identificeren de cellen van elke tabel door de coördinaten van de lijnen en kolommen en registreren de inhoud van elke cel. GEGEVEN
BESCHRIJVING
FORMAAT
VOORBEELD
cell
identificatie van het element cel
-
"0203201340"
rub
identificatie van de rapportlijn
tekst
"1"
col
identificatie van de kolom
tekst
"99"
10
8. XML Definition Revision History Revision 1.0
27 May 2005
Table of Contents 8.1. Introduction 8.2. General Principles 8.2.1. Structure of content part 8.2.2. About CSSR admin parameters 8.3. XML Schema 8.3.1. Client list Dataset 8.3.1.1. Description 8.3.1.2. XML Schema Definition 8.3.1.3. Details 8.3.2. Client list table 8.3.2.1. Description 8.3.2.2. XML Schema Definition 8.3.2.3. Details 8.3.3. Table Number 8.3.3.1. Description 8.3.3.2. XML Schema Definition 8.3.3.3. Details 8.3.4. Definition of a reported cell 8.3.4.1. Description 8.3.4.2. XML Schema Definition 8.3.4.3. Details 8.3.5. Sequential number 8.3.5.1. Description 8.3.5.2. XML Schema Definition 8.3.5.3. Details 8.3.6. Territorial Base 8.3.6.1. Description 8.3.6.2. XML Schema Definition 8.3.6.3. Details 8.3.7. Currency Code 8.3.7.1. Description 8.3.7.2. XML Schema Definition 8.3.7.3. Details 8.4. All XML Schema definitions together 8.5. Example Delivery
11
8.1
Introduction
The reporting for the 'Client list' 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.1. 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 is structured. Then a detailed description is given of the XML Schema at which the 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.
8.2
General Principles
8.2.1
Structure of content part
The data to report is organized into tables. A table is a two dimensional structure made of : ─ rows identified by a numerical id ─ columns. The tables are identified by ─ reporting period the data relates to ─ a table number, for example 0492 ─ a territorial base - for example 10
...
Cells are making up the crossing between a row and a column identified by a sequential number and a column code respectively. A cell can contain only one value.
0203201340500000500001
1] [2]
by following Statistics > Declarations > Summary in other words it is defined by mlns:xsd="http://www.w3.org/2001/XMLS
12
If a declarer has no cells to report, then the table can be declared “nihil” by using the nihil attribute. The specific tables which are part of the' Client list' can variate in time and will be described in an additional document. In that, for each table, a table number and a list of columns is described. For each column the column code, the format and the semantics will be given. 8.2.2
About CSSR admin parameters
Concerning some CSSR admin parameters, we have : ─ As content_type = 'PrtAcquisitionDataset' ─ The test parameter is not applicable ─ As lang processing parameter may be used, as default 'English' is assumed.
8.3
XML Schema
This schema needs definitions defined elsewhere in CSSR. 8.3.1
'Client list' Dataset
8.3.1.1
Description
Definition of a 'Client list' dataset containing the tables to report:. The element. the table elements
The cell is the smallest unit inside a table, to report. It corresponds to a single value. The element contains a value to report. Any alphanumerical string is allowed although some restriction applies which are defined in the application. Its format depends on the actual data type expected for the indicated column and table. The following table describes the possible data types. The format of the data types which corresponds to a definition in the XML Schema standard, are identical to the format described there. XML SCHEMA/DATA TYPE
DESCRIPTION
EXAMPLE
string
a finite sequence of characters. Only characters defined in the "ASCII extended character set" are accepted
decimal
A real number with in theory infinite precision
• 210
A point will be used as decimal separator and no grouping character will be used to separate thousands
• 12667.543
When according to the definition of the table, more decimals are reported then defined, they will be truncated.
• +1000.00
• -1.23
In the validation process, based on the definition of the indicated column, restriction are applied on the actual maximal length of a string and the number of significant digits and the scale in case of a decimal. When a decimal is reported with less precision then the one expected according to the column definition, zeros are assumed for the higher precision digits. For example 1.1 will be treated as 1.1000... . Some examples of the element : 0203201340500000500001
The following example is pure fictional and is not complete. It just demonstrates how cell values must be reported. <sender kbo="1234567890"> Mr. X <processing_parameters> <email_response>[email protected]true <description>This is a user-description of the delivery
020320134050000050000104899873651020
18
Voor meer informatie Wie meer informatie wenst over deze handleiding en de methodologie kan terecht bij de dienst Betalingsbalans Tel. +32 2 221 20 81 – Fax +32 2 221 31 44 [email protected]
Verantwoordelijke uitgever
Jean-Jacques Vanhaelen Chef van het departement Algemene statistiek Nationale Bank België de Berlaimontlaan, 14 – BE-1000 Brussel
