Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Beschrijving Vraag (GeefWerkrelaties-02.00)

Owned by Jasper Missinne (Unlicensed)
Last updated: 27 Mar, 2024 by Bert Van Kets
5 min read

Algemeen

De dienst GeefWerkrelaties 02.00 biedt de afnemer van het MAGDA platform de mogelijkheid om

vanaf een opgegeven datum de contracten tussen werknemers en werkgevers op te vragen. Afhankelijk van de verkregen machtiging zal de gebruiker in staat zijn een opvraging te doen gebruik makend van 1 of meerdere van onderstaande mogelijkheden:

  • Het opvragen van (de contracten bij al) de werkgevers van een bepaalde werknemer

  • Het opvragen van (de contracten van) de werknemers van een bepaalde werkgever

  • Het opvragen van de contracten van een bepaalde werknemer bij een bepaalde werkgever.

Naast deze drie basisfunctionaliteiten kan de gebruiker nog een aantal extra selectiecriteria opgeven om zijn selectie te verfijnen :

  • een broncode (RSZ of DIBISS)

  • een aantal extra dimonakenmerken:

    • één of meerdere paritaire comités

    • één of meerdere aard werknemer

    • enkel contracten afgesloten via een welbepaalde interimonderneming

  • een afgesloten periode

  • enkel periodes gestart of beëindigd in de opgegeven periode

  • enkel niet-geschrapte of enkel geschrapte

  • enkel niet-interim periodes of enkel interim periodes

KSZ stelt hiervoor een nieuwe SOA-dienst ter beschikking.

Opmerkingen:

  • Indien er een inschrijvingscontrole op ondernemingsnummer voor de afnemer geconfigureerd werd, dan is het voor deze afnemer niet mogelijk een vraag te stellen op basis van het RSZNummer.

  • Geen mogelijkheid om een opvraging te doen op basis van vestigingsnummer, RSZ ondersteunt dergelijke opvraging niet.

XSD Visueel

 

Detail

Element

Cardinaliteit

Opmerkingen

Referte

Verplicht

1

UUID, unieke referte per vraag (wordt niet gevalideerd).

Inhoud

Verplicht

1



      TypeAntwoord

Verplicht

1

Laat toe aan te geven hoe het resultaat van de opvraging moet worden teruggegeven :

  • 0 = enkel online; indien het antwoord meer dan 2000 contracten bevat, geven we geen antwoord, maar een fout dat het antwoord meer dan 2000 contracten bevat.

  • 1 = indien het resultaat meer dan 2000 contracten bevat, wordt het opgestuurd in batch. Indien het minder dan 2000 contracten heeft wordt het online opgestuurd.

  • 2 = alle antwoorden worden steeds in batch geleverd.

            Criteria

Verplicht

1

Bevat de geefcriteria.

                  Relatie

Verplicht

1

Hier geeft men aan welk type werkrelatie ondervraagd wordt:

alle werkrelaties van een bepaalde onderneming

alle werkrelaties van een bepaalde persoon

de werkrelaties van een bepaalde persoon binnen een bepaalde onderneming

                        Werkgever

Optioneel

[0..1]

Een werkgever kan geïdentificeerd worden ofwel op basis van zijn KBO-nummer ofwel op basis van zijn RSZ-nummer

                              Ondernemingsnummer

Verplicht

[0..1]

Een opzoeking op het KBO ondernemingsnummer van de werkgever is mogelijk (met checksum 97 validatie). Met voorloop nul indien ondernemingsnummer niet 10 lang.

                              RSZNummer

Verplicht

[0..1]

Een opzoeking op het RSZ inschrijvingsnummer van de werkgever is mogelijk.

                              DeelEntiteit

Optioneel

[0..1]



Eventueel kan in bepaalde gevallen de opzoeking beperkt worden tot op niveau van een deelentiteit. De code deelentiteit is een voorloper van de vestigingseenheid, gekozen door de werkgever in afspraak met de RSZ. De deelentiteit is echter enkel van toepassing op en gebruikt door scholen, Vlaams gewest, Waals gewest, justitie en politie.

                              SectorIndicatoren

Optioneel

[0..1]

 

SectorIndicator

[1..2]

Sector van de werkgever. Tot 2 SectorIndicatoren kunnen optioneel opgegeven worden voor de filtering.

  • PRI : Gegevens van werkgevers in de particuliere sector

  • PFR : Gegevens van werkgevers in de federale publieke sector

  • PLP : Gegevens van werkgevers in de provinciale en lokale publieke sector

