GEBRUIKERSHANDLEIDING ONDERNEMING GEEFFISCALESCHULD Versie /// 1.0 Publicatiedatum /// /// Gebruikershandleiding

Transcriptie

1 /// Gebruikershandleiding GEBRUIKERSHANDLEIDING ONDERNEMING GEEFFISCALESCHULD Versie /// 1.0 Publicatiedatum ///

2 Informatie Vlaanderen /// Auteur: Michaël Loedts Datum aanmaak: Wijzigingsdatum: Datum afdruk: Interne bestandsnaam: Document1 Documenthistoriek: Versie Opmerking Datum Auteur Status 0.1 Aanmaak analysedocument Michaël Loedts Eerste versie 1.0 Klaar voor publicatie 08/01/2018 Michaël Loedts 2 /// /// Gebruikershandleiding - GeefFiscaleSchuld

3 /// Informatie Vlaanderen INHOUD Inhoud Inleiding Definities en afkortingen Doel Algemeen Omgevingsinformatie Gegevensbronnen Batch Interface Algemeen Vraag Visueel Detail Functionele validaties Voorbeeld Opmerkingen Antwoord Visueel Detail Voorbeeld Onderneming met schuld Onderneming zonder schuld Uitzonderingen Overzicht dienst specifieke uitzonderingen Overzicht mogelijk annotaties Voorbeelden Gebruikershandleiding - GeefFiscaleSchuld /// /// 16

4 Informatie Vlaanderen /// Fout bij ophalen gegevens Geen gegevens gevonden Codetabellen Vraag: InclusiefBedrag Antwoord: Schuld Werking Aandachtspunten Bedrag InclusiefBedrag Opties FAQ Verschillen met vorige versie Testgegevens / mock Testgegevens /// /// Gebruikershandleiding - GeefFiscaleSchuld

5 /// Informatie Vlaanderen 1 INLEIDING 1.1 DEFINITIES EN AFKORTINGEN Term/Afkorting FodFin KSZ Omschrijving Federale overheidsdienst Financiën Kruispuntbank Sociale Zekerheid 1.2 DOEL Dit document beschrijft het gebruik en de werking van de webservice GeefFiscaleSchuld zoals deze door Agentschap Informatie Vlaanderen op het MAGDA platform aangeboden wordt. Het doel van deze dienst op het MAGDA-platform is het beschikbaar stellen van de fiscale schuld van een onderneming. Dit gegeven is beschikbaar bij de FodFin en zal opgevraagd worden via de KSZ. Gebruikershandleiding - GeefFiscaleSchuld /// /// 16

6 Informatie Vlaanderen /// 2 ALGEMEEN 2.1 OMGEVINGSINFORMATIE Naam: GeefFiscaleSchuld Versie: Functioneel domein: Onderneming Classificatie: Persoonsgevoelig 2.2 GEGEVENSBRONNEN De gegevens worden opgevraagd/opgeslagen bij volgende (authentieke) gegevensbron(nen): FodFin met als integrator KSZ (SOA EnterpriseFiscalDebtService) Agentschap Informatie Vlaanderen is dan ook afhankelijk van deze externe bron voor de kwaliteit en de beschikbaarheid van de gegevens. 2.3 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 deze bestanden: GFSD. 6 /// /// Gebruikershandleiding - GeefFiscaleSchuld

7 /// Informatie Vlaanderen 3 INTERFACE 3.1 ALGEMEEN De Vraag- en Antwoord interface zijn opgebouwd volgens de MAGDA 2.0 standaarden. De vraag bevat drie elementen: Het ondernemingsnummer Nummer erkenning Aanduiding of het schuldbedrag al dan niet gewenst is in het antwoord Als antwoord verkrijgt de afnemer volgende gegevens: Het ondernemingsnummer zoals opgegeven in de vraag Nummer van erkenning (indien beschikbaar) Aanduiding of er al dan niet een fiscale schuld is Statusdatum Het schuldbedrag 3.2 VRAAG Visueel Gebruikershandleiding - GeefFiscaleSchuld /// /// 16

8 Informatie Vlaanderen /// Detail Element Ondernemingsnummer NummerErkenning InclusiefBedrag Opmerkingen Het ondernemingsnummer, steeds met voorloopnul. Hierop wordt een functionele validatie uitgevoerd. Het eventuele erkenningsnummer Aanduiding of het bedrag al dan niet gewenst is in het antwoord: - 0: bedrag niet gewenst - 1: bedrag gewenst Functionele validaties Element Validatie Mogelijke foutcodes Ondernemingsnummer Het opgegeven nummer moet voldoen aan het controlecijfer Voorbeeld <Vragen> <Vraag> <Referte>8459</Referte> <Inhoud> <Criteria> <Ondernemingsnummer> </Ondernemingsnummer> 8 /// /// Gebruikershandleiding - GeefFiscaleSchuld

9 /// Informatie Vlaanderen <InclusiefBedrag>1</InclusiefBedrag> </Criteria> </Inhoud> </Vraag> </Vragen> Opmerkingen Geen specifieke opmerkingen. 3.3 ANTWOORD Visueel Gebruikershandleiding - GeefFiscaleSchuld /// /// 16

