GEBRUIKERSHANDLEIDING GEEFSOCIALESCHULD Versie /// 1.0 Publicatiedatum /// /// Gebruikershandleiding

Transcriptie

1 /// Gebruikershandleiding GEBRUIKERSHANDLEIDING GEEFSOCIALESCHULD Versie /// 1.0 Publicatiedatum ///

2 Informatie Vlaanderen /// Auteur: Jan Van Geert Datum aanmaak: Wijzigingsdatum: Datum afdruk: Interne bestandsnaam: Gebruikershandleiding GeefSocialeSchuld Documenthistoriek: Versie Opmerking Datum Auteur Status 0.1 Aanmaak gebruikershandleiding Jan Van Geert Eerste versie 1.0 Klaar voor publicatie Paulin Van Biesen Finale versie Informatie Vlaanderen Hoofdzetel Boudewijnlaan 30, 1000 Brussel +32 (0) Regionale zetel Koningin Maria Hendrikaplein 70, 9000 Gent +32 (0) /// /// Gebruikershandleiding - GeefSocialeSchuldFout! Bladwijzer niet gedefinieerd. - 1.

3 /// Informatie Vlaanderen INHOUD Inhoud Inleiding Definities en afkortingen Doel Algemeen Omgevingsinformatie Gegevensbronnen Interface Algemeen Antwoord Informatie & Detail Contactpersoon Werkgever (1/2) Werkgever (2/2) Voorbeeld Uitzonderingen Functionele fouten Runtime gerelateerde fouten Codetabel AfbetalingsPlanGevolgd TypeBetwisting Tewerkstelling Tewerkstelling... Fout! Bladwijzer niet gedefinieerd. 4 Werking FAQ Semi-online Gebruikershandleiding - GeefSocialeSchuld- 1. /// /// 22

4 Informatie Vlaanderen /// 5 Testgegevens Testgegevens Algemene Magda documentatie /// /// Gebruikershandleiding - GeefSocialeSchuldFout! Bladwijzer niet gedefinieerd. - 1.

5 /// Informatie Vlaanderen 1 INLEIDING 1.1 DEFINITIES EN AFKORTINGEN Term/Afkorting Magda KSZ Omschrijving Maximale gegevensdeling tussen administraties Kruispuntbank Sociale Zekerheid 1.2 DOEL Dit document beschrijft het gebruik en de werking van de dienst GeefSocialeSchuld 1. zoals deze door Agentschap Informatie Vlaanderen op het MAGDA platform aangeboden wordt. Deze dienst maakt gebruik van de webservice EnterpriseSocialDebt bij KSZ. Gebruikershandleiding - GeefSocialeSchuld- 1. /// /// 22

6 Informatie Vlaanderen /// 2 ALGEMEEN 2.1 OMGEVINGSINFORMATIE Naam: GeefSocialeSchuld Versie: 1. Functioneel domein: Onderneming 1 Classificatie: Privacygevoelig 2.2 GEGEVENSBRONNEN De gegevens zijn afkomstig van de RSZ waarbij KSZ als tussenpartij fungeert. 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. Als prefix voor de batchbestanden wordt GSSD gebruikt. 1 Context informatie over dit domein zijn opgenomen in Domeincontext [DC] 6 /// /// Gebruikershandleiding - GeefSocialeSchuldFout! Bladwijzer niet gedefinieerd. - 1.

7 /// Informatie Vlaanderen 3 INTERFACE 3.1 ALGEMEEN Het doel van deze service op het MAGDA-platform is het beschikbaar stellen van een semi-online antwoordstroom op het online bevragen van de sociale schuld van een onderneming. 3.2 VRAAG Element Kardinaliteit Omschrijving Ondernemingsnummer [1 1] Het ondernemingsnummer waarvoor de sociale schuld gevraagd wordt Aanvrager/Ondernemingsnummer [1 1] Het ondernemingsnummer van de aanvrager. Aanvrager/Vestigingsnummer [0 1] Het vestigingsnummer van de aanvrager. 3.3 ANTWOORD Het antwoord bevat een choice. Oftewel verkrijgt men - een ontvangstbevestiging, de ok van KSZ. Dit wil zeggen dat KSZ de vraag ontvangen heeft en ze meeneemt voor een verwerking in batch waarbij eenmaal per dag de gegevens worden opgehaald. Dit is op dit moment de enige optie. - de financiële situatie van de onderneming uit de RSZ databank. Op dit moment nog niet geïmplementeerd bij KSZ maar op termijn zouden de gegevens meteen in het antwoord vervat zijn (full-online). Gebruikershandleiding - GeefSocialeSchuld- 1. /// /// 22