Om op alle sectoren te zoeken kan het blok sectorIndicatoren weggelaten worden.

                        Werknemer

Optioneel

[0..1]



                              INSZ

Verplicht

1

Opzoeking op basis van het INSZ van de werknemer (met checksum 97 validatie).

                              DimonaNummer

Optioneel

[0..1]

Men kan de selectie beperken tot een specifiek contract. Het dimonanummer identificeert een contract tussen een werknemer en zijn werkgever.

                  Bron

Optioneel

[0..1]

Hier kan men aanduiden of de opzoeking enkel in de gegevensbank van ‘RSZ’, ‘DIBISS’ of in allebei (niet ingevuld) moet gebeuren.

                  DimonaKenmerken

Optioneel

[0..1]

Extra kenmerken waarop geselecteerd kan worden

                        ParitaireComites

Optioneel

[0..1]

Er kunnen één of meerdere specifieke paritaire comités opgevraagd worden (zie verder)

                              ParitaireComite

Verplicht

[1..n]

Het nummer van het paritair comité of subcomité waaronder de werkgever ressorteert.

                        AardWerknemers

Optioneel

[0..1]

Er kan eveneens geselecteerd worden op basis van aard-codes van werknemers (zie verder).

                              AardWerknemer

Verplicht

[1..n]

Code die de aard van de werknemer aangeeft.

                        InterimOnderneming

Optioneel

[0..1]

Er kan ook eventueel specifiek gezocht worden op basis van de identificatie van een interimonderneming, zijnde ofwel zijn KBO ondernemingsnummer ofwel zijn RSZ Inschrijvingsnummer

                              Ondernemingsnummer

Optioneel

[0..1]

KBO ondernemingsnummer van de interimonderneming (met checksum 97 validatie).

                              RSZNummer

Optioneel

[0..1]

RSZ inschrijvingsnummer van de interimonderneming.

                        Periode

Verplicht

1



                              BeginDatum

Verplicht

1

Begindatum periode waarin de opgevraagde contracten moeten liggen Formaat: jjjj-mm-dd

Moet geldige datum zijn

                              EindDatum

Optioneel

[0..1]

Einddatum periode waarin de opgevraagde contracten moeten liggen Formaat: jjjj-mm-dd

Moet geldige datum zijn

Moet groter of gelijk zijn aan BeginDatum

                        EnkelGestartOfBeeindigd

Optioneel

[0..1]

Hiermee kan aangegeven worden of alle periodes worden opgevraagd, dan wel alleen de periodes die begonnen of geëindigd zijn binnen de opgevraagde periode.

1 = enkel periodes begonnen of geëindigd binnen de opgevraagde periode

0 = alle periodes

Indien niet ingevuld, default = 0 / alle periodes

                        SchrappingsIndicatie

Verplicht

1

Met de schrappingsindicatie kan men vragen naar alle contracten (inclusief de geschrapte contracten), enkel de niet-geschrapte contracten, of enkel de geschrapte contracten.

0 = alle contracten

1 = niet-geschrapte

2 = geschrapte

                        InterimIndicatie

Optioneel

[0..1]

Laat toe om enkel interim periodes of niet-interim periodes of beide op te zoeken:

0 = interim + niet interim

1 = alleen interim

2 = alleen niet-interim

Indien niet ingevuld, default = 2 / alleen niet-interim

Validaties op vraag

Element

Validatie

Mogelijke foutcodes

Periode/Begin

Geldige datum

20001

Periode/Einde

Geldige datum, groter dan of gelijk aan begindatum (Periode/Begin)

20001

20003

INSZ

Een INSZ heeft volgende structuur: yymmddnnncc

Controlegetal van het INSZ nummer moet voldoen aan de checksum 97 validatie: cc = 97 – (nnnnnnnnn mod 97)

Een INSZ nummer is dus geldig indien het berekende controlegetal gelijk is aan het opgenomen controlegetal.

20002

Ondernemingsnummer

Een KBO ondernemings- of vestigingsnummer heeft volgende structuur: nnnnnnnncc

Controlegetal van het Ondernemingsnummer moet voldoen aan de checksum 97 validatie cc = 97 – (nnnnnnnnn mod 97)

Een KBO nummer is dus geldig indien het berekende controlegetal gelijk is aan het opgenomen controlegetal.

20007

Opmerkingen

Mogelijke waarden voor ParitairComité