10 Informatie Vlaanderen /// Detail Element Ondernemingsnummer NummerErkenning Schuld Opmerkingen Het ondernemingsnummer zoals opgegeven in de vraag Het eventuele erkenningsnummer van de onderneming Aanduiding of er een schuld is: - 0: geen schuld - 1: wel een schuld DatumVaststelling Bedrag Formaat jjjj-mm-dd. Dit is niet zozeer de datum van vaststelling maar een statusdatum. Deze datum is identiek aan de datum van opvraging. Het bedrag van de fiscale schuld, in eurocent Voorbeeld Onderneming met schuld <Antwoorden> <Antwoord> <Referte>8459</Referte> <Inhoud> <FiscaleSchuld> <Ondernemingsnummer> </Ondernemingsnummer> <Schuld>1</Schuld> <DatumVaststelling> </DatumVaststelling> <Bedrag> </Bedrag> </FiscaleSchuld> </Inhoud> </Antwoord> </Antwoorden> Onderneming zonder schuld <Antwoorden> <Antwoord> <Referte>8456</Referte> <Inhoud> <FiscaleSchuld> <Ondernemingsnummer> </Ondernemingsnummer> <Schuld>0</Schuld> <DatumVaststelling> </DatumVaststelling> <Bedrag>0</Bedrag> </FiscaleSchuld> </Inhoud> </Antwoord> 10 /// /// Gebruikershandleiding - GeefFiscaleSchuld

11 /// Informatie Vlaanderen </Antwoorden> 3.4 UITZONDERINGEN Overzicht dienst specifieke uitzonderingen Identificatie Niveau Type Toelichting FOUT Ondernemingsnummer in de vraag heeft een ongeldige structuur FOUT Fout bij ophalen gegevens bij leverancier FOUT Geen gegevens gevonden voor de vraag FOUT Inhoudelijke fout bij de bron, contacteer VIP FOUT Fouten gevonden voor één of meerdere ondernemingen Overzicht mogelijk annotaties Geen dienst specifieke annotaties Voorbeelden Fout bij ophalen gegevens <Antwoorden> <Antwoord> <Referte>8458</Referte> <Uitzonderingen> <Uitzondering> <Identificatie>45621</Identificatie> <Oorsprong>KSZ</Oorsprong> <Type>FOUT</Type> <Tijdstip> <Datum> </Datum> <Tijd>15:06:01.437</Tijd> </Tijdstip> <Diagnose>Fout bij ophalen gegevens bij leverancier</diagnose> <Omstandigheid>EFD00002</Omstandigheid> </Uitzondering> </Uitzonderingen> </Antwoord> </Antwoorden> Gebruikershandleiding - GeefFiscaleSchuld /// /// 16

12 Informatie Vlaanderen /// Geen gegevens gevonden <Antwoorden> <Antwoord> <Referte>8463</Referte> <Uitzonderingen> <Uitzondering> <Identificatie>30001</Identificatie> <Oorsprong>KSZ</Oorsprong> <Type>FOUT</Type> <Tijdstip> <Datum> </Datum> <Tijd>12:56:22.609</Tijd> </Tijdstip> <Diagnose>Geen gegevens gevonden voor de vraag</diagnose> <Omstandigheid>EFD00003</Omstandigheid> </Uitzondering> </Uitzonderingen> </Antwoord> </Antwoorden> 3.5 CODETABELLEN Vraag: InclusiefBedrag Code Omschrijving 0 Bedrag niet gewenst in het antwoord 1 Bedrag wel gewenst in het antwoord Antwoord: Schuld Code Omschrijving 0 Geen fiscale schuld voor de onderneming 1 Onderneming heeft een fiscale schuld 12 /// /// Gebruikershandleiding - GeefFiscaleSchuld

13 /// Informatie Vlaanderen 4 WERKING 4.1 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> </Ondernemingsnummer> <Schuld>1</Schuld> <DatumVaststelling> </DatumVaststelling> <Bedrag> </Bedrag> </FiscaleSchuld> </Inhoud> Indien InclusiefBedrag = 0: het Bedrag-element zal niet aanwezig zijn <Inhoud> <FiscaleSchuld> <Ondernemingsnummer> </Ondernemingsnummer> <Schuld>1</Schuld> <DatumVaststelling> </DatumVaststelling> </FiscaleSchuld> </Inhoud> 4.2 OPTIES Volgende configuratieparameters kunnen ingesteld worden in functie van de machtigingen en de wensen van de afnemer: Geen specifieke opties voor deze dienst Gebruikershandleiding - GeefFiscaleSchuld /// /// 16

14 Informatie Vlaanderen /// 4.3 FAQ Overzicht van gekende vragen en problemen voor zover die bestaan. 14 /// /// Gebruikershandleiding - GeefFiscaleSchuld

15 /// Informatie Vlaanderen 5 VERSCHILLEN MET VORIGE VERSIE Dit is de eerste versie van de dienst, geen vorige versie. Gebruikershandleiding - GeefFiscaleSchuld /// /// 16

16 Informatie Vlaanderen /// 6 TESTGEGEVENS / MOCK 6.1 TESTGEGEVENS De authentieke bron neemt regelmatig een kopie van productie en stelt deze gegevens als testdata ter beschikking op de acceptatieomgeving. Houd er bijgevolg rekening dat deze data niet actueel is. 16 /// /// Gebruikershandleiding - GeefFiscaleSchuld