Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Interface (Gezin.RegistreerAanvraagZorgtoeslag-02.00 - Bronbestand)

Informatie:

De XML en CSV bestanden die via FTP gepubliceerd worden dienen te voldoen aan de MAGDA richtlijnen. Voor meer informatie over hoe een Publicatie-dienst algemeen gebruikt dient te worden, bekijk Bestandsuitwisseling (Publicaties/batchverwerking).

Het betreft hier een batch verwerking waarbij de brongegevens door K&G worden aangeleverd op de Magda FTP server (Cronos omgeving). De gegevens worden aangeleverd in XML formaat  en zijn opgebouwd volgens de MAGDA richtlijnen.

Bestandsnaam

Opmerking:

De exacte bestandsnaam wordt pas meegedeeld tijdens het aansluitingsproces. De gegevens die u hier vindt kunnen dus mogelijk wijzigen.

Voor de naamgeving van de aangeleverde bestanden wordt een vast patroon gevolgd: gezin.registreeraanvraagzorgtoeslag-0200_JJJJMMDDUUMMSSsss.xml, waarbij UU in 24-uur formaat staat.

Voorbeeld

gezin.registreeraanvraagzorgtoeslag-0200_20140224155516000.xml

Registratie in XML

Algemeen

Informatie:

De Registratie in XML bevat een standaard context zoals de andere MAGDA publicaties. Dit naar analogie met de contextbeschrijving voor webservices, bekijk hiervoor eens de handleiding Webservices 02.00.

XSD

De aangeboden bestanden worden gevalideerd volgens de service-XSD horende bij deze dienst. De actuele XSD is ter beschikking op aanvraag.

Elementen

Visueel

Algemeen

IdentificatieBericht

Criteria/Attest

Criteria/IdentificatieKind

Criteria/IdentificatieAanvraag

Detail

Element

../Vraag/

Beschrijving

Referte

Unieke referte van het bericht.

Formaat: 15 alfanumerieke posities

Inhoud








IdentificatieBericht

Informatieblok m.b.t. de bericht prefix gegevens, voor de informatieuitwisselingen binnen de KSZ. Deze informatie is belangrijk voor een juiste interpretatie van de gegevens en voor routering.
































Netwerk

Informatieblok m.b.t. de berichtenuitwisseling



Constante

De constante geeft aan naar welke omgeving de gegevens moeten worden georiënteerd.

Formaat: 4 alfanumerieke posities

Waarde: "TAPE"

VersiePrefix

Versie van het gebruikte KSZ prefix formaat.

Formaat: 2 alfanumerieke posities

Waarde: "A1"

Sector

Sector van de uitgever van de voorlegging (K&G).

Formaat: 3 numerieke posities

Waarde: "040"

TypeInstelling

Typering van de instelling van de uitgever van de voorlegging (K&G).

Formaat: 3 numerieke posities

Waarde: "001"

InterneReferentieSector

Interne referentie van de afzender (K&G).

Formaat: 15 alfanumerieke posities

Waarde: (unieke) referentie, bijvoorbeeld attest-nummer invullen zoals in .../Inhoud/Criteria/Attest/Nummer

UserId

Programmanummer van KSZ

Formaat: 11 numerieke posities

Opmerking: Waarde aan te vragen tijdens het aansluitingsproces.

TypeAanvraag

Gegeven dat informatie verstrekt over de te verrichten verwerking en bepaalde kenmerken ervan in het kort beschrijft.

Formaat: 3 alfanumerieke posities

Waarde: "D0M"

INSZ

Het INSZ nummer van de betrokkene.

Formaat: 11 alfanumerieke posities

Waarde: INSZ van het rechthebbende kind invullen zoals in .../Inhoud/Criteria/IdentificatieKind/INSZ

Formulier

Informatieblok m.b.t. de inhoud van de gegevens



Code

Aanduiding van de logische set van gegevens met het oog op de verwezenlijking van een specifieke functionaliteit van de sociale zekerheid.

Formaat: 4 alfanumerieke posities

Waarde: "A651"

Variante

Aanduiding van een subset van een bepaald formulier.

Formaat: 4 alfanumerieke posities

Opmerking: dit element niet meegeven in deze voorlegging.

Berichtgedeelte

Duidt de referentie of volgorde aan van een bericht.

Formaat: 5 alfanumerieke posities

Opmerking: dit element niet meegeven in deze voorlegging.

