Reporting System CPA 2006

Reporting System CPA 2006

XML PROTOCOL (juni 2005) Versie 1.0

1/14

Inhoudsopgave 1. 2.

Inleiding ...................................................................................................................... 3 Algemene principes .................................................................................................... 3 2.1 Structuur content gedeelte................................................................................... 3 2.2 CSSR admin parameters ..................................................................................... 5 3. XML Schema .............................................................................................................. 5 3.1 Content voor de verzekeringsmaatschappijen .................................................... 5 3.1.1. Beschrijving ................................................................................................ 5 3.1.2. XML Schema Definitie............................................................................... 5 3.1.3. Details ......................................................................................................... 5 3.2 Survey ................................................................................................................. 5 3.2.1. Beschrijving ................................................................................................ 5 3.2.2. XML Schema Definitie............................................................................... 5 3.2.3. Détails ......................................................................................................... 5 3.3 Form.................................................................................................................... 5 3.3.1. Beschrijving ................................................................................................ 5 3.3.2. XML Schema Definitie............................................................................... 5 3.3.3. Détails ......................................................................................................... 5 3.4 Item ..................................................................................................................... 5 3.4.1. Beschrijving ................................................................................................ 5 3.4.2. XML Schema Definitie............................................................................... 5 3.4.3. Détails ......................................................................................................... 5 3.5 Group .................................................................................................................. 5 3.5.1. Beschrijving ................................................................................................ 5 3.5.2. XML Schema Definitie............................................................................... 5 3.5.3. Détails ......................................................................................................... 5 4. Alle XML Schema definities samen ........................................................................... 5 5. Voorbeeld rapportering............................................................................................... 5

2/14

1. Inleiding De rapportering door de verzekeringsmaatschappijen zal verlopen via de “Centrale Server voor Statistische Rapporteringen” (afgekort CSSR). Het standaard XML formaat dat de CSSR ontvangt, volgt een formaat dat opgedeeld is in : ¾ een admin gedeelte dat definities bevat om een transfer naar de CSSR te sturen. Dit gedeelte volgt eenzelfde structuur voor alle XML documenten van deze standaard. ¾ een content gedeelte dat specifiek is per rapportering. Het doel van dit document is uitsluitend dit specifiek content gedeelte vast te leggen voor de rapportering van de verzekeringsmaatschappijen. Voor meer algemene informatie omtrent het gebruik en de functionaliteit van de CSSR, wordt er gerefereerd naar de website1. Een eerste sectie zal de structuur van een afgifte beschrijven met aandacht voor de relatie tot de huidige situatie. Vervolgens zal een gedetailleerde beschrijving gegeven worden van het XMLSchema waaraan de elementen en attributen van het content gedeelte van het CSSR document moeten voldoen. Kleine voorbeelden zullen gegeven worden voor elke XMLSchema definitie die er gemaakt wordt. De daaropvolgende sectie herneemt het volledige XML Schema gevolgd in het laatste deel door een voorbeeld van een geldig CSSR document van een hypothetische afgifte voor deze rapportering.

2. Algemene principes 2.1 Structuur content gedeelte Het doel van dit document is uitsluitend het specifieke content gedeelte vast te leggen voor de rapportering.

zie documentatie CSSR voor inhoud elementen en attributen die hier voorkomen zijn gedefinieerd in dit protocol

Het “content type” is dus CPAAcquisitionDataset. De op te vragen gegevens zullen gegroepeerd worden in enquêtes - “collection de travail” - en formulieren - “tabellen” - met respectievelijk het <survey> en

1

Zie Guidelines op de website van de National Bank van België via Statistieken > Aangiften > Overzicht.

3/14

element. De specifieke codes om ze te identificeren zullen het onderwerp uitmaken van het inhoudelijk protocol met betrekking tot de rapportering. Het content-gedeelte zou dan bijvoorbeeld zijn :

<survey code="SURVEY_CODE1" per="2006-01"> ...

...

... <survey code="SURVEY_CODE2" per="2006-01"> ... ...

Het is niet verplicht om alle formulieren en/of enquêtes op te nemen in één afgifte. Bijvoorbeeld indien na afgifte blijkt dat formulier FORM_CODE2 nog fouten bevat volstaat het enkel deze op te sturen. De inhoud van de

elementen bevat de eigenlijk te rapporteren gegevens. Hiervoor heeft men, om de conversie eenvoudig te houden, aan elke soort tabellen een verzameling karakteristieken geassocieerd. Zo heeft men voor de jaarrekeningen, “Hoofdstuk I - Afdeling I”, de karakteristieken c013 en c107 die men opvraagt. Deze informatie samen met de betekenis, het formaat en de eventueel mogelijke waarden van alle karakteristieken, is opgenomen in het inhoudelijk protocol. Het algemene principe bestaat erin om voor elke karakteristiek, die van toepassing is, een attribuut aan het element toe te voegen. Bijvoorbeeld voor “Hoofdstuk II - Afdeling II.I” uit de jaarrekeningen vraagt men de volgende karakteristieken op : C013 C201 C107

Dit wordt in XML :



