Situering

Dit document beschrijft het gebruik en de werking van de webservice GeefLeefloonbedragen 2.0 zoals deze door Digitaal Vlaanderen op het MAGDA platform aangeboden wordt. De webservice GeefLeefloonbedragen 2.0 laat toe om de perioden en de bedragen die uitgekeerd worden in het kader van het leefloon te raadplegen.

Als vraag dient de afnemer het INSZ (rijksregisternummer) van de gevraagde persoon op te geven alsook een (referentie)jaar. De afnemer kan een overzicht krijgen tot drie jaar voor het referentiejaar.

Als gegevens worden bekomen:

• Aanduiding of de persoon in kwestie al dan niet een uitbetaling ontvangen heeft

• Of er indicaties zijn van tweede begunstigden

• De aard van tegemoetkomingen (leefloon, leefloonequivalent, kinderbijslag)

• Het jaarlijks en maandelijks bedrag van tegemoetkoming

Gegevensbronnen

De gegevens worden opgevraagd/opgeslagen bij volgende (authentieke) gegevensbron(nen):

• KSZ als integrator voor de sociale zekerheid

• POD Maatschappelijke integratie als authentieke bron

Overlap inschrijvingscontrole

Naast de standaard actieve inschrijving is deze dienst ook beschikbaar met overlap inschrijvingscontrole. Hierbij wordt een periode uit de vraag vergeleken met de periode die gebruikt is bij de Repertorium.RegistreerInschrijving-02.00 dienst. Er moet minimaal 1 dag overlap zijn tussen beide periodes. Bij een actieve inschrijvingscontrole dient het INSZ actief te zijn in het inschrijvingsrepertorium op het moment van verwerking van de vraag.

Begin- en eindatum van de periode uit de vraag

Volgend element wordt gebruikt als begin- en einddatum

Batch

Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML).

Hiervoor moet men de Service-xsd gebruiken en niet de Webservice. Door de Service-xsd te gebruiken zijn er meerdere vragen mogelijk in één bestand. De vraag-bestanden worden op de MAGDA FTP geplaatst in een afnemer specifieke folder. Deze folder wordt tijdens het aansluitingsproces toegekend.

Als prefix is voorzien: “GLLB_”.

Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.

Werking

Aandachtspunten

Huidig jaar:

De vraag bevat een element jaar met een attribuut “Huidig” met als huidige waardes 0 of 1.

Indien 0 opgegeven wordt (of het attribuut wordt niet in de vraag opgenomen), wordt het opgegeven jaartal doorgegeven naar de bron.

Indien 1 werd opgegeven, dan zal het opgegeven jaar genegeerd worden. Het jaar-element moet wel opgegeven worden maar achterliggend zal bij de bron op het huidig jaar gezocht worden.

Opmerking: Testen wijzen uit dat attribuut “huidig” niet aanwezig moet zijn (of 0) en enkel het referentiejaar (of het huidig jaar) opgegeven kan worden.

"Geen gegevens gevonden" vs. "Geen uitbetaling":

Indien de persoon gekend is bij de achterliggende bron én voor alle opgevraagde jaren geen uitbetaling geweest is, is foutcode 30001 – geen gegevens gevonden, NIET van toepassing.

Zijn er geen uitbetalingen, dan zal dit gewoonweg terugkomen als een antwoord met leefloonbedragen. In het jaar dat geen uitbetaling geweest is, zal dan een Uitbetaling-element terug te vinden zijn met waarde “0” en het attribuut Beschrijving “Geen uitbetaling”.

De uitzondering “Geen gegevens gevonden”, verkrijgt de afnemer indien de opgevraagde persoon niet gekend is bij de bron.

Negatief bedrag:

Bedragen kunnen negatief zijn, dit houdt veelal in dat een terugbetaling naar de POD Maatschappelijke Integratie uitgevoerd werd.

Aantal Maand-elementen en aantal Periode-elementen:

Het aantal Maand-elementen binnen Maandelijks is unboundend binnen het Antwoord. Echter, vanuit de bron kunnen er maar 12 Maand-elementen voorkomen.

LeefloonPeriode, EquivalentLeefloonPeriode en KinderbijslagPeriode zijn dan vanuit de bron beperkt tot max 31 voorkomens. 

Responsetijden & Beschikbaarheid

Logging

De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".

Ondersteunde talen

MAGDA ondersteunt de Nederlandse taal.

Indien in de brongegevens de Nederlandse tekst niet beschikbaar is voor een bepaald element zal de eerste vertaling van de tekst in de brongegevens gebruikt worden, onafhankelijk van de taal waarin dit gegeven beschikbaar is.