Beschrijving berichten-P051-NL

Titel: Beschrijving berichten - P051
Re.
:5
Blad
: 1 van 7
Datum : 1-december-2016
INHOUD:
1
SPECIFIEKE FUNCTIONELE BESCHRIJVING VAN HET BERICHT P051......................... 2
1.1
1.2
Doel .................................................................................................................................................... 2
Beschrijving ....................................................................................................................................... 2
1.2.1
BERICHTEN PRIMAIR NETWERK (Schema’s beginnend met ‘P’) ...................................................... 2
1.2.1.1 P051: Raadpleging Personeelsregister (RIP) ......................................................................................... 2
1.2.1.1.1 Principe ........................................................................................................................................... 2
1.2.1.1.2 Beschrijving van een voorlegging ................................................................................................... 2
1.2.1.1.3 Beschrijving van de Response ......................................................................................................... 3
2
BIJLAGEN ................................................................................................................................... 7
2.1
Bijlage 1: Lijst met frequent voorkomende foutcodes ....................................................................... 7
Titel: Beschrijving berichten - P051
Re.
:5
Blad
: 2 van 7
Datum : 1-december-2016
1
SPECIFIEKE FUNCTIONELE BESCHRIJVING VAN HET BERICHT P051
1.1
Doel
Dit document geeft een beschrijving van het Kadasterbericht P051 dat in de vorm van een XMLschema (.xsd-bestand) beschikbaar wordt gesteld aan de kinderbijslagfondsen.
Het P051-bericht behoort tot de groep van P-berichten. Dit type van berichten wordt gebruikt voor de
raadpleging van de gegevens beschikbaar bij het Rijksregister, het KSZ-register en de instellingen van
het primair netwerk van de Sociale Zekerheid alsook het beheer van het KSZ-register.
1.2
Beschrijving
1.2.1
BERICHTEN PRIMAIR NETWERK (Schema’s beginnend met ‘P’)
De Pxxx-berichten bestaan uit een Header en een Body (zie ook 'Structuur berichten.doc').
De Pxxx-berichten die de kinderbijslagfondsen verzenden zijn voorleggingen. FAMIFED stuurt voor
elke ontvangen voorlegging een antwoord terug naar het betrokken fonds.
De kinderbijslagfondsen kunnen de P-berichten synchroon of asynchroon verzenden.
1.2.1.1
1.2.1.1.1
P051: Raadpleging Personeelsregister (RIP)
Principe
Het personeelsbestand is een gegevensbank die beheerd wordt door RSZ(-PPO). Ze bevat gegevens in
verband met contracten tussen de werknemers en hun werkgevers (arbeidsrelaties) en wordt gevoed
door de DIMONA-aangiften (d.i. de Onmiddellijke Aangifte van indienst- en uitdiensttreding van de
werknemer door de werkgever).
Voor deze raadpleging moet de persoon gekend zijn in een kadasterdossier voor het betrokken fonds
en de periode van de raadpleging moet minstens 1 dag overlappen met de integratieperiode van de
betrokkene.
In het Request-gedeelte geeft men de INSZ en een opvraagperiode mee.
1.2.1.1.2
Beschrijving van een voorlegging
HEADER
Voor de beschrijving van de Header: zie document ‘Structuur berichten.doc’.
Titel: Beschrijving berichten - P051
Re.
:5
Blad
: 3 van 7
Datum : 1-december-2016
BODY: Bij een voorlegging bestaat de Body enkel uit een ‘Request’-gedeelte.
Request
Betekenis:
Bevat de voorlegging, afkomstig van het kinderbijslagfonds.
Verplicht, bevat:
 PersonINSS
 EnquiryPeriod
PersonINSS
Betekenis:
Uniek INSZ van een natuurlijke persoon waarvoor men een raadpleging P051 wil
uitvoeren.
Waarde:
Verplicht, 11 posities. Dient te beantwoorden aan de geldigheidscontrole, eigen aan
een INSZ.
EnquiryPeriod
Betekenis:
Vraagperiode waarvoor men het Personeelsregister wil raadplegen. Deze
vraagperiode moet minstens 1 dag overlap hebben met een integratieperiode van de
betrokken persoon voor het betrokken fonds.
Verplicht, bevat:
 StartDate
 EndDate