8 Informatie Vlaanderen /// Ontvangsbevestiging SocialeSchuld/ Kardinaliteit Omschrijving Ontvangstbevestiging [1-1] Boolean die weergeeft of de vraag ontvangen is of niet. Mogelijke waarden: 0 [0 1] Omschrijving van de code Ontvangstbevestiging. 0= Niet correct ontvangen 1= Correct ontvangen Informatie & Detail 8 /// /// Gebruikershandleiding - GeefSocialeSchuldFout! Bladwijzer niet gedefinieerd. - 1.

9 /// Informatie Vlaanderen SocialeSchuld/FinancieleSituatie Informatie/ [1..1] Referentienummer [1..1] Het element Referentienummer bevat een unieke RSZ-referentie die verwijst Gebruikershandleiding - GeefSocialeSchuld- 1. /// /// 22

10 Informatie Vlaanderen /// naar de schuldberekening van het behandelde ondernemingsnummer RSZNummer [0..1] RSZ nummer van de werkgever Ondernemingsnummer [1..1] KBO nummer van de werkgever DatumVerzendingAntwoord [1..1] Datum van verzending van het antwoord Detail/ [0..1] TypeDocument [1..1] Type van het document komende van de dienst. De eerste positie in de code geeft de afdeling weer die het document gemaakt heeft 1: Rekeningen 2: Communicatie 3: Art. 30bis-ter De tweede positie is het document type A = Betalingstermijn B = Betalingsplan C = Verklaring D = Status van de rekening De derde en vierde positie geeft het volgnummer van het document weer (01 tot 99) EindeBijwerkingWerkgeversrekening [1..1] Datum [1..1] Datum laatste bijwerking van de werkgeversrekening. Kwartaal [1..1] Laatste kwartaal dat in rekening wordt genomen bij de analyse van de werkgeversrekening. AfbetalingsplanGevolgd [0..1] Geeft aan of het afbetalingsplan wordt gevolgd. Mogelijke waarden: 0 of Beschrijving van de vlag AfbetalingsplanGevolgd 0 = wordt niet gevolgd 1= wordt gevolgd BedragenSchuld/ [0..1] Dit blok bevat de bedragen van de schulden, na een analyse van de rekening van de werkgever. AangaandeBijdragen [0..1] Totaal bedrag van de schuld aangaande bijdragen (in eurocent). AangaandeToenames [0..1] Totaal bedrag van de schuld aangaande toenames (in eurocent) AangaandeInteresten [0..1] Totaal bedrag van de schuld aangaande interesten (in eurocent) AangaandeLegaleKosten [0..1] Totaal bedrag van de schuld aangaande legale kosten (in eurocent) Betwisting [1..1] Bevat gegevens rond de betwisting Type [1..1] Geeft het type betwisting weer Code [1..1] Code die het type betwisting weergeeft, mogelijke waarden: 1, 2, 3 of [0..1] Beschrijving van het type betwisting 1 = De achterstallige betalingen hebben uitsluitend betrekking op een 10 /// /// Gebruikershandleiding - GeefSocialeSchuldFout! Bladwijzer niet gedefinieerd. - 1.

11 /// Informatie Vlaanderen juridisch geschil over lidmaatschap van een specifiek paritair comité, er wordt gewacht op een uitspraak van de rechtbank. 2 = De automatische rechtzettingen op basis van een verklaring van de werkgever werden vastgelegd door de Rijksdienst Sociale Zekerheid. Deze rechtzettingen zijn de basis voor een geschil dat voorgelegd is aan de rechtbank. 3 = De achterstallige betalingen vermeldt in het document zijn het gevolg van de weigering van verhoogde Maribel-vermindering door Sociale Zekerheid. Dit omdat de werkgever niet voldeed aan bepaalde formele vereisten voor het bewijs van recht op vermindering. 4 = De niet betaalde sociale bijdragen zijn afkomstig door de tewerkstelling van personen met een beperking die gebonden zijn aan een speciale stage voor de beroepsrevalidatie van gehandicapten, een opleidingscontract of beroepsmatige revalidatie, artikel 17, 2 en 3 de wet van 16 april 1963 inzake de sociale re-integratie van mensen met een handicap, en bovendien een werkloosheidsuitkering of uitkering van een ziekenfonds ontvangen. Bedrag [1..1] Totaal bedrag van betwisting OntbrekendeKwartalen [0..1] Lijst van kwartalen waarvoor een aangifte ontbreekt. Kwartaal [1..n] Jaar en kwartaal waarvoor er een aangifte ontbreekt. Gebruikershandleiding - GeefSocialeSchuld- 1. /// /// 22