De mogelijke waarden voor deze code zijn echter NIET beperkt tot de waarden hieronder opgegeven.

Dit is ook niet gedefinieerd als een enumeratie om te vermijden dat het schema moet aangepast worden bij een wijziging in deze lijst:

  • 124 : Bouw

  • 140 : Transport

  • 322 : Uitzendkracht

  • 144 : Landbouw

  • 145 : Tuinbouw

  • 302 : Horeca

  • xxx : Andere

Mogelijke waarden voor AardWerknemer

De mogelijke waarden voor deze code zijn echter NIET beperkt tot de waarden hieronder opgegeven.

Dit is eveneens niet gedefinieerd als een enumeratie om te vermijden dat het schema moet aangepast worden bij een wijziging in deze lijst:

  • BCW : Bouw & constructie werknemer

  • EXT : Extra werknemer

  • IVT : Individuele beroepsopleiding

  • RTA : Geregistreerde stagiairs of gelijkgestelde

  • STU : student

  • STX : Extra student

  • TEA : Onderwijzer

  • DWD : Dimona zonder Dmfa

  • TRI : Overgang stage

  • FLX : FlexiJob

  • OTH : Andere

Voorbeeld

<Vraag> <Referte>f1af3-ad0e-4958-ab8f-1b4f529bb93e</Referte> <Inhoud> <TypeAntwoord>0</TypeAntwoord> <Criteria> <Relatie> <Werkgever> <Ondernemingsnummer>0987654321</Ondernemingsnummer> </Werkgever> </Relatie> <Periode> <Begin>2006-10-01</Begin> </Periode> <EnkelGestartOfBeeindigd>1</EnkelGestartOfBeeindigd> <SchrappingsIndicatie>1</SchrappingsIndicatie> </Criteria> </Inhoud> </Vraag>
<Vraag> <Referte>f1af3-ad0e-4958-ab8f-1b4f529bb93e</Referte> <Inhoud> <TypeAntwoord>0</TypeAntwoord> <Criteria> <Relatie> <Werknemer> <INSZ>98765432109</INSZ> </Werknemer> </Relatie> <Periode> <Begin>2006-10-01</Begin> </Periode> <EnkelGestartOfBeeindigd>1</EnkelGestartOfBeeindigd> <SchrappingsIndicatie>1</SchrappingsIndicatie> </Criteria> </Inhoud> </Vraag>
<Vraag> <Referte>f1af3-ad0e-4958-ab8f-1b4f529bb93e</Referte> <Inhoud> <TypeAntwoord>0</TypeAntwoord> <Criteria> <Relatie> <Werkgever> <Ondernemingsnummer>0987654321</Ondernemingsnummer> </Werkgever> <Werknemer> <INSZ>98765432109</INSZ> </Werknemer> </Relatie> <Periode> <Begin>2006-10-01</Begin> </Periode> <EnkelGestartOfBeeindigd>1</EnkelGestartOfBeeindigd> <SchrappingsIndicatie>1</SchrappingsIndicatie> </Criteria> </Inhoud> <Inhoud> </Vraag>

Codetabellen Vraag

Bij bepaalde gegevens worden er door de  MAGDA-dienst beschrijvingen toegevoegd (als attribuut) aan de codes die worden doorgegeven door KSZ en wel omdat deze beschrijvingen niet door KSZ zelf worden doorgegeven.

Onderstaande tabellen geven weer voor welke codes er welke beschrijvingen worden toegevoegd.

Indien er een nieuwe code van de bron ontvangen wordt waarvoor MAGDA de beschrijving (nog) niet kent, zal er aan het antwoord een uitzondering toegevoegd worden met de melding dat er voor die specifieke code nog geen beschrijving gevonden werd.

Hou er bijgevolg rekening mee dat de lijst met beschrijvingen niet vast ligt en er dus bij kunnen komen.

Bron

Code

Omschrijving

RSZ

Rijksdienst voor sociale zekerheid

DIBISS

Dienst voor de Bijzondere Socialezekerheidsstelsels (= RSZ_PPO + DOSZ)

IdentificatiePersoonGevalideerd

Code

Omschrijving

0

Probleem met identificatie persoon

1

Identificatie persoon OK

ServiceCategorie

Code

Omschrijving

S

Kort

L

Lang

LaatsteDimonaActie

Code

Omschrijving

I

Indienst

O

Uitdienst

U

Wijziging

C

Annulatie

B

Verwijdering

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