MGBI bietet eine umfassende API zum Abruf von Daten aus öffentlichen Registern und Verzeichnissen, darunter aus dem Nationalen Schuldnerregister (KRZ). Eine Liste der in diesem Dienst verfügbaren Datenquellen findest du auf der Website:
👉 Öffentliche Register API
Dieser Leitfaden bezieht sich auf die API für die KRZ-Unternehmenssuche, die wir im Rahmen des Produkts
zur Verfügung stellen 👉 API des Nationalen Schuldnerregisters (KRZ API) – Unternehmenssuche
Im Folgenden beschreiben wir, wie Sie über die API Informationen über eingestellte Vollstreckungsverfahren aus dem KRZ für einen bestimmten Schuldner anhand seiner Steuer- oder Sozialversicherungsnummer 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 Schuldnerregisters (KRZ-API) – Suchmaschine für Unternehmen
Schritt 2: Rufe den Endpunkt „Create Refresh“ auf
Die in der KRZ-Unternehmenssuche verfügbaren Daten stellen wir in der MGBI-API im Datenmodell mit der Kennung „pl-krz-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 KRZ 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-krz-wp-record",
"identifiers.pl_nip": [numer NIP]
}
}
Wenn Sie Informationen zu Verfahren gegen einen Schuldner benötigen, der eine natürliche Person ist, können Sie auch die PESEL-Nummer verwenden.
Beispiel für den Aufruf des Endpunkts „Create Refresh“ mit der PESEL-Nummer:
POST /v1/refresh HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]
{
"model": "pl-krz-wp-record",
"pl_pesel": [numer PESEL]
}
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-krz-wp-record“ stellt den Endpunkt „Get Records“ bereit, der Datensätze mit dem vollständigen Antworttext aus der KRZ-Schuldnersuche für den angegebenen Schuldner zurückgibt.
👉 Dokumentation zum Endpunkt „Get Records“ für das Modell „pl-krz-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-krz-wp-record/records?refresh_id=[Auftrags-ID] HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]
Schritt 5: Entnehmen Sie der Antwort die Liste der gegen den Schuldner eingestellten Vollstreckungsverfahren
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 dłużnika],
"content": [treść odpowiedzi z wyszukiwarki],
"meta": [metadane rekordu]
}
]
}
Gerichtsverfahren im Nationalen Schuldnerregister werden in sogenannten Akten zusammengefasst. Eine einzelne Akte kann Daten zu einem oder mehreren miteinander verbundenen Verfahren enthalten.
Je nach Rechtsform des Schuldners findest du die Liste der Akten im Feld:
- content.raw_result.wyszukaj-po-podmiocie.lista_uczestnikow.0.teczki – für Rechtsträger, die keine natürlichen Personen sind,
- content.raw_result.wyszukaj-po-of-jdg.lista_uczestnikow.0.teczki – für natürliche Personen, die ein Gewerbe betreiben,
- content.raw_result.wyszukaj-po-of.lista_uczestnikow.0.teczki – für natürliche Personen, die kein Gewerbe betreiben.
Um die vollständige Liste aller gegen den Schuldner geführten und im KRZ offengelegten, eingestellten Vollstreckungsverfahren einzusehen, muss jedes Element der Liste in jeder einzelnen Akte bearbeitet werden.
Beispiel für den Inhalt des Elements „Vorgehensweise“:
{
"aktualna-metryka": [dane dłużnika],
"dataRozpoczecia": [data rozpoczęcia postępowania],
"dataUtworzenia": [data utworzenia postępowania],
"dataZakonczenia": [data zakończenia postępowania],
"id": [identyfikator wewnętrzny postępowania],
"idZewnetrzny": [identyfikator zewnętrzny postępowania],
"rodzajPostepowania": [informacje o rodzaju postępowania],
"stanPostepowaniaRejestr": [aktualny stan postępowania],
"sygnaturaAkt": [sygnatura postępowania],
"szczegoly": [szczegółowe informacje o postępowaniu],
"szczegoly-UPE": [szczegółowe informacje o umorzonym postępowaniu egzekucyjnym]
}
Eingestellte Vollstreckungsverfahren lassen sich anhand des Inhalts des Verzeichnisses „RodzajPostępowania“ von anderen im KRZ aufgeführten Verfahrensarten unterscheiden.
Inhalt des Glossars „Verfahren“ für eingestellte Vollstreckungsverfahren:
{
"kod": "PE-upe",
"kodRodzajuEwidencji": "PE",
"tytul": "umorzone postępowanie egzekucyjne"
}
Detaillierte Informationen zum Verfahren, wie beispielsweise den Namen der Behörde, die den Vollstreckungstitel ausgestellt hat, das Datum der Aufhebung oder den nicht vollstreckten Betrag, findest du im Verzeichnis „szczegoly-UPE“.
Inhalt des Wörterbuchs „szegoly-UPE“ für eingestellte Vollstreckungsverfahren:
{
"danePodstawowePostepowania": {
"dataUjawnienia": [data ujawnienia postępowania w KRZ],
"dataUmorzenia": [data umorzenia postępowania],
"sumaNiewyegzekwowana": [niewyegzekwowana suma],
"sygnatura": [sygnatura postępowania],
"tytulWykonawczy": [tytuł wykonawczy]
},
"dluznik": {
"nip": [numer NIP dłużnika],
"krs": [numer KRS dłużnika],
"siedziba": [siedziba dłużnika],
"nazwa": [nazwa dłużnika]
"formaPrawna": [forma prawna dłużnika]
},
"organWydajace": {
"nazwaOrganu": [nazwa organu wydającego tytuł wykonawczy]
}
}
Weitere Informationen:
👉 Datenstruktur im Modell „pl-krz-wp-record“
👉 Dokumentation der Endpunkte für das Modell „pl-krz-wp-record“