12 Informatie Vlaanderen /// Contactpersoon SocialeSchuld/FinancieleSituatie Contactpersoon/ [0...n] Dit blok bevat de contactpersoon/dienst waarmee de eindgebruiker contact dient op te nemen in geval van vragen/verduidelijking/betwisting Naam/ [1..1] Achternamen [1..1] Achternamen/Achternaam [1..n] Achternaam van de persoon Voornamen [1..1] Voornamen/Voornaam [1..n] Voornaam van de persoon Contact/ [1..1] Functioneel blok dat de communicatie gegevens bevat Telefoonnummer [0..1] Telefoonnummer van de contactpersoon GSM [0..1] Gsmnummer Faxnummer [0..1] Faxnummer [0..1] adres NummerBureau [0..1] Bureau nummer 12 /// /// Gebruikershandleiding - GeefSocialeSchuldFout! Bladwijzer niet gedefinieerd. - 1.

13 /// Informatie Vlaanderen Werkgever (1/2) Gebruikershandleiding - GeefSocialeSchuld- 1. /// /// 22

14 Informatie Vlaanderen /// SocialeSchuld/FinancieleSituatie/Werkgever Ondernemingsnummer [1..1] KBO-nummer van de werkgever RSZNummer [0..1] RSZ registratienummer van de werkgever Naam [0..1] De naam van de werkgever JuridischArrondissement [0..1] Juridisch Arrondissement Rechtsvorm/ [0..1] Geeft de Juridische vorm / rechtsvorm van de werkgever weer Code [0..1] Code die de juridische vorm weergeeft Omschrijving [1..1] Omschrijving van de code die de juridische vorm weergeeft Tewerkstelling Bevat gegevens rond de tewerkstellingscijfers, in code en omschrijving Code [1..1] Code die de tewerkstellingscijfers weergeeft, mogelijke waarden: [0..1] Beschrijving van de code 1 = 1 t.e.m. 4 werknemers 2 = 5 t.e.m.9 3 = 10 t.e.m = 20 t.e.m = 50 t.e.m = 100 t.e.m = 200 t.e.m = 500 t.e.m = 1000 en meer Activiteiten [0..1] Bevat een lijst met activiteiten Activiteit [1..n] Een lijst met activiteiten, bevat een code en omschrijving Code [1 1] Code die de activiteit weergeeft Omschrijving [0..1] Omschrijving van de code die de activiteit weergeeft NaamVertegenwoordiger [0..1] Naam van de vertegenwoordiger 14 /// /// Gebruikershandleiding - GeefSocialeSchuldFout! Bladwijzer niet gedefinieerd. - 1.

15 /// Informatie Vlaanderen PeriodeActiviteit/ [0..1] Informatie betreffende de activiteitsperiode van de werkgever DatumAansluiting [0..1] Datum van aansluiting KwartaalVerwachteEersteAangifte [0..1] Kwartaal waarvoor een eerste aangifte wordt verwacht in het kader van de datum van de (her-) aansluiting. VervaldatumIndienenEersteAangifte [0..1] Datum waarop de werkgever zijn eerste aangifte moet indienen Einde/ [0..1] Gegevens rond het einde van de activiteit van de werkgever Datum [0..1] Datum van einde activiteit van de werkgever Kwartaal [0..1] Kwartaal van einde activiteit van de werkgever Gebruikershandleiding - GeefSocialeSchuld- 1. /// /// 22

16 Informatie Vlaanderen /// Werkgever (2/2) SocialeSchuld/FinancieleSituatie/Werkgever Adres/ Adresgegevens van de werkgever Straat/Code [00] Wordt niet ingevuld in deze dienst Straat/Naam [0..1] Straatnaam van de werkgever Huisnummer [0..1] Huisnummer van de werkgever Busnummer [0..1] Busnummer van de werkgever Gemeente/NISCode [00] Wordt niet ingevuld in deze dienst Gemeente/Postcode [0..1] Postcode van de gemeente van de werkgever Gemeente/Naam [1..1] Naam van de gemeente van de werkgever Land/NISCode [0...1] NISCode van het land van de werkgever 16 /// /// Gebruikershandleiding - GeefSocialeSchuldFout! Bladwijzer niet gedefinieerd. - 1.

