DIGITAAL VLAANDEREN

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Current »

Informatie:

De XML  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).

De gegevens zijn beschikbaar in XML en opgebouwd volgens de MAGDA richtlijnen.

Algemeen

In deze sectie bespreken we de praktische werking van deze publicatiedienst met eventuele specifieke opmerkingen. Voor meer algemene informatie in verband met het gebruik van MAGDA publicatiediensten neemt u best de algemene handleiding Bestandsuitwisseling (Publicaties/batchverwerking) door.

Bestandsnaam

Opmerking:

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

De bestandsnaam is van de vorm SocZek.PubliceerTijdelijkeWerkloosheid-02.00_timestamp.xml.

Voorbeeld

SocZek.PubliceerTijdelijkeWerkloosheid-02.00_20140224155516000.xml

Publicatie in XML

Algemeen

Informatie:

De publicatie 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 bestanden die worden aangeboden op de outputfolder zijn gevalideerd volgens de service-xsd horende bij deze dienst. De actuele xsd is ter beschikking op de Overzicht endpoints en XSD's pagina.

Elementen

Informatie:

Voor een overzicht van alle elementen die in de gevraagde XML staan en eventuele beperkingen wordt er verwezen naar de XSD.

Visueel


Detail

De Referte wordt opgebouwd door een combinatie te maken van het KSZ ticketnummer en de INSZ van de persoon.

Netwerk

Element

../Identificatiebericht/Netwerk/

Commentaar

Returncode

De netwerkcode wordt gebruikt voor veiligheid en syntactische controles en is voorbehouden aan de KSZ.

Versie

Aan de hand van deze code kan, op het niveau van de lay-out, een onderscheid worden gemaakt tussen het huidige en het oude prefix en tussen de prefixen die later zullen worden ingevoerd.

Mogelijke waarden:

  • A0 = het oude prefix met beperkte mogelijkheden

  • A1 = het standaardprefix

Sector

Deze code komt overeen met een stelsel, tak of een onderdeel van een tak uit de sociale zekerheid. De Kruispuntbank wordt eveneens door een specifieke code sector aangeduid. De code sector duidt steeds de dialoog houdende partner aan die de voorlegging of de distributie heeft verstuurd.

TypeInstelling

Binnen een sector kan een onderscheid worden gemaakt tussen verschillende types instellingen. Een type instelling is een geheel van instellingen die dezelfde taken vervullen en die bijgevolg dezelfde informatiebehoeften en -beschikbaarheden hebben. Een instelling is een eenheid die deelneemt aan de uitwisseling van sociale gegevens van persoonlijke aard.

  • In een voorlegging verstuurd door een andere instelling dan de KSZ komt die code overeen met de type instelling die het bericht verstuurt.

  • In een voorlegging verstuurd door de Kruispuntbank komt die code overeen met het type netwerk dat de uiteindelijke bestemmeling is van het bericht.

Aan de hand van de inhoud van deze zone kan de beheersinstelling van een secundair netwerk onmiddellijk zien of de voorlegging door haar of door een instelling van het secundair netwerk moet worden behandeld. Ze kan dienovereenkomstig handelen.

InterneReferentieSector

Code eigen aan de afzender (instelling) aan de hand waarvan een voorlegging op een eenduidige manier kan worden geïdentificeerd. Aangezien die code als dusdanig wordt overgenomen in het antwoord, kan de afzender de voorlegging koppelen met zijn antwoord.

UserId

Aan de hand van deze code kan enerzijds een gebruiker (de afzender van de voorlegging) worden geïdentificeerd en kan anderzijds worden nagegaan of de betrokken gebruiker de voorlegging mag formuleren.

Type: numeriek, lengte 11

Deze code komt overeen:

  • ofwel met het INSZ van de natuurlijke persoon van de instelling die de voorlegging verstuurt (formaat JJMMDDNNNCC)

ofwel met de code van het programma dat de voorlegging genereert. Deze code wordt door de dienst Veiligheid van de Kruispuntbank toegekend in samenwerking met de instellingen

TypeAntwoord

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

