SocZek.GeefLeefLoonBedragen-02.00
Informatie:
Voor de ontsluiting van een MAGDA 2.0 webservice, alsook het generieke proces binnen een 2.0 webservice, wordt verwezen naar Werking en gebruik MAGDA 2.0 Webservices.
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
Opmerking:
Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens.
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
| Pad | Opmerking |
---|---|---|
Begindatum | /Inhoud/Criteria/Jaar | “01/01/” + Jaar |
Einddatum | /Inhoud/Criteria/Jaar | “31/12/” + Jaar |
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.
Prefix | SocZek.GLLB-02.00 |
---|---|
Voorbeeld | SocZek.GLLB-02.00_20131103115553530 |
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
Opmerking:
De MAGDA response tijden zijn heel sterk afhankelijk van de response tijden van de bron. Als de brongegevens heel traag worden aangeleverd kan het MAGDA antwoord niet snel worden aangeleverd.
Logging
De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".
Ondersteunde talen
MAGDA ondersteun