Situering

Dit document beschrijft het gebruik en de werking van de webservice GeefDmfaVoorWerknemer 02.01 zoals deze door Digitaal Vlaanderen op het MAGDA platform aangeboden wordt. Met deze dienst kunnen de DmfA-attesten van een werknemer gegeven worden. DmfA is een afkorting voor multifunctionele Aangifte. Met deze aangifte dient de werkgever de loon- en arbeidstijdgegevens van zijn werknemers in.

De webservice kan op 3 verschillende manieren gebruikt worden:

• Opvragen van alle DMFA attesten van een persoon over een bepaalde (reeks van) trimester(s)

• Opvragen van 1 bepaald DMFA attest van een persoon

• Opvragen van het volgende attest indien er meerdere attesten voldoen aan de vraag

De dienst GeefDmfAVoorWerknemer geeft de DmfA-attesten van een werknemer. De dienst geeft maximaal één versie van een door de werkgever aangegeven attest.

Meerdere attesten kunnen voldoen aan één vraag. In dit geval wordt dan in het antwoord bij het attest het adres van het volgende attest meegegeven. Om dit volgende attest te verkrijgen, moet in de vraag dit adres uit het vorige antwoord toegevoegd worden.

Gegevensbronnen

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

• RSZ

• RSZPPO

Het ophalen van de gegevens gebeurt via de Kruispuntbank Sociale Zekerheid.

Batch

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

Werking

Aandachtspunten

Kwartaalwijzigingen

DMFA kent zogenaamde kwartaalwijzigingen. Dit houdt in dat elke kwartaal deze dienst potentieel wijzigingen ondergaat. Deze wijzigingen kunnen puur datagewijs zijn maar ook gerelateerd aan de xsd, al dan niet backwards compatible.

Op de ALG/OND/PERS meeting zal besproken worden hoe VDI zal omgaan met deze kwartaalwijzigingen.

Functionele validaties

De Magda dienst controleert enkel of het opgegeven einde van de kwartaal periode gelegen is ná het begin.

Bij de verschillende bronnen gebeuren echter nog bijkomende controles waarmee de afnemer zelf dient rekening te houden:

• Voor opvragingen bij de RSZ mag het beginkwartaal niet liggen voor 20031.

• Voor opvragingen bij de lokale sociale zekerheid (DIBISS) mag het beginkwartaal niet liggen voor 20051.

• Voor beide kan maar opgevraagd worden tot het kwartaal voorgaand aan het huidige.

DMFA kent zogenaamde kwartaalwijzigingen. Dit houdt in dat elke kwartaal deze dienst potentieel wijzigingen ondergaat. Deze wijzigingen kunnen puur datagewijs zijn maar ook gerelateerd aan de xsd, al dan niet backwards compatible.

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.

Op deze pagina

Binnen deze handleiding

Omgevingsinformatie

Verwante diensten