Het XMLSchema, een declaratie van wat in het XML document mag voorkomen en wat niet, zal men zeer algemeen houden. Met andere woorden we zullen erin definiëren dat een element attributen mag bevatten zonder te specifiëren dewelke. Dit laat toe om nieuwe karakteristieken toe te voegen. Analoog maken we geen definitie in het XMLSchema dat bepaalt dat attribuut c107 een decimaal getal moet bevatten.

4/14

Vermits een normaal gebruik van attributen veronderstelt dat men geen al te grote tekst erin plaatst, is het ook toegelaten een karakteristiek op te nemen als een subelement van het item element. De naam van dit element is de naam van de karakteristiek.

157

Als laatste element om te introduceren heeft men het element. Overeenkomende met een lijnnummer, heeft dit tot doel de te rapporteren waarden, items, te groeperen. In het XML protocol verwacht men niet dat de aangever expliciet lijnnummers opgeeft vermits de XML structuur het toelaat om deze groepering uit te voeren door een element rond de te groeperen items te plaatsen. Voorbeeld :

some text

2.2 CSSR admin parameters Betreffende enkele CSSR admin parameters, hebben we : ƒ ƒ ƒ

als content_type = 'CPAAcquisitionDataset'. de test parameter is niet van toepassing. de lang processing parameter mag gebruikt worden, als default wordt Engels verondersteld.

3. XML Schema 3.1 Content voor de verzekeringsmaatschappijen 3.1.1. Beschrijving Een aangifte voor de verzekeringsmaatschappijen wordt geïdentificeerd aan de hand van het type content dat vastgelegd is als respectievelijk zijnde “CPAAcquisitionDataset”. Het mag gegevens bevatten handelend over één of meer enquêtes.

5/14

Declaratie van het element :

... de survey elementen ...

3.1.2. XML Schema Definitie

<xsd:complexType xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="CPAAcquisitionDataset"> <xsd:complexContent> <xsd:extension base="cssr:Content"> <xsd:sequence> <xsd:element name="survey" type="cssr:CPPCPASurvey" maxOccurs="unbounded" />

3.1.3. Details Inhoud : complex Erft elementen en attributen over van definitie cssr:Content Inhoud : een opeenvolging van de volgende elementen in strikte volgorde naam type min max beschrijving survey cssr:CPPCPASurvey 1 N

3.2 Survey 3.2.1. Beschrijving Een enquête, geïdentificeerd door een code, komt overeen met een type rapportering (Jaarrekeningen, Statistieken; etc ...). Het moet één of meerdere formulieren bevatten. De gegevens in de formulieren hebben allen betrekking op dezelfde rapporteringsperiode. Bijvoorbeeld :

<survey code="SURVEYCODE" per="2006-01"> ... de form elementen ...

6/14

3.2.2. XML Schema Definitie

<xsd:complexType xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="CPPCPASurvey"> <xsd:sequence> <xsd:element name="form" type="cssr:CPPCPAForm" maxOccurs="unbounded" /> <xsd:attribute name="code" type="xsd:string" use="required" /> <xsd:attribute name="per" type="xsd:gYearMonth" use="required" />

3.2.3. Détails

naam

type

code xsd:string per

Attributen default verplicht waarde Ja

beschrijving De identificatie van de enquête. Rapporteringsperiode

xsd:gYearMonth Ja

waarop

de

gegevens betrekking hebben.

Inhoud : een opeenvolging van de volgende elementen in strikte volgorde naam type min max beschrijving form cssr:CPPCPAForm 1 N

3.3 Form 3.3.1. Beschrijving Een formulier is de minimale rapporteringseenheid en komt overeen met een bepaalde tabel2. Met andere woorden indien men een bepaald gegeven van een formulier moet verbeteren dan is men genoodzaakt alle gegevens van het formulier opnieuw op te sturen. Bijvoorbeeld :

... item en/of group elementen ...

2

of groep van gelijkaardige tabellen

7/14

3.3.2. XML Schema Definitie

<xsd:complexType xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="CPPCPAForm"> <xsd:sequence> <xsd:choice minOccurs="0" maxOccurs="unbounded"> <xsd:element name="item" type="cssr:CPPCPAItem" /> <xsd:element name="group" type="cssr:CPPCPAGroup" /> <xsd:attribute name="code" type="xsd:string" use="required" /> <xsd:attribute name="nihil" type="xsd:boolean" default="false" />

3.3.3. Détails

naam

type

code xsd:string

Attributen default waarde

verplicht Ja

beschrijving de identificatie van het formulier Een

aanduiding

formulier

nihil

xsd:boolean Neen

false

er

rapporteren

dat

geen zijn

voor

gegevens (indien

het te

“true”)

Indien “true” dan mogen er ook geen “items” in gedeclareerd zijn.

Inhoud : een opeenvolging van de volgende elementen zonder enige voorkeur van volgorde naam type min max beschrijving item

cssr:CPPCPAItem 1

1

group

cssr:CPPCPAGroup 1

1

8/14