Dit gegeven bestaat uit de drie volgende codes :

  1. de verwerkingswijze:

    1. F = definitief antwoord

    2. I = tussentijds antwoord

  2. 0 = prefix met een vaste lengte

  3. de soort verwerking: dit gegeven wordt gecodificeerd aan de hand van de volgende elementen

    1. een letter ingeval van functionele bewerking van de gegevens
      Bv.: L = raadpleging, M = verspreiding

    2. een cijfer ingeval van technische bewerking met het oog op het beheer van de mailboxtransfers

      1. "1": de instelling vraagt aan de KSZ om haar de inhoud van de mailbox op te sturen.

      2. "2": de instelling vraagt aan de KSZ om de inhoud van de mailbox in ontvangst te nemen.

INSZ

Het INSZ nummer van de verzekerde.

ReturncodeKSZ

De applicatie returncode wordt voornamelijk gebruikt bij controles op het niveau van het verwijzings- en personenrepertorium en is voorbehouden aan de KSZ.

Indien er door de KSZ geen fouten of anomalieën worden vastgesteld, wordt de code op nul gezet ('000000').

Formulier

Element

../Identificatiebericht/Formulier/

Commentaar

Code

A037

Variante

  • “‘X000”: duidt aan dat er geen gegevensgedeelte volgt;

  • ·“X001”: hierna volgt wel een gegevensgedeelte

Berichtgedeelte

Deze zone duidt voor de instelling die de oorspronkelijke voorlegging heeft verstuurd, de referentie of de volgorde aan van een antwoordgedeelte dat door de Kruispuntbank werd ontvangen. Deze referentie of volgorde bevat meer bepaald informatie m.b.t. de lengte van het ontvangen antwoordgedeelte.

BeheerAntwoord

Element

../Identificatiebericht/BeheerAntwoord/

Commentaar

InterneReferentieBeantwoorder

Unieke referentie aangemaakt door de instelling die antwoordt, waardoor het antwoord (de delen van het antwoord uitgezonderd) m.b.t. de verstuurde voorlegging op een eenduidige manier wordt aangeduid.

TijdstipVersturenAanvraag

Datum en uur (in uren/minuten) van versturen van een voorlegging. Het betreft een controlegegeven dat elke afzender (met inbegrip van de Kruispuntbank) mag gebruiken.

         Datum

Formaat : JJJJ-MM-DD

         Tijd

Formaat : HH:MM:SS.sss

TijdstipVersturenAntwoord

Datum en uur van versturen van het antwoord:

  • van de instelling leverancier of bestemmeling (ingeval van mededeling van gegevens met opvolging) naar de Kruispuntbank.

  • van de Kruispuntbank naar de instelling die de oorspronkelijke voorlegging heeft verstuurd.

In geval informatie wordt gevraagd, komt dit gegeven overeen met het ogenblik waarop de gevraagde gegevens uit de databank van de leverancier worden gehaald.

         Datum

Formaat : JJJJ-MM-DD

         Tijd

Formaat : HH:MM:SS.sss

SlagenStroom

Mogelijke waarden (A037 stroom):

  •  ‘E’ = voorlegging geweigerd door de KSZ omdat er een probleem is vastgesteld met een zone uit het prefix

  • ‘A’ = voorlegging aanvaard en doorgestuurd

Repertorium

Element

../Identificatiebericht/Repertorium/

Commentaar

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. De hoedanigheidscodes worden per sector bepaald in samenspraak met de Kruispuntbank.

Mogelijke waarden: van 000 tot 899; 902 of 903 

Fase

De opsplitsing van de hoedanigheidscodes in fases beantwoordt aan de gegevensbehoeften en -beschikbaarheden tijdens de behandeling van een dossier binnen een sector. Deze fasecode zou nuttig kunnen zijn voor het bepalen van de toe te kennen formuliervariante.

PeriodeRepertorium

Datums die het begin en einde van de periode aangeven tijdens dewelke een instelling over een dossier beschikt voor een INSZ.

         Begin

Formaat: JJJJ-MM-DD

         Einde

Formaat: JJJJ-MM-DD

PeriodeBericht

Datums die het begin en einde van de periode aangeven waarop de gegevens in het bericht betrekking hebben.

         Begin

Formaat: JJJJ-MM-DD

         Einde

Formaat: JJJJ-MM-DD

SectorLeverancier

Code die staat voor de sector leverancier van de gegevens ingeval van informatievraag of voor de bestemmeling ingeval van overmaking van gegevens.

InstellingLeverancier

Code die ofwel de instelling leverancier, ofwel de instelling van bestemming van de gegevens aangeeft.

Gegevens

../Inhoud/GegevensTijdelijkeWerkloosheid/Attest

