De webservice GeefAanslagbiljetPersonenbelasting is in staat gegevens van het aanslagbiljet van de personenbelasting op te vragen bij de FOD Financiën. Deze gegevens zijn opvraagbaar ofwel rechtstreeks bij de FOD Fin, ofwel via KSZ (die daarna de connectie naar FOD Fin verzorgt).

Situering

De webservice GeefAanslagbiljetPersonenbelasting kadert binnen het domein Inkomen van het MAGDA Platform.

Gegevensbronnen

De authentieke bron van de gegevens is de FOD Financiën. Agentschap Digitaal Vlaanderen is dan ook afhankelijk van deze Federale bron voor de kwaliteit en de aanlevering van de gegevens.
Voor meer informatie met betrekking tot het aanslagbiljet van de personenbelasting wordt verwezen naar de documentatie van de FOD Financiën die terug te vinden is via volgende URL: http://financien.belgium.be/nl/particulieren/.
Digitaal Vlaanderen biedt twee connectiemogelijkheden aan naar de FodFin, het soort connectie is wel afhankelijk van de verkregen machtiging:

• Via KSZ als tussenpartij

• Rechtstreeks naar FodFin

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

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 https://vlaamseoverheid.atlassian.net/wiki/spaces/MG/pages/1211465898 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

Open

Gebruiksvoorwaarden

Om gebruik te kunnen maken van deze dienst dient men een machtiging te hebben die toegang geeft tot deze gegevens en een aansluitingsprocedure te doorlopen.

Batch

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

Functionaliteiten

Vraag

De webservice GeefAanslagbiljetPersonenbelasting 2.0 laat de afnemer van het MAGDA platform toe de gegevens van het aanslagbiljet van de personenbelasting op te halen, op basis van het INSZ van deze persoon en het gewenste en toegelaten inkomensjaar. 
Om de gegevens van het aanslagbiljet van de personenbelasting te raadplegen van twee personen die gezamenlijk belast worden, waardoor ze van de FOD Financiën één aanslagbiljet ontvangen (bvb. gehuwden of wettelijk samenwonenden), moet de webservice met de twee INSZ nummers van de twee personen, afzonderlijk opgeroepen worden. Maar bij opvraging van de ene komt het INSZ van de gerelateerde persoon terug in het antwoord zodat het duidelijk is dat het om een gezamenlijke aangifte gaat en er een bijkomende opvraging kan gebeuren. 

Eens de afnemer de request gelanceerd heeft wordt de vraag doorgestuurd naar de FOD Financiën, al dan niet met de tussenkomst van de Kruispuntbank van de Sociale Zekerheid, de KSZ. Dit is afhankelijk van de machtigingen van de afnemer en de bronkeuze in de vraag.

Antwoord

MAGDA ontvangt het antwoord van KSZ of FodFin en transformeert dit naar een AanslagbiljetPersonenbelasting en/of een uitzondering. De gegevens die op het AanslagbiljetPersonenbelasting ontvangen worden zijn afhankelijk van de verkregen machtigingen.

Werking

Aandachtspunten

• Enkel gemachtigde Ipcalcodes kunnen opgevraagd worden, deze worden opgezet op basis van het inkomstenjaar en afnemer.

Opties

Volgende configuratieparameters kunnen ingesteld worden in functie van de machtigingen en de wensen van de afnemer:

• Configuratieparameters op het MAGDA platform zijn voor deze dienst niet van toepassing

Opvraging

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, bijvoorbeeld de inschrijvingscontrole. 
Hierna vindt er een functionele validatie plaats van de vraag (bijvoorbeeld checksum 97 op het INSZ). Nadien zal de webservice achterliggend de FOD Financiën of de KSZ oproepen. Ontvangt de webservice een antwoord – hetzij de gegevens van het aanslagbiljet van de personenbelasting, 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.

Responsetijden & Beschikbaarheid

De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar. De beschikbaarheid van de gegevens is echter volledig afhankelijk van de FOD Financiën en - indien de gegevens via KSZ opgevraagd worden - KSZ die in principe 24/7 beschikbaar zijn. 
Bij geplande onbeschikbaarheden van de FOD Financiën of de KSZ worden de afnemers op de hoogte gebracht via mail. Bij een onverwachte onbeschikbaarheid wordt in het mate van het mogelijk een mail uitgestuurd (dit is als Digitaal Vlaanderen zelf op de hoogte gebracht wordt door de FOD Financiën of KSZ.).

Logging

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

Op deze pagina

Binnen deze handleiding

Omgevingsinformatie

Verwante diensten