Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Onderneming.GeefPCenTW-02.00

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 webservice GeefPCenTW stelt de gebruiker in staat om op basis van een ondernemingsnummer de personeelsklasse van tewerkstelling, opgesplitst naar Paritair Comité volgens RSZ, van het laatst gekende kwartaal op te vragen. 

Situering

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

Verwante diensten

  • PubliceerPCenTW

Gegevensbronnen

De gegevens zijn deze uit de dienst statistiek van de Rijksdienst Sociale Zekerheid (RSZ). De RSZ int en beheert de sociale werkgevers- en werknemersbijdragen waarmee hij de verschillende takken van de sociale zekerheid financiert. Hij verzamelt en verspreidt de administratieve basisgegevens ten behoeve van de andere sociale zekerheidsinstellingen. De RSZ-personeelsklasse en paritair comité komen uit de aangifte van de ondernemingen/werkgevers aan de RSZ. De verwerking bij RSZ duurt 6 tot 9 maanden.

MAGDA onderhoudt –om verschillende redenen- een eigen kopie van de RSZ gegevens. Deze kopie vormt de kern van onze VKBO-dienstverlening (Verrijkte Kruispuntbank voor Ondernemingen). De kopie wordt periodiek geactualiseerd. De RSZ gegevens worden aangeleverd op kwartaalbasis, ongeveer 6 maanden na het einde van het betreffende kwartaal.

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:

  • Toelating tot de webservice GeefPCenTW 02.00

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

GPCTWD

Voorbeeld

GPCTWD_20131103115553530.XML

Functionaliteiten

Vraag

De afnemer dient te beschikken over het ondernemingsnummer van de onderneming om deze dienst te bevragen.

Antwoord

De output bestaat uit volgende indicatoren:

  • Ondernemingsnummer

  • De periode waarop de gegevens betrekking hebben

  • Authentieke bron en omschrijving

  • Kwartaalgegevens ( jaar, kwartaalcode, begin-einddatum)

  • Lijst van Paritaire Comité ( code en beschrijving)

  • De RSZ-personeelsklasse

Werking

Aandachtspunten

De verschillen met de 01.01 versie van de dienst zijn zeer beperkt waardoor een overgang naar deze 2.0 versie geen al te zware effort mag kosten.

De interface is in vergelijking met de 01.01-versie op enkele punten gewijzigd maar is voor minstens 75% identiek.

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, dit blijft beperkt toch een controle van het ondernemingsnummer

Is er een actueel paritair comité (meest recent gekende), dan wordt dit opgenomen in het antwoord. Zijn er meerdere gekend, dan worden deze allemaal opgenomen in het antwoord.

Is er geen paritair comité aanwezig, dan verkrijgt men de melding dat er geen gegevens gevonden zijn.

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. Deze webservice is niet afhankelijk van externe bronnen zoals Rijksregister, KSZ, … .

RSZ-gegevens worden elk kwartaal bijgewerkt. 

Bij geplande onbeschikbaarheden worden de afnemers op de hoogte gebracht.

Logging

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

Op deze pagina


Binnen deze handleiding


Omgevingsinformatie

Domein

Onderneming

Classificatie

Geen persoonsgegevens


Verwante diensten


Met vragen kunt u steeds terecht bij de MAGDA Service Desk.


Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren

De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid

uitgegeven door Digitaal Vlaanderen