MGBI bietet eine umfassende API zum Abruf von Daten aus öffentlichen Registern und Verzeichnissen, darunter auch aus den vom Finanzministerium veröffentlichten Informationen. Eine Liste der in diesem Dienst verfügbaren Datenquellen findest du auf der Website:
👉Öffentliche Register API
Dieser Leitfaden bezieht sich aufdie API für individuelle Daten von Körperschaftsteuerzahlern, die wir im Rahmen des Produkts „
“ zur Verfügung stellen 👉API für individuelle Daten von Körperschaftsteuerzahlern
Im Folgenden beschreiben wir, wie Sie über die API Datensätze mit individuellen Daten von Körperschaftsteuerpflichtigen anhand der Registrierungsnummern für ein bestimmtes Kalenderjahr 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:
👉Individuelle Daten von CIT-Steuerzahlern (API)
Schritt 2: Rufe den Endpunkt „Get Records“ auf
Die im CIT-Register verfügbaren Daten stellen wir in der MGBI-API im Datenmodell mit der Kennung„pl-idpcit-record“ bereit.
Die API stellt für dieses Modell den Endpunkt„Get Records“ bereit, der Datensätze mit individuellen Daten von Körperschaftsteuerpflichtigen für Unternehmen zurückgibt, die die angegebenen Kriterien erfüllen.
👉Dokumentation zum Endpunkt „Get Records“ für das Modell „pl-idpcit-record“
Um die Daten eines einzelnen Körperschaftsteuerpflichtigen abzurufen, muss im Endpunkt„Get Records“dessen Registrierungsnummer angegeben werden: KRS, NIP oder REGON. Optional kann das Steuerjahr über den Parameter „list.fiscal_year“ angegeben werden.
Im folgenden Beispiel wurde der Endpunkt„Get Records“verwendet, um die Daten eines Körperschaftsteuerpflichtigen für das Jahr 2025 für die angegebene Steueridentifikationsnummer abzurufen.
Beispiel für den Aufruf des Endpunkts „Get Records“ mit der Steuernummer für das Jahr 2025:
GET /v1/models/pl-idpcit-record/records?identifiers.pl_nip=[Steuernummer]&list.fiscal_year=2025 HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]Schritt 3: Entnehmen Sie den Antworten die individuellen Daten des Körperschaftsteuerpflichtigen
Ein korrekter Aufruf des Endpunkts„Get Records“gibt als Antwort eine Liste der Datensätze zurück, die den angegebenen Kriterien entsprechen.
Im vorherigen Beispiel sollte der Endpunkt eine Ergebnisliste mit einem oder mehreren Datensätzen zurückgeben:
{
"count": "[liczba wyników]",
"pages": "[liczba stron wyników]",
"results": [
{
"id": "[identyfikator rekordu]",
"identifiers": "[identyfikator podmiotu]",
"content": "[lista zwracanych pól z modelu]",
"list": "[lista, z której pochodzi wpis]",
"meta": "[metadane rekordu]"
}
]
}Jeder Datensatz in der Liste enthält eine Reihe individueller Daten für einen einzelnen Körperschaftsteuerpflichtigen.
Informationen zu der Liste, aus der der Eintrag stammt, sind imListenverzeichnis verfügbar.
Inhalt des Briefwortbuchs:
{
"fiscal_year": "[rok podatkowy]",
"entity_type": "[rodzaj podmiotu]",
"version_date": "[stan danych na dzień]"
}Alle individuellen Daten für ein einzelnes Steuerjahr des angegebenen Körperschaftssteuerpflichtigen findest du im Verzeichnis„content.standarized_fields“.
Inhalt des Wörterbuchs „content.standarized_fields“:
{
"h_on": "[liczba porządkowa]",
"h_tn": "[nazwa podatnika]",
"h_vm": "[numer NIP]",
"h_tyf": "[za rok podatkowy od]",
"h_tyt": "[za rok podatkowy do]",
"r_tr": "[suma przychodów]",
"r_tr_fcg": "[suma przychodów, w tym z zysków kapitałowych]",
"r_tr_fosor": "[suma przychodów, w tym z innych źródeł przychodu]",
"r_tr_fqipr": "[suma przychodów, w tym z kwalifikowanych praw własności intelektualnej]",
"tde_ttde": "[suma kosztów uzyskania przychodów]",
"tde_ttde_fcg": "[suma kosztów uzyskania przychodów, w tym z zysków kapitałowych]",
"tde_ttde_fosor": "[suma kosztów uzyskania przychodów, w tym z innych źródeł przychodu]",
"tde_ttde_fqipr": "[suma kosztów uzyskania przychodów, w tym z kwalifikowanych praw własności intelektualnej]",
"p_tp": "[suma dochodów]",
"p_tp_fcg": "[suma dochodów, w tym z zysków kapitałowych]",
"p_tp_fosor": "[suma dochodów, w tym z innych źródeł przychodu]",
"p_tp_fqipr": "[suma dochodów, w tym z kwalifikowanych praw własności intelektualnej]",
"l_tl": "[suma strat]",
"l_tl_fcg": "[suma strat, w tym z zysków kapitałowych]",
"l_tl_fosor": "[suma strat, w tym z innych źródeł przychodu]",
"l_tl_fqipr": "[suma strat, w tym z kwalifikowanych praw własności intelektualnej]",
"tb": "[podstawa opodatkowania]",
"tb_fqipr": "[podstawa opodatkowania, w tym z kwalifikowanych praw własności intelektualnej]",
"td": "[podatek należny, po uwzględnieniu podatku o którym mowa w art. 24b ustawy CIT]",
"td_fqipr": "[podatek należny, po uwzględnieniu podatku o którym mowa w art. 24b ustawy CIT, w tym z kwalifikowanych praw własności intelektualnej]",
"aloreeitcg": "[informacja, czy w załączniku do zeznania wskazano, że przynajmniej jedna ze spółek wchodzących w skład PGK jest spółką nieruchomościową, o której mowa w art. 4a pkt 35 ustawy]"
}Weitere Informationen:
👉Datenstruktur im Modell „pl-idpcit-record“
👉Dokumentation der Endpunkte für das Modell „pl-idpcit-record“
