Parties prenantes
€0.20 + TVA
Le service Stakeholder appartient à l'API Company et est conçu pour toutes les entreprises souhaitant accéder à des données certifiées et détaillées sur les Dirigeants, Associés, Administrateurs légaux et Employés d'une entreprise via une API.
Le service Stakeholders appartient à l'API Company et est conçu pour toutes les entreprises souhaitant accéder à des données certifiées et détaillées sur le représentant légal, les associés et, en général, sur tous les individus occupant un poste dans l'entreprise.
Pour chaque personne, des données telles que le nom, le prénom, le rôle, le début de l'activité, l'âge, le numéro fiscal, la date et le lieu de naissance sont disponibles.
En ce qui concerne les associés, il est également possible de connaître la part de propriété. L'ensemble des données est ensuite enrichi par des informations sur les employés, telles que le nombre, la tendance par rapport à l'année précédente, et le type de contrat.
Le service est actuellement disponible en mode synchrone et asynchrone.
En période de forte affluence, les sources de données officielles peuvent subir des ralentissements dans les temps de réponse. Par conséquent, si ce n'est pas absolument nécessaire, nous vous suggérons d'implémenter la méthode POST.
Cette méthode permet de définir une URL de rappel, éliminant ainsi la nécessité de vérifier l'état et vous offrant la possibilité de recevoir une notification proactive à la fin de la demande.
L'endpoint de référence est https://company.openapi.com/IT-stakeholders/{vatCode_or_taxCode}
EXEMPLE DE DEMANDE
POST /IT-stakeholders
Voici un exemple de demande où le paramètre de numéro de TVA a été utilisé : 12485671007
https://company.openapi.com/IT-stakeholders/12485671007Comme indiqué précédemment, il est également possible de définir un rappel via le payload :
{
"callback": {
"url": "https://your_domain.it/your_callback.php",
"method": "JSON",
"headers": {
"session_id": "oiwejdf89453urf945jfg"
}
}EXEMPLE DE RÉPONSE
POST /IT-stakeholders
La réponse comprendra l'ID de la demande et le statut
{
"callback": {
"data": {
"state": "PENDING",
"id": "66a8ed9b82cf2ae627012068"
},
"success": true,
"message": "",
"error": null
}VÉRIFIER L'ÉTAT DE LA DEMANDE
Il est possible de vérifier l'état de la demande à tout moment via le point de terminaison /IT-check_id/{id}. En cas de configuration d'un callback, le système notifiera directement lorsque la réponse sera disponible.
EXEMPLE DE DEMANDE
GET/IT-check_id/{id}
https://company.openapi.com//IT-check_id/66a8ed9b82cf2ae627012068EXEMPLE DE RÉPONSE
Si l'état de la demande est complété, c'est-à-dire qu'il est en done, la réponse comprendra toutes les données :
{
"data": {
"managers": [
{
"name": "LUCA",
"surname": "SCURIATTI",
"roles": [
{
"role": {
"code": "AUN",
"description": "Directeur général"
},
"roleStartDate": "2020-09-10T00:00:00"
}
],
"gender": {
"code": "M",
"description": "Homme"
},
"taxCode": "SCRLCU73R02H501H",
"birthDate": "1973-10-02T00:00:00",
"age": 49,
"birthTown": "ROMA (RM)",
"isLegalRepresentative": true
},
{
"companyName": "OPEN HOLDING SRL",
"roles": [
{
"role": {
"code": "SOU",
"description": "Propriétaire unique"
},
"roleStartDate": "2022-12-05T00:00:00"
}
],
"taxCode": "16935371001",
"isLegalRepresentative": false
},
{
"name": "SIMONE",
"surname": "DESANTIS",
"roles": [
{
"role": {
"code": "PP",
"description": "Représentant/agent spécial"
},
"roleStartDate": "2013-10-17T00:00:00"
}
],
"gender": {
"code": "M",
"description": "Homme"
},
"taxCode": "DSNSMN80M11L117F",
"birthDate": "1980-08-11T00:00:00",
"age": 42,
"birthTown": "TERNI (TR)",
"isLegalRepresentative": false
},
{
"name": "SHAUN",
"surname": "DE LUCIA",
"roles": [
{
"role": {
"code": "PP",
"description": "Représentant/agent spécial"
},
"roleStartDate": "2013-10-17T00:00:00"
}
],
"gender": {
"code": "M",
"description": "Homme"
},
"taxCode": "DLCSHN77S29Z114J",
"birthDate": "1977-11-29T00:00:00",
"age": 45,
"birthTown": "STOKE ON TRENT (E)",
"isLegalRepresentative": false
}
],
"shareholders": [
{
"shareholdersInformation": [
{
"taxCode": "16935371001",
"openapiNumber": "IT8A380807S0001",
"companyName": "OPEN HOLDING SRL",
"sinceDate": "2022-11-23T00:00:00",
"streetName": "VIALE FILIPPO TOMMASO MARINETTI 221"
}
],
"percentShare": 100
}
],
"companyDetails": {
"vatCode": "12485671007",
"taxCode": "12485671007",
"lastUpdateDate": "2023-03-08T11:25:08.0331456Z",
"cciaa": "RM",
"reaCode": "1378273",
"companyName": "OPENAPI SRL",
"officeType": {
"code": "SSL",
"description": "Siège administratif et siège social"
},
"openapiNumber": "IT93E20F0DS0001"
},
"address": {
"streetName": "VIALE FILIPPO TOMMASO MARINETTI, 221",
"zipCode": "00143",
"town": "ROMA",
"province": {
"code": "RM",
"description": "ROMA"
},
"region": {
"code": "12",
"description": "LAZIO"
},
"country": {
"code": "IT",
"description": "Italie"
}
},
"branches": {
"numberOfBranches": 1
"employees": {
"employeeRange": {
"code": "ER4",
"description": "11 - 20"
},
"employee": 15,
"employeeTrend": 7.14
},
"employeesStatistic": {
"permanentContract": 100,
"partialTimeContract": 20,
"fullTimeContract": 80,
"whiteCollar": 100
},
"corporateGroups": {
"belongsToGroup": true,
"groupName": "DE LUCIA - SCURIATTI",
"holdingCompanyName": "LUCA SCURIATTI",
"nationalParentCompany": {
"province": {
"code": "ND99",
"description": "N. A."
}
}
}
},
"success": true,
"message": "",
"error": null
}
Comme indiqué, Stakeholders est également disponible en mode synchrone. Le point de terminaison à utiliser est /IT-stakeholders/{vatCode_or_taxCode}, mais dans ce cas, la méthode sera GET. La réponse sera généralement renvoyée en quelques secondes.
En période de forte affluence, les sources de données officielles peuvent présenter des temps de réponse plus lents. En ces périodes de pointe ou de maintenance, nous avons prévu un délai d'attente de 30 secondes pour les demandes synchrones. Après ce délai, un ID unique est généré, permettant aux clients de demander des mises à jour sur l'état et d'obtenir la réponse lorsqu'elle est disponible via le point de terminaison GET company.openapi.com/IT-check_id.
Le service Stakeholders est utilisé par les entreprises qui souhaitent obtenir des informations détaillées sur toutes les personnes impliquées dans l'organisation de l'entreprise. Quelques exemples d'entreprises utilisant déjà le service Stakeholders sont les banques, les investisseurs et les capital-risqueurs, les concurrents, les partenaires commerciaux et les fournisseurs, les sociétés de conseil et de recherche de marché, ainsi que les entreprises de recrutement.
Avez-vous besoin d'aide ?
Vous n'avez pas trouvé la réponse que vous cherchiez?
Remplissez tous les détails, nous vous contacterons dès que possible!
