MGBI bietet eine umfassende API zum Abruf von Daten aus öffentlichen Registern und Verzeichnissen, darunter aus dem Nationalen Gerichtsregister (KRS). Eine Liste der in diesem Dienst verfügbaren Datenquellen findest du auf der Seite:
👉 Öffentliche Register API
Dieser Leitfaden bezieht sich auf die API für die Suchmaschine für Unternehmen im KRS, die wir im Rahmen des Produkts
zur Verfügung stellen 👉 API des Nationalen Gerichtsregisters (KRS API) – Suchmaschine für Unternehmen
Im Folgenden beschreiben wir, wie Sie über die API anhand der KRS-Nummer eine aktuelle Liste der Verbindungen eines bestimmten KRS-Eintrags zu anderen Unternehmen und Personen abrufen können.
Schritt 1: Beziehen Sie einen Autorisierungsschlüssel über die API
Um den Autorisierungsschlüssel zu erhalten, der für den Aufruf der in der MGBI-API verfügbaren Endpunkte erforderlich ist, kontaktieren Sie uns bitte über das Kontaktformular auf der Produktseite:
👉 API des Nationalen Gerichtsregisters (KRS-API) – Suchmaschine für Rechtsträger
Schritt 2: Rufe den Endpunkt „Get Records“ auf
Die in der KRS-Unternehmenssuche verfügbaren Daten stellen wir in der MGBI-API im Datenmodell mit der Kennung „pl-krs-wp-record“ bereit.
Die API stellt für dieses Modell den Endpunkt „Get Records“ zur Verfügung, der Datensätze mit dem Inhalt des aktuellen und vollständigen Auszugs aus dem KRS für Unternehmen zurückgibt, die die angegebenen Kriterien erfüllen.
👉 Dokumentation zum Endpunkt „Get Records“ für das Modell „pl-krs-wp-record“
Um Daten zu einem einzelnen Unternehmen aus dem KRS abzurufen, muss im Endpunkt „Get Records“ dessen Registrierungsnummer angegeben werden: KRS, NIP oder REGON.
Beispiel für den Aufruf des Endpunkts „Get Records“ mit einer KRS-Nummer:
{
"count": 1,
"pages": 1,
"results": [
{
"id": [identyfikator rekordu],
"identifiers": [identyfikatory podmiotu i powiązanych osób],
"content": [treść odpisu aktualnego i pełnego],
"files": [pliki odpisów w formacie PDF],
"relations": [relacje podmiotu z innymi podmiotami i osobami],
"meta": [metadane rekordu]
}
]
}
Schritt 3: Lies die Daten zu den Verknüpfungen aus der Antwort ab
Bei korrekter Aufrufung des Endpunkts „Get Records“ wird als Antwort eine Liste der Datensätze zurückgegeben, die den angegebenen Kriterien entsprechen.
Im obigen Beispiel sollte der Endpunkt eine Ergebnisliste mit einem Datensatz zurückgeben:
{
"count": 1,
"pages": 1,
"results": [
{
"id": [identyfikator rekordu],
"identifiers": [identyfikatory podmiotu i powiązanych osób],
"content": [treść odpisu aktualnego i pełnego],
"files": [pliki odpisów w formacie PDF],
"relations": [relacje podmiotu z innymi podmiotami i osobami],
"meta": [metadane rekordu]
}
]
}
Die aktuelle Liste der Verbindungen dieses Objekts zu anderen Objekten und Personen findest du im Feld „relations“.
Jeder Eintrag des in diesem Feld angezeigten Verzeichnisses enthält eine Liste von Verknüpfungen eines bestimmten Typs sowie Daten zu den verbundenen Einrichtungen und Personen und weitere Informationen.
Beispiel für den Inhalt des Verzeichnisses „relations“:
{
"dzial2_reprezentacja_sklad": [lista powiązań z członkami organów reprezentacji],
"dzial2_prokurenci": [lista powiązań z prokurentami],
"dzial2_organNadzoru_sklad": [lista powiązań z członkami organów nadzoru]
}
Die Datenstruktur in den Listenelementen entspricht der Datenstruktur in den Spalten des vollständigen Auszugs, der im Wörterbuch „content.full_excerpt.dane“ verfügbar ist.
Jedes Element der Verknüpfungsliste enthält zusätzlich folgende Felder:
- nrWpisuWprow – Nummer des Eintrags im KRS, der die Verknüpfung enthält,
- dataWpisuWprow – Datum der Eintragung in das KRS, mit der die Verknüpfung vorgenommen wurde.
Für historische Verknüpfungen stehen außerdem folgende Felder zur Verfügung:
- nrWpisuWykr – Nummer des Eintrags im KRS, mit dem die betreffende Verbindung gelöscht wird,
- dataWpisuWykr – Datum der Eintragung in das KRS, mit der die betreffende Verbindung gelöscht wurde.
Weitere Informationen:
👉 Datenstruktur im Modell „pl-krs-wp-record“
👉 Dokumentation der Endpunkte für das Modell „pl-krs-wp-record“
