Het doel van deze dienst op het MAGDA-platform is het beschikbaar stellen van de fiscale schuld van een onderneming. 

Situering

Deze dienst kadert binnen het domein Onderneming van het MAGDA platform.

Gegevensbronnen

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

• FodFin met als integrator KSZ (SOA EnterpriseFiscalDebtService)

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

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:

• Juridische toegang tot deze gegevens (Machtiging bron Fod Financiën/KSZ)

Batch

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

Functionaliteiten

Vraag

De afnemer moet beschikken over het ondernemingsnummer, hiermee kan de dienst bevraagd worden. De afnemer kan eveneens specifiëren of het bedrag moet teruggegeven worden en een eventueel erkenningsnummer specificeren.

Antwoord

Het antwoord bevat een element dat specificeert of er een schuld is en indien dit als parameter werd meegegeven in de vraag eveneens het bedrag.

Werking

Aandachtspunten

Bedrag

In het antwoord komt het bedrag terug in eurocenten.

InclusiefBedrag

Dit element laat toe aan te duiden of het bedrag al dan niet in het antwoord opgenomen moet worden.
Indien InclusiefBedrag = 1: het Bedrag-element bevindt zich in het antwoord.

<Inhoud>
<FiscaleSchuld>
<Ondernemingsnummer>0510343510</Ondernemingsnummer>
<Schuld>1</Schuld>
<DatumVaststelling>2017-08-30</DatumVaststelling>
<Bedrag>1209055</Bedrag>
</FiscaleSchuld>
</Inhoud> 

Indien InclusiefBedrag = 0: het Bedrag-element zal niet aanwezig zijn

<Inhoud>
<FiscaleSchuld>
<Ondernemingsnummer>0510343510</Ondernemingsnummer>
<Schuld>1</Schuld>
<DatumVaststelling>2017-08-30</DatumVaststelling>
</FiscaleSchuld>
</Inhoud> 

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

De Fiscale Schuld van een onderneming is beschikbaar bij de FOD Financiën en zal opgevraagd worden via KSZ.

Responsetijden

Logging

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