Aperçu
Service qui permet aux entreprises de consulter et de gérer leurs contacts et coordonnées associées.
Services métiers des institutions
Sous-domaineCycle de vie d'une entreprise
TypologieService & API
Service ownerONSS
2019
Réutilisation5
Effort d'intégrationQuelle en est l'utilité ?
En tant qu'institution de la sécurité sociale, vous pouvez être amené à contacter des entreprises dans le cadre d'une campagne de communication ciblée. Pour ce faire, vous pouvez appeler le service REST contactData, afin d'obtenir les coordonnées existantes du représentant de chaque entreprise.
Vous pouvez également stocker des informations de contact supplémentaires - spécifiques au contexte de votre demande - pour chaque entreprise, et choisir qui y a accès.
Description fonctionnelle
Un contact représente un ensemble d’informations cohérentes, comparable à une carte de visite reprenant plusieurs informations (nom, prénom, langue préférentielle, téléphones, fax, emails et sites web) permettant de contacter une personne ou une entreprise dans le cadre d’une communication.
Le service REST contactData offre les fonctionnalités suivantes :
- Rechercher des contacts liés à une ou plusieurs entreprises, basé sur le numéro d'entreprise
- Rechercher des contacts dans des sources de données externes comme la Banque Carrefour des Entreprises et le Répertoire des employeurs ONSS
- Consulter le détail d’un contact
- Créer un contact lié à une entreprise
- Modifier les données d'un contact
- Supprimer un contact
- Consulter l’historique des modifications apportées à un ou plusieurs contacts d’une entreprise
Public cible
Le service est disponible pour des applications et services utilisant et exploitant des données de contact d’entreprises.
Ce service est utilisé à ce jour par les agents et les inspecteurs de l’ONSS, mais une instance peut être déployée dans n'importe quelle autre institution qui voudrait gérer ses données de contact.
Conditions d'intégration
Les appels sont sécurisés par OAuth.
Différents scopes OAuth sont attribués afin d’isoler les fonctionnalités de consultation et les fonctionnalités d’édition.
Une application souhaitant utiliser le service contactData devra au préalable prendre contact avec l’équipe du projet afin de vérifier que leurs besoins soient bien couverts par le service. Le propriétaire de l’application fournira aussi une estimation des volumes d’appels prévus. Le propriétaire de l’application devra valider les aspects GDPR avec les DPO concernés.
Documentation
Contact
Contact : ReuseOperational@smals.be