BeheerAntwoord

Informatieblok m.b.t. de ontvangst van antwoorden op reeds gestelde vragen



IdentificatieToepassing

Identificatie van de toepassing

Formaat: 8 alfanumerieke posities

Opmerking: dit element niet meegeven in deze voorlegging.

InterneReferentieBeantwoorder

Interne referentie van de bij de dialoog betrokken partner die antwoordt.

Formaat: 15 alfanumerieke posities

Opmerking: dit element niet meegeven in deze voorlegging.

TijdstipVersturenAanvraag

Tijdstip van versturen van de voorlegging.




Datum

Datum

Formaat: JJJJ-MM-DD

Waarde:  Datum van versturen bericht invullen zoals in .../Context/Bericht/Tijdstip/Datum

Tijd

Tijd

Formaat: UU:MM(:SS(.sss))

Waarde: Tijd van versturen bericht invullen zoals in .../Context/Bericht/Tijdstip/Tijd

Antwoordtermijn

Maximale wachttijd op het antwoord.

Formaat: 3 alfanumerieke posities

Opmerking: dit element niet meegeven in deze voorlegging.

TimeoutActie

Actie indien de Antwoordtermijn is verstreken.

Formaat: 1 alfanumerieke positie

Opmerking: dit element niet meegeven in deze voorlegging.

SlagenStroom

Code die de kwaliteit van de stroom aangeeft.

Formaat: 1 alfanumerieke positie

Waarde: "0"

Repertorium

Informatieblok m.b.t. de toepassing van berichten



Hoedanigheidscode

Code die de dossiers aanduidt waarvoor, in het kader van de gegevensuitwisseling via het netwerk van de KSZ, de gegevensbehoeften en -beschikbaarheden gelijkaardig zijn. Per sector bepaald in samenspraak met de KSZ

Formaat: 3 alfanumerieke posities

Waarde: Hoedanigheidscode invullen zoals in ../Context/Bericht/Afzender/Hoedanigheid

Fase

Opsplitsing van de hoedanigheidscodes in fases beantwoordt aan de gegevensbehoeften en -beschikbaarheden tijdens de behandeling van een dossier binnen een sector.

Formaat: 2 alfanumerieke posities

Waarde: "00"

PeriodeRepertorium

Periode tijdens de welke een instelling over een dossier beschikt voor een INSZ




Begin

Begindatum

Formaat: JJJJ-MM-DD

Einde

Einddatum

Formaat: JJJJ-MM-DD

PeriodeBericht

Periode die de periode aangeeft waarop de gegevens in het bericht betrekking




Begin

Begindatum

Formaat: JJJJ-MM-DD

Einde

Einddatum

Formaat: JJJJ-MM-DD

SectorLeverancier

Code die staat voor de sector van de bestemmeling van de gegevens.

Formaat: 3 alfanumerieke posities

Opmerking: dit element niet meegeven in deze voorlegging.

InstellingLeverancier

Code die de instelling van de bestemmeling van de gegevens aangeeft.

Formaat: 3 alfanumerieke posities

Opmerking: dit element niet meegeven in deze voorlegging.

Criteria

Criteria van 1 registratie aanvraag zorgtoeslag



Attest

Gegevensblok met attest informatie



@DatumCreatie

Datum van versturen van het attest, begindatum van de 14 weken voor de RegistreerAanvraagHandicap waarbinnen de FOD SZ de opvolging van het dossier dient af te ronden.

Formaat: JJJJ-MM-DD

Nummer

Uniek nummer van het attest.

