DIGITAAL VLAANDEREN

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

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.


Wijzigingshistoriek

Versie

Opmerking

Datum

Auteur

Status

0.1

Eerste versie

19-05-2016

Bart Olaerts

Concept

0.2

Verwerking opmerkingen review Sara Burm + code IdentificatiePersoonGevalideerd

22-06-2016

Bart Olaerts

Concept

0.3

Kleine correcties

27-09-2016

Michaël Loedts

Concept

0.4

Review en kleine correcties

06-10-2016

Valère Bouserie

Concept

0.5

Aandachtspunt vraag criterium

ondernemingsnummer

24-10-2016

Bart Olaerts

Concept

0.6

Opvang element “NbrOfPlannedWorkingHour” (5.1)

26-10-2016

Jan Van Geert

Concept

1.0

Publicatie

26-10-2016

Jan Van Geert

Finale versie

2.0

Nieuwe lay-out

16-08-2017

Elin Vanlierde

Finale versie

Situering

Dit document beschrijft het gebruik en de werking van de webservice GeefWerkrelaties 02.00 zoals deze door Agentschap Informatie Vlaanderen op het MAGDA platform aangeboden wordt.

Verwante diensten

Diensten Magda Inschrijvingsrepertorium : Mogelijk moet er eerst een inschrijving aangemaakt worden in het Magda inschrijvingsrepertorium alvorens deze dienst te kunnen aanroepen.

Contacteer Agentschap Informatie Vlaanderen in verband met de actuele vereisten omtrent het gebruik van deze diensten.

Gegevensbronnen

De gegevens worden opgevraagd via de KSZ – DIMONA service

Agentschap Informatie Vlaanderen is dan ook afhankelijk van deze externe bron voor de kwaliteit en de beschikbaarheid van de gegevens.

Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvraging.

Opmerking:

Agentschap Informatie Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens. 

Gebruiksvoorwaarden

Afnemers moeten aan volgende voorwaarden voldoen om deze webservice te mogen gebruiken:

  • Toelating tot het MAGDA platform
  • Machtiging van de Vlaamse Toezichtcommissie
  • Machtiging van het sectoraal comité van de Sociale Zekerheid

Meer informatie over deze voorwaarden is terug te vinden in het document “Machtigingen en toelatingen” [MT].

Informatie:

Meer informatie over deze voorwaarden is terug te vinden op de pagina “Machtigingen en toelatingen”.


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.

Prefix voor de batchbestanden: GWRD (GeefWerkRelatiesDienst)

Meer informatie hierover kan u vinden via “Aansluiting op het MAGDA-platform” in het document “MS – Gebruikershandleiding_WebserviceInBatch”, of neem contact op met Agentschap Informatie Vlaanderen.

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

Prefix
Werk.GWRD-02.00
Voorbeeld

Werk.GWRD-02.00_20131103115553530.


Werking

Aandachtspunten

Van zodra de vraag gesteld is wordt er een XSD-validatie uitgevoerd. Is de ontvangen vraag XML niet geldig tegenover het schema, dan stopt de verwerking en wordt een foutmelding aangemaakt, anders gaat de verwerking verder. Na de XSD-validatie vinden de nodige authenticatie- en autorisatiecontroles plaats.

Hierna vindt er een functionele validatie plaats van de vraag. Nadien zal de webservice achterliggend de DimonaService van KSZ oproepen. Ontvangt de webservice een antwoord – hetzij de werkrelaties, hetzij een foutcode – wordt dit gevalideerd en omgezet in een MAGDA XML formaat. Het antwoord wordt nogmaals gevalideerd waarna het aan de afnemer ter beschikking gesteld wordt.

De achterliggende KSZ DimonaService laat niet toe om een vraag o.b.v. een vestigingsnummer te stellen; er moet een ondernemingsnummer meegegeven worden. Indien in de vraag toch een vestigingsnummer wordt meegegeven, resulteert dit in een uitzondering 60003.

Het element “NbrOfPlannedWorkingHour” komende van KSZ wordt niet overgenomen in deze XSD.

Responsetijden & Beschikbaarheid

De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar.

De beschikbaarheid is afhankelijk van de beschikbaarheid bij de bron.

Bij geplande onbeschikbaarheden worden de afnemers op de hoogte gebracht.


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".

Ook de afnemer van persoonsgegevens dient zich verplicht te houden aan de wettelijke loggingsplicht. Meer informatie hieromtrent is terug te vinden in de documenten “Richtlijn logging persoonsgegevens” en “MR - Logging persoonsgegevensdiensten” [MR – Verdeling van verantwoordelijkheden].

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.

Op deze pagina

Binnen deze handleiding

Omgevingsinformatie

Functioneel Domein
Classificatie


  • No labels