{"openapi": "3.0.3", "info": {"title": "KAUZIS – firmy a registre SR", "version": "1.2", "description": "Verejné JSON API nad zrkadlom štátnych registrov: Register právnických osôb, podnikateľov a orgánov verejnej moci (RPO, Ministerstvo vnútra SR) spojený podľa IČO so zoznamami Finančnej správy SR a ďalšími zoznamami. Bez autentizácie, limit 60 požiadaviek za minútu. Dátumy sú ISO RRRR-MM-DD, sumy sú reťazce s desatinnou bodkou. Každá odpoveď nesie pole zdroje (použité zdroje s dátumom aktuálnosti aktualne_k) a upozornenie, že údaje sú informatívne. Fyzické osoby – podnikatelia sa nájdu len presným IČO, zobrazuje sa len obec a sú označené fo: true; zaniknutý podnikateľ – fyzická osoba má len IČO a stav „subjekt zanikol“. Osoby v orgánoch právnických osôb: meno, funkcia, obec, od – do. Tvrdenie, že subjekt v zozname nie je, platí vždy len k uvedenému dátumu aktuálnosti zdroja. Súdne rozhodnutia a predpisy: /api/v1/judikatura/openapi.json. Verejné dáta podporujú aj Accept: application/xml alebo ?format=xml. Koreň XML je odpoved, zoznam má deti polozka a chýbajúca hodnota atribút null=\"true\". Pri stránkovaní posielajte Accept pri každom volaní. Portfóliá používajú JSON a prístupový token."}, "servers": [{"url": "https://www.kauzis.sk/api/v1/firmy"}], "externalDocs": {"url": "https://www.kauzis.sk/firmy/api", "description": "Firemné API, pokrytie jednotlivých údajov, úradné zdroje a plán rozšírení."}, "paths": {"/hladat": {"get": {"operationId": "searchCompanies", "summary": "Našepkávanie podľa názvu, IČO, DIČ a IČ DPH", "description": "Názov a daňové čísla vyhľadávajú právnické osoby. Podnikateľa – fyzickú osobu možno nájsť presným IČO. Číselné našepkávanie zapnete cez prefix=1. Na výber konkrétneho druhu identifikátora slúži podla. Po výbere adresáta načítajte fakturacia_api_url, ak ho položka obsahuje. Ďalšie návrhy poskytuje dalsia_url. České s.r.o. a a.s. poskytuje na vyžiadanie ARES. V režime krajina=CZ podporuje presné osemmiestne IČO a názov od troch znakov, najviac desať návrhov. Českú fakturačnú kartu možno získať cez fakturacia_api_url.", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}, "description": "názov (od dvoch znakov), IČO, DIČ alebo IČ DPH vrátane predpony štátu"}, {"name": "krajina", "in": "query", "schema": {"type": "string", "enum": ["SK", "CZ"]}, "description": "SK (predvolené) alebo CZ"}, {"name": "skupina", "in": "query", "schema": {"type": "string"}, "description": "skupina subjektov: 1 firmy, 3 rozpočtové a príspevkové organizácie, 4 verejná správa, 5 neziskové organizácie, 9 ostatné (alebo slug: firmy, rozpoctove-prispevkove, verejna-sprava, neziskove)"}, {"name": "aktivne", "in": "query", "schema": {"type": "string", "enum": ["0", "1"]}, "description": "1 = len aktívne, 0 = len zaniknuté; bez parametra aktívne prvé"}, {"name": "kraj", "in": "query", "schema": {"type": "string"}, "description": "kraj sídla – kód NUTS 3 (SK010 Bratislavský, SK021 Trnavský, SK022 Trenčiansky, SK023 Nitriansky, SK031 Žilinský, SK032 Banskobystrický, SK041 Prešovský, SK042 Košický) alebo slug (bratislavsky…). Presné IČO sa nájde bez ohľadu na filter."}, {"name": "limit", "in": "query", "schema": {"type": "integer", "minimum": 1, "maximum": 50}, "description": "počet výsledkov, predvolene 20, najviac 50"}, {"name": "po", "in": "query", "schema": {"type": "string"}, "description": "token ďalšej strany (pole dalsie predošlej odpovede)"}, {"name": "podla", "in": "query", "schema": {"type": "string", "enum": ["auto", "nazov", "ico", "dic", "ic_dph"]}, "description": "pole pre vyhľadávanie, predvolene automatická voľba"}, {"name": "prefix", "in": "query", "schema": {"type": "string", "enum": ["0", "1"]}, "description": "1 zapne vyhľadávanie čiastočných identifikátorov právnických osôb od 5 číslic"}], "responses": {"200": {"description": "Návrhy adresátov faktúry. Pocet je počet položiek na tejto strane.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/VysledkyHladania"}}, "application/xml": {"schema": {"type": "string"}}}}, "400": {"description": "Chyba – JSON {\"error\": text, …}", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Chyba"}}, "application/xml": {"schema": {"type": "string"}}}}, "503": {"description": "Dočasne nedostupný český zdroj. Ďalší pokus po uvedenom počte sekúnd.", "headers": {"Retry-After": {"schema": {"type": "string"}}}, "content": {"application/json": {"schema": {"type": "object"}}, "application/xml": {"schema": {"type": "string"}}}}}, "x-codeSamples": [{"lang": "Shell", "label": "Vyhľadanie podľa DIČ", "source": "curl -fsS 'https://www.kauzis.sk/api/v1/firmy/hladat?q=2120735628'"}]}}, "/{ico}": {"get": {"operationId": "getCompany", "summary": "Profil subjektu podľa IČO", "description": "Časti odpovede: identifikacia – názov, právna forma, stav, vznik a zánik, sídlo, SK NACE, označenie účastníka (vždy súčasťou odpovede); dane – DIČ, IČ DPH, paragraf a dátum registrácie pre DPH, index daňovej spoľahlivosti; register – zápis v registri: registrový súd a číslo, základné imanie, predmety činnosti, spôsob konania, vklady, akcie, právne stavy, predchodcovia a nástupcovia, organizačné jednotky; osoby – osoby v orgánoch a spoločníci: meno, funkcia, obec, štát, od – do (aktuálne aj bývalé); historia – historické názvy, sídla a právne formy + časová os udalostí; zmeny – posledné riadky feedu zmien tohto IČO; zaznamy – záznamy zo zoznamov (DPH, dlžníci…) po zdrojoch s názvom zdroja a dátumom aktuálnosti; rizika – právny stav, kódy rizík a prítomnosť v zoznamoch – vždy s dátumom aktuálnosti zdroja. Bez parametra casti prídu všetky. Staré IČO vráti profil aktuálneho IČO a pole stare_ico. Podnikateľ – fyzická osoba nemá časti osoby a historia. Právnická osoba dostane s časťou rizika aj objekt hodnotenie – Hodnotenie KAUZIS podľa zverejnenej metodiky (metodika_url): stav (data | bez_cisla | ziadne), rok závierky, body 0 – 100, znamka A – E (N = nedostatok podkladov), pokrytie (% váhy ukazovateľov s údajom), strop (obmedzenie, ktoré výsledok znížilo), pred_stropom, len_zo_zavierky, dovod (prečo číslo nie je – napr. právny stav alebo závierka mimo účtovnej rovnosti), skupiny[] (body piatich skupín ukazovateľov), porovnanie (odvetvie a veľkosť porovnávacej skupiny), datumy_zoznamov (ku ktorému dňu poznáme úradné zoznamy), roky[] (história) a bez strucne=1 aj ukazovatele[] (hodnota, body, váha, príspevok, percentil, porovnávacia skupina a počet porovnávaných subjektov). Hodnotenie je informatívny údaj – nie je úverovým ratingom ani predpoveďou úpadku; fyzické osoby ho nemajú. Český výpis z ARES obsahuje identifikáciu a fakturačnú kartu. Aktualne_k je dátum zmeny v ARES, overene je čas kontroly. Registráciu k DPH treba overiť samostatne.\n\nKlient načíta fakturačné údaje cez `?casti=fakturacia`. Do formulára prevezme `fakturacia.nazov`, `fakturacia.ico`, `fakturacia.sidlo` a známe daňové čísla. Odkazy `detaily[sekcia].api_url` vracajú dáta, `detaily[sekcia].url` otvára verejnú stránku. Parametre `rok`, `strana`, `limit` a `zavierka_id` sa tu používajú spolu s `rozsirit`.", "parameters": [{"name": "ico", "in": "path", "required": true, "schema": {"type": "string", "pattern": "^\\d{6,8}$"}, "description": "IČO – 8 číslic (6 – 7 číslic sa doplní nulami zľava)"}, {"name": "casti", "in": "query", "schema": {"type": "string"}, "description": "výber častí oddelený čiarkami (menšia odpoveď): identifikacia, dane, register, osoby, historia, zmeny, zaznamy, rizika. Pre fakturačný formulár použite casti=fakturacia."}, {"name": "strucne", "in": "query", "schema": {"type": "string", "enum": ["0", "1"]}, "description": "1 = stručný profil: len aktuálne osoby a platné položky zápisu (predmety činnosti, vklady…), kratšia časová os; počty hovoria, koľko položiek je spolu"}, {"name": "krajina", "in": "query", "schema": {"type": "string", "enum": ["SK", "CZ"]}, "description": "SK (predvolené) alebo CZ"}, {"name": "rozsirit", "in": "query", "schema": {"type": "string", "enum": ["organizacne-jednotky", "financie", "suvaha", "vykaz-ziskov-a-strat", "uctovne-zavierky", "sudne-rozhodnutia", "platobne-rozkazy", "konkurzy-a-restrukturalizacie", "exekucie", "zmluvy-so-statom", "partner-verejneho-sektora", "nehnutelnosti", "podobne", "pravne-nastroje"]}, "description": "Jedna dostupná sekcia z profilu. Jej prvá alebo vybraná strana sa vloží do poľa detail."}, {"name": "rok", "in": "query", "schema": {"type": "integer", "minimum": 1000, "maximum": 9999}, "description": "Voliteľný účtovný rok pre finančné detaily"}, {"name": "strana", "in": "query", "schema": {"type": "integer", "minimum": 1, "maximum": 100000, "default": 1}, "description": "Strana od 1"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "minimum": 1, "maximum": 100, "default": 20}, "description": "Počet riadkov na stranu"}, {"name": "zavierka_id", "in": "query", "schema": {"type": "integer", "format": "int64", "minimum": 1, "maximum": 999999999999999999}, "description": "ID konkrétneho podania z účtovných závierok pre uctovne-zavierky, suvaha alebo vykaz-ziskov-a-strat. Pošlite buď zavierka_id, alebo rok."}], "responses": {"200": {"description": "ico, krajina, nazov, fo, aktivny, url, api_url, aktualne_k, casti[], vybrané časti, hodnotenie (právnická osoba s časťou rizika), zdroje[], upozornenie", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ProfilFirmy"}}, "application/xml": {"schema": {"type": "string"}}}}, "400": {"description": "Chyba – JSON {\"error\": text, …}", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Chyba"}}, "application/xml": {"schema": {"type": "string"}}}}, "404": {"description": "Chyba – JSON {\"error\": text, …}", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Chyba"}}, "application/xml": {"schema": {"type": "string"}}}}, "503": {"description": "Dočasne nedostupný český zdroj. Ďalší pokus po uvedenom počte sekúnd.", "headers": {"Retry-After": {"schema": {"type": "string"}}}, "content": {"application/json": {"schema": {"type": "object"}}, "application/xml": {"schema": {"type": "string"}}}}}, "x-codeSamples": [{"lang": "Shell", "label": "Fakturačný formulár", "source": "curl -fsS 'https://www.kauzis.sk/api/v1/firmy/51649608?casti=fakturacia'"}, {"lang": "Shell", "label": "Fakturačné údaje a účtovný rok", "source": "curl -fsS 'https://www.kauzis.sk/api/v1/firmy/51649608?casti=fakturacia&rozsirit=financie&rok=2025'"}]}}, "/{ico}/detail/{sekcia}": {"get": {"operationId": "getCompanyDetail", "summary": "Detail vybraný z poľa detaily v profile firmy", "description": "Začnite volaním GET /{ico}. Profil vráti fakturacia pre fakturačný formulár a detaily s konkrétnymi odkazmi api_url. Sledujte dalsia_url, kým má hodnotu. Účtovné údaje rozlišujú obdobie, menu, presnú hodnotu, odhad a chýbajúci podklad. Pri registroch rešpektujte rozsah zdroja a stav overenia.\n\nPri financiách obsahuje `results[]` účtovné obdobia. Skontrolujte `ebitda_stav` a potom čítajte `ukazovatele.ebitda` alebo `ukazovatele.ebitda_odhad`. Samostatná sekcia `organizacne-jednotky` obsahuje prevádzkarne a ostatné jednotky slovenskej právnickej osoby. Počty a stav rozlišujú úplný export od čiastočnej historickej vzorky. Pri ostatných sekciách závisia polia riadkov od druhu registra alebo výkazu.", "parameters": [{"name": "ico", "in": "path", "required": true, "schema": {"type": "string", "pattern": "^\\d{6,8}$"}, "description": "IČO – 8 číslic (6 – 7 číslic sa doplní nulami zľava)"}, {"name": "sekcia", "in": "path", "required": true, "description": "Názov dostupného detailu z profilu", "schema": {"type": "string", "enum": ["organizacne-jednotky", "financie", "suvaha", "vykaz-ziskov-a-strat", "uctovne-zavierky", "sudne-rozhodnutia", "platobne-rozkazy", "konkurzy-a-restrukturalizacie", "exekucie", "zmluvy-so-statom", "partner-verejneho-sektora", "nehnutelnosti", "podobne", "pravne-nastroje"]}}, {"name": "krajina", "in": "query", "schema": {"type": "string", "enum": ["SK", "CZ"]}, "description": "SK (predvolené) alebo CZ"}, {"name": "strana", "in": "query", "schema": {"type": "integer", "minimum": 1, "maximum": 100000, "default": 1}, "description": "Strana od 1"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "minimum": 1, "maximum": 100, "default": 20}, "description": "Počet riadkov na stranu"}, {"name": "rok", "in": "query", "schema": {"type": "integer", "minimum": 1000, "maximum": 9999}, "description": "Voliteľný účtovný rok pre finančné detaily"}, {"name": "zavierka_id", "in": "query", "schema": {"type": "integer", "format": "int64", "minimum": 1, "maximum": 999999999999999999}, "description": "ID konkrétneho podania z účtovných závierok pre uctovne-zavierky, suvaha alebo vykaz-ziskov-a-strat. Pošlite buď zavierka_id, alebo rok."}], "responses": {"200": {"description": "Stránka vybraného detailu", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/DetailFirmy"}}, "application/xml": {"schema": {"type": "string"}}}}, "400": {"description": "Chyba – JSON {\"error\": text, …}", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Chyba"}}, "application/xml": {"schema": {"type": "string"}}}}, "404": {"description": "Chyba – JSON {\"error\": text, …}", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Chyba"}}, "application/xml": {"schema": {"type": "string"}}}}}, "x-codeSamples": [{"lang": "Shell", "label": "Prvá strana účtovných období", "source": "curl -fsS 'https://www.kauzis.sk/api/v1/firmy/51649608/detail/financie?limit=1'"}]}}, "/{ico}/prepojenia": {"get": {"operationId": "getCompanyLinks", "summary": "Graf prepojení právnickej osoby (osoby, vlastníci, dcérske firmy)", "description": "Úroveň 1: osoby a firmy v orgánoch a medzi spoločníkmi subjektu a firmy, v ktorých je subjekt spoločníkom; úroveň 2 – 3: ďalšie firmy týchto osôb a vrstva firma – firma. Osoby sú spojené podľa zhody mena a obce – register fyzickým osobám nedáva identifikátor, preto nejde o overenú identitu osoby (dve osoby rovnakého mena z jednej obce sa nedajú rozlíšiť). Osoba s viac než 50 firmami sa nerozbaľuje.", "parameters": [{"name": "ico", "in": "path", "required": true, "schema": {"type": "string", "pattern": "^\\d{6,8}$"}, "description": "IČO – 8 číslic (6 – 7 číslic sa doplní nulami zľava)"}, {"name": "hlbka", "in": "query", "schema": {"type": "integer", "minimum": 1, "maximum": 3}, "description": "hĺbka grafu 1 – 3, predvolene 2"}, {"name": "historicke", "in": "query", "schema": {"type": "string", "enum": ["0", "1"]}, "description": "1 = aj ukončené väzby (predvolene len aktuálne; zaniknutý subjekt sa prepne sám)"}, {"name": "max_uzlov", "in": "query", "schema": {"type": "integer", "minimum": 2, "maximum": 150}, "description": "najviac uzlov, predvolene 60, najviac 150"}, {"name": "krajina", "in": "query", "schema": {"type": "string", "enum": ["SK", "CZ"]}, "description": "SK (predvolené) alebo CZ"}], "responses": {"200": {"description": "ico, subjekt, uzly[] (id, typ: firma | osoba, nazov, obec, uroven, ico, url, api_url), hrany[] (od, do, typ, typ_nazov, funkcia, aktualna), orezane, historicke, cez_osoby, osoby_rozbalene, zdroje[], upozornenie", "content": {"application/json": {"schema": {"type": "object"}}, "application/xml": {"schema": {"type": "string"}}}}, "400": {"description": "Chyba – JSON {\"error\": text, …}", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Chyba"}}, "application/xml": {"schema": {"type": "string"}}}}, "404": {"description": "Chyba – JSON {\"error\": text, …}", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Chyba"}}, "application/xml": {"schema": {"type": "string"}}}}}}}, "/zdroje": {"get": {"operationId": "listCompanySources", "summary": "Zdrojové registre a zoznamy s dátumom aktuálnosti", "responses": {"200": {"description": "zdroje[] (kod, nazov, prevadzkovatel, aktualne_k, nahraty, licencia, atribucia, url, kadencia, rezim, pocet, prve_nahratie_hotove, posledny_uspech, posledna_kontrola, data_v_kopii_k, pocet_v_kopii, prípadné obmedzenie rozsah)", "content": {"application/json": {"schema": {"type": "object", "properties": {"pocet": {"type": "integer"}, "aktualne_k": {"type": "string", "nullable": true, "format": "date"}, "zdroje": {"type": "array", "items": {"$ref": "#/components/schemas/StavZdroja"}}, "poznamka": {"type": "string"}, "url": {"type": "string", "format": "uri"}, "api_url": {"type": "string", "format": "uri"}, "upozornenie": {"type": "string"}}, "required": ["pocet", "aktualne_k", "zdroje", "poznamka", "url", "api_url", "upozornenie"]}}, "application/xml": {"schema": {"type": "string"}}}}}}}, "/zmeny": {"get": {"operationId": "listCompanyChanges", "summary": "Feed zmien a udalostí (kurzor)", "description": "Riadky s id > since_id od najstaršieho. Hodnotu next_cursor pošlite ako ďalšie since_id; has_more = existujú ďalšie riadky. Prechod nemá medzery ani duplicity. Feed neuvádza mená fyzických osôb: pri udalostiach osôb v orgánoch a medzi spoločníkmi (`fyzicka_osoba: true`) a pri podnikateľoch – fyzických osobách (`fo: true`) sú polia `stare` a `nove` prázdne (okrem zmien právnej formy, SK NACE, IČO a registrácie pre DPH); udalosti zaniknutých podnikateľov – fyzických osôb sa vynechávajú. Osoby právnickej osoby sú v jej profile (`api_url`, časť osoby).", "parameters": [{"name": "since_id", "in": "query", "schema": {"type": "integer", "minimum": 0}, "description": "kurzor – id posledného spracovaného riadku (predvolene 0 = od začiatku)"}, {"name": "ico", "in": "query", "schema": {"type": "string"}, "description": "len udalosti jedného IČO"}, {"name": "typ", "in": "query", "schema": {"type": "string", "enum": ["dic", "dlznik_fs", "dlznik_fs_koniec", "dlznik_fs_zmena", "dlznik_sp", "dlznik_sp_koniec", "dlznik_sp_zmena", "dlznik_stat", "dlznik_stat_koniec", "dlznik_stat_zmena", "dlznik_zp", "dlznik_zp_koniec", "dlznik_zp_zmena", "dozorny_koniec", "dozorny_novy", "dph_dovody", "dph_dovody_koniec", "dph_dovody_vymaz", "dph_registracia", "dph_zmena", "dph_zrusenie", "exekucia_koniec", "exekucia_poverenie", "exekucia_zmena", "forma", "ico", "ids", "imanie", "konkurz", "konkurz_koniec", "konkurz_navrh", "konkurz_vyhlaseny", "likvidacia", "likvidacia_koniec", "likvidacia_register", "nace", "nazov", "novy_subjekt", "nutena_sprava", "nutena_sprava_koniec", "osoba_koniec", "osoba_nova", "preventivna_restrukturalizacia", "prokurista_koniec", "prokurista_novy", "register", "restrukturalizacia", "restrukturalizacia_koniec", "restrukturalizacia_navrh", "restrukturalizacia_povolena", "sidlo", "spolocnik_koniec", "spolocnik_novy", "spravca_koniec", "spravca_novy", "statutar_koniec", "statutar_novy", "stav", "stav_koniec", "upadok_konanie", "upadok_skoncene", "upadok_vyradene", "upadok_zastavene", "vyrovnanie", "vyrovnanie_koniec", "zakladatel_koniec", "zakladatel_novy", "zanik", "zanik_zruseny", "zrusenie", "zrusenie_koniec"]}, "description": "len jeden typ udalosti"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "minimum": 1, "maximum": 500}, "description": "počet riadkov, predvolene 100, najviac 500"}, {"name": "krajina", "in": "query", "schema": {"type": "string", "enum": ["SK", "CZ"]}, "description": "SK (predvolené) alebo CZ"}, {"name": "den", "in": "query", "schema": {"type": "string", "format": "date"}, "description": "Udalosti zaznamenané v KAUZIS počas daného UTC dňa. Dátum podľa zdroja nesie pole datum."}, {"name": "kraj", "in": "query", "schema": {"type": "string"}, "description": "Kód alebo slug súčasného kraja sídla právnickej osoby."}, {"name": "nace", "in": "query", "schema": {"type": "string", "pattern": "^[0-9]{2,5}$"}, "description": "Začiatok súčasného kódu SK NACE právnickej osoby."}, {"name": "zavaznost", "in": "query", "schema": {"type": "string", "enum": ["info", "warning", "critical"]}, "description": "Závažnosť udalosti."}], "responses": {"200": {"description": "results[] (id, ico, typ, nazov, zavaznost: info | warning | critical, stare, nove, datum, zistene, zdroj, data, subjekt, url, api_url), next_cursor, has_more, dalsia_url, pocet, vynechane, zdroje[], upozornenie", "content": {"application/json": {"schema": {"type": "object"}}, "application/xml": {"schema": {"type": "string"}}}}, "400": {"description": "Chyba – JSON {\"error\": text, …}", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Chyba"}}, "application/xml": {"schema": {"type": "string"}}}}}}}, "/openapi.json": {"get": {"operationId": "getCompanyOpenApi", "summary": "Tento popis", "responses": {"200": {"description": "dokument OpenAPI 3", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/portfolia": {"get": {"operationId": "listPortfolios", "summary": "Moje skupiny firiem", "security": [{"UcetJWT": []}], "parameters": [{"name": "po", "in": "query", "description": "Pokračovanie z dalsia_url.", "schema": {"type": "string"}}, {"name": "limit", "in": "query", "description": "Veľkosť strany.", "schema": {"type": "integer", "minimum": 1, "maximum": 100}}], "responses": {"200": {"description": "results, dalsia_url"}, "401": {"description": "Vyžaduje sa platný prístupový token účtu."}}}}, "/portfolia/{kluc}": {"get": {"operationId": "listPortfolioMembers", "summary": "Firmy v skupine", "security": [{"UcetJWT": []}], "parameters": [{"name": "kluc", "in": "path", "required": true, "description": "Kľúč skupiny v rámci vášho účtu.", "schema": {"type": "string", "maxLength": 64, "pattern": "^[A-Za-z0-9_-]+$"}}, {"name": "po", "in": "query", "description": "Pokračovanie z dalsia_url.", "schema": {"type": "string"}}, {"name": "limit", "in": "query", "description": "Veľkosť strany.", "schema": {"type": "integer", "minimum": 1, "maximum": 100}}], "responses": {"200": {"description": "results, dalsia_url, zmeny_url"}, "404": {"description": "Skupina sa nenašla."}, "401": {"description": "Vyžaduje sa platný prístupový token účtu."}}}, "put": {"operationId": "putPortfolio", "summary": "Vytvoriť skupinu pod vlastným kľúčom", "security": [{"UcetJWT": []}], "parameters": [{"name": "kluc", "in": "path", "required": true, "description": "Kľúč skupiny v rámci vášho účtu.", "schema": {"type": "string", "maxLength": 64, "pattern": "^[A-Za-z0-9_-]+$"}}], "responses": {"200": {"description": "Existuje."}, "201": {"description": "Vytvorená."}, "409": {"description": "Iná krajina."}, "401": {"description": "Vyžaduje sa platný prístupový token účtu."}}, "requestBody": {"content": {"application/json": {"schema": {"type": "object", "properties": {"krajina": {"type": "string", "enum": ["SK", "CZ"]}}}}}}}, "delete": {"operationId": "deletePortfolio", "summary": "Odstrániť vlastnú skupinu a členstvo", "security": [{"UcetJWT": []}], "parameters": [{"name": "kluc", "in": "path", "required": true, "description": "Kľúč skupiny v rámci vášho účtu.", "schema": {"type": "string", "maxLength": 64, "pattern": "^[A-Za-z0-9_-]+$"}}], "responses": {"204": {"description": "Odstránená."}, "404": {"description": "Skupina sa nenašla."}, "401": {"description": "Vyžaduje sa platný prístupový token účtu."}}}}, "/portfolia/{kluc}/clenovia/{ico}": {"put": {"operationId": "putPortfolioMember", "summary": "Pridať firmu podľa IČO", "security": [{"UcetJWT": []}], "parameters": [{"name": "kluc", "in": "path", "required": true, "description": "Kľúč skupiny v rámci vášho účtu.", "schema": {"type": "string", "maxLength": 64, "pattern": "^[A-Za-z0-9_-]+$"}}, {"name": "ico", "in": "path", "required": true, "description": "Celé IČO vrátane počiatočných núl.", "schema": {"type": "string", "pattern": "^[0-9]{8}$", "description": "IČO vrátane úvodných núl."}}], "responses": {"200": {"description": "Už je členom."}, "201": {"description": "Pridaná."}, "404": {"description": "Neznáma skupina alebo firma."}, "401": {"description": "Vyžaduje sa platný prístupový token účtu."}}}, "delete": {"operationId": "deletePortfolioMember", "summary": "Odobrať firmu zo skupiny", "security": [{"UcetJWT": []}], "parameters": [{"name": "kluc", "in": "path", "required": true, "description": "Kľúč skupiny v rámci vášho účtu.", "schema": {"type": "string", "maxLength": 64, "pattern": "^[A-Za-z0-9_-]+$"}}, {"name": "ico", "in": "path", "required": true, "description": "Celé IČO vrátane počiatočných núl.", "schema": {"type": "string", "pattern": "^[0-9]{8}$", "description": "IČO vrátane úvodných núl."}}], "responses": {"204": {"description": "Členstvo odstránené."}, "404": {"description": "Skupina sa nenašla."}, "401": {"description": "Vyžaduje sa platný prístupový token účtu."}}}}, "/portfolia/{kluc}/zmeny": {"get": {"operationId": "getPortfolioChanges", "summary": "Udalosti súčasných členov skupiny", "security": [{"UcetJWT": []}], "parameters": [{"name": "kluc", "in": "path", "required": true, "description": "Kľúč skupiny v rámci vášho účtu.", "schema": {"type": "string", "maxLength": 64, "pattern": "^[A-Za-z0-9_-]+$"}}, {"name": "since_id", "in": "query", "schema": {"type": "integer", "minimum": 0}, "description": "kurzor – id posledného spracovaného riadku (predvolene 0 = od začiatku)"}, {"name": "typ", "in": "query", "schema": {"type": "string", "enum": ["dic", "dlznik_fs", "dlznik_fs_koniec", "dlznik_fs_zmena", "dlznik_sp", "dlznik_sp_koniec", "dlznik_sp_zmena", "dlznik_stat", "dlznik_stat_koniec", "dlznik_stat_zmena", "dlznik_zp", "dlznik_zp_koniec", "dlznik_zp_zmena", "dozorny_koniec", "dozorny_novy", "dph_dovody", "dph_dovody_koniec", "dph_dovody_vymaz", "dph_registracia", "dph_zmena", "dph_zrusenie", "exekucia_koniec", "exekucia_poverenie", "exekucia_zmena", "forma", "ico", "ids", "imanie", "konkurz", "konkurz_koniec", "konkurz_navrh", "konkurz_vyhlaseny", "likvidacia", "likvidacia_koniec", "likvidacia_register", "nace", "nazov", "novy_subjekt", "nutena_sprava", "nutena_sprava_koniec", "osoba_koniec", "osoba_nova", "preventivna_restrukturalizacia", "prokurista_koniec", "prokurista_novy", "register", "restrukturalizacia", "restrukturalizacia_koniec", "restrukturalizacia_navrh", "restrukturalizacia_povolena", "sidlo", "spolocnik_koniec", "spolocnik_novy", "spravca_koniec", "spravca_novy", "statutar_koniec", "statutar_novy", "stav", "stav_koniec", "upadok_konanie", "upadok_skoncene", "upadok_vyradene", "upadok_zastavene", "vyrovnanie", "vyrovnanie_koniec", "zakladatel_koniec", "zakladatel_novy", "zanik", "zanik_zruseny", "zrusenie", "zrusenie_koniec"]}, "description": "len jeden typ udalosti"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "minimum": 1, "maximum": 500}, "description": "počet riadkov, predvolene 100, najviac 500"}, {"name": "den", "in": "query", "schema": {"type": "string", "format": "date"}, "description": "Udalosti zaznamenané v KAUZIS počas daného UTC dňa. Dátum podľa zdroja nesie pole datum."}, {"name": "kraj", "in": "query", "schema": {"type": "string"}, "description": "Kód alebo slug súčasného kraja sídla právnickej osoby."}, {"name": "nace", "in": "query", "schema": {"type": "string", "pattern": "^[0-9]{2,5}$"}, "description": "Začiatok súčasného kódu SK NACE právnickej osoby."}, {"name": "zavaznost", "in": "query", "schema": {"type": "string", "enum": ["info", "warning", "critical"]}, "description": "Závažnosť udalosti."}], "responses": {"200": {"description": "results, next_cursor, has_more, dalsia_url"}, "404": {"description": "Skupina sa nenašla."}, "401": {"description": "Vyžaduje sa platný prístupový token účtu."}}}}, "/zavierky": {"get": {"operationId": "listChangedFinancialStatements", "summary": "Podania slovenských firiem zmenené v RÚZ vo vybraný deň", "parameters": [{"name": "den", "in": "query", "required": true, "schema": {"type": "string", "format": "date"}, "description": "Deň poslednej úpravy podania podľa RÚZ."}, {"name": "po", "in": "query", "schema": {"type": "string"}, "description": "Pokračujte cez dalsia_url."}, {"name": "limit", "in": "query", "schema": {"type": "integer"}, "description": "Počet podaní na stránke."}, {"name": "riadky", "in": "query", "schema": {"type": "string", "enum": ["0", "1"]}, "description": "1 pridá dostupné zverejnené riadky podporovaných účtovných šablón."}], "responses": {"200": {"description": "results[] s IČO a ID konkrétneho podania, zdrojom a pokračovaním.", "content": {"application/json": {"schema": {"type": "object"}}, "application/xml": {"schema": {"type": "string"}}}}, "400": {"description": "Neplatný deň, kurzor alebo parameter.", "content": {"application/json": {"schema": {"type": "object"}}, "application/xml": {"schema": {"type": "string"}}}}}}}}, "components": {"schemas": {"Chyba": {"type": "object", "required": ["error"], "properties": {"error": {"type": "string", "description": "text chyby po slovensky"}, "parameter": {"type": "string", "description": "chybný parameter"}, "povolene": {"type": "array", "items": {}, "description": "povolené hodnoty"}, "ico": {"type": "string"}}}, "FakturacneSidlo": {"type": "object", "properties": {"text": {"type": "string", "nullable": true}, "ulica": {"type": "string", "nullable": true}, "cislo": {"type": "string", "nullable": true}, "cast": {"type": "string", "nullable": true}, "obec": {"type": "string", "nullable": true}, "psc": {"type": "string", "nullable": true}, "stat": {"type": "string", "nullable": true, "pattern": "^[A-Z]{2}$", "description": "Dvojpísmenový kód ISO z adresy v registri."}}, "required": ["text", "ulica", "cislo", "cast", "obec", "psc", "stat"]}, "VerejnyRegister": {"type": "object", "properties": {"kod": {"type": "string", "nullable": true}, "nazov": {"type": "string", "nullable": true}, "reg_sud": {"type": "string", "nullable": true}, "reg_cislo": {"type": "string", "nullable": true}, "oddiel": {"type": "string", "nullable": true}, "vlozka": {"type": "string", "nullable": true}}, "required": ["kod", "nazov", "reg_sud", "reg_cislo", "oddiel", "vlozka"]}, "RegistraciaDPH": {"type": "object", "properties": {"stav": {"type": "string", "enum": ["platitel", "registrovany", "vymazany", "mimo_zoznamu", "nezistene"], "description": "Registrovaný zahŕňa registráciu podľa § 7 alebo § 7a. Mimo zoznamu sa vzťahuje na úplný zoznam ku dňu aktualne_k."}, "paragraf": {"type": "string", "nullable": true}, "od": {"type": "string", "nullable": true, "format": "date"}, "zdroj": {"type": "string", "nullable": true}, "aktualne_k": {"type": "string", "nullable": true, "format": "date"}}, "required": ["stav", "paragraf", "od", "zdroj", "aktualne_k"]}, "Fakturacia": {"type": "object", "properties": {"nazov": {"type": "string"}, "ico": {"type": "string", "pattern": "^[0-9]{8}$", "description": "IČO vrátane úvodných núl."}, "krajina_registra": {"type": "string", "enum": ["SK", "CZ"]}, "fo": {"type": "boolean"}, "aktivny": {"type": "boolean"}, "dic": {"type": "string", "nullable": true}, "ic_dph": {"type": "string", "nullable": true, "description": "Identifikátor DPH uvedený pri subjekte. Po výmaze registrácie je hodnota null."}, "forma": {"type": "string", "nullable": true}, "forma_nazov": {"type": "string", "nullable": true}, "sidlo": {"$ref": "#/components/schemas/FakturacneSidlo"}, "register": {"$ref": "#/components/schemas/VerejnyRegister"}, "dph": {"$ref": "#/components/schemas/RegistraciaDPH"}, "zdroj": {"type": "string", "nullable": true}, "aktualne_k": {"type": "string", "nullable": true, "format": "date"}}, "required": ["nazov", "ico", "krajina_registra", "fo", "aktivny", "dic", "ic_dph", "forma", "forma_nazov", "sidlo", "register", "dph", "zdroj", "aktualne_k"], "description": "Objekt môže v profile chýbať pri neistom priradení IČO alebo zániku podnikateľa – fyzickej osoby. Pri fyzickej osobe obsahuje sídlo nanajvýš obec a štát. Aktualne_k patrí zdroju identity, dph.aktualne_k zdroju DPH. Null pri zdroji alebo dátume znamená, že overenie k danému dňu nie je k dispozícii."}, "OdkazNaDetail": {"type": "object", "properties": {"nazov": {"type": "string"}, "api_url": {"type": "string", "format": "uri"}, "url": {"type": "string", "format": "uri"}}, "required": ["nazov", "api_url", "url"]}, "PouzityZdroj": {"type": "object", "properties": {"kod": {"type": "string"}, "nazov": {"type": "string"}, "aktualne_k": {"type": "string", "nullable": true, "format": "date"}, "url": {"type": "string"}, "nahraty": {"type": "boolean"}}, "required": ["kod", "nazov", "aktualne_k", "url", "nahraty"]}, "StavZdroja": {"type": "object", "properties": {"kod": {"type": "string"}, "nazov": {"type": "string"}, "aktualne_k": {"type": "string", "nullable": true, "format": "date"}, "url": {"type": "string"}, "nahraty": {"type": "boolean"}, "prevadzkovatel": {"type": "string"}, "licencia": {"type": "string"}, "atribucia": {"type": "string"}, "kadencia": {"type": "string"}, "rezim": {"type": "string"}, "pocet": {"type": "integer", "nullable": true}, "prve_nahratie_hotove": {"type": "boolean"}, "posledny_uspech": {"type": "string", "nullable": true, "format": "date-time"}, "posledna_kontrola": {"type": "string", "nullable": true, "format": "date-time"}, "data_v_kopii_k": {"type": "string", "nullable": true, "format": "date"}, "pocet_v_kopii": {"type": "integer", "nullable": true}, "rozsah": {"type": "string"}, "denna_kontrola": {"type": "object", "properties": {"stav": {"type": "string", "enum": ["prevzate", "overene", "bez_zmeny", "podla_intervalu", "overena_vzorka", "zdroj_nedostupny", "caka", "bezi", "chyba"], "description": "overena_vzorka potvrdzuje dostupnosť prvej stránky VšZP. Dátum údajov vychádza z posledného úplného výpisu."}, "zaciatok_pokusu": {"type": "string", "nullable": true, "format": "date-time"}, "koniec_pokusu": {"type": "string", "nullable": true, "format": "date-time"}, "dalsi_pokus_po_chybe_alebo_odklade": {"type": "string", "nullable": true, "format": "date-time"}}, "required": ["stav", "zaciatok_pokusu", "koniec_pokusu", "dalsi_pokus_po_chybe_alebo_odklade"]}}, "required": ["kod", "nazov", "aktualne_k", "url", "nahraty", "prevadzkovatel", "licencia", "atribucia", "kadencia", "rezim", "pocet", "prve_nahratie_hotove", "posledny_uspech", "posledna_kontrola", "data_v_kopii_k", "pocet_v_kopii"]}, "CastiMenaRPO": {"type": "object", "properties": {"mena": {"type": "array", "items": {"type": "string", "maxLength": 120}, "maxItems": 16, "description": "Krstné mená v poradí zdroja."}, "priezviska": {"type": "array", "items": {"type": "string", "maxLength": 120}, "maxItems": 16, "description": "Priezviská v poradí zdroja."}, "tituly_pred": {"type": "array", "items": {"type": "string", "maxLength": 120}, "maxItems": 16, "description": "Tituly pred menom."}, "tituly_za": {"type": "array", "items": {"type": "string", "maxLength": 120}, "maxItems": 16, "description": "Tituly za menom."}}, "additionalProperties": false, "minProperties": 1, "description": "Každý prítomný kľúč pochádza zo samostatného poľa RPO. Prázdny zoznam znamená, že zdroj uviedol prázdne pole."}, "OsobaVoFirme": {"type": "object", "properties": {"meno": {"type": "string"}, "vazba": {"type": "string"}, "vazba_nazov": {"type": "string"}, "typ": {"type": "string"}, "funkcia": {"type": "string"}, "obec": {"type": "string"}, "stat": {"type": "string"}, "od": {"type": "string", "nullable": true, "format": "date"}, "do": {"type": "string", "nullable": true, "format": "date"}, "aktualna": {"type": "boolean"}, "casti_mena": {"$ref": "#/components/schemas/CastiMenaRPO"}, "po_ico": {"type": "string", "pattern": "^[0-9]{8}$", "description": "IČO vrátane úvodných núl."}, "url": {"type": "string", "format": "uri"}, "api_url": {"type": "string", "format": "uri"}}, "required": ["meno", "vazba", "vazba_nazov", "typ", "funkcia", "obec", "stat", "od", "do", "aktualna"]}, "OsobyVoFirme": {"type": "object", "properties": {"pocet": {"type": "integer"}, "pocet_aktualnych": {"type": "integer"}, "osoby": {"type": "array", "items": {"$ref": "#/components/schemas/OsobaVoFirme"}}, "orezane": {"type": "boolean"}, "len_aktualne": {"type": "boolean", "description": "Uvádza sa pri skrátenom profile."}}, "required": ["pocet", "pocet_aktualnych", "osoby", "orezane"]}, "SidloJednotkyRPO": {"type": "object", "properties": {"ulica": {"type": "string", "nullable": true}, "cislo": {"type": "string", "nullable": true}, "obec": {"type": "string", "nullable": true}, "obec_kod": {"type": "string", "nullable": true}, "psc": {"type": "string", "nullable": true}, "okres": {"type": "string", "nullable": true}, "cast": {"type": "string", "nullable": true}, "stat": {"type": "string", "nullable": true}, "text": {"type": "string", "nullable": true}}, "nullable": true, "additionalProperties": false, "description": "Aktuálna alebo posledná adresa jednotky uvedená v exporte."}, "JednotkaRPO": {"type": "object", "properties": {"typ": {"type": "string", "nullable": true}, "nazov": {"type": "string", "nullable": true}, "adresa": {"type": "string", "nullable": true}, "vznik": {"type": "string", "nullable": true, "format": "date"}, "zanik": {"type": "string", "nullable": true, "format": "date"}, "typ_kod": {"type": "string", "nullable": true}, "ico": {"type": "string", "pattern": "^[0-9]{8}$", "description": "IČO vrátane úvodných núl.", "nullable": true}, "sidlo": {"$ref": "#/components/schemas/SidloJednotkyRPO"}}, "required": ["sidlo"], "additionalProperties": false, "description": "IČO patrí samotnej jednotke. Staršie profily môžu mať iba textovú adresu."}, "JednotkyVRegistri": {"type": "object", "properties": {"pocet": {"type": "integer", "minimum": 0, "nullable": true, "description": "Počet všetkých položiek v RPO vrátane zaniknutých."}, "pocet_prevadzkarni": {"type": "integer", "minimum": 0, "nullable": true, "description": "Počet jednotiek typu Prevádzkareň. Pri starších profiloch môže byť neznámy."}, "pocet_ostatnych": {"type": "integer", "minimum": 0, "nullable": true, "description": "Počet ostatných organizačných jednotiek. Pri starších profiloch môže byť neznámy."}, "zoznam": {"type": "array", "items": {"$ref": "#/components/schemas/JednotkaRPO"}, "maxItems": 50}, "orezane": {"type": "boolean", "nullable": true}}, "required": ["pocet", "pocet_prevadzkarni", "pocet_ostatnych"]}, "VzorkaJednotiekRPO": {"type": "object", "properties": {"pocet_v_zdroji": {"type": "integer", "minimum": 0, "nullable": true}, "zoznam": {"type": "array", "items": {"type": "object", "properties": {"typ": {"type": "string", "nullable": true}, "nazov": {"type": "string", "nullable": true}, "adresa": {"type": "string", "nullable": true}, "vznik": {"type": "string", "nullable": true, "format": "date"}, "zanik": {"type": "string", "nullable": true, "format": "date"}}, "required": ["typ", "nazov", "adresa", "vznik", "zanik"]}, "maxItems": 50}, "rozsah": {"type": "string", "enum": ["organizacne_jednotky_bez_prevadzkarni"]}, "vsetky_zobrazene": {"type": "boolean", "nullable": true}, "zdroj": {"type": "string", "enum": ["rpo"]}}, "required": ["pocet_v_zdroji", "zoznam", "rozsah", "vsetky_zobrazene", "zdroj"], "nullable": true, "description": "Obmedzená vzorka zo základného profilu. Všetky dostupné jednotky obsahuje samostatný detail."}, "DetailJednotiekRPO": {"type": "object", "properties": {"sekcia": {"type": "string", "enum": ["organizacne-jednotky"]}, "stav": {"type": "string", "enum": ["overene", "ciastocne", "caka_na_strany"], "description": "Úplný zoznam z exportu, historická neúplná vzorka alebo chýbajúca stránka importu."}, "pocet": {"type": "integer", "minimum": 0, "nullable": true, "description": "Počet všetkých položiek v RPO vrátane zaniknutých."}, "pocet_prevadzkarni": {"type": "integer", "minimum": 0, "nullable": true, "description": "Počet jednotiek typu Prevádzkareň. Pri starších profiloch môže byť neznámy."}, "pocet_ostatnych": {"type": "integer", "minimum": 0, "nullable": true, "description": "Počet ostatných organizačných jednotiek. Pri starších profiloch môže byť neznámy."}, "pocet_dostupnych": {"type": "integer", "minimum": 0, "nullable": true, "description": "Celkový počet momentálne dostupných riadkov naprieč stranami."}, "results": {"type": "array", "items": {"$ref": "#/components/schemas/JednotkaRPO"}, "maxItems": 100}}, "required": ["sekcia", "stav", "pocet", "pocet_prevadzkarni", "pocet_ostatnych", "pocet_dostupnych", "results"]}, "CharakteristikaFirmy": {"type": "object", "properties": {"druh_vlastnictva": {"type": "object", "nullable": true, "description": "Kód, názov, dátum a odkaz na účtovnú jednotku v RÚZ."}, "zamestnanci": {"type": "object", "nullable": true, "description": "Kategória s medzami od a do. Presný počet len pri jednočlennej kategórii."}, "registrovy_sud": {"type": "object", "nullable": true, "description": "Úradná adresa, kontakt a deň overenia zdrojov."}, "overenie_uctu_fs": {"type": "object", "nullable": true, "description": "IČ DPH a úradný formulár na vyhľadanie zverejneného účtu."}, "organizacne_jednotky": {"$ref": "#/components/schemas/VzorkaJednotiekRPO"}}, "required": ["druh_vlastnictva", "zamestnanci", "registrovy_sud", "overenie_uctu_fs", "organizacne_jednotky"]}, "NavrhFirmy": {"type": "object", "properties": {"ico": {"type": "string", "pattern": "^[0-9]{8}$", "description": "IČO vrátane úvodných núl."}, "krajina": {"type": "string", "enum": ["SK", "CZ"]}, "nazov": {"type": "string"}, "fo": {"type": "boolean"}, "aktivny": {"type": "boolean", "nullable": true}, "obec": {"type": "string"}, "zhoda": {"type": "string"}, "api_url": {"type": "string", "format": "uri"}, "url": {"type": "string", "format": "uri"}, "fakturacia_api_url": {"type": "string", "format": "uri", "description": "Po výbere zavolajte tento odkaz a prevezmite objekt fakturacia. Chýba pri neistom priradení IČO alebo zániku fyzickej osoby."}}, "required": ["ico", "krajina", "nazov", "fo", "aktivny", "api_url", "url"]}, "VysledkyHladania": {"type": "object", "properties": {"query": {"type": "object"}, "druh": {"type": "string", "enum": ["ico", "ico_dic", "dic", "ic_dph", "nazov", "kratky", "prazdny"]}, "pocet": {"type": "integer"}, "results": {"type": "array", "items": {"$ref": "#/components/schemas/NavrhFirmy"}}, "dalsie": {"type": "string", "nullable": true}, "dalsia_url": {"type": "string", "format": "uri", "nullable": true}, "podobne": {"type": "boolean"}, "zdroje": {"type": "array", "items": {"$ref": "#/components/schemas/PouzityZdroj"}}, "upozornenie": {"type": "string"}}, "required": ["query", "druh", "pocet", "results", "dalsie", "dalsia_url", "podobne", "zdroje", "upozornenie"]}, "FinancnyRok": {"type": "object", "properties": {"rok": {"type": "integer"}, "obdobie_od": {"type": "string", "nullable": true, "pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$"}, "obdobie_do": {"type": "string", "nullable": true, "pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$"}, "porovnavaci_stlpec": {"type": "boolean"}, "konsolidovana": {"type": "boolean"}, "zavierka_id": {"type": "integer", "nullable": true}, "zavierka_url": {"type": "string", "format": "uri", "nullable": true}, "hodnoty": {"type": "object", "additionalProperties": {"type": "string", "nullable": true, "description": "Desatinný reťazec v EUR. Null označuje chýbajúcu hodnotu."}, "properties": {"kurzove_zisky": {"type": "string", "nullable": true, "description": "Desatinný reťazec v EUR. Null označuje chýbajúcu hodnotu."}, "kurzove_straty": {"type": "string", "nullable": true, "description": "Desatinný reťazec v EUR. Null označuje chýbajúcu hodnotu."}, "danove_pohladavky_a_dotacie": {"type": "string", "nullable": true, "description": "Desatinný reťazec v EUR. Null označuje chýbajúcu hodnotu."}, "trzby_za_tovar": {"type": "string", "nullable": true, "description": "Desatinný reťazec v EUR. Null označuje chýbajúcu hodnotu."}, "naklady_na_predany_tovar": {"type": "string", "nullable": true, "description": "Desatinný reťazec v EUR. Null označuje chýbajúcu hodnotu."}, "cisty_obrat": {"type": "string", "nullable": true, "description": "Desatinný reťazec v EUR. Null označuje chýbajúcu hodnotu."}, "socialne_a_danove_pohladavky_a_dotacie": {"type": "string", "nullable": true, "description": "Desatinný reťazec v EUR. Null označuje chýbajúcu hodnotu."}}}, "ukazovatele": {"type": "object", "properties": {"trzby": {"type": "string", "nullable": true, "description": "Tržby"}, "trzby_zmena": {"type": "number", "nullable": true, "description": "Tržby – medziročná zmena"}, "vynosy": {"type": "string", "nullable": true, "description": "Výnosy spolu"}, "pridana_hodnota": {"type": "string", "nullable": true, "description": "Pridaná hodnota"}, "zisk": {"type": "string", "nullable": true, "description": "Zisk po zdanení"}, "zisk_zmena": {"type": "string", "nullable": true, "description": "Zisk – medziročná zmena"}, "ebitda": {"type": "string", "nullable": true, "description": "EBITDA"}, "marza_zisku": {"type": "number", "nullable": true, "description": "Zisková marža"}, "marza_ebitda": {"type": "number", "nullable": true, "description": "EBITDA marža"}, "marza_prevadzkova": {"type": "number", "nullable": true, "description": "Prevádzková marža"}, "marza_ph": {"type": "number", "nullable": true, "description": "Marža pridanej hodnoty"}, "roa": {"type": "number", "nullable": true, "description": "Rentabilita aktív (ROA)"}, "roe": {"type": "number", "nullable": true, "description": "Rentabilita vlastného imania (ROE)"}, "likvidita_1": {"type": "number", "nullable": true, "description": "Pohotová likvidita (1. stupňa)"}, "likvidita_2": {"type": "number", "nullable": true, "description": "Bežná likvidita (2. stupňa)"}, "likvidita_3": {"type": "number", "nullable": true, "description": "Celková likvidita (3. stupňa)"}, "pracovny_kapital": {"type": "string", "nullable": true, "description": "Čistý pracovný kapitál"}, "aktiva": {"type": "string", "nullable": true, "description": "Aktíva spolu"}, "vlastne_imanie": {"type": "string", "nullable": true, "description": "Vlastné imanie"}, "zavazky": {"type": "string", "nullable": true, "description": "Záväzky"}, "zadlzenost": {"type": "number", "nullable": true, "description": "Celková zadlženosť"}, "podiel_vi": {"type": "number", "nullable": true, "description": "Podiel vlastného imania"}, "vi_k_zavazkom": {"type": "number", "nullable": true, "description": "Vlastné imanie k záväzkom"}, "uvery_k_ebitda": {"type": "number", "nullable": true, "description": "Bankové úvery k EBITDA"}, "urokove_krytie": {"type": "number", "nullable": true, "description": "Úrokové krytie"}, "obrat_aktiv": {"type": "number", "nullable": true, "description": "Obrat aktív"}, "doba_zasob": {"type": "number", "nullable": true, "description": "Doba obratu zásob"}, "osobne_k_ph": {"type": "number", "nullable": true, "description": "Osobné náklady k pridanej hodnote"}, "danova_sadzba": {"type": "number", "nullable": true, "description": "Efektívna daňová sadzba"}, "ebitda_odhad": {"type": "string", "nullable": true, "description": "Odhad EBITDA pri spojených odpisoch a opravných položkách."}, "ebit": {"type": "string", "nullable": true, "description": "Výsledok pred zdanením + nákladové úroky."}, "hruba_marza_tovaru": {"type": "number", "nullable": true, "description": "(Tržby z predaja tovaru − obstarávacie náklady predaného tovaru) / tržby z predaja tovaru. Len predaj tovaru."}, "marza_ebit": {"type": "number", "nullable": true, "description": "EBIT / tržby."}, "vynosy_k_aktivam": {"type": "number", "nullable": true, "description": "Celkové výnosy / aktíva na konci obdobia. Ukazovateľ obratu aktív podľa výnosov."}}, "required": ["trzby", "trzby_zmena", "vynosy", "pridana_hodnota", "zisk", "zisk_zmena", "ebitda", "marza_zisku", "marza_ebitda", "marza_prevadzkova", "marza_ph", "roa", "roe", "likvidita_1", "likvidita_2", "likvidita_3", "pracovny_kapital", "aktiva", "vlastne_imanie", "zavazky", "zadlzenost", "podiel_vi", "vi_k_zavazkom", "uvery_k_ebitda", "urokove_krytie", "obrat_aktiv", "doba_zasob", "osobne_k_ph", "danova_sadzba", "ebitda_odhad"]}, "ebitda_stav": {"type": "string", "enum": ["vypocitana", "odhad", "nedostupna"]}, "ebitda_chybajuce_vstupy": {"type": "array", "items": {"type": "string"}}, "vykazy": {"type": "array", "items": {"type": "object", "properties": {"id": {"type": "integer"}, "tabulky": {"type": "array", "items": {"type": "string"}}, "url": {"type": "string", "format": "uri"}}, "required": ["id", "tabulky", "url"]}}, "detaily": {"type": "object", "additionalProperties": {"type": "string", "format": "uri"}, "description": "API odkazy na závierky a výkazy pre tento rok."}, "riadky_hodnot": {"type": "object", "additionalProperties": {"type": "object", "properties": {"vykaz_id": {"type": "integer"}, "sablona": {"type": "integer"}, "tabulka": {"type": "string"}, "riadok": {"type": "integer"}}, "required": ["vykaz_id", "sablona", "tabulka", "riadok"]}}, "kategoria_obratu": {"type": "object", "properties": {"kod": {"type": "string"}, "nazov": {"type": "string"}, "od_vratane": {"type": "string", "nullable": true, "description": "Desatinný reťazec v EUR. Null označuje chýbajúcu hodnotu."}, "do_vylucne": {"type": "string", "nullable": true, "description": "Desatinný reťazec v EUR. Null označuje chýbajúcu hodnotu."}, "zaklad": {"type": "string", "enum": ["cisty_obrat", "trzby", "vynosy"]}, "hodnota": {"type": "string", "nullable": true, "description": "Desatinný reťazec v EUR. Null označuje chýbajúcu hodnotu."}}, "required": ["kod", "nazov", "od_vratane", "do_vylucne", "zaklad", "hodnota"], "nullable": true, "description": "Pásma KAUZIS. Prednosť má vykázaný čistý obrat vrátane nuly, potom tržby. Pri chýbajúcich tržbách použijeme výnosy."}, "kreditne_modely": {"type": "object", "properties": {"altman_z": {"$ref": "#/components/schemas/KreditnyModel"}, "in05": {"$ref": "#/components/schemas/KreditnyModel"}}, "required": ["altman_z", "in05"]}}, "required": ["rok", "obdobie_od", "obdobie_do", "porovnavaci_stlpec", "konsolidovana", "zavierka_id", "zavierka_url", "hodnoty", "ukazovatele", "ebitda_stav", "ebitda_chybajuce_vstupy", "vykazy", "detaily"]}, "KreditnyModel": {"type": "object", "properties": {"variant": {"type": "string"}, "hodnota": {"type": "number", "nullable": true}, "stav": {"type": "string", "enum": ["vypocitany", "nevhodny_vykaz", "nesulad_vykazu", "nepotvrdene_rocne_obdobie", "neoverene_odvetvie_obdobia", "mimo_odvetvia", "chybajuce_vstupy", "nekladny_menovatel"]}, "chybajuce_vstupy": {"type": "array", "items": {"type": "string"}}, "neplatne_vstupy": {"type": "array", "items": {"type": "string"}}}, "required": ["variant", "hodnota", "stav", "chybajuce_vstupy", "neplatne_vstupy"]}, "UctovnaZavierka": {"type": "object", "properties": {"rok": {"type": "integer", "nullable": true}, "zavierka_id": {"type": "integer"}, "zavierka_url": {"type": "string", "format": "uri"}, "obdobie_od": {"type": "string", "nullable": true, "format": "date"}, "obdobie_do": {"type": "string", "nullable": true, "format": "date"}, "typ": {"type": "string"}, "typ_nazov": {"type": "string"}, "konsolidovana": {"type": "boolean"}, "vykazy": {"type": "array", "items": {"type": "object", "properties": {"id": {"type": "integer"}, "sablona": {"type": "integer", "nullable": true}, "pristupnost": {"type": "string"}, "url": {"type": "string", "format": "uri"}}, "required": ["id", "sablona", "pristupnost", "url"]}}, "detaily": {"type": "object", "additionalProperties": {"type": "string", "format": "uri"}, "description": "Odkazy na výkazy konkrétneho podania vrátane opravnej závierky."}}, "required": ["rok", "zavierka_id", "zavierka_url", "obdobie_od", "obdobie_do", "typ", "typ_nazov", "konsolidovana", "vykazy", "detaily"]}, "RiadokVykazu": {"type": "object", "properties": {"tabulka": {"type": "string"}, "cislo": {"type": "integer"}, "oznacenie": {"type": "string"}, "nazov": {"type": "string"}, "hodnota": {"type": "string", "nullable": true, "description": "Desatinný reťazec v EUR. Null označuje chýbajúcu hodnotu."}, "vykaz_id": {"type": "integer"}, "sablona": {"type": "integer"}, "url": {"type": "string", "format": "uri"}}, "required": ["tabulka", "cislo", "oznacenie", "nazov", "hodnota", "vykaz_id", "sablona", "url"]}, "PlnenieRozkazu": {"type": "object", "properties": {"stav": {"type": "string"}, "suma_vo_vyroku": {"type": "string", "nullable": true, "description": "Desatinný reťazec v EUR. Null označuje chýbajúcu hodnotu."}, "istina": {"type": "string", "nullable": true, "description": "Desatinný reťazec v EUR. Null označuje chýbajúcu hodnotu."}, "mena": {"type": "string", "nullable": true}, "strana_firmy": {"type": "string", "nullable": true}, "datum_rozkazu": {"type": "string", "nullable": true, "format": "date"}, "zdroj_url": {"type": "string", "format": "uri", "nullable": true}, "podklad": {"type": "string", "nullable": true}, "pravoplatnost": {"type": "string"}}, "required": ["stav", "suma_vo_vyroku", "istina", "mena", "strana_firmy", "datum_rozkazu", "zdroj_url", "podklad", "pravoplatnost"], "description": "Čiastka uložená konkrétnym výrokom. Istina je vyplnená iba pri výslovnom označení v rozhodnutí. Výrok sám nepreukazuje právoplatnosť ani nesplatený zostatok."}, "DetailFirmy": {"type": "object", "properties": {"ico": {"type": "string", "pattern": "^[0-9]{8}$", "description": "IČO vrátane úvodných núl."}, "krajina": {"type": "string", "enum": ["SK", "CZ"]}, "sekcia": {"type": "string", "enum": ["organizacne-jednotky", "financie", "suvaha", "vykaz-ziskov-a-strat", "uctovne-zavierky", "sudne-rozhodnutia", "platobne-rozkazy", "konkurzy-a-restrukturalizacie", "exekucie", "zmluvy-so-statom", "partner-verejneho-sektora", "nehnutelnosti", "podobne", "pravne-nastroje"]}, "strana": {"type": "integer"}, "limit": {"type": "integer"}, "stav": {"type": "string"}, "pocet": {"type": "integer", "nullable": true, "description": "Celkový počet. Pri nedokončenom pokrytí môže byť null."}, "results": {"type": "array", "items": {"type": "object"}}, "has_more": {"type": "boolean"}, "dalsia_url": {"type": "string", "format": "uri", "nullable": true}, "api_url": {"type": "string", "format": "uri"}, "url": {"type": "string", "format": "uri"}, "profil_api_url": {"type": "string", "format": "uri"}, "zdroje": {"type": "array", "items": {"$ref": "#/components/schemas/PouzityZdroj"}}, "upozornenie": {"type": "string"}}, "required": ["ico", "krajina", "sekcia", "strana", "limit", "stav", "pocet", "results", "has_more", "dalsia_url", "api_url", "url", "profil_api_url", "zdroje", "upozornenie"], "oneOf": [{"$ref": "#/components/schemas/DetailJednotiekRPO"}, {"type": "object", "properties": {"sekcia": {"type": "string", "enum": ["financie"]}, "results": {"type": "array", "items": {"$ref": "#/components/schemas/FinancnyRok"}}, "mena": {"type": "string", "enum": ["EUR"]}, "roky": {"type": "array", "items": {"type": "integer"}}, "jednotky_ukazovatelov": {"type": "object", "additionalProperties": {"type": "string"}}}, "required": ["sekcia", "results", "mena", "roky", "jednotky_ukazovatelov"]}, {"type": "object", "properties": {"sekcia": {"type": "string", "enum": ["uctovne-zavierky"]}, "results": {"type": "array", "items": {"$ref": "#/components/schemas/UctovnaZavierka"}}}, "required": ["sekcia", "results"]}, {"type": "object", "properties": {"sekcia": {"type": "string", "enum": ["suvaha", "vykaz-ziskov-a-strat"]}, "results": {"type": "array", "items": {"$ref": "#/components/schemas/RiadokVykazu"}}}, "required": ["sekcia", "results"]}, {"type": "object", "properties": {"sekcia": {"type": "string", "enum": ["platobne-rozkazy"]}, "results": {"type": "array", "items": {"type": "object", "properties": {"plnenie": {"$ref": "#/components/schemas/PlnenieRozkazu"}}, "required": ["plnenie"]}}}, "required": ["sekcia", "results"]}, {"type": "object", "properties": {"sekcia": {"type": "string", "enum": ["sudne-rozhodnutia", "konkurzy-a-restrukturalizacie", "exekucie", "zmluvy-so-statom", "partner-verejneho-sektora", "nehnutelnosti", "podobne", "pravne-nastroje"]}}, "required": ["sekcia"]}]}, "ProfilFirmy": {"type": "object", "properties": {"ico": {"type": "string", "pattern": "^[0-9]{8}$", "description": "IČO vrátane úvodných núl."}, "stare_ico": {"type": "string", "pattern": "^[0-9]{8}$", "description": "IČO vrátane úvodných núl."}, "krajina": {"type": "string", "enum": ["SK", "CZ"]}, "nazov": {"type": "string"}, "fo": {"type": "boolean", "nullable": true}, "aktivny": {"type": "boolean", "nullable": true}, "casti": {"type": "array", "items": {"type": "string"}}, "aktualne_k": {"type": "string", "nullable": true, "format": "date"}, "url": {"type": "string", "format": "uri"}, "api_url": {"type": "string", "format": "uri"}, "fakturacia": {"$ref": "#/components/schemas/Fakturacia"}, "charakteristika": {"$ref": "#/components/schemas/CharakteristikaFirmy"}, "detaily": {"type": "object", "additionalProperties": {"$ref": "#/components/schemas/OdkazNaDetail"}}, "detail": {"$ref": "#/components/schemas/DetailFirmy"}, "zdroje": {"type": "array", "items": {"$ref": "#/components/schemas/PouzityZdroj"}}, "upozornenie": {"type": "string"}, "osoby": {"$ref": "#/components/schemas/OsobyVoFirme"}, "register": {"type": "object", "properties": {"jednotky": {"$ref": "#/components/schemas/JednotkyVRegistri"}}}}, "required": ["ico", "krajina", "nazov", "fo", "aktivny", "casti", "aktualne_k", "url", "api_url", "zdroje", "upozornenie"]}}, "securitySchemes": {"UcetJWT": {"type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Prístupový token účtu z POST /api/auth/login/. Obnova cez POST /api/auth/token/refresh/."}}}, "x-typy-zmien": [{"typ": "novy_subjekt", "nazov": "Nový subjekt v registri", "zavaznost": "info"}, {"typ": "nazov", "nazov": "Zmena názvu", "zavaznost": "info"}, {"typ": "sidlo", "nazov": "Zmena sídla", "zavaznost": "info"}, {"typ": "forma", "nazov": "Zmena právnej formy", "zavaznost": "info"}, {"typ": "ico", "nazov": "Zmena IČO", "zavaznost": "info"}, {"typ": "imanie", "nazov": "Zmena základného imania", "zavaznost": "info"}, {"typ": "register", "nazov": "Zmena registrového súdu alebo čísla zápisu", "zavaznost": "info"}, {"typ": "nace", "nazov": "Zmena hlavnej činnosti (SK NACE)", "zavaznost": "info"}, {"typ": "zanik", "nazov": "Zánik subjektu", "zavaznost": "warning"}, {"typ": "zanik_zruseny", "nazov": "Zánik subjektu bol v registri zrušený", "zavaznost": "info"}, {"typ": "likvidacia", "nazov": "Vstup do likvidácie", "zavaznost": "warning"}, {"typ": "konkurz", "nazov": "Vyhlásenie konkurzu", "zavaznost": "critical"}, {"typ": "restrukturalizacia", "nazov": "Povolenie reštrukturalizácie", "zavaznost": "critical"}, {"typ": "vyrovnanie", "nazov": "Vyrovnanie", "zavaznost": "critical"}, {"typ": "nutena_sprava", "nazov": "Nútená správa", "zavaznost": "critical"}, {"typ": "zrusenie", "nazov": "Zrušenie subjektu", "zavaznost": "warning"}, {"typ": "stav", "nazov": "Nový právny stav", "zavaznost": "info"}, {"typ": "likvidacia_koniec", "nazov": "Ukončenie likvidácie", "zavaznost": "info"}, {"typ": "konkurz_koniec", "nazov": "Ukončenie konkurzu", "zavaznost": "info"}, {"typ": "restrukturalizacia_koniec", "nazov": "Ukončenie reštrukturalizácie", "zavaznost": "info"}, {"typ": "vyrovnanie_koniec", "nazov": "Ukončenie vyrovnania", "zavaznost": "info"}, {"typ": "nutena_sprava_koniec", "nazov": "Ukončenie nútenej správy", "zavaznost": "info"}, {"typ": "zrusenie_koniec", "nazov": "Právny stav „zrušená“ skončil", "zavaznost": "info"}, {"typ": "stav_koniec", "nazov": "Ukončenie právneho stavu", "zavaznost": "info"}, {"typ": "statutar_novy", "nazov": "Nový člen štatutárneho orgánu", "zavaznost": "info"}, {"typ": "statutar_koniec", "nazov": "Koniec funkcie v štatutárnom orgáne", "zavaznost": "info"}, {"typ": "spolocnik_novy", "nazov": "Nový spoločník / akcionár", "zavaznost": "info"}, {"typ": "spolocnik_koniec", "nazov": "Spoločník / akcionár vystúpil", "zavaznost": "info"}, {"typ": "dozorny_novy", "nazov": "Nový člen dozorného orgánu", "zavaznost": "info"}, {"typ": "dozorny_koniec", "nazov": "Koniec funkcie v dozornom orgáne", "zavaznost": "info"}, {"typ": "prokurista_novy", "nazov": "Nový prokurista", "zavaznost": "info"}, {"typ": "prokurista_koniec", "nazov": "Koniec prokúry", "zavaznost": "info"}, {"typ": "spravca_novy", "nazov": "Ustanovený likvidátor / správca", "zavaznost": "warning"}, {"typ": "spravca_koniec", "nazov": "Koniec funkcie likvidátora / správcu", "zavaznost": "info"}, {"typ": "zakladatel_novy", "nazov": "Nový zakladateľ / zriaďovateľ", "zavaznost": "info"}, {"typ": "zakladatel_koniec", "nazov": "Zakladateľ / zriaďovateľ vymazaný", "zavaznost": "info"}, {"typ": "osoba_nova", "nazov": "Nová zapísaná osoba", "zavaznost": "info"}, {"typ": "osoba_koniec", "nazov": "Zapísaná osoba vymazaná", "zavaznost": "info"}, {"typ": "dph_registracia", "nazov": "Registrácia pre DPH", "zavaznost": "info"}, {"typ": "dph_zmena", "nazov": "Zmena registrácie pre DPH", "zavaznost": "info"}, {"typ": "dph_zrusenie", "nazov": "Zrušenie registrácie pre DPH", "zavaznost": "warning"}, {"typ": "dph_dovody", "nazov": "Zaradenie do zoznamu platiteľov s dôvodmi na zrušenie registrácie DPH", "zavaznost": "warning"}, {"typ": "dph_dovody_koniec", "nazov": "Vyradenie zo zoznamu platiteľov s dôvodmi na zrušenie registrácie DPH", "zavaznost": "info"}, {"typ": "dph_dovody_vymaz", "nazov": "Výmaz zo zoznamu platiteľov s dôvodmi na zrušenie registrácie DPH", "zavaznost": "info"}, {"typ": "ids", "nazov": "Zmena indexu daňovej spoľahlivosti", "zavaznost": "info"}, {"typ": "dic", "nazov": "Zmena DIČ", "zavaznost": "info"}, {"typ": "dlznik_fs", "nazov": "Zaradenie do zoznamu daňových dlžníkov", "zavaznost": "warning"}, {"typ": "dlznik_fs_zmena", "nazov": "Zmena výšky daňového nedoplatku", "zavaznost": "info"}, {"typ": "dlznik_fs_koniec", "nazov": "Vyradenie zo zoznamu daňových dlžníkov", "zavaznost": "info"}, {"typ": "dlznik_sp", "nazov": "Zaradenie do zoznamu dlžníkov Sociálnej poisťovne", "zavaznost": "warning"}, {"typ": "dlznik_sp_zmena", "nazov": "Zmena dlžnej sumy v zozname dlžníkov Sociálnej poisťovne", "zavaznost": "info"}, {"typ": "dlznik_sp_koniec", "nazov": "Vyradenie zo zoznamu dlžníkov Sociálnej poisťovne", "zavaznost": "info"}, {"typ": "dlznik_zp", "nazov": "Zaradenie do zoznamu dlžníkov VšZP", "zavaznost": "warning"}, {"typ": "dlznik_zp_zmena", "nazov": "Zmena výšky pohľadávky v zozname dlžníkov VšZP", "zavaznost": "info"}, {"typ": "dlznik_zp_koniec", "nazov": "Vyradenie zo zoznamu dlžníkov VšZP", "zavaznost": "info"}, {"typ": "dlznik_stat", "nazov": "Splatná pohľadávka štátu v registri pohľadávok štátu", "zavaznost": "warning"}, {"typ": "dlznik_stat_zmena", "nazov": "Zmena istiny pohľadávky štátu", "zavaznost": "info"}, {"typ": "dlznik_stat_koniec", "nazov": "Pohľadávka štátu už v registri nie je", "zavaznost": "info"}, {"typ": "exekucia_poverenie", "nazov": "Poverenie na vykonanie exekúcie", "zavaznost": "warning"}, {"typ": "exekucia_zmena", "nazov": "Zmena poverenia na vykonanie exekúcie", "zavaznost": "info"}, {"typ": "exekucia_koniec", "nazov": "Poverenie na vykonanie exekúcie už register neuvádza", "zavaznost": "info"}, {"typ": "konkurz_navrh", "nazov": "Začaté konkurzné konanie (návrh na vyhlásenie konkurzu)", "zavaznost": "warning"}, {"typ": "konkurz_vyhlaseny", "nazov": "Vyhlásený konkurz podľa registra úpadcov", "zavaznost": "critical"}, {"typ": "restrukturalizacia_navrh", "nazov": "Začaté reštrukturalizačné konanie (návrh na povolenie reštrukturalizácie)", "zavaznost": "warning"}, {"typ": "restrukturalizacia_povolena", "nazov": "Povolená reštrukturalizácia podľa registra úpadcov", "zavaznost": "critical"}, {"typ": "preventivna_restrukturalizacia", "nazov": "Verejná preventívna reštrukturalizácia", "zavaznost": "warning"}, {"typ": "likvidacia_register", "nazov": "Likvidácia – záznam v registri úpadcov", "zavaznost": "warning"}, {"typ": "upadok_konanie", "nazov": "Iné konanie v registri úpadcov", "zavaznost": "info"}, {"typ": "upadok_skoncene", "nazov": "Skončené konanie v registri úpadcov", "zavaznost": "info"}, {"typ": "upadok_zastavene", "nazov": "Zastavené konanie v registri úpadcov", "zavaznost": "info"}, {"typ": "upadok_vyradene", "nazov": "Konanie register úpadcov pri subjekte už neuvádza", "zavaznost": "info"}]}