Sequoia

SEQUOIA
WEBSERVICE
COMPANYINFORMATION
CompanyInformation.docx
Niets uit deze uitgave mag worden verveelvoudigd, openbaar gemaakt, overgeschreven, opgeslagen in een automatisch gegevensbestand, of vertaald in enige
menselijke of computertaal, in enige vorm of op enige wijze, hetzij elektronisch, mechanisch, magnetisch, optisch, chemisch, met de hand of op enige andere wijze,
zonder uitdrukkelijke schriftelijke toestemming van RSVZ.
Inhoudstafel
1
BESCHRIJVING WEBSERVICE COMPANYINFORMATION ................................................................................. 3
1.1
1.2
2
FLUXEN .......................................................................................................................................................... 5
2.1
3
IDENTIFICATIE ...................................................................................................................................................3
BESCHRIJVING ..................................................................................................................................................3
COMPANYINFORMATION ....................................................................................................................................5
WSDL ............................................................................................................................................................. 6
3.1
OPERATIES VOORZIEN DOOR RSVZ, GEBRUIKT DOOR HET SVF (NISSECOMPANYINFORMATIONSERVICE) ............................6
3.1.1 NisseCompanyInformationService::GetCompanyInformation .................................................................6
1 / 14
Document1
Document Informatie
Project:
Sequoia
Auteur:
Karlien Vyvey
Documentnaam:
CompanyInformation_V0.3.docx
Documentdatum:
10/12/2013
Versiebeheer
versie
Datum
Auteur
Beschrijving
V0.1
8/11/2013
Karlien Vyvey
Draft versie V0.1; de WSDL informatie wordt aangevuld in versie
V0.2
V0.2
29/11/2013 Karlien Vyvey
Draft versie V0.2
V0.3
10/12/2013 Karlien Vyvey
Draft V0.3 : KBO informatie aangevuld
17/02/2014
Contactdata: aanpassing schema contract : voor buitenlandse
vennootschappen zowel adres maatschappelijke zetel als adres
bijhuis in België
18/03/2014
Voorbeeld JuridicalFormHistory
24/03/2014
Veld datum rechtspersoonlijkheid toegevoegd
04/04/2014
Adressen worden meegegeven per taal adres – voorbeelden
toegevoegd
15/04/2014
Voorbeeld adres aangepast (structuur xsd) + voorbeeld bijdrages
toegevoegd
Referenties
Ref
Beschrijving
REF.001
B2B integration guidelines V0.1
REF.002
WSDL V0.1
2 / 14
Document1
1 Beschrijving webservice CompanyInformation
1.1
Identificatie
Naam
NisseCompanyInformationService
Versie
0.1
Namespace http://www.rsvz-inasti.fgov.be/schemas/WS/Sequoia/Company/Information/V1
http://www.rsvzinasti.fgov.be/schemas/WS/Sequioa/Company/Information/V1/NisseCompanyInfor
mationService/schema
1.2
Beschrijving
Deze service wordt gebruikt door een Sociaal verzekeringsfonds (SVF) om informatie over een
vennootschap op te vragen.
Het SVF neemt het intitiatief om informatie op te vragen aan het RSVZ van zodra aangesloten (in
principe direct na de beslissing SifAffilitateCompany::AcceptAffiliation) of op elk ander gewenst
moment.
Typisch zal het SVF informatie via deze webservice opvragen in volgende gevallen :
 Na het ontvangen van de beslissing van het RSVZ dat de aanvraag aansluiting aanvaard is
(opvragen van de basis informatie zoals KBO gegevens naam, adres, rechtstoestand, …)

Na het ontvangen van een notificatie van een wijziging bij het RSVZ (wijzigingen afkomstig van
KBO, een aanvraag overkomst, annulatie overkomst, schrappingen loopbaan door RSVZ, een
fusie..)
De informatie die via deze webservice opgevraagd wordt, is deze ter vervanging van de VL-berichten
VL10,VL20/VL24, VL22,VL23, VL30&VL32, VL34, VL35, VL43, VL50
3 / 14
Document1
De patronen, naamgevingen en legendes zijn beschreven in het document [Ref.001] B2B integration
guidelines.
4 / 14
Document1
2 Fluxen
2.1
CompanyInformation
CompanyInformation
GetCompanyInformation
Het SVF vraag informatie aan het RSVZ over een
vennootschap.
Het type van de informatie kan via een parameter
meegegeven worden.
Het SVF heeft de autorisatie om via B2B enkel
informatie op te vragen over de vennootschappen die
bij hen zijn aangesloten op het moment van de
vraagstelling, behalve KBO gegevens.
Op basis van het ondernemingsnummer en het type
informatie geeft het systeem de gegevens van de
onderneming terug aan het SVF die tot het opgegeven
type behoren.
5 / 14
Document1
3 WSDL
Voor de input en output parameters zijn de details van de gebruikte elementen te vinden in de WSDL
[Ref.002]. In onderstaande schema’s staat in de meest rechtse kolom aangegeven welk element gebruikt
is.
3.1
Operaties voorzien door RSVZ, gebruikt door het SVF
(NisseCompanyInformationService)
3.1.1
NisseCompanyInformationService::GetCompanyInformation
Doel
SVF stuurt een vraag om informatie over een vennootschap te krijgen
Type
Request-Reply
Input Parameters
Cf. documentatie datacontracten
Output Parameters
6 / 14
Document1
-
Ondernemingsnummer
-
Aanduiding welk type informatie gewenst is
Cf. documentatie datacontracten
Indien het SVF geen toegang heeft tot bepaalde informatie dan zullen
deze gegevens leeg blijven (bijv. bijdrages of gegevens aansluiting
opvragen voor een onderneming die niet is aangesloten bij het SVF) , de
KBO informatie is publiek en kan steeds opgevraagd worden
Errors