Structuur: sssfffnnnnnnncc

  • sss = sectorcode (‘040’ voor K&G)

  • fff = fondsnummer

  • nnnnnnn = uniek nummer van 0 tot 9999999

  • cc = controlecijfers in het nummer (97 - (sssjj MOD 97)

Formaat: 15 alfanumerieke posities

Versie

Wijzigingstatus of versienummer van het attest, in deze publicatie steeds gelijk aan “00”.

Formaat: 2 numerieke posities

Status

Geeft code van de status van het attest zorgtoeslag aan:

  • 0 = origineel – eerste aanvraag

  • 1 = volledig dossier

  • 2 = medische vaststelling

  • 9 = afwijzing

  • 3 = cancellation (in het ‘Nummer’-element het attestnummer opgeven dat men wil annuleren)

IdentificatieKind

Gegevensblok met identificatie gegevens van het betrokken kind



INSZ

INSZ van het rechthebbende kind.

Formaat: 11 numerieke posities

TaalDossier

Taalcode van het dossier; dit is geen wettelijk gegeven (geen wettelijk gegeven):

  • fr= Frans

  • nl= Nederlands

  • de= Duits

Plaatsing

Oproepadres, enkel ingevuld indien dit verschillend is van het adres in het Rijksregister.



Naam

Naam van het plaatsingsinstituut of van een natuurlijk persoon in geval van een plaatsing.

Formaat: 150 alfanumerieke posities

Land

Land van plaatsing; indien buitenland, dan worden geen gemeente, straat, huisnummer of busnummer aangeduid.



ISOCode

ISO landcode. 

Er gebeurt in deze publicatie geen vertaling van de NIS landcode naar de ISO landcode. Dit element is dus niet aanwezig in de publicatie.

NISCode

NIS landcode.

Formaat: 3 numerieke posities

Naam

Naam van het land.

Formaat: alfanumeriek

Gemeente

Gemeente van plaatsing (enkel België).



NISCOde

NIS gemeentecode.

Formaat: 5 numerieke posities

PostCode

Postcode.

Formaat: 6 alfanumerieke posities

Naam

Naam van de gemeente.

Formaat: alfanumeriek

Straat

Straat van plaatsing (enkel België).



NISCode

NIS straatcode.

Formaat: 4 alfanumerieke posities

Naam

Naam van de straat

Formaat: alfanumeriek

Huisnummer

Huisnummer.

Formaat: alfanumeriek

Busnummer

Busnummer.

Formaat: alfanumeriek

IdentificatieAanvraag

Gegevensblok met identificatie gegevens van de aanvraag zorgtoeslag



Type

Geeft de code van het type aanvraag weer.

Mogelijke waarden:

  • 00 = aanvraag door FOD SZ (wordt niet toegepast maar juridisch voorzien)

  • 01 = eerste aanvraag

  • 02 = ambtshalve herziening

  • 03 = aanvraag door KBF

  • 04 = herziening op vraag van de ouders of derden

  • 05 = Europees formulier

Herziening

Reden van de herziening in geval van scenario 03 aanvraag door KBF.



Datum

Datum van de herziening.

Formaat: JJJJ-MM-DD

Reden

Code die de reden van herziening weergeeft.

Mogelijke waarden:

  • 01 gerechtigde op werkloosheidsuitkeringen

  • 02 inschrijving als werkzoekende

  • 03 tewerkstelling

Formaat: 2 alfanumerieke posities

Annulatie

Informatieblok m.b.t. de reden van annulering



Reden



Aanvragen

Lijst van aanvragen.



Aanvraag

Bevat de gegevens m.b.t. één aanvraag



@DatumBegin

Begindatum van periode waarover de aanvraag gaat.

Formaat: JJJJ-MM-DD

@DatumEinde

Einddatum van periode waarover de aanvraag gaat.

Formaat: JJJJ-MM-DD

Nummer

Volgnummer van de aanvraag.

Formaat: 2 numerieke posities

ErkenningHandicap

Indicator lichamelijke of geestelijke ongeschiktheid (66%).

Mogelijke waarden:

  • 1 = Ja

  • 0 = Neen

Formaat: 1 numerieke positie



Beschrijving

Beschrijving van de ErkenningHandicap code.

Formaat: alfanumeriek

ScoreZelfredzaamheid

Indicator Graad van zelfredzaamheid.

Mogelijke waarden:

  • 1 = Ja

  • 0 = Neen

Formaat: 1 numerieke positie



Beschrijving

Beschrijving van de ScoreZelfredzaamheid code.

Formaat: alfanumeriek

OnvermogenTeWerken

Indicator totale ongeschiktheid om een beroep uit te oefenen.

Mogelijke waarden:

  • 1 = Ja

  • 0 = Neen

Formaat: 1 numerieke positie



Beschrijving

Beschrijving van de OnvermogenTeWerken code.

Formaat: alfanumeriek

OnvermogenCursusTeVolgen

Indicator onmogelijkheid om regelmatig lessen te volgen.

Mogelijke waarden:

  • 1 = Ja

  • 0 = Neen

Formaat: 1 numerieke positie



Beschrijving

Beschrijving van de OnvermogenCursusTeVolgen code.

Formaat: alfanumeriek

MedischSocialeSchaal

Indicator Wetgeving K.B. 28/03/2003.

Mogelijke waarden:

  • 1 = Ja

  • 0 = Neen

Formaat: 1 numerieke positie



Beschrijving

Beschrijving van de MedischSocialeSchaal code.

Formaat: alfanumeriek

Opmerkingen

De opzet van een eventuele publicatie voor Vlaamse afnemers zal de aangeleverde informatie ongewijzigd verdelen. Er zal geen bijkomende verrijking gebeuren op het Magda platform. Het is de verantwoordelijkheid van K&G om de datastructuur zo volledig mogelijk op te vullen.

Voorbeelden

<?xml version="1.0" encoding="UTF-8"?> <!--Sample XML file generated by XMLSpy v2017 rel. 3 sp1 (x64) (http://www.altova.com)--> <n1:RegistreerAanvraagZorgtoeslag xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:n1="http://service.registreeraanvraagzorgtoeslagdienst-02_00.gezin-02_00.vip.vlaanderen.be" xsi:schemaLocation="http://service.registreeraanvraagzorgtoeslagdienst-02_00.gezin-02_00.vip.vlaanderen.be RegistreerAanvraagZorgtoeslag.xsd"> <Verzoek> <Context/> <Vragen> <Vraag> <Referte>123456789</Referte> <Inhoud> <IdentificatieBericht> <Netwerk> <Constante>TAPE</Constante> <VersiePrefix>A1</VersiePrefix> <Sector>040</Sector> <TypeInstelling>001</TypeInstelling> <InterneReferentieSector>123456789012345</InterneReferentieSector> <UserId>00000012345</UserId> <TypeAntwoord>D0M</TypeAntwoord> <INSZ>62080599816</INSZ> </Netwerk> <Formulier> <Code>A651</Code> </Formulier> <BeheerAntwoord> <TijdstipVersturenAanvraag> <Datum>2019-05-10</Datum> <Tijd>14:57</Tijd> </TijdstipVersturenAanvraag> <SlagenStroom>0</SlagenStroom> </BeheerAntwoord> <Repertorium> <Hoedanigheidscode>188</Hoedanigheidscode> <Fase>00</Fase> <PeriodeRepertorium> <Begin>2019-05-01</Begin> <Einde>2019-05-31</Einde> </PeriodeRepertorium> <PeriodeBericht> <Begin>2019-05-10</Begin> <Einde>2019-05-17</Einde> </PeriodeBericht> </Repertorium> </IdentificatieBericht> <Criteria> <Attest DatumCreatie="1957-08-13"> <Nummer>123456789012345</Nummer> <Versie>12</Versie> <Status>0</Status> </Attest> <IdentificatieKind> <INSZ>62080599816</INSZ> <TaalDossier>nl</TaalDossier> <Plaatsing> <Naam>De Horizon</Naam> <Land> <ISOCode>149</ISOCode> <NISCode>150</NISCode> <Naam>België</Naam> </Land> <Gemeente> <NISCode>41002</NISCode> <PostCode>9300</PostCode> <Naam>Aalst</Naam> </Gemeente> <Straat> <NISCode>123</NISCode> <Naam>Havenlaan</Naam> </Straat> <Huisnummer>88</Huisnummer> <Busnummer>a</Busnummer> </Plaatsing> </IdentificatieKind> <IdentificatieAanvraag> <Type>03</Type> <Herziening> <Datum>1958-08-13</Datum> <Reden>02</Reden> </Herziening> <Annulatie> <Reden>01</Reden> </Annulatie> <Aanvragen> <Aanvraag DatumBegin="1959-08-13" DatumEinde="1960-08-13"> <Nummer>7</Nummer> <ErkenningHandicap>1</ErkenningHandicap> <ScoreZelfredzaamheid>0</ScoreZelfredzaamheid> <OnvermogenTeWerken>1</OnvermogenTeWerken> <OnvermogenCursusTeVolgen>1</OnvermogenCursusTeVolgen> <MedischSocialeSchaal>0</MedischSocialeSchaal> </Aanvraag> </Aanvragen> </IdentificatieAanvraag> </Criteria> </Inhoud> </Vraag> </Vragen> </Verzoek> </n1:RegistreerAanvraagZorgtoeslag>

Codetabellen

IdentificatieKind/TaalDossier

Code

Omschrijving

nl

Nederlands

fr

Frans

de

Duits


Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren

De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid

uitgegeven door Digitaal Vlaanderen