StartDate
Betekenis:
Begindatum van de vraagperiode.
Waarde:
Verplicht. (format xs:date: jjjj-mm-dd)
EndDate
Betekenis:
Einddatum van de vraagperiode.
Waarde:
Facultatief. (format xs:date: jjjj-mm-dd)
1.2.1.1.3
Beschrijving van de Response
Na verwerking van een voorlegging, zendt FAMIFED een antwoord terug. Elk antwoord bestaat
eveneens uit een Header en een Body.
Het Header-gedeelte bevat dezelfde informatie als deze van de voorlegging, aangevuld met een
aanduiding van het resultaat van de verwerking.
De status van de verwerking wordt weergegeven in ‘Result’. Is deze gelijk aan ‘OK’, dan is de
voorlegging aanvaard. Is de status ‘NOK’ (Not OK), dan werd de voorlegging geweigerd.
De samenstelling van het Body-gedeelte is afhankelijk van het resultaat van de verwerking. In de zone
‘ReturnCode’ van de Header wordt gespecificeerd of er in de Body een ‘ErrorSection’ en/of een
‘Response’ terug te vinden is.
Als antwoord (Response) wordt hetzelfde XML-bestand teruggezonden met volgende mogelijkheden:
Result = OK
ReturnCode = ResponseOnly
 Het Response-gedeelte bevat een lijst met contracten tussen werknemers en hun
werkgevers die voldoen aan de criteria in het Request-gedeelte.
Result = NOK
ReturnCode = ErrorSectionOnly
 INSZ ongeldig.
 INSZ niet gekend in een dossier binnen uw kinderbijslagfonds.
 …
Titel: Beschrijving berichten - P051
Re.
:5
Blad
: 4 van 7
Datum : 1-december-2016
HEADER
Voor de beschrijving van de Header: zie document ‘Structuur berichten.doc’.
BODY
Request
Betekenis:
Response
Betekenis:
Herhaling van de voorlegging.
Antwoordgedeelte waarin een lijst met contracten tussen werknemers en hun
werkgevers die voldoen aan de criteria in het Request-gedeelte voorkomt.
Bevat:
 Activity
Activity
Betekenis:
De gegevens van het contract. Komt maximaal 999 keer voor.
Verplicht, bevat:
 Employer
 Person
 Worker
 Interim
Employer
Betekenis:
De gegevens van de werkgever.
Verplicht, bevat:
 EmployerID
 PLAIndicator
 SubEntity
 LocalUnitID
EmployerID
Betekenis:
Bevat de identificatiegegevens van de werkgever.
Verplicht, bevat:
 NOSSRegistrationNbr
 CompanyID
NOSSRegistrationNbr
Betekenis :
Het RSZ(-PPO)-inschrijvingsnummer van de werkgever.
Waarde:
Maximaal 10 posities.
Facultatief, formaat xs:integer.
CompanyID
Betekenis :
Uniek ondernemingsnummer (KBO-nummer).
Waarde :
Maximaal 10 posities.
Facultatief, formaat xs:long.
PLAIndicator
Betekenis :
Code die aanduidt of het attest afkomstig is van RSZ of RSZ-PPO.
Waarde :
0: onbekend.
1: afkomstig van RSZ.
2: afkomstig van RSZ-PPO.
Verplicht, formaat xs:integer.
SubEntity
Betekenis :
Waarde :
LocalUnitID
Code toegekend, na akkoord van RSZ(-PPO), aan de deelentiteit van de werkgever
voor de publieke sector.
Maximaal 10 posities.
Facultatief, formaat xs:long.
Titel: Beschrijving berichten - P051
Re.
:5
Blad
: 5 van 7
Datum : 1-december-2016
Betekenis :
Waarde :
Identificatienummer van de lokale eenheid: nummer dat de bedrijfszetel identificeert
waarin of van waaruit de werknemer tewerkgesteld is.
Maximaal 10 posities.
Facultatief, formaat xs:long.
Person
Betekenis: Bevat de identificatiegegevens van de werknemer.
Verplicht, bevat:
 PersonINSS
 OriolusValidationCode
PersonINSS
Betekenis: Het INSZ van de betrokken persoon.
Waarde:
11 posities.
Verplicht, formaat: xs:string.
OriolusValidationCode
Betekenis :
Oriolusvalidatiecode.
Waarde :
0: gewoon INSZ.
1: KSZ-nummer met vlag (d.w.z dat er twijfel bestaat of het nummer correct is)
Facultatief, formaat xs:int.
Worker
Betekenis: Bevat gegevens van het contract.
Verplicht, bevat:
 OccupationPeriod
 JointCommissionNbr
 KindOfWorker
 DimonaNbr
 ValidityStatus
 LastDimonaAction
