MGBI bietet umfassende APIs zum Abruf von Daten aus öffentlichen Registern und Verzeichnissen, darunter aus dem Zentralregister der wirtschaftlichen Eigentümer (CRBR).
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 CRBR-Unternehmenssuche, die wir im Rahmen des Produkts
zur Verfügung stellen 👉 Zentrales Register der wirtschaftlichen Eigentümer API (CRBR API) – Unternehmenssuche
Im Folgenden beschreiben wir, wie du über die API eine Liste der wirtschaftlichen Eigentümer eines Unternehmens aus dem CRBR anhand dessen Steueridentifikationsnummer abrufen kannst.
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 Zentralregisters der wirtschaftlichen Eigentümer (CRBR-API) – Suchmaschine für Rechtsträger
Schritt 2: Rufe den Endpunkt „Create Refresh“ auf
Die in der CRBR-Unternehmenssuche verfügbaren Daten stellen wir in der MGBI-API im Datenmodell mit der Kennung „pl-crbr-wp-record“ bereit.
Dieses Modell wird auf Anfrage synchronisiert, was bedeutet, dass wir in unseren Beständen keine vollständige Kopie der im Quellregister verfügbaren Daten dafür haben.
Um aktuelle Daten zu einem bestimmten Schuldner aus dem Modell abzurufen, musst du zunächst über den Endpunkt „Create Refresh“ einen Abrufauftrag bei der CRBR erstellen.
👉 Dokumentation zum Endpunkt „Create Refresh“
Beispiel für den Aufruf des Endpunkts „Create Refresh“ mit der Steuernummer:
POST /v1/refresh HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]
{
"query: {
"model": "pl-crbr-wp-record",
"identifiers.pl_nip": [numer NIP]
}
}
Bei korrekter Aufrufung des Endpunkts „Create Refresh“ wird als Antwort ein Dictionary zurückgegeben, das im Feld „id“ die Auftrags-ID enthält.
Schritt 3: Rufe den Endpunkt „Get Refresh“ auf
Aufträge zum Abrufen von Daten aus dem Quellregister dauern in der Regel einige bis zu mehreren Sekunden ab dem Zeitpunkt ihrer Erstellung durch den Endpunkt „Create Refresh“.
Um den aktuellen Status des Auftrags zu überprüfen, rufe den Endpunkt „Get Refresh“ auf und gib in der URL die im vorherigen Schritt erhaltene Auftrags-ID an.
👉 Dokumentation zum Endpunkt „Get Refresh“
Beispiel für den Aufruf des Endpunkts „Get Refresh“ mit der Auftrags-ID:
GET /v1/refresh/[Auftrags-ID] HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]
Wenn das Statusfeld im zurückgegebenen Wörterbuch den Wert „pending“ annimmt, wird der Auftrag noch ausgeführt, und der Endpunkt „Get Refresh“ sollte in einigen Sekunden erneut aufgerufen werden.
Wenn das Statusfeld den Wert „success“ annimmt, bedeutet dies, dass der Auftrag ausgeführt wurde und die Daten zum angegebenen Schuldner bereits aus dem Quellregister abgerufen wurden.
Schritt 4: Rufe den Endpunkt „Get Records“ auf
Die API für das Modell „pl-crbr-wp-record“ stellt den Endpunkt „Get Records“ bereit, der Datensätze mit dem vollständigen Antworttext aus der CRBR-Schuldnersuche für den angegebenen Schuldner zurückgibt.
👉 Dokumentation zum Endpunkt „Get Records“ für das Modell „pl-crbr-wp-record“
Um die aus dem Quellregister abgerufenen Daten in einem zuvor erstellten Auftrag abzurufen, rufen Sie den Endpunkt „Get Records “ auf und übergeben Sie dabei die Auftrags-ID im Parameter „refresh_id“.
Beispiel für den Aufruf des Endpunkts „Get Records“ mit Auftrags-ID:
GET /v1/models/pl-crbr-wp-record/records?refresh_id=[Auftrags-ID] HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]
Schritt 5: Entnehmen Sie den Antworten die Liste der wirtschaftlichen Eigentümer
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],
"version": [informacje o wersji rekordu],
"content": [treść odpowiedzi z wyszukiwarki],
"meta": [metadane rekordu]
}
]
}
Die Liste der wirtschaftlichen Eigentümer des Unternehmens ist im Feld „content.raw_result.listaBeneficjentow“ verfügbar.
Jedes Element der Liste enthält Angaben zu einem einzelnen Begünstigten, wie beispielsweise Vor- und Nachname, Staatsangehörigkeit sowie Informationen über Beteiligungen oder sonstige Ansprüche.
Beispiel für den Inhalt des Elements:
{
"pesel": [numer PESEL],
"dataUrodzenia": [data urodzenia],
"imiePierwsze": [pierwsze imię],
"imieDrugieINastepne": [drugie imię],
"nazwisko": [nazwisko],
"obywatelstwo": [kraje obywatelstwa],
"panstwoZamieszkania": [państwo zamieszkania],
"nazwaBeneficjentaGrupowego": [nazwa beneficjenta grupowego],
"informacjeOUprawnieniachTrust": [informacje o uprawnieniach w truście],
"informacjeOUdzialeLubUprawnieniach": [informacje o udziale lub innych uprawnieniach],
"idTech": [wewnętrzny identyfikator beneficjenta]
}
Weitere Informationen:
👉 Datenstruktur im Modell „pl-crbr-wp-record“
👉 Dokumentation der Endpunkte für das Modell „pl-crbr-wp-record“