ServiceFault
-
-
-
Het KBO nummer is niet gekend
De KBO gegevens zijn publieke gegevens en zijn niet onderhevig aan extra security validaties;
bijdrages en aansluitingsgegevens daarentegen zijn enkel beschikbaar voor het fonds waar de
onderneming aangesloten is; De KBO gegevens kunnen door elk fonds op elk moment
opgevraagd worden ook vóór de aansluiting.
Indien men de informatie opvraagt van een ondernemingsnummer dat ondertussen
gefusioneerd werd: IsMerged= TRUE en de andere informatie wordt niet ingevuld.
IncorporationDate = datum rechtspersoonlijkheid
Dit veld is als volgt bepaald:
o voor Belgische ondernemingen : de datum van rechtstoestand= 000 (normaal)
7 / 14
Document1
o
-
voor buitenlandse ondernemingen : de datum waarop de rechtstoestand 000 in
KBO geregistreerd werd.
JuridicalFormHistory :
o Bevat minimaal de actuele toestand
o Indien een historiek gevraagd wordt dan bevat deze de historiek van de
rechtsvormen/rechtstoestanden
Voorbeeld1: actuele rechtstoestand en rechtsvorm hebben een verschillende startdatum:
Voorbeeld2: actuele rechtstoestand en rechtsvorm hebben dezelfde startdatum
8 / 14
Document1
Het veld JuridicalSituationStartDate zal hernoemd worden naar StartDate : kan zowel de
startdate van rechtsvorm als van rechtstoestand zijn indien deze een verschillende datum
hebben.
-
Indien Functies (KBO info) opgevraagd worden dan is deze informatie beschikbaar in Functions
-
Indien Toelatingen (KBO info) opgevraagd worden dan is deze informatie beschikbaar in
Permissions
-
Indien bijdrages opgevraagd worden (bijvoorbeeld na fusie van 2 ondernemingsnummers) dan is
deze informatie beschikbaar in YearlyContributions; de bijdrages zijn niet pas beschikbaar nadat
de gegevens van de Nationale Bank verwerkt zijn (bijvoorbeeld net na de aansluiting zijn deze
nog niet beschikbaar).
-
Indien RelatiesOndernemingen (Kbo info) opgevraagd worden dan is deze informatie
beschikbaar in Relationships
-
AffiliationStatus:
Duidt aan of de onderneming momenteel is aangesloten of niet. Deze informatie is beschikbaar
voor alle fondsen.
-
-
AffiliationHistory
9 / 14
Document1
o
o
-
Dit bevat een historiek van de aansluitingen en aanvragen en beslissingen
Historiek is enkel toegankelijk voor het actieve fonds waar de onderneming momenteel
is aangesloten.
ContactData : de adressen voor tweetalige gemeentes worden in 2 talen meegegeven
-
Voorbeeld : 2-talig adres
10 / 14
Document1
Buitenlands adres:
Een buitenlands adres kan in om het even welke taal voorkomen en de taal van buitenlandse adressen is
niet opgegeven in het KBO adres, enkel de taal van Belgische adressen; voor buitenlandse adressen zal de
taal=”Andere” ingevuld worden maar de SystemValue biedt de mogelijkheid om dit later in te vullen
indien we de taal kennen
11 / 14
Document1
-
YearlyContributions
- Nadat de jaarlijkse batchfile verstuurd werd naar het fonds zal de bijdrage voor dat jaar ook
beschikbaar zijn in GetCompanyInformation - YearlyContributions
- Voor een aansluiting na de batchfile zal bij de aansluiting het bedrag bijdrage bepaald
worden door het RSVZ en een Notification naar het fonds gestuurd worden. De bijdrage zal
dan beschikbaar zijn in GetCompanyInformation -YearlyContributions
- Indien het fonds een wijziging doorstuurt via UpdateContribution , dan zal bij het opvragen
van GetCompanyInformation de bijdrage het aangepaste bedrag bevatten (ook voor een
vrijstelling zal dit bedrag in GetCompanyInformation op 0 gezet worden voor dat jaar in
YearlyContributions
- Indien er nog geen bijdrage bekend is voor het jaar (vóór de jaarlijkse batch) dan zal dit jaar
nog niet meegegeven worden in de GetCompanyInformation in YearlyContributions (ook
niet met null of 0 –waarde)
Voorbeeld:




Voor 2010 heeft het fonds een UpdateContribution naar het RSVZ gestuurd
Voor 2011 was er geen update
Voor 2012 was er een update met reden = vrijstelling
Voor 2013 is de batch nog niet verwerkt voor het versturen van de batchfile met
de bijdrages naar de fondsen (bijdrage werd nog niet bepaald door het RSVZ);
dit jaar is niet aanwezig in YearlyContributions
Op het scherm SEQ.NET is de volledige historiek zichtbaar als volgt:
12 / 14
Document1
13 / 14
Document1