- Created by Dagmar Ottevangers (Deactivated) , last modified by Jan Willem on 26 Apr, 2022
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 9 Next »
Informatie:
Voor de ontsluiting van een MAGDA 2.0 webservice, alsook het generieke proces binnen een 2.0 webservice, wordt verwezen naar Werking en gebruik MAGDA 2.0 Webservices.
De dienst GeefFiscaleInhoudingsplicht stelt de afnemer van het MAGDA platform in staat om na te gaan of een onderneming al dan niet een fiscale schuld heeft.
Situering
Wie een overeenkomst afsluit met een aannemer (bouw, elektro of schoonmaak), met ondernemingen behorende tot de sector van de bewakings- en/of toezichtsdiensten of met ondernemingen behorende tot de vleessector moet nagaan of die aannemer fiscale schulden heeft. Is dit het geval dan is de opdrachtgever (met uitzondering van particuliere opdrachtgevers) hoofdelijk aansprakelijk voor de betaling van die schulden.
Als de aannemer (nog) fiscale schulden heeft op het ogenblik van de uitbetaling van diens factuur, dan moet de opdrachtgever 15% van dit bedrag inhouden en doorstorten aan de fiscus.
Gegevensbronnen
De gegevens die door deze webservice beschikbaar gesteld worden zijn afkomstig van FOD Financiën.
Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvraging.
Opmerking:
Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens.
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:
Toelating tot de dienst GeefFiscaleInhoudingsplicht 02.01
Informatie:
Meer informatie over deze voorwaarden is terug te vinden op de pagina “Machtigingen en toelatingen”.
Meer informatie over het aansluitingsproces is terug te vinden op deze webpagina.
Batch
Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.
Prefix | Onderneming.GeefFiscaleInhoudingplicht-02.01 |
---|---|
Voorbeeld | Onderneming.GeefFiscaleInhoudingplicht-02.01_20131103115553530.xml |
Functionaliteiten
Vraag
De vraag gebeurt aan de hand van een verplicht ondernemingsnummer, het ondernemingsnummer van de uiteindelijke bestemmeling van de gegevens en het ondernemingsnummer van de onderneming die de aanvraag doet. Dit aangevuld met de contactgegevens van de onderneming en de persoon die de aanvraag doet.
Antwoord
Als antwoord verkrijgt men de aanduiding of er voor de fiscus al dan niet inhoudingsplicht geldt.
Een negatieve beslissing inzake inhoudingsplicht geldt slechts voor een bepaalde periode en is beperkt in de tijd. Er wordt dan ook meegegeven tot wanneer deze beslissing geldig is. Tot dan is de afnemer in feite vrijgesteld van controle van de fiscale inhoudingsplicht is.
Een positieve beslissing, daarentegen, is alleen geldig op de dag zelf. In principe moet de opdrachtgever de dag nadien terug raadplegen aangezien de ondernemer intussen zijn schuld kan vereffend hebben.
Werking
Aandachtspunten
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.
Hierna vindt er een functionele validatie plaats van de vraag (checksum 97 op ondernemingsnummers).
Zijn de ondernemingsnummers correct, dan wordt de request naar de CrassusWS aangemaakt en uitgevoerd. Nadien zal de webservice het antwoord op de vraag opbouwen op basis van het ontvangen antwoord van de CrassusWS. Het MAGDA-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. Deze webservice is echter wel afhankelijk van de beschikbaarheid van de CrassusWS bij FodFin.
Bij geplande onbeschikbaarheden worden de afnemers op de hoogte gebracht.
Opmerking:
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 deze pagina "MAGDA logging".
Op deze pagina
Binnen deze handleiding
Omgevingsinformatie
Domein | Onderneming |
---|---|
Classificatie | Persoonsgegevens |
Verwante diensten
- Type Onderneming-02.00
- Onderneming.GeefAdressenLocaties-02.00
- Onderneming.GeefBeschikbareJaarrekeningen-02.00
- Onderneming.GeefDeelnemingen-02.00
- Onderneming.GeefFiscaleInhoudingsplicht-02.01
- Onderneming.GeefFiscaleSchuld-02.00
- Onderneming.GeefFuncties-02.00
- Onderneming.GeefJaarrekeningen-02.00
- Onderneming.GeefOnderneming-02.00
- Onderneming.GeefOndernemingVKBO-02.00
- Onderneming.GeefOndernemingSignalen-02.00
- Onderneming.GeefPCenTW-02.00
- Onderneming.GeefSocialeSchuld-02.00
- Onderneming.GeefTewerkstelling-02.00
- Onderneming.PubliceerAdressenLocaties-02.00
- Onderneming.PubliceerAdressenLocaties-02.02
- Onderneming.PubliceerDeelnemingen-02.00
- Onderneming.PubliceerFaillisementsignalen-02.00
- Onderneming.PubliceerFuncties-02.00
- Onderneming.PubliceerGeannuleerdeOndernemingen-02.00
- Onderneming.PubliceerOndernemingVKBO-02.00
- Onderneming.PubliceerRSZDagvaarding-02.00
- Onderneming.PubliceerSocialeSchuld-02.00
- Onderneming.ZoekOnderneming-02.00
- Onderneming.ondernemingen/adressenLocaties - v1
- Company
Met vragen kunt u steeds terecht bij de MAGDA Service Desk.
- No labels