MGBI надає комплексний API для отримання даних із державних реєстрів та облікових баз, зокрема з інформації, що публікується Міністерством фінансів. Перелік джерел даних, доступних у цій службі, можна знайти на сайті:
👉Державні реєстри API
Цей посібник стосуєтьсяAPI для індивідуальних даних платників податку на прибуток підприємств, який ми надаємо в рамках продукту:
👉API індивідуальних даних платників податку на прибуток підприємств
Нижче ми описали, як за допомогою API можна знайти записи з індивідуальними даними платників податку на прибуток (CIT) на основі реєстраційних номерів за відповідний календарний рік.
Крок 1: Отримати ключ авторизації в API
Щоб отримати ключ авторизації, необхідний для виклику кінцевих точок, доступних в MGBI API, зв’яжіться з нами за допомогою контактної форми на сторінці продукту:
👉Індивідуальні дані платників податку на прибуток (CIT API)
Крок 2: Викличте кінцеву точку Get Records
Дані, що містяться в реєстрі CIT, ми надаємо в MGBI API у вигляді набору даних з ідентифікаторомpl-idpcit-record.
API надає для цієї моделі кінцеву точкуGet Records, яка повертає записи з індивідуальними даними платників податку на прибуток підприємств для суб’єктів, що відповідають зазначеним критеріям.
👉Документація кінцевої точки Get Records для моделі pl-idpcit-record
Для отримання даних про окремого платника податку на прибуток підприємств (CIT) необхідно вказати в кінцевій точціGet Recordsйого реєстраційний номер: KRS, NIP або REGON. Опціонально можна вказати податковий рік за допомогою параметра list.fiscal_year.
У наведеному нижче прикладі для пошуку даних платника податку на прибуток за 2025 рік за вказаним номером NIP було використано ендпоінтGet Records.
Приклад виклику ендпоінту Get Records із номером NIP за 2025 рік:
GET /v1/models/pl-idpcit-record/records?identifiers.pl_nip=[номер NIP]&list.fiscal_year=2025 HTTP/1.1
Host: api.mgbi.pl
Authorization: [ключ авторизації]Крок 3: Зчитайте з відповіді індивідуальні дані платника податку на прибуток підприємств
При правильному виклику кінцевої точкиGet Recordsу відповідь повертається список записів, що відповідають вказаним критеріям.
У попередньому прикладі кінцева точка повинна повернути список результатів, що містить один або кілька записів:
{
"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]"
}
]
}Кожен запис у списку містить набір індивідуальних даних щодо окремого платника податку на прибуток підприємств.
Дані про список, з якого походить запис, доступні у словникусписків.
Зміст словника листів:
{
"fiscal_year": "[rok podatkowy]",
"entity_type": "[rodzaj podmiotu]",
"version_date": "[stan danych na dzień]"
}Усі індивідуальні дані за окремий податковий рік для вказаного платника податку на прибуток можна знайти у словникуcontent.standarized_fields.
Вміст словника 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]"
}Дізнайтеся більше:
👉Структура даних у моделі pl-idpcit-record
👉Документація щодо кінцевих точок для моделі pl-idpcit-record