17 /// Informatie Vlaanderen Land/ISOCode [0 1] ISOCode van het land van de werkgever Land/Naam [0...1] Naam van het land van de werkgever Voorbeeld Vraag <Inhoud> <Criteria> <Ondernemingsnummer> </Ondernemingsnummer> <Aanvrager> <Ondernemingsnummer> </Ondernemingsnummer> <Vestigingsnummer> </Vestigingsnummer> </Aanvrager> </Criteria> </Inhoud> Antwoord <Antwoorden> <Antwoord> <Inhoud> <Ontvangstbevestiging Beschrijving="Correct Ontvangen">1</Ontvangstbevestiging> </Inhoud> </Antwoord> </Antwoorden> 3.4 UITZONDERINGEN Functionele fouten Code Niveau Zwaarte Zwaarte - Diagnose FOUT Kan antwoord van de bron niet interpreteren FOUT Ongekende foutcode van de bron, contacteer VIP FOUT Er heeft zich een interne fout voorgedaan FOUT Dienst is tijdelijk niet beschikbaar FOUT Te veel ondernemingen in request FOUT Inhoudelijke fout bij de bron, contacteer VIP FOUT Fouten gevonden voor één of meerdere ondernemingen FOUT Ondernemingsnummer in de vraag heeft een ongeldige structuur FOUT Fout bij ophalen gegevens bij leverancier FOUT Geen gegevens gevonden voor de vraag Gebruikershandleiding - GeefSocialeSchuld- 1. /// /// 22

18 Informatie Vlaanderen /// Runtime gerelateerde fouten Identificatie Niveai Zwaarte Omschrijving FOUT Broncode niet aanwezig voor opgegeven Magda code in de vraag, contacteer VIP WAARSCHUWING Magda code niet aanwezig voor teruggekomen broncode, contacteer VIP WAARSCHUWING Magda beschrijving voor code niet aanwezig, contacteer VIP 3.5 CODETABEL AfbetalingsPlanGevolgd Code Beschrijving 0 Afbetalingsplan niet gevolgd 1 Afbetalingsplan gevolgd TypeBetwisting Code Beschrijving 1 De achterstallige betalingen hebben uitsluitend betrekking op een juridisch geschil over lidmaatschap van een specifiek paritair comité, er wordt gewacht op een uitspraak van de rechtbank. 2 De automatische rechtzettingen op basis van een verklaring van de werkgever werden vastgelegd door de Rijksdienst Sociale Zekerheid. Deze rechtzettingen zijn de basis voor een geschil dat voorgelegd is aan de rechtbank. 3 De achterstallige betalingen vermeldt in het document zijn het gevolg van de weigering van verhoogde Maribel-vermindering door Sociale Zekerheid. Dit omdat de werkgever niet voldeed aan bepaalde formele vereisten voor het bewijs van recht op vermindering. 4 De niet betaalde sociale bijdragen zijn afkomstig door de tewerkstelling van personen met een beperking die gebonden zijn aan een speciale stage voor de beroepsrevalidatie van gehandicapten, een opleidingscontract of beroepsmatige revalidatie, artikel 17, 2 en 3 de wet van 16 april 1963 inzake de sociale re-integratie van personen met een handicap, en bovendien een werkloosheidsuitkering of uitkering van een ziekenfonds ontvangen. 18 /// /// Gebruikershandleiding - GeefSocialeSchuldFout! Bladwijzer niet gedefinieerd. - 1.

19 /// Informatie Vlaanderen Tewerkstelling Code Tewerkstelling Beschrijving 1 1 t.e.m. 4 werknemers 2 5 t.e.m.9 werknemers 3 10 t.e.m. 19 werknemers 4 20 t.e.m. 49 werknemers 5 50 t.e.m. 99 werknemers t.e.m. 199 werknemers t.e.m. 499 werknemers t.e.m. 999 werknemers en meer werknemers Gebruikershandleiding - GeefSocialeSchuld- 1. /// /// 22

20 Informatie Vlaanderen /// 4 WERKING 4.1 FAQ Semi-online Op dit moment is het niet mogelijk een online bevraging uit te voeren om de sociale schuld van een onderneming te verkrijgen. Het antwoord op de gestelde vraag wordt via deze stroom ontvangen. 20 /// /// Gebruikershandleiding - GeefSocialeSchuldFout! Bladwijzer niet gedefinieerd. - 1.

21 /// Informatie Vlaanderen 5 TESTGEGEVENS 5.1 TESTGEGEVENS Voor deze dienst zijn er bij MAGDA geen testgegevens beschikbaar. Hiervoor wordt verwezen naar KSZ. Gebruikershandleiding - GeefSocialeSchuld- 1. /// /// 22

22 Informatie Vlaanderen /// 6 ALGEMENE MAGDA DOCUMENTATIE Onderwerp Logging Generieke foutcodes Magda uitzonderingen Authenticatie & autorisatie Prefixen voor batch gebruik Verwante diensten Website Magda platform /// /// Gebruikershandleiding - GeefSocialeSchuldFout! Bladwijzer niet gedefinieerd. - 1.