OccupationPeriod
Betekenis: Periode van de tewerkstelling.
Verplicht, bevat:
 StartDate
 EndDate
StartDate
Betekenis :
De datum van indiensttreding van de werknemer.
Waarde :
Facultatief, formaat xs:date.
EndDate
Betekenis :
De datum van uitdiensttreding van de werknemer.
Waarde :
Facultatief, formaat xs:date.
JointCommissionNbr
Betekenis:
Het nummer van het paritair comité of subcomité waaronder de werkgever ressorteert.
Een officiële lijst met de paritaire (sub)comités wordt ieder jaar gepubliceerd in het
Belgisch Staatsblad.
Waarde :
CCC: nummer van een paritair comité.
CCC.CC: nummer van een paritair subcomité.
999: als de werknemer onder geen enkel paritair (sub)comité valt.
Maximaal 9 posities.
Verplicht, formaat xs:string.
KindOfWorker
Betekenis:
Code die de aard van de werknemer aangeeft.
Waarde :
3 blanco’s: alle werknemers (uitgezonderd studenten) in alle sectoren buiten de
bouwsector.
000: alle andere werknemers (uitgezonderd studenten) in sector van de bouwsector.
035: erkende leerlingen en gelijkgestelden in de bouwsector.
VOL: vrijwilliger.
Titel: Beschrijving berichten - P051
Re.
:5
Blad
: 6 van 7
Datum : 1-december-2016
STU: student in alle sectoren.
IBO: individuele beroepsopleiding.
EXT: extra in de land- en tuinbouw en horeca.
TEA: onderwijzend personeel.
DWD: DIMONA zonder DmfA.
TRI: instapstage.
A17: werknemer in het sociaal-cultureel domein (private & publieke sector)
3 posities.
Verplicht, formaat xs:string.
DimonaNbr
Betekenis:
Waarde :
Nummer toegekend door RSZ(-PPO) aan de originele ‘indienst-aangifte’. Dit nummer
identificeert een contract tussen een werknemer en zijn werkgever.
Maximaal 12 posities.
Verplicht, formaat xs:long.
ValidityStatus
Betekenis:
Code die de status van de verificatie van de gegevens weergeeft.
Waarde :
0: geladen, niet gecontroleerd.
1: gecontroleerd.
Verplicht, formaat xs:string.
LastDimonaAction
Betekenis:
Code die de aard van de laatste DIMONA-aangifte weergeeft.
Waarde :
0: onbekend
1: indiensttreding.
2: uitdiensttreding.
3: wijziging.
4: schrapping.
N: neutralisatie: logische schrapping van de aangifte uit de DIMONA-database.
S: fysische schrapping van de aangifte uit de DIMONA-database.
Verplicht, formaat xs:string.
Interim
Betekenis:
Waarde:
Code die aangeeft of de werknemer al dan niet een interimair is.
0: de werknemer is geen interimair.
1: de werknemer is een interimair.
Facultatief, xs:string.
ErrorSection
ErrorList
Betekenis:
Lijst van Errors die aanduiden welke fouten werden vastgesteld. In een eerste fase
wordt hier slechts 1 Error meegegeven.
Error
Betekenis:
Errorcode die aanduidt welke fout werd vastgesteld.
Attribuut:
De Errorcode bevat als attribuut 'code' waarin één foutcode wordt weergegeven.
Code
Betekenis:
Foutcode zoals weergegeven in het document betreffende foutcodes voor
Kadasterberichten.
Parameter
Betekenis:
Bevat bijkomende informatie in verband met de vastgestelde error.
Waarde:
Vrije tekst, toegekend door FAMIFED (formaat xs:string vrije tekst).
Attribuut:
name
Name
Betekenis:
Naam van de parameter.
Waarde:
Vrije tekst, toegekend door FAMIFED (formaat xs:string vrije tekst) (bvb
"Reference").
Titel: Beschrijving berichten - P051
Re.
:5
Blad
: 7 van 7
Datum : 1-december-2016
2
2.1
BIJLAGEN
Bijlage 1: Lijst met frequent voorkomende foutcodes
Code
P05101
P05102
P05105
P05106
P05107
P05108
P05110
P05111
Omschrijving
Periode in de voorlegging ontbreekt
Periode in de voorlegging is ongeldig
De opvraging vereist een integratie bij de KSZ voor de opgegeven periode
Technisch probleem met de KSZ
Blijvend integratieprobleem bij de KSZ
INSZ ongeldig formaat
Geen data beschikbaar in het personeelsbestand
Deze raadpleging vereist het bestaan van een dossier voor uw Kbf