Overzicht
Service waarmee bedrijven hun contacten en bijbehorende contactgegevens kunnen raadplegen en beheren.
Kerndiensten van de instellingen
SubdomeinLevenscyclus van een onderneming
TypologieService & API
Service ownerRSZ
2019
Hergebruik5
Integration effortWaarvoor dient het?
Als instelling van de sociale zekerheid moet je mogelijk contact opnemen met bedrijven in het kader van een gerichte communicatiecampagne. Hiertoe kan je de contactData REST-service oproepen, zo dat je de bestaande contactgegevens van de representant van elk bedrijf verkrijgt.
Verder kan je ook nog andere contactgegevens - specifiek voor de context van je aanvraag - van elk bedrijf opslaan, en kiezen wie er toegang toe heeft.
Functionele beschrijving
Een contact stelt een geheel van consistente informatie voor, vergelijkbaar met een visitekaartje waarop allerhande gegevens staan zoals voornaam, achternaam, voorkeurstaal, telefoonnummers, faxen, e-mails en websites waardoor een persoon of een bedrijf gecontacteerd kan worden.
De REST-service contactData biedt volgende functionaliteiten:
- Zoeken van contacten die gelinkt zijn aan een of meerdere bedrijven, op basis van een ondernemingsnummer
- Zoeken van contacten die reeds bestaan in externe gegevensbronnen zoals de Kruispuntbank van Ondernemingen of de RSZ werkgevers repertorium
- Raadplegen van een detail van een contact
- Aanmaken van een contact dat gelinkt is aan een bedrijf
- Wijzigen van een detail van een contact
- Verwijderen van een contact
- Consulteren van de historiek van de aangebrachte wijzigingen in één of meerdere contacten van een bedrijf
Doelpubliek
De service is beschikbaar voor applicaties en services die zakelijke contactgegevens gebruiken en exploiteren.
Momenteel wordt de service door agenten en inspecteurs van de RSZ gebruikt, maar een instantie kan in elke andere instelling, die haar contactgegevens wil beheren, ingezet worden.
Integratievoorwaarden
De oproepen worden beveiligd door OAuth.
Verschillende OAuth-scopes worden toegepast om een onderscheid te maken tussen de functionaliteiten van het consulteren en deze van het bewerken.
Voor een toepassing die gebruik wil maken van de service contactData, zal men voorafgaandelijk contact opnemen met het projectteam om na te gaan of de service voldoet aan de gestelde vereisten. De eigenaar van de toepassing zal ook een schatting van de verwachte volumes doorgeven, alsook de GDPR-aspecten valideren met de betreffende DPO's.
Documentatie
Contact
Contact: ReuseOperational@smals.be