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 das Finanzdokumenten-Repositorium des KRS, die wir im Rahmen des Produkts
zur Verfügung stellen 👉 API des Nationalen Gerichtsregisters (KRS API) – Finanzdokumenten-Repositorium
Im Folgenden beschreiben wir, wie Sie über die API ausgewählte Felder des Jahresabschlusses eines bestimmten Unternehmens aus dem KRS anhand dessen KRS-Nummer und anderer Parameter 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) – Repository für Finanzdokumente
Schritt 2: Rufe den Endpunkt „Get Records“ auf
Die im Finanzdokumentenarchiv des KRS verfügbaren Daten stellen wir in der MGBI-API im Datenmodell mit der Kennung „pl-krs-rdf-record“ bereit.
Die API stellt für dieses Modell den Endpunkt „Get Records“ bereit, der Datensätze zurückgibt, die Informationen zu einzelnen Finanzdokumenten enthalten, die den angegebenen Kriterien entsprechen.
👉 Dokumentation zum Endpunkt „Get Records“ für das Modell „pl-krs-rdf-record“
Um einen Datensatz mit dem Inhalt des Jahresabschlusses aus dem Finanzdokumentenregister des KRS für ein ausgewähltes Unternehmen abzurufen, muss im Endpunkt „Get Records“ dessen Registrierungsnummer (KRS, NIP oder REGON) sowie zusätzliche Parameter wie beispielsweise folgende angegeben werden:
- Typ – Art des Dokuments (z. B. Jahresabschluss, Lagebericht),
- period_major_year – das Jahr, in dem der größte Teil des Zeitraums liegt, auf den sich das Dokument bezieht.
Im folgenden Beispiel wurde der Endpunkt „Get Records“ verwendet, um den Jahresabschluss für das Jahr 2025 für ein Unternehmen mit der angegebenen KRS-Nummer abzurufen.
Beispiel für den Aufruf des Endpunkts „Get Records“ mit KRS-Nummer, Dokumenttyp und Geschäftsjahr:
GET /v1/models/pl-krs-rdf-record/records?identifiers.pl_krs=[KRS-Nummer]&type=financial_statement._major_year=2025 HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]
Schritt 3: Lesen Sie die ausgewählten Felder des Berichts aus den Antworten aus
Ein korrekter Aufruf des Endpunkts „Get Records“ gibt als Antwort eine Liste der Dokumente zurück, die den angegebenen Kriterien entsprechen.
Im vorherigen Beispiel sollte der Endpunkt eine Ergebnisliste mit einem Datensatz zurückgeben:
{
"count": 1,
"pages": 1,
"results": [
{
"id": [identyfikator rekordu],
"identifiers": [identyfikatory podmiotu],
"document": [informacje o dokumencie]
"content": [zawartość dokumentu],
"files": [pliki z treścią dokumentu],
"meta": [metadane rekordu]
}
]
}
Die Felder, die in den Finanzberichten im XML-Format gemäß den logischen Strukturen des polnischen Finanzministeriums verfügbar sind, werden in zwei Wörterbüchern gespeichert:
- content.extracted_fields,
- content.standardized_fields.
Das Wörterbuch „content.extracted_fields“ enthält alle Felder, die im Bericht gemäß der verwendeten logischen Struktur verfügbar sind.
Die vollständige Liste der in diesem Wörterbuch verfügbaren Felder stellen wir in einer Excel-Datei zur Verfügung. Bitte kontaktieren Sie uns über das Formular auf der Produktseite, um einen Link zum Herunterladen der Datei zu erhalten.
Beispiel für den Inhalt des Wörterbuchs „content.extracted_fields“:
{
"bs": {
"a_ca_cfy": 0,
"a_ca_pfy": 0,
"a_fa_cfy": 0,
"a_fa_pfy": 0,
"a_ta_cfy": 0,
"a_ta_pfy": 0,
...
}
}
Wenn Sie Zugriff auf alle Finanzfelder im Bericht benötigen, verwenden Sie das Dictionary „content.extracted_fields“. Reichen Ihnen hingegen die wichtigsten Felder aus der Bilanz oder der Gewinn- und Verlustrechnung aus, nutzen Sie das Dictionary „content.standardized_fields“.
Weitere Informationen:
👉 Datenstruktur im Modell „pl-krs-rdf-record“
👉 Dokumentation der Endpunkte für das Modell „pl-krs-rdf-record“
