Apprenez à récupérer et interpréter les personnes liées à partir des données d’entreprise via l’API, notamment comment déterminer les actionnaires et les représentants agréés les plus récents.
Le champ « Personnes liées » dans la réponse API donne des informations sur les personnes associées à une entreprise. Ces données permettent d’identifier les données clés telles que les représentants agréés, les parties prenantes et les responsables.
Comprendre les « personnes liées » dans la réponse API
Lors de la recherche des données d’entreprise, le champ « Personnes liées » répertorie les personnes liées à l’entité. Chaque entrée de personne contient des attributs clés dont :
- Rôles : définit la fonction de la personne (par ex. directeur, actionnaire, représentant agréé).
- Date : indique le moment où le rôle devient effectif.
- Rétrogradation : indique si le rôle n’est plus actif (si « rétrogradation = vrai »).
Pour déterminer les personnes les plus pertinentes, triez les entrées par champ de date de rôle dans l’ordre décroissant et filtrez les éléments par type de rôle souhaité.
Comment rechercher l’actionnaire le plus récent
Pour identifier les actionnaires les plus récents, reportez-vous aux champs Personnes liées et Entreprises liées de l’objet d’entreprise. Chaque entité liée a au moins un rôle associé (figurant dans l’éventail des rôles). Le champ Date dans chaque rôle indique le moment où le rôle devient effectif.
Pour rechercher les actionnaires les plus récents :
- Trier les personnes liées et les entreprises liées par champ de Date dans leurs rôles.
- Effectuer un tri par type de rôle Actionnaire.
- Vérifier que la propriété dir a la valeur Source, ce qui signifie que l’entité identifiée est un actionnaire de l’entreprise demandée (et non le contraire).
Identification de personnes inactives
Pour déterminer si une personne est toujours activement associée à une entreprise, la propriété Rétrogradation dans
l’éventail des rôles doit être cochée :
- Si le dernier rôle enregistré d’une personne indique rétrogradation = vrai, cela signifie qu’elle a été retirée de ce rôle et ne doit plus être considérée comme un représentant actif
- Le tri des rôles par date (croissant) vous permet de rechercher le statut le plus récent d’une personne.
Cette méthode garantit que seules les personnes agréées autorisées sont prises en compte
Gestion de la précision des données et des mises à jour
La précision des données liées à l’entreprise dépend de divers facteurs :
- Mises à jour régulières de données : l’API met continuellement à jour sa base de données pour reprendre les éléments les plus récents de l’entreprise.
- Variabilité de source : des différences dans les formats de publication et les structures de registre public peuvent parfois introduire des divergences qui sont ensuite progressivement affinées par des mises à jour d’algorithmes et examens manuels.