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 :
|
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.
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
| Expand | |||||
|---|---|---|---|---|---|
| |||||
|
| Expand | |||||
|---|---|---|---|---|---|
| |||||
|
| Expand | |||||
|---|---|---|---|---|---|
| |||||
|
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 |
Op deze pagina
| Table of Contents | ||||
|---|---|---|---|---|
|
Binnen deze handleiding
| Child pages (Children Display) | ||
|---|---|---|
|
| Info |
|---|
Met vragen kunt u steeds terecht bij de MAGDA Service Desk. |