1 Aanmaak van een XML bestand voor de aangifte van de beleggingen in effecten Ed. 20062 Nationale Bank van België, Brussel. Alle rechten voorbehouden...
5. Structuur van de tabellen: identificatie van de kolommen
13
6. Samenstelling van de enquêtes in tabellen en kolommen
15
7. Voorbeeld van tabel
17
8. Beschrijving van de data
19
8.1 8.2
De administratieve data Aangiftegegevens
19 20
9. XML Definition
21
9.1 Introduction 9.2 General Principles 9.2.1 Structure of content part 9.2.2 About CSSR admin parameters 9.3 XML Schema 9.3.1 Portfolio Dataset 9.3.2 A portfolio table 9.3.3 Table Number 9.3.4 Definition of a reported cell 9.3.5 Sequential number 9.3.6 Territorial Base 9.3.7 Currency Code 9.3.8 All XML Schema definitions together 9.4 Example Delivery
3
22 22 22 23 23 23 24 24 25 26 26 27 27 28
1. Inleiding De statistische aangiften gericht aan de NBB1 worden elektronisch ingezameld met behulp van een internet 2 toepassing genaamd CSSR . Deze toepassing laat het volgende toe: ─ het versturen van bestanden in XML formaat via e-mail; ─ het encoderen van de aangifte met behulp van een webformulier; ─ het beveiligd opladen van bestanden in CSV formaat via het webformulier; ─ het beveiligd opladen van bestanden in XML formaat via internet. Dit document beschrijft hoe u een XML bestand moet aanmaken voor de aangifte van de "effecten"3 nodig voor de betalingsbalansstatistieken. Belangrijk is te onthouden dat de rapportering op volgende concepten steunt: ─ enquête; ─ tabel; ─ lijn; ─ kolom en ─ cel. Deze concepten worden hierna beschreven en aan de hand van een voorbeeld verduidelijkt.
1 NBB: Nationale Bank van België. 2 CSSR: Central Server for Statistical Reporting (centrale server voor statistische aangiften) 3 Ook genaamd "portefeuillerapportering"
5
2. Uitsluiting Voor de aanmaak van een bestand in CSV formaat, moet u de handleiding voor elke specifieke enquête raadplegen. De aanmaak van een bestand in XML formaat voor de aangifte van de activiteiten met het buitenland m.b.t. diensten, overdrachten en goederen vindt u terug in de ad hoc documentatie. Voor de aanmaak van een bestand in XML formaat voor de aangifte van de effecten ten behoeve van de betalingsbalans door de kredietinstellingen, verzekeringsondernemingen en de pensioenfondsen, bestaat er een specifiek XML bestandsformaat, beschreven in een specifieke documentatie en gezamenlijk uitgegeven door de CBFA1 en de NBB. Voor de aanmaak van een bestand in XML formaat bestemd voor de aangifte van de "directe investeringen en overige investeringen", verwijzen we eveneens naar de specifieke documentatie terzake.
1
CBFA: Commissie voor het bank-, financie-, en assurantiewezen
7
3. Enquêtes waarvoor dit document van belang is De in dit document beschreven regels zijn van toepassing voor de enquêtes en tabellen opgenomen in onderstaande tabel.
IDENTIFICATIE
NAAM VAN DE ENQUÊTE
S10SNF
Beleggingen in effecten: niet-financiële ondernemingen
S10OPC
Beleggingen in effecten: ICB (instellingen voor collectieve belegging)
S10OPM
Beleggingen in effecten: instellingen voor collectieve belegging met monetair karakter
S10BNB
Beleggingen in effecten: Nationale Bank van België
S10ADM
Beleggingen in effecten: openbare besturen
S10STB
Beleggingen in effecten: beursvennootschappen
S10INV
Beleggingen in effecten: vennootschappen voor vermogensbeheer
9
4. Identificatie van de tabellen Voor de hiervoor vermelde enquêtes dienen meerdere tabellen gerapporteerd te worden. De nummers en hoofdingen van de tabellen worden doorheen de verschillende enquêtes aangeduid. Niettemin is de structuur van elke tabel specifiek voor elke enquête. Het is bijgevolg noodzakelijk zich te houden aan de tabelvorm van elke enquête. Tabel 0390
Haussepositie schuldbewijzen op ten hoogste één jaar
Tabel 0391
Haussepositie schuldbewijzen meer dan één jaar
Tabel 0392
Haussepositie in aandelen en gelijkgestelde effecten
Tabel 0399
Haussepositie in afgeleide producten
Tabel 0490
Baissepositie in schuldbewijzen op ten hoogste één jaar
Tabel 0491
Baissepositie in schuldbewijzen op meer dan één jaar
Tabel 0492
Baissepositie in aandelen en gelijkgestelde effecten
Tabel 0493
Schuldbewijzen op ten hoogste één jaar uitgegeven door de instelling
Tabel 0494
Schuldbewijzen op meer dan één jaar uitgegeven door de instelling
Tabel 0495
Aandelen en gelijkgestelde effecten uitgegeven door de instellingen
Tabel 0499
Afgeleide producten uitgegeven door de instelling
Tabel 0590
Schuldbewijzen op ten hoogste één jaar toevertrouwd aan de instelling
Tabel 0591
Schuldbewijzen op meer dan één jaar toevertrouwd aan de instelling
Tabel 0592
Aandelen en gelijkgestelde effecten toevertrouwd aan de instelling
Tabel 0690
Haussepositie schuldbewijzen op ten hoogste één jaar - reserves
Tabel 0691
Haussepositie schuldbewijzen op meer dan een jaar - reserves
Tabel 0692
Haussepositie aandelen en gelijkgestelde effecten - reserves
11
5. Structuur van de tabellen: identificatie van de
kolommen Elke tabel bestaat uit lijnen en kolommen. De verschillende registraties worden per tabel gerangschikt volgens opeenvolgende lijnen, geïdentificeerd door opeenvolgende nummers. Per kolom vindt men steeds hetzelfde type informatie voor de verschillende opeenvolgende registraties. De kolommen zijn formeel geïdentificeerd door een kolomnummer die in alle tabellen dezelfde betekenis heeft. Een gegeven wordt geregistreerd in een cel, gelegen op de kruising van een lijn en een kolom. De kolommen zijn als volgt genummerd: 05
Nummer van de post v/d boekhoudstaat waarin de effecten zijn opgenomen
10
Identificatie van de effecten: code
11
Identificatie van de effecten: identificatie van de codificatie
15
Identificatie van de effecten: benaming
25
Aantal effecten
30
Stemrecht in percentage
40
Muntcode (ISO-4217 code)
50
Nominale waarde
60
Boekhoudingswaarde
70
Marktwaarde
71
Identificatie van het type marktwaarde
80
Percentage-belang van niet-ingezetenen
90
Sector
98
Plaats van bewaring: landcode van de bewaarder (ISO-3166 code)
99
Plaats van bewaring: ondernemingsnummer van de bewaarder
13
6. Samenstelling van de enquêtes in tabellen en
kolommen Elke enquête is samengesteld uit verschillende tabellen die zelf verschillende kolommen omvatten. ENQUÊTES
TABEL
SxxSNF
0390
05, 10, 11, 15, 40, 50, 60, 70, 71, 98, 99
0391
05, 10, 11, 15, 40, 50, 60, 70, 71, 98, 99
0392
05, 10, 11, 15, 25, 30, 40, 60, 70, 71, 98, 99
0490
05, 10, 11, 15, 40, 50, 60, 70, 71, 98, 99
0491
05, 10, 11, 15, 40, 50, 60, 70, 71, 98, 99
0492
05, 10, 11, 15, 25, 40, 60, 70, 71, 98, 99
0493
05, 10, 11, 15, 40, 50, 60, 70, 71, 80
0494
05, 10, 11, 15, 40, 50, 60, 70, 71, 80
0495
05, 10, 11, 15, 25, 40, 60, 70, 71, 80
0390
05, 10, 11, 15, 40, 50, 60, 70, 71, 98, 99
0391
05, 10, 11, 15, 40, 50, 60, 70, 71, 98, 99
0392
05, 10, 11, 15, 25, 30, 40, 60, 70, 71, 98, 99
0493
05, 10, 11, 15, 40, 50, 60, 70, 71, 80
0494
05, 10, 11, 15, 40, 50, 60, 70, 71, 80
0495
05, 10, 11, 15, 25, 40, 60, 70, 71, 80
0390
05, 10, 11, 15, 40, 50, 60, 70, 71, 98, 99
0391
05, 10, 11, 15, 40, 50, 60, 70, 71, 98, 99
0392
05, 10, 11, 15, 25, 30, 40, 60, 70, 71, 98, 99
0493
05, 10, 11, 15, 40, 50, 60, 70, 71, 80
0494
05, 10, 11, 15, 40, 50, 60, 70, 71, 80
0495
05, 10, 11, 15, 25, 40, 60, 70, 71, 80
SxxOPC
SxxOPM
KOLOMMEN
15
ENQUÊTES
TABEL
SxxOFI
0390
05, 10, 11, 15, 40, 50, 60, 70, 71, 98, 99
0391
05, 10, 11, 15, 40, 50, 60, 70, 71, 98, 99
0392
05, 10, 11, 15, 25, 30, 40, 60, 70, 71, 98, 99
0490
05, 10, 11, 15, 40, 50, 60, 70, 71, 98, 99
0491
05, 10, 11, 15, 40, 50, 60, 70, 71, 98, 99
0492
05, 10, 11, 15, 25, 40, 60, 70, 71, 98, 99
0493
05, 10, 11, 15, 40, 50, 60, 70, 71, 80
0494
05, 10, 11, 15, 40, 50, 60, 70, 71, 80
0495
05, 10, 11, 15, 25, 40, 60, 70, 71, 80
0390
05, 10, 11, 15, 40, 50, 60, 70, 71
0391
05, 10, 11, 15, 40, 50, 60, 70, 71
0392
05, 10, 11, 15, 25, 30, 40, 60, 70, 71
0490
05, 10, 11, 15, 40, 50, 60, 70, 71
0491
05, 10, 11, 15, 40, 50, 60, 70, 71
0492
05, 10, 11, 15, 25, 40, 60, 70, 71
0493
05, 10, 11, 15, 40, 50, 60, 70, 71, 80
0494
05, 10, 11, 15, 40, 50, 60, 70, 71, 80
0495
05, 10, 11, 15, 25, 40, 60, 70, 71, 80
0590
05, 10, 11, 15, 40, 50, 60, 70, 71, 90
0591
05, 10, 11, 15, 40, 50, 60, 70, 71, 90
0592
05, 10, 11, 15, 25, 40, 60, 70, 71, 90
SxxSTB
KOLOMMEN
SxxBNB
In opmaak
SxxADM
In opmaak
16
7. Voorbeeld van tabel
MUNT (CODE ISO-4217)
BEDRAG WAARVOOR DE EFFECTEN ZIJN OPGENOMEN IN DE BETROKKEN POST VAN DE BOEKHOUDSTAAT
MARKTWAARDE
ID
BENAMING
STEMRECHT IN %
ID
LAND
ID
10
11
15
25
30
40
60
70
71
98
99
51
BE0003008019
01
Aand. NBB
10
1
EUR
39.450
38.750
1
BE
0203201340
PLAATS VAN BEWARING
AANTAL
CODE
05
NUMMER VAN DE POST V/D BOEKHOUDSTAAT WAARIN DE EFFECTEN ZIJN OPGENOMEN
1
IDENTIFICATIE VAN DE EFFECTEN
Dit voorbeeld komt uit de enquête S10SNF, tabel 03.92: "Haussepositie in aandelen en gelijkgestelde effecten".
2 3 Het gaat om lijn 1, die een registratie bevat betreffende het bezit van 10 aandelen "NBB" geïdentificeerd door de ISIN-code "BE0003008019". De cel, gelegen op de kruising van lijn "1" en kolom "10" bevat de vermelding "BE0003008019". Terugdenkend aan het concept, heeft men: ─ enquête: "S10SNF"; ─ tabel: "0392"; ─ lijn: "1"; ─ kolom: "10"; ─ cel geïdentificeerd door lijn "1"; ─ kolom "10": BE0003008019".
17
8. Beschrijving van de data Het XML bestand bevat twee types data: ─ de administratieve data en ─ de aangiftedata.
8.1
De administratieve data
Deze worden gebruikt om doorgestuurde bestanden te beheren, om de afzender en de inhoud te identificeren, alsook om te preciseren langs welke weg het ontvangstbewijs en het validatierapport naar de afzender moeten gestuurd worden. De data zijn de volgende:
DATA
BESCHRIJVING
FORMAAT
VOORBEELD
admin creation_time
creatiedatum van het bestand
yyyy-mm-dd hh:mm:ss
"2006-01-10 12:05:32"
sender kbo
ondernemingnummer (BTWnummer) of identificatie van het compartiment (ICB's)
Num(10) vrije tekst
"0402325689" "BE2003069561CBF"
name
naam van de contactpersoon
vrije tekst
"Dewolf Bart"
Email
e-mailadres van de contactpersoon
vrije tekst
"dewolf.bart@onderneming. be"
telephone
telefoonnummer
vrije tekst
"02/355.15.15"
fax
faxnummer
vrije tekst
"02/355.80.10"
email_response
e-mailadres voor verzending door de NBB van het ontvangstbewijs
vrije tekst
"dewolf.bart@onderneming. be"
transform_response
het validatierapport van de aangifte moet worden verstuurd in een leesbaar formaat ("true") of in een html systeemformaat (“false”)
booleaans: "true" "false"
"true"
transform_acknowledgement
het ontvangstbewijs moet ofwel in leesbaar formaat ("true") ofwel in XML formaat (“false”) zijn - enkel voor de streng beveiligde optie
booleaans: "true" "false"
"true"
secure_response
het validatierapport moet ofwel geëncrypteerd zijn ("true") ofwel niet geëncrypteerd (“false”) enkel voor de streng beveiligde optie
booleaans : "true" "false"
"false"
secure_acknowledgement
het ontvangstbewijs moet ofwel geëncrypteerd zijn ("true") ofwel niet geëncrypteerd (“false”) enkel voor de streng beveiligde
booleaans: "true" "false"
'true"
19
DATA
BESCHRIJVING
FORMAAT
VOORBEELD
optie lang
taal voor contacten
X(2) waarden : "nl" = Nederlands "fr" = Français "de" = Deutsch "en" = English
"nl"
xsi:type
toepassingsdomein = betalingsbalans
tekst
"PrtAcquisitionDataset"
survey
identificatie van de enquête
tekst
"S10SNF"
per
aangifteperiode
yyyy-mm
"2006-03"
tblnr
identificatie van de tabel
tekst
"0392"
bas
territoriale basis/bijkantoren in het buitenland
N(2) waarden "10" of "19"
"10"
nihil
aanduiding dat er in de aangifteperiode geen transacties hebben plaatsgehad
booleaans: "true" "false"
"true" niets aan te geven
8.2
Aangiftegegevens
De aangiftegegevens identificeren de cellen van elke tabel via de coördinaten van de lijnen en kolommen en registreren de inhoud van elke cel.
DATA
OMSCHRIJVING
FORMAAT
VOORBEELD
cell
identificatie van de cel
-
"BE0003470755"
rub
identificatie van de lijn
tekst
"1"
col
identificatie van de kolom
tekst
"10"
20
9. XML Definition Revision History Revision 1.0
27 May 2005
Table of Contents 9.1. Introduction 9.2. General Principles 9.2.1. Structure of content part 9.2.2. About CSSR admin parameters 9.3. XML Schema 9.3.1. Portfolio Dataset 9.3.1.1. Description 9.3.1.2. XML Schema Definition 9.3.1.3. Details 9.3.2. A portfolio table 9.3.2.1. Description 9.3.2.2. XML Schema Definition 9.3.2.3. Details 9.3.3. Table Number 9.3.3.1. Description 9.3.3.2. XML Schema Definition 9.3.3.3. Details 9.3.4. Definition of a reported cell 9.3.4.1. Description 9.3.4.2. XML Schema Definition 9.3.4.3. Details 9.3.5. Sequential number 9.3.5.1. Description 9.3.5.2. XML Schema Definition 9.3.5.3. Details 9.3.6. Territorial Base 9.3.6.1. Description 9.3.6.2. XML Schema Definition 9.3.6.3. Details 9.3.7. Currency Code 9.3.7.1. Description 9.3.7.2. XML Schema Definition 9.3.7.3. Details 9.4. All XML Schema definitions together 9.5. Example Delivery
21
9.1
Introduction
The reporting for the 'Portfolio Survey' 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.
9.2
General Principles
9.2.1
Structure of content part
The data to report is organised 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.
BE03652517441920EUR
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 'Portfolio Reporting' can vary 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.
1 by following Statistics > Declarations > Summary
22
About CSSR admin parameters
9.2.2
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.
XML Schema
9.3
This schema needs definitions defined elsewhere in CSSR. 9.3.1
Portfolio Dataset
9.3.1.1
Description
Definition of a portfolio 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
DESCRIPTION
EXAMPLE
TYPE
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 decimale seperator and no grouping character will be used to seperate 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 : 13211USD1986453
Restriction based on xsd:string ENUMERATION, MUST BE ONE OF THE FOLLOWING VALUES VALUE
DESCRIPTION
10
Territorial basis
19
Foreign seats
9.3.7
Currency Code
9.3.7.1
Description
Currency Code according to ISO-4217. For example : 'EUR' and 'USD'. Invalid examples are, 'eur' because it is in capitals defined and ' EUR' because leading and trailing spaces are significant. 9.3.7.2
The following XML Schema contains all definitions for the content part of a 'Portfolio Reporting'. References to types for which the prefix is xsd, refers to the one made in the XML Schema specifications. 1 <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.nbb.be/cssr" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xsd:complexType name="PrtAcquisitionDataset"> <xsd:complexContent> <xsd:extension base="cssr:Content"> <xsd:sequence> <xsd:element name="table" type="cssr:PrtAcquisitionTable" maxOccurs="unbounded" /> <xsd:attribute name="survey" type="xsd:string" use="required" />
1
in other words it is defined by mlns:xsd="http://www.w3.org/2001/XMLS
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
28
<description>This is a user-description of the delivery
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