Wie können "relatedPersons" in API-Abfragen identifiziert werden?

Das Feld "relatedPersons" in der API-Antwort liefert Informationen zu Personen, die mit einem Unternehmen verbunden sind. Diese Daten helfen, wichtige Akteure wie vertretungsberechtigte Personen, Anteilseigner und Führungskräfte zu identifizieren.

Verständnis von "relatedPersons" in der API-Antwort

Bei der Abfrage von Unternehmensdaten listet das Feld "relatedPersons" die mit dem Unternehmen verbundenen Personen auf. Jeder Eintrag enthält wichtige Attribute, darunter:

• Rollen: Definiert die Funktion der Person (z. B. Geschäftsführer, Anteilseigner, vertretungsberechtigte Person).
• Datum: Zeigt an, wann die Rolle wirksam wurde.
• Demotion: Gibt an, ob die Rolle nicht mehr aktiv ist (demotion=true).

Um die relevantesten Personen zu identifizieren, sollten die Einträge nach dem Datum der Rolle in absteigender Reihenfolge sortiert und nach der gewünschten Rolle gefiltert werden.

Identifizierung der letzten Gesellschafter 

Um die aktuellsten Anteilseigner zu ermitteln, müssen die Felder relatedPersons und relatedCompanies des Unternehmensobjekts herangezogen werden. Jede verbundene Entität hat mindestens eine zugeordnete Rolle (zu finden im roles-Array). Das date-Feld innerhalb jeder Rolle gibt an, wann diese Rolle wirksam wurde.

Vorgehen zur Identifikation der jüngsten Gesellschafter:

1. Sortieren Sie relatedPersons und relatedCompanies nach dem date-Feld in den Rollen.
2. Filtern Sie nach dem Rollentyp Shareholder.
3. Stellen Sie sicher, dass die Eigenschaft dir den Wert Source hat. Dies bedeutet, dass die identifizierte Entität ein Anteilseigner des abgefragten Unternehmens ist (und nicht umgekehrt).

Identifikation inaktiver Personen

Um festzustellen, ob eine Person noch aktiv mit einem Unternehmen verbunden ist, sollte die Eigenschaft "demotion" im roles-Array überprüft werden:

• Falls die letzte erfasste Rolle einer Person demotion=true enthält, bedeutet dies, dass die Person aus dieser Rolle entfernt wurde und nicht mehr als aktive vertretungsberechtigte Person betrachtet werden sollte.
• Durch Sortierung der Rollen nach Datum (aufsteigend) kann der aktuellste Status einer Person ermittelt werden.

Diese Methode stellt sicher, dass nur aktuelle, autorisierte Personen berücksichtigt werden.

Datenaktualität und Genauigkeit sicherstellen

Die Genauigkeit der unternehmensbezogenen Daten hängt von verschiedenen Faktoren ab:

• Regelmäßige Datenaktualisierungen: Die API aktualisiert kontinuierlich ihre Datenbank, um die neuesten Unternehmensmeldungen widerzuspiegeln.
• Unterschiedliche Datenquellen: Abweichungen in Publikationsformaten und öffentlichen Registerstrukturen können gelegentlich zu Unstimmigkeiten führen, die durch manuelle Überprüfungen und Algorithmus-Optimierungen schrittweise korrigiert werden.