Bevat de gegevens rond het attest

        @DatumCreatie

Datum van aanmaak van het bericht

        INSZ

INSZ van de betrokkene

        Nummer

Uniek nummer toegekend door de UI’s

De samenstelling is als volgt:

  • eerste 2 posities: het jaartal waarin de refertemaand waarvoor de gegevens worden meegedeeld, zich bevindt;

  • volgende 3 posities: het attest ‘037’;

  • laatste 10 posities: uniek nummer voor de werkloosheidssector

vb: 030370007945382

        Versie

Versie nummer van het gegevensgedeelte van het bericht

        Status

Geeft de status van het bericht weer

                Code

Code die de status weergeeft

Mogelijke waarden:

  • 0

  • 1

  • 2

  • 3

                Omschrijving

Omschrijving van de code.

  • 0 = origineel;

  • 1 = corrigerend bericht;

  • 2 = duplicaat;

  • 3 = annulering

        AttestMaand

Referentie maand van de attest

Formaat YYYYMM – waard tussen 190001 en 219912.

../Inhoud/GegevensTijdelijkeWerkloosheid/Werkgever

Bevat de gegevens van de werkgever

        Ondernemingsnummer

Ondernemingsnummer van de werkgever

        RSZNummer

RSZNummer van de werkgever

        Categorie

Geeft de categorie van de werkgever weer

Via de werkgeverscategorie kan men de werkgevers onderscheiden volgens hun verplichtingen op basis van bijzonderheden die eigen zijn aan de verrichte activiteit. Het wordt door de RSZ toegekend.

Dit veld is weliswaar facultatief.

../Inhoud/GegevensTijdelijkeWerkloosheid/Werknemer

Bevat de gegevens van de werknemer

        Kengetal

Werknemerskengetal bij de RSZ waartoe de sociaal verzekerde behoort

        BegindatumBetrekking

De begindatum van de betrekking

        ParitairComite

Nummer van het paritair comité waaronder de sociaal verzekerde ressorteert

        InternTewerkstellingsnummer

Het intern tewerkstellingsnummer van de werknemer

        GemiddeldAantalUren

Normaal gemiddelde wekelijkse arbeidsduur van de sociaal verzekerde in de onderneming

        VoltijdseReferentie

Normaal gemiddelde wekelijkse arbeidsduur van een voltijdse tewerkgestelde werknemer in de onderneming

        Statuut

Het statuut van de werknemer

../Inhoud/GegevensTijdelijkeWerkloosheid/TijdelijkeWerkloosheid

Bevat de gegevens rond de tijdelijke werkloosheid

        Type

Geeft het type tijdelijke werkloosheid weer

                Code

De code die het type tijdelijke werkloosheid weergeeft

                Omschrijving

Omschrijving van de code

        Betaling

Bevat de gegevens rond uitbetaling

                Duurtijd


                        Eenheid

Mogelijke waarden voor tijdseenheid:

  • 1 = uur

  • 2 = dag

  • 3 = week

  • 4 = maand

  • 5 = trimester

  • 6 = jaar

                        Aantal

Aantal tijdseenheden tijdelijke werkloosheid in aanmerking genomen voor de berekening van het aantal uitkeringen per type tijdelijke werkloosheid

                AantalUitkeringen

Aantal uitkeringen betaald per type tijdelijke werkloosheid

        Weigeringen

Bevat de gegevens rond de weigering van tijdelijke werkloosheid

           Weigering


                Duurtijd


                        Eenheid

Mogelijke waarden voor tijdseenheid:

  • 1 = uur

  • 2 = dag

  • 3 = week

  • 4 = maand

  • 5 = trimester

  • 6 = jaar

                        Aantal

Aantal tijdseenheden tijdelijke werkloosheid in aanmerking genomen voor de berekening van het aantal uitkeringen per type tijdelijke werkloosheid

                AantalUitkeringen

Aantal uitkeringen dat wegens sanctie / uitsluiting niet kon vergoed worden per type tijdelijke werkloosheid

                OngeachtUren

Aantal uitkeringen dat wegens sanctie / uitsluiting niet kon vergoed worden per type tijdelijke werkloosheid onafhankelijk van het aantal uren tijdelijke werkloosheid

               WeigerCode


                         Code

code die de reden voor de weigering van de betaling aangeeft

                         Omschrijving

Omschrijving van de code

  • No labels