Interface (PubliceerTijdelijkeWerkloosheid-02.00)
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
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:
|
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.
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 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 :
|
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 |
|
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:
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):
|
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:
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:
|
Omschrijving | Omschrijving van de code.
|
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 01 tijdelijke werkloosheid ingevolge gebrek aan werk wegens economische redenen 02 tijdelijke werkloosheid ingevolge slecht weer 03 tijdelijke werkloosheid ingevolge technische stoornis 04 tijdelijke werkloosheid ingevolge overmacht 05 tijdelijke werkloosheid ingevolge overmacht om medische redenen 06 tijdelijke werkloosheid ingevolge collectieve sluiting van de onderneming wegens jaarlijkse vakantie 07 tijdelijke werkloosheid ingevolge collectieve sluiting van de onderneming wegens vakantie krachtens een algemeen bindend verklaarde CAO 08 tijdelijke werkloosheid ingevolge collectieve sluiting van de onderneming wegens inhaalrust in het kader van arbeidsduurvermindering 09 tijdelijke werkloosheid ingevolge staking of lock-out 10 tijdelijke werkloosheid in geval van ontslag van een beschermde werknemer 11 jeugdvakantie 12 seniorvakantie 13 crisis schorsing bedienden |
Betaling | Bevat de gegevens rond uitbetaling |
Duurtijd | |
Eenheid | Mogelijke waarden voor tijdseenheid:
|
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:
|
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 artikel bron omschrijving |
Op deze pagina
Binnen deze handleiding
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