| Excerpt |
|---|
|
Dit document beschrijft het gebruik en de werking van de bestandstransfer service PubliceerMutatiesNotificatiesARZA 2.01 voor het beschikbaar stellen van de gegevens omtrent de loopbaan van een zelfstandige uit het "Algemeen Repertorium van de Zelfstandige Arbeiders" of kortweg ARZA bij het Rijksinstituut voor de Sociale Verzekeringen der Zelfstandigen (RSVZ). Meer specifiek zal de authentieke bron alle INSZ-nummers doorgeven die sinds de laatste notificatie een wijziging ondergingen. |
Wijzigingshistoriek
| Datum | Aanpassingen |
|---|
| Eerste versie van de handleiding
Situering
De PubliceerMutatiesNotificatiesARZA 02.01 publiceert de INSZ-nummers van de personen waarvoor veranderingen zijn doorgevoerd. Deze gegevens komen van het RSVZ en worden doorgegeven naar MAGDA in XML bestanden vanaf de KSZ FTP server. MAGDA haalt die daar op en verwerkt deze data door ze te structureren naar een gestandaardiseerd MAGDA 2.0 formaat. Daarna wordt deze informatie ter beschikking gesteld aan de afnemer via de MAGDA FTP server. Enkel het INSZ nummer van de persoon waarvoor veranderingen zijn doorgevoerd worden doorgegeven. Indien meer info over de persoon nodig is dient deze opgevraagd te worden via de GeefLoopbaanARZA webservice.
Meer info over het MAGDA 2.0 formaat en de FTP richtlijnen zijn te vinden in hoofdstuk 2.
Verwante diensten
- De afnemer registreert een INSZ nummer in het MAGDA inschrijvingsrepertorium via de RegistreerInschrijving dienst
- De PubliceerMutatieNotificatieARZA dienst geeft een notificatie voor het INSZ nummer
- Via de GeefLoopbaanARZA worden alle nodige gegevens opgevraagd over de zelfstandige waarvan het INSZ nummer gepubliceerd is
RegistreerInschrijving en RegistreerUitschrijving : Deze diensten worden gebruikt voor het aanmaken en wissen van een inschrijving in het MAGDA inschrijvingsrepertorium. Op basis van deze inschrijvingen worden de PubliceerMutatiesNotificatiesARZA ontvangen en verdeeld.
Voordat publicaties kunnen ontvangen worden dienen de INSZ worden geregistreerd in het MAGDA inschrijvingsrepertorium. Dit gebeurt via de RegistreerInschrijving dienst.
Indien publicaties voor een bepaalde INSZ niet meer ontvangen moeten worden dient deze INSZ uitgeschreven te worden uit het inschrijvingsrepertorium via de RegistreerUitschrijving dienst. Meer informatie over deze diensten is te vinden in de MAGDA gebruikersgroep site.
/wiki/spaces/MDI/pages/128385061 : Indien meer informatie nodig is over de zelfstandige waarvoor een INSZ is doorgestuurd in een mutatie dient deze informatie opgevraagd te worden via de GeefLoopbaanARZA dienst. Meer informatie over deze dienst is te vinden op de MAGDA gebruikersgroep.
Gegevensbronnen
De oorspronkelijke bron van deze gegevens is het Rijksinstituut voor de Sociale Verzekeringen der Zelfstandigen. Deze gegevens worden via het KSZ ter beschikking gesteld aan Informatie Vlaanderen. Informatie Vlaanderen is dan ook afhankelijk van deze bron voor de kwaliteit en de aanlevering van de gegevens.
Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvraging.
| Note |
|---|
|
Agentschap Informatie Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens. |
Gebruiksvoorwaarden
Vooraleer een afnemer MAGDA diensten kan gebruiken, moet die de MAGDA Aansluitingsprocedure doorlopen. Deze procedure zorgt ervoor dat de afnemer wordt geregistreerd als gerechtigd gebruiker van één of meerdere MAGDA diensten.
Batch
Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.
| Prefix | Werk.PubliceerMutatieNotificatieArza-02.01 |
|---|
| Voorbeeld | Werk.PubliceerMutatieNotificatieArza-02.01_20131103115553530. |
|---|
Functionaliteiten
De communicatie vanuit de KSZ gebeurt in batch-vorm volgens de LDM-standaard ("Lot de Messages"). Deze verwerking is een standaard op het Magda platform en beschreven in de standaard MAGDA documentatie.
KSZ ontvangt de wijzigingen in de persoonsgegevens van het Rijksinstituut voor de Sociale Verzekeringen der Zelfstandigen.
- KSZ stelt deze wijzingen beschikbaar aan diens partners op zijn FTP server.
- De FTP Scheduler haalt dit bestand op bij de KSZ en stelt deze ter beschikking aan de File To File Scheduler
- De File To File Scheduler doet een integriteitscontrole van de inkomende bestanden en stelt deze vervolgens ter beschikking van de File To DB scheduler
- De File-To-DB scheduler zal instaan voor de correcte transformatie van het KSZ-formaat naar het MAGDA-formaat
- Pubmut 02.01 pusht de gegevens naar de publicatiegateway
- De publicatiegateway stelt de gegevens beschikbaar aan de afnemers
Werking
Opties
Volgende afleveropties zijn mogelijk. Deze moeten afgesproken worden bij aansluiting:
- Compressie van het bestand (.zip)
- Melding via mail van aflevering bestand
Responsetijden & Beschikbaarheid
De beschikbaarheid van de dienst staat beschreven in het MAGDA verdeling verantwoordelijkheden document.
| Note |
|---|
|
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".
Bestanden worden gedurende een beperkte tijd aangeboden op de FTP folder zoals beschreven in de FTP richtlijnen
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.