3.4 Item 3.4.1. Beschrijving Een item is een te declareren gegeven. Het bestaat uit een verzameling karakteristieken waaraan een waarde geassocieerd is. Een karakteristiek is, in volgorde van voorrang, voorgesteld als een attribuut of een subelement. Met andere woorden, indien zowel een attribuut als een subelement voorkomt met dezelfde naam dan wordt de waarde van het attribuut genomen. Bijvoorbeeld :



is dezelfde declaratie als

1564

Indien een karakteristiek niet van toepassing is dan mag het niet voorkomen. Bijvoorbeeld karakteristiek c999 is niet van toepassing of met andere woorden heeft geen waarde voor een bepaald item. Dan is het volgende niet correct :



zou moeten zijn



tenzij een blanco of spaties voor de karakteristiek een betekenis heeft. Er is geen restrictie ingebouwd in de naam van en het aantal karakteristieken in het XML Schema van deze rapportering. Welke er effectief mogen voorkomen voor een bepaalde enquête en/of formulier is het onderdeel van het inhoudelijk protocol. Het formaat van een karakteristiek is eveneens vastgelegd in het inhoudelijk protocol. Niettegenstaande gelden de volgende algemene richtlijnen3 : 3

deze bepaald in XML Schema specificaties werden overgenomen

9/14

-

numerieke karakteristieken gebruiken een punt als decimaal scheidingsteken. Bijvoorbeeld +13.45 -54 245.00 datumformaat is JJJJ-MM-DD waarbij JJJJ het jaartal, MM de maand en DD de dag is. Bijvoorbeeld 2006-05-12 alfanumerieke karakteristieken zijn hoofdletter gevoelig 3.4.2. XML Schema Definitie

<xsd:complexType xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="CPPCPAItem"> <xsd:sequence> <xsd:any minOccurs="0" maxOccurs="unbounded" processContents="skip" /> <xsd:anyAttribute processContents="skip" />

3.4.3. Détails Attributen type verplicht default waarde beschrijving

naam om het even welk attribuut Inhoud : een opeenvolging van de volgende elementen in strikte volgorde naam type min max beschrijving om het even welk element

10/14

3.5 Group 3.5.1. Beschrijving Element gebruikt om items, die bij elkaar horen4 , te groeperen. Dit concept komt overeen met de functie van een lijnnummer. Bijvoorbeeld : element

... item elements ...

3.5.2. XML Schema Definitie

<xsd:complexType xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="CPPCPAGroup"> <xsd:sequence> <xsd:element maxOccurs="unbounded" name="item" type="cssr:CPPCPAItem" />

3.5.3. Détails Inhoud : een opeenvolging van de volgende elementen in strikte volgorde naam type min max beschrijving item cssr:CPPCPAItem 1 N

4

noodzakelijk omdat er aan de elementen geen orde wordt opgelegd

11/14

4. Alle XML Schema definities samen Het volgende XML Schema bevat enkel die definities die specifiek zijn aan de rapportering zelf. Referenties naar types met als prefix xsd, refereren naar deze gemaakt in de XML Schema specificaties5.

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.nbb.be/cssr" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xsd:complexType name="CPAAcquisitionDataset"> <xsd:complexContent> <xsd:extension base="cssr:Content"> <xsd:sequence> <xsd:element name="survey" type="cssr:CPPCPASurvey" maxOccurs="unbounded" /> <xsd:complexType name="CPPCPASurvey"> <xsd:sequence> <xsd:element name="form" type="cssr:CPPCPAForm" maxOccurs="unbounded" /> <xsd:attribute name="code" type="xsd:string" use="required" /> <xsd:attribute name="per" type="xsd:gYearMonth" use="required" /> <xsd:complexType name="CPPCPAForm"> <xsd:sequence> <xsd:choice minOccurs="0" maxOccurs="unbounded"> <xsd:element name="item" type="cssr:CPPCPAItem" /> <xsd:element name="group" type="cssr:CPPCPAGroup" /> <xsd:attribute name="code" type="xsd:string" use="required" /> <xsd:attribute name="nihil" type="xsd:boolean" default="false" /> <xsd:complexType name="CPPCPAItem"> <xsd:sequence> <xsd:any minOccurs="0" maxOccurs="unbounded" processContents="skip" /> <xsd:anyAttribute processContents="skip" /> <xsd:complexType name="CPPCPAGroup"> <xsd:sequence> <xsd:element maxOccurs="unbounded" name="item" type="cssr:CPPCPAItem" />

5

in andere woorden deze gedefinieerd door xmlns:xsd="http://www.w3.org/2001/XMLSchema

12/14

5. Voorbeeld rapportering Het volgend voorbeeld is een denkbeeldige aangifte. Voor enquête met code SURVEY1 worden de volgende formulieren als voorbeeld genomen worden : ƒ ƒ ƒ

FORM_CODE1 FORM_CODE2 FORM_CODE3

Voor enquête met code SURVEY2 hebben we de volgende formulier : •

FORM_CODE4

<sender kbo="1234567890" /> <processing_parameters> <email_response>[email protected] true <description>Free description <survey code="SURVEY1" per="2006-01">

naam en adres

<survey code="SURVEY2" per="2006-01">

13/14

14/14