loader Načítavam ...

RÚZ Open API, verzia 2.0

Obsah:

Úvod

Verejné RÚZ Open API poskytuje možnosť získať verejne dostupné údaje (t.j. všetko, čo je poskytované portálom registeruz.sk) v podobe vhodnej na spracovanie, konkrétne vo formáte JSON. Konceptuálny dátový model API je znázornený na nasledujúcom obrázku:

Open API JSON model

Služby je moné rozdeliť do troch skupín:

  • zoznamy identifikátorov - slúžia na stiahnutie identifikátorov pre jednotlivé typy údajov, tieto sa následne použijú na prístup k detailom
  • detail entity - obsahuje detailné atribúty entity pre daný identifikátor
  • číselníky - zoznamy číselníkových údajov, ktorých zdrojom je ŠÚSR

Spôsob poskytovania údajov

  • Všetky dátumy sú textové reťazce formátované v súlade s ISO 8601 ako RRRR-MM-DD.
  • Obdobia uvedené na titulnej strane výkazu sú textové reťazce formátované v súlade s ISO 8601 ako RRRR-MM.
  • Všetky odkazy na číselníkové hodnoty sa udávajú pomocou kódu danej položky (viac viď Číselníky).
  • Atribúty bez hodnoty (s hodnotou null) nie sú zahrnuté do odpovede. Toto platí pre jednoduché atribúty, aj pre zoznamy. Napr. ak účtovná jednotka neobsahuje
    idUctovnychZavierok
    , znamená to, že pre ňu nie sú evidované žiadne závierky (alebo nie sú verejne dostupné, viď FAQ).
  • Ak je požiadavka nesprávne formulovaná (chýbajúce alebo nesprávne formátované parametre), bude vrátený kód HTTP 400 Bad Request. Telo odpovede môže obsahovať vysvetlenie.
  • Ak neexistuje konkrétny požadovaný údaj (neexistujúce id), bude vrátený kód HTTP 404 Not Found.
  • Údaj
    datumPoslednejUpravy
    (používaný pre dopytovanie podľa
    zmenene-od
    ) sa týka len konkrétnej entity a nie jej logických väzieb. Príklad: Ak pribudne nová závierka, ale účtovná jednotka nie je zmenená, prejaví sa to v zozname zmenených závierok (pribudne nové id), nie v zozname jednotiek zmenených od daného dátumu. Toto nie je nijako ovplyvnené faktom, že v detaile účtovnej jednotky dané id závierky pribudne do zoznamu jej závierok (toto nie je považované za zmenu atribútu účtovnej jednotky). Toto platí pre všetky vzťahy na úrovni objektov uvedených na obrázku vyššie.
  • Pre zoznamy, kde sa zadáva
    zmenene-od
    , platí, že budú získané všetky údaje (postupne po stránkach v poradí podľa id), ktoré boli zmenené buď v daný deň alebo kedykoľvek neskôr (t.j. zmenene-od vrátane).
  • Verzia API sa objavuje v HTTP hlavičke "X-API-Version" (napr. "X-API-Version: 1.2"), z JSONu bol vypustený atribút verziaApi.

Odporúčaný spôsob postupného sťahovania

  • Pri prvom sťahovaní údajov je možné získať všetky údaje zadaním dostatočne dávneho dátumu pre
    zmenene-od
    , napríklad:
    zmenene-od=2000-01-01

    Je dôležité poznačiť si dátum, kedy bolo začaté získavanie údajov, ktoré môže trvať aj viac dní - nech je to napr. 2014-02-14.
  • Pri opakovanom sťahovaní údajov stačí získať iba záznamy, pre ktoré sa niečo zmenilo. Použije sa teda dopyt s
    zmenene-od=2014-02-14
    (príklad z predchádzajúceho bodu). Opäť je nutné si poznačiť dátum, kedy sa začlo so sťahovaním aktualizácií (napr. 2014-03-08). Tento sa použije v ďalšom cykle aktualizácie dát.
  • Je na implementácii sťahovacieho mechanizmu, či si bude zaznamenávať jeden spoločný dátum začiatku sťahovania údajov pre všetky zoznamy, alebo per zoznam (zvlášť účtovné jednotky, zvlášť závierky, atď.).
  • Ak sa periodicky zaujímate o údaje k malému zoznamu účtovných jednotiek, najjednoduchšie je periodicky spraviť dopyt na dané účtovné jednotky podľa ich
    id
    (je možné si ich zapamätať, nikdy sa nemenia) a prejsť ich údaje do hĺbky (závierky, výkazy, výročné správy) a nájsť prípadné zmeny.

Mazanie údajov v RÚZ

  • Údaje v RÚZ typicky iba pribúdajú a nemali by byť mazané, z technických príčin sa tak ale stať môže.
  • Id danej entity sa objaví v zozname zmenených záznamov.
  • Po prístupe na detail danej entity sa vráti jej detail so skráteným zoznamom atribútov: id, datumPoslednejUpravy a stav
    {"id":316853,"datumPoslednejUpravy":"2013-08-21","stav":"ZMAZANÉ"}
  • Vždy platí, že ak je zmazaná entita, sú zmazané aj všetky jej podúdaje (napr. pri zmazaní závierky sú zmazané aj všetky výkazy). Na identifikátory podúdajov nie je možné pristúpiť cez detail zmazanej entity, ale objavia sa v zozname zmenených entít daného typu (v našom príklade v zozname účtovných výkazov).
  • Zmazanie výkazu nespôsobí nastavenie dátumu zmeny účtovnej závierky, podobne zmazanie závierky nenastaví zmenu účtovnej jednotky, napriek tomu, že zmazané identifikátory budú chýbať v detailoch týchto inak nezmenených údajov.
  • Zmazanie príloh výkazu spôsobuje nastavenie zmeny účtovného výkazu, v ktorého detaile zmazaná príloha bude chýbať. Pri pokuse priamo stiahnúť zmazanú prílohu systém vráti HTTP 404.
  • Šablóny výkazov nikdy nie sú mazané.
  • Vo výnimočných prípadoch sa môže stať, že údaj zmizne z verejnej časti (a teda aj z Open API) bez stopy. Tieto prípady nie je možné technicky vylúčiť, ale je snaha ich výskyt minimalizovať.

Iné poznámky

  • Prílohy výkazov sú sprístupňované mimo API cez URL zhodnú so samotnou web aplikáciou, konkrétne /domain/financialreport/attachment/id-prilohy. Zoznam id príloh je uvedený v detaile reportu (/api/uctovny-vykaz), ak nejaké prílohy obsahuje.
  • V aplikácii je možné stiahnúť aj PDF podobu štruktúrovaných dát pomocou URL /domain/financialreport/pdf/id-vykazu. Ide o vygenerované PDF, ktoré je z pohľadu dátového obsahu zhodné so samotným detailom výkazu cez API. Táto URL je z pohľadu API bezvýznamná. (Tento fakt uvádzame len preto, aby konzument API nesťahoval tieto generované PDF v presvedčení, že obsahujú nejaké dáta navyše. Ide len o vizualizáciu dát v PDF formáte.)

Služby pre zoznam identifikátorov

Zoznam parametrov:

Všetky služby pre zoznam identifikátorov maju spoločné nasledovné parametre:

  • zmenene-od
    - povinný parameter, vráti zoznam identifikátorov, ktoré boli zmenené v daný dátum alebo neskôr.
  • pokracovat-za-id
    - nepovinný parameter, vráti zoznam identifikátorov, ktoré sú väčšie ako zadaný identifikátor.
  • max-zaznamov
    - nepovinný parameter, vráti uvedený počet záznamov, maximálne 10000. Prednastavený počet je 1000.

Služba pre zoznam identifikátorov účtovných jednotiek /api/uctovne-jednotky ako jediná navyše umožňuje použitie nasledovných parametrov:

  • ico
    - nepovinný parameter
  • dic
    - nepovinný parameter
  • pravna-forma
    - nepovinný parameter, kód právnej formy (viď Číselníky)

Príklad dopytu:

/api/uctovne-jednotky?zmenene-od=2000-01-01&pokracovat-za-id=1&max-zaznamov=100&ico=17319617&pravna-forma=701

Formát odpovede:

Formát odpovede je jednotný pre všetky dopyty na zoznamy identifikátorov.

  • id
    - zoznam identifikátorov, ktoré spĺňajú zadané kritériá. Identifikátor je celé číslo, maximálne desaťciferné.
  • pocetZostavajucichId
    - počet zostávajúcich identifikátorov, ktoré tiež spĺňajú zadané kritériá a nie sú zobrazené na stránke. Celé číslo prakticky neobmedzenej veľkosti.

Služba vráti požadovaný (alebo prednastavený) počet záznamov v poradí podľa id, pričom ak je pocetZostavajucichId nenulový, je možné získať ďalšiu stránku zoznamu opakovaním dopytu s uvedením pokracovat-za-id=xxx, kde xxx je posledný identifikátor z obdržaného zoznamu.

Príklad výstupu:

{"id":[1001,7148,8221,8222,8223,9911,12700],"pocetZostavajucichId":10}

URL služieb pre zoznamy identifikátorov:


Služby pre detaily

Tieto služby vrátia detaily jednej entity, pričom všetky majú len jeden povinný parameter:

  • id
    - identifikátor danej entity (účtovnej jednotky, účtovnej závierky, ...). Identifikátor je celé číslo, maximálne desaťciferné.

Účtovná jednotka

Url: /api/uctovna-jednotka

Formát výstupu:

  • id
    - identifikátor účtovnej jednotky, maximálne desaťciferné celé číslo
  • ico
    - IČO účtovnej jednotky, osemznakový textový reťazec
  • dic
    - DIČ účtovnej jednotky, desaťznakový textový reťazec
  • sid
    - SID účtovnej jednotky, najviac päťznakový textový reťazec
  • nazovUJ
    - názov účtovnej jednotky, textový reťazec s maximálnou dĺžkou 500 znakov
  • mesto
    - adresa účtovnej jednotky, mesto, textový reťazec s maximálnou dĺžkou 200 znakov
  • ulica
    - adresa účtovnej jednotky, ulica s číslom, textový reťazec s maximálnou dĺžkou 200 znakov
  • psc
    - adresa účtovnej jednotky, PSČ, textový reťazec s maximálnou dĺžkou 10 znakov
  • datumZalozenia
    - dátum založenia účtovnej jednotky, formát RRRR-MM-DD
  • datumZrusenia
    - dátum zrušenia účtovnej jednotky, formát RRRR-MM-DD
  • pravnaForma
    - kód právnej formy (viď Číselníky), textový reťazec s maximálnou dĺžkou 100 znakov
  • skNace
    - kód SK NACE klasifikácie (viď Číselníky), textový reťazec s maximálnou dĺžkou 100 znakov
  • velkostOrganizacie
    - kód kategórie veľkosti organizácie (viď Číselníky), textový reťazec s maximálnou dĺžkou 100 znakov
  • druhVlastnictva
    - kód druhu vlastníctva (viď Číselníky), textový reťazec s maximálnou dĺžkou 100 znakov
  • kraj
    - sídlo účtovnej jednotky, kód kraja (viď Číselníky), textový reťazec s maximálnou dĺžkou 100 znakov
  • okres
    - sídlo účtovnej jednotky, kód okresu (viď Číselníky), textový reťazec s maximálnou dĺžkou 100 znakov
  • sidlo
    - sídlo účtovnej jednotky, kód obce alebo mesta (viď Číselníky), textový reťazec s maximálnou dĺžkou 100 znakov
  • konsolidovana
    - boolean príznak - true, ak jednotka obsahuje aspoň jednu konsolidovanú účtovnú závierku
  • idUctovnychZavierok
    - zoznam identifikátorov všetkých súvisiacich účtovných závierok, identifikátor je maximálne desaťciferné celé číslo
  • idVyrocnychSprav
    - zoznam identifikátory všetkých súvisiacich výročných správ, identifikátor je maximálne desaťciferné celé číslo
  • zdrojDat
    - kód zdroja, z ktorého pochádzajú dáta (viď Zdroje dát), textový reťazec s maximálnou dĺžkou 30 znakov
  • datumPoslednejUpravy
    - dátum poslednej úpravy, formát RRRR-MM-DD

Príklad výstupu:

{
 "id":336953,"skNace":"84110","konsolidovana":true,"ico":"00603481","dic":"2020372596",
 "nazovUJ":"Hlavné mesto Slovenskej republiky Bratislava", "mesto":"Bratislava - mestská časť Staré Mesto",
 "ulica":"Primaciálne námestie 1","psc":"81499","datumPoslednejUpravy":"2012-11-14", "datumZalozenia":"1991-01-01",
 "pravnaForma":"801","velkostOrganizacie":"25","druhVlastnictva":"5","kraj":"1","okres":"SK0101", "sidlo":"528595",
 "zdrojDat":"ŠÚSR","idUctovnychZavierok":[340867,497509,1100864,726508,727630,1296603]
}

Účtovná závierka

Url: /api/uctovna-zavierka

Formát výstupu:

  • id
    - identifikátor účtovnej závierky, maximálne desaťciferné celé číslo
  • obdobieOd
    - účtovná závierka za obdobie - od, formát RRRR-MM
  • obdobieDo
    - účtovná závierka za obdobie - do, formát RRRR-MM
  • datumPodania
    - dátum podania účtovnej závierky (napr. evidencia na FRSR), formát RRRR-MM-DD
  • datumZostavenia
    - dátum, kedy bola závierka zostavená, formát RRRR-MM-DD
  • datumSchvalenia
    - dátum, kedy bola závierka schválená, formát RRRR-MM-DD
  • datumZostaveniaK
    - dátum, ku ktorému bola závierka zostavená, formát RRRR-MM-DD
  • datumPrilozeniaSpravyAuditora
    - dátum priloženia správy audítora, formát RRRR-MM-DD
  • nazovUJ
    - názov účtovnej jednotky v čase podania závierky, textový reťazec s maximálnou dĺžkou 500 znakov
  • ico
    - IČO účtovnej jednotky v čase podania závierky, osemznakový textový reťazec
  • dic
    - DIČ účtovnej jednotky v čase podania závierky, desaťznakový textový reťazec
  • nazovFondu
    - názov fondu, za ktorý bola závierka predložená (v prípade že sa jedná o účtovnú závierku fondu), textový reťazec s maximálnou dĺžkou 500 znakov
  • leiKod
    - LEI kód, pod ktorým bola závierka predložená, textový reťazec s dĺžkou 20 znakov
  • idUJ
    - identifikátor účtovnej jednotky, maximálne desaťciferné celé číslo
  • konsolidovana
    - boolean príznak - true, ak ide o konsolidovanú závierku
  • konsolidovanaZavierkaUstrednejStatnejSpravy
    - boolean príznak - true, ak ide o konsolidovanú závierku ústrednej štátnej správy
  • suhrnnaUctovnaZavierkaVerejnejSpravy
    - boolean príznak - true, ak ide o súhrnnú účtovnú závierku verejnej správy
  • typ
    - "Riadna", "Mimoriadna", "Priebežná" alebo "Kombinovaná" (riadna aj mimoriadna)
  • idUctovnychVykazov
    - zoznam identifikátorov všetkých súvisiacich účtovných výkazov, identifikátor je maximálne desaťciferné celé číslo
  • zdrojDat
    - kód zdroja, z ktorého pochádzajú dáta (viď Zdroje dát), textový reťazec s maximálnou dĺžkou 30 znakov
  • datumPoslednejUpravy
    - dátum poslednej úpravy, formát RRRR-MM-DD

Príklad výstupu:

{
 "id":340867,"nazovUJ":"Hlavné mesto Slovenskej republiky Bratislava","datumPoslednejUpravy":"2011-12-08","zdrojDat":"FRSR",
 "obdobieOd":"2009-01", "obdobieDo":"2009-12","ico":"00603481","dic":"2020372596","idUJ":336953,"konsolidovana":false,"typ":"Riadna",
 "idUctovnychVykazov":[686260,680247]
}

Účtovný výkaz

Url: /api/uctovny-vykaz

Formát výstupu:

  • id
    - identifikátor účtovného výkazu, maximálne desaťciferné celé číslo
  • idUctovnejZavierky
    - identifikátor účtovnej závierky, ku ktorej výkaz patrí (ak patrí k výročnej správe, tento element sa vo výkaze nenachádza), maximálne desaťciferné celé číslo
  • idVyrocnejSpravy
    - identifikátor výročnej správy, ku ktorej výkaz patrí (ak patrí k účtovnej závierke, tento element sa vo výkaze nenachádza), maximálne desaťciferné celé číslo
  • idSablony
    - identifikátor zodpovedajúcej šablóny, maximálne desaťciferné celé číslo
  • mena
    - mena výkazu (celé eurá, tisíce, ...), najviac deväťznakový textový reťazec
  • kodDanovehoUradu
    - kód daňového úradu, najviac trojznakový textový reťazec
  • prilohy
    - pole súvisiacich príloh, príloha je objekt zložený z atribútov:
    • id
      - identifikátor prílohy, maximálne desaťciferné celé číslo - následne je možné samotnú prílohu stiahnúť cez /domain/financialreport/attachment/id-prilohy
    • meno
      - meno prílohy, textový reťazec s maximálnou dĺžkou 100 znakov
    • mimeType
      - typ prílohy, textový reťazec s maximálnou dĺžkou 80 znakov
    • velkostPrilohy
      - veľkosť prílohy, celé číslo prakticky neobmedzenej veľkosti
    • pocetStran
      - počet strán výkazu, maximálne šesťciferné celé číslo
    • digest
      - výťah (hash) obsahu prílohy, algoritmus SHA-256, textový reťazec s dĺžkou 64 znakov
    • jazyk
      - jazyk prílohy, najviac trojznakový textový reťazec
  • obsah
    - dátový obsah výkazu pozostávajúci z:
    • titulnaStrana
      - titulná strana výkazu (krycí list) s identifikačnými údajmi. Všetky údaje z titulnej strany sú získavané z externých systémov. V systéme RÚZ sú ukladané ako textové reťazce bez ohraničenia dĺžky. Pri obdobiach a dátumoch ide o reťazce, kde je zaručený formát RRRR-MM, resp. RRRR-MM-DD.
      Objekt
      titulnaStrana
      je zložený z nasledovných atribútov:
      • nazovUctovnejJednotky
        - názov účtovnej jednotky
      • ico
        - IČO účtovnej jednotky
      • dic
        - DIČ účtovnej jednotky
      • sid
        - SID účtovnej jednotky
      • adresa
        - adresa účtovnej jednotky, objekt zložený z atribútov:
        • ulica
          - ulica
        • cislo
          - číslo
        • psc
          - PSČ
        • mesto
          - mesto
      • miestoPodnikania
        - miesto podnikania účtovnej jednotky, objekt zložený z atribútov:
        • ulica
          - ulica
        • cislo
          - číslo
        • psc
          - PSČ
        • mesto
          - mesto
      • pravnaForma
        - kód právnej formy (viď Číselníky)
      • skNace
        - kód SK NACE klasifikácie (viď Číselníky)
      • typZavierky
        - "Riadna", "Mimoriadna", alebo "Kombinovaná" (riadna aj mimoriadna)
      • konsolidovana
        - boolean príznak - true, ak ide o konsolidovanú závierku
      • konsolidovanaZavierkaUstrednejStatnejSpravy
        - boolean príznak - true, ak ide o konsolidovanú závierku ústrednej štátnej správy
      • suhrnnaUctovnaZavierkaVerejnejSpravy
        - boolean príznak - true, ak ide o súhrnnú účtovnú závierku verejnej správy
      • typUctovnejJednotky
        - "malá", "veľká"
      • oznacenieObchodnehoRegistra
        - označenie obchodného registra a číslo zápisu obchodnej spoločnosti
      • nazovSpravcovskehoFondu
        - názov správcovskej spoločnosti/fondu (vyplnené len v prípade účtovného výkazu fondu)
      • leiKod
        - LEI kód (vyplnené len v prípade účtovného výkazu fondu)
      • obdobieOd
        - účtovný výkaz za obdobie od, formát RRRR-MM
      • obdobieDo
        - účtovný výkaz za obdobie do, formát RRRR-MM
      • predchadzajuceObdobieOd
        - účtovný výkaz za predchádzajúce obdobie od, formát RRRR-MM
      • predchadzajuceObdobieDo
        - účtovný výkaz za obdobie predchádzajúce do, formát RRRR-MM
      • datumVyplnenia
        - dátum vyplnenia účtovného výkazu, formát RRRR-MM-DD
      • datumSchvalenia
        - dátum schválenia účtovného výkazu, formát RRRR-MM-DD
      • datumZostavenia
        - dátum zostavenia účtovného výkazu, formát RRRR-MM-DD
      • datumZostaveniaK
        - dátum zostavenia k účtovného výkazu, formát RRRR-MM-DD
      • datumPrilozeniaSpravyAuditora
        - dátum priloženia správy audítora, formát RRRR-MM-DD
    • tabulky
      - zoznam tabuliek obsahujúcich číselné údaje:
      • nazov
        - názov tabuľky (napríklad "Súvaha"), textový reťazec s maximálnou dĺžkou 100 znakov
      • data
        - číselné údaje z tabuliek výkazu, čítané po riadkoch zľava doprava, číselný údaj je textový reťazec ľubovoľnej dĺžky, maxímalne však 30 ciferné a 4 desatinné miesta. Oddeľovač desatinných miest je bodka.
  • zdrojDat
    - kód zdroja, z ktorého pochádzajú dáta (viď Zdroje dát), textový reťazec s maximálnou dĺžkou 30 znakov
  • datumPoslednejUpravy
    - dátum poslednej úpravy, formát RRRR-MM-DD

V krycom liste pre dátove typy ENTITY_LEGAL_FORM, ENTITY_SK_NACE, ENTITY_ORGANIZATION_SIZE a ENTITY_OWNERSHIP hodnoty predstavujú kódy z čísleníka Klasifikácií a pre dátove typy ENTITY_DOMICILE, ENTITY_COUNTY, ENTITY_DISTRICT hodnoty predstavujú kódy z číselníka Lokácie. Služby pre oba čísleníky sú spomenuté nižšie v dokumentácii.

Príklad výstupu:

        {
           "id":686260,
           "datumPoslednejUpravy":"2013-07-31",
           "zdrojDat":"DataCentrum",
           "idUctovnejZavierky":340867,
           "idSablony":98,
           "obsah":{
              "titulnaStrana":{
                 "ico":"00603481",
                 "obdobieOd":"2009-01",
                 "obdobieDo":"2009-12",
                 "nazovUctovnejJednotky":"Hlavné mesto Slovenskej republiky Bratislava",
                 "adresa":{
                    "ulica":"Primaciálne námestie 1",
                    "psc":"94131",
                    "mesto":"Bratislava - mestská časť Staré Mesto"
                 },
                 "typZavierky":"Riadna"
              },
              "tabulky":[
                 {
                    "nazov":"Náklady",
                    "data":[
                       "4248919",
                       "17058",
        //... kratene
                       "145116521",
                       "216375501"
                    ]
                 },
                 {
                    "nazov":"Výnosy",
                    "data":[
                       "12222937",
                       "425982",
        //... kratene
                       "130597430",
                       "51660772"
                    ]
                 }
              ]
           },
           "prilohy":[
              {
                 "id":214469,
                 "digest":"5c4db0a4b4af7126fe1a48aa3f51fe8deae8be9d7f8b0526f92bb4a55eee9dc2",
                 "mimeType":"image/tiff",
                 "meno":"POD101_2022773060_IR_2009_617_2010_501653.TIF",
                 "velkostPrilohy":203499,
        	     "pocetStran":4
              }
           ],
        }
        

Výročná správa

Url: /api/vyrocna-sprava

Formát výstupu:

  • id
    - identifikátor výročnej správy, maximálne desaťciferné celé číslo
  • nazovUJ
    - názov účtovnej jednotky v čase podania výročnej správy, textový reťazec s maximálnou dĺžkou 500 znakov
  • typ
    - "Ročná finančná správa", "Individuálna výročná správa", "Konsolidovaná výročná správa" alebo "Súhrnná výročná správa SR"
  • nazovFondu
    - názov fondu, za ktorý bola výročná správa predložená (v prípade že sa jedná o výročnú správu fondu), textový reťazec s maximálnou dĺžkou 500 znakov
  • leiKod
    - LEI kód, pod ktorým bola výročná správa predložená, textový reťazec s dĺžkou 20 znakov
  • obdobieOd
    - výročná správa za obdobie - od, formát RRRR-MM
  • obdobieDo
    - výročná správa za obdobie - od, formát RRRR-MM
  • datumPodania
    - dátum podania výročnej správy (napr. evidencia na FRSR), formát RRRR-MM-DD
  • datumZostaveniaK
    - dátum, ku ktorému bola výročná správa zostavená, formát RRRR-MM-DD
  • prilohy
    - pole súvisiacich príloh zložené z atribútov:
    • id
      - identifikátor prílohy, maximálne desaťciferné celé číslo
    • meno
      - meno prílohy, textový reťazec s maximálnou dĺžkou 100 znakov
    • mimeType
      - typ prílohy, textový reťazec s maximálnou dĺžkou 80 znakov
    • velkostPrilohy
      - veľkosť prílohy, číselný údaj
    • digest
      - výťah (hash) obsahu prílohy, algoritmus SHA-256, textový reťazec s maximálnou dĺžkou 64 znakov
  • idUctovnychVykazov
    - zoznam identifikátorov všetkých súvisiacich účtovných výkazov, identifikátor je maximálne desaťciferné celé číslo
  • idUJ
    - identifikátor účtovnej jednotky, maximálne desaťciferné celé číslo
  • zdrojDat
    - kód zdroja, z ktorého pochádzajú dáta (viď Zdroje dát)
  • datumPoslednejUpravy
    - dátum poslednej úpravy, formát RRRR-MM-DD

Príklad výstupu:

{
 "id":316853,"nazovUJ":"Continental Matador Rubber, s.r.o.","datumPoslednejUpravy":"2013-08-21","zdrojDat":"FRSR",
 "obdobieOd":"2011-01","obdobieDo":"2011-12","datumPodania":"2013-01-01","idUJ":635004,"typ":"Individuálna výročná správa","rok":2011,
 "prilohy":[{"id":217769,"digest":"5c4db0a4b4af7126fe1a48aa3f51fe8deae8be9d7f8b0526f92bb4a55eee9dc2","mimeType":"image/tiff",
 "meno":"POD201_4045546120_IR_2011_617_2013_538566.TIF","velkostPrilohy":296519}]
}

Šablóna účtovného výkazu

Url: /api/sablona

Šablóna účtovného výkazu poskytovaná cez API definuje obsah tabuľkovej časti účtovného výkazu. Dáta z krycieho listu sú obsahom účtovného výkazu aj priamo s určením svojho významu.

Niektoré šablóny nekorešpondujú s oficiálnymi výkazmi a slúžia ako pseudošablóny pre ukladanie "finančných výkazov", ktoré nie je možné inak zaradiť. Príkladom je "výkaz", ktorý obsahuje iba jednu prílohu s kompletnou závierkou podľa IFRS štandardov. Takéto "výkazy" nemajú dostupné štruktúrované dáta.

Formát výstupu:

  • id
    - identifikátor šablóny výkazu, maximálne desaťciferné celé číslo
  • nazov
    - názov šablóny, textový reťazec s maximálnou dĺžkou 100 znakov
  • nariadenieMF
    - označenie nariadenia Ministerstva financií, v ktorom bol výkaz uvedený, textový reťazec s maximálnou dĺžkou 100 znakov
  • platneOd
    - platnosť výkazu od, formát RRRR-MM-DD
  • platneDo
    - platnosť výkazu do (môže byť neuvedená a výkaz môže byť aktualizovaný novším s rovnakým menom), formát RRRR-MM-DD
  • tabulky
    - zoznam údajov pozostávajúci z:
    • nazov
      - názov tabuľky, objekt kde kľúč je lokalizácia ("sk") a hodnota je textový reťazec
    • hlavicka
      - hlavička tabuľky pozostávajúca z údajov:
      • text
        - opis stĺpca, objekt kde kľúč je lokalizácia ("sk") a hodnota je textový reťazec
      • riadok
        - pozícia v hlavičke, celé číslo
      • stlpec
        - pozícia v hlavičke, celé číslo
      • sirkaStlpca
        - veľkosti bunky v stĺpcoch, číslo
      • vyskaRiadku
        - veľkosť bunky v riadkoch, číslo
    • riadky
      - riadok tabuľky pozostávajúci z:
      • oznacenie
        -
      • cisloRiadku
        - poradové číslo riadku
      • text
        - opis riadku, objekt kde kľúč je lokalizácia ("sk") a hodnota je textový reťazec

Príklad výstupu:

        {
           "id":7,
           "nazov":"Úč FO 1-01",
           "nariadenieMF":"MF/27076/1/2007-74/1",
           "platneOd":"2009-01-01",
           "tabulky":[
              {
                 "nazov":{
                    "sk":"Príjmy"
                 },
                 "hlavicka":[
                    {
                       "text":{
                          "sk":"Príjmy"
                       },
                       "riadok":1,
                       "stlpec":1,
                       "sirkaStlpca":1,
                       "vyskaRiadku":1
                    },
        //... kratene
                 ],
                 "riadky":[
                    {
                       "text":{
                          "sk":"Predaj tovaru"
                       },
                       "cisloRiadku":1
                    },
        //... kratene
                 ]
              },
              {
                 "nazov":{
                    "sk":"Výdavky"
                 },
                 "hlavicka":[
                    {
                       "text":{
                          "sk":"Výdavky"
                       },
                       "riadok":1,
                       "stlpec":1,
                       "sirkaStlpca":1,
                       "vyskaRiadku":1
                    },
        //... kratene
                 ],
                 "riadky":[
                    {
                       "text":{
                          "sk":"Nákup materiálu"
                       },
                       "cisloRiadku":5
                    },
        //... kratene
                 ]
              }
           ],
        }
        

Služby pre číselníky

Číselníky vychádzajú z údajov ŠÚSR dostupného na tejto adrese (platná k januáru 2017). Číselníky sa zobrazujú vždy celé, služby nevyžadujú žiadne parametre. Výstupom je pole objektov, ktoré obsahujú nasedovné atribúty:

  • kod
    - kód položky (pridelené ŠÚSR)
  • nazov
    - názov položky (krátka verzia názvu evidovaná v ŠÚSR)
  • nadradenaLokacia
    (len pre lokácie - obce, okresy) - kód nadradenej lokácie

URL služieb pre klasifikácie:

Príklad výstupu:

{"klasifikacie":[
    {"nazov":{"en":"Not ascertained yet","sk":"Zatiaľ nezistené"},"kod":"0"},{"nazov":{"en":"International with preponderance of public sector","sk":"Medzinárodné s prevažujúcim verejným sektorom"},"kod":"1"},
    {"nazov":{"en":"Private inland","sk":"Súkromné tuzemské"},"kod":"2"},{"nazov":{"en":"Cooperative-owned","sk":"Družstevné"},"kod":"3"},
    {"nazov":{"en":"State-owned","sk":"Štátne"},"kod":"4"},{"nazov":{"en":"Municipality-owned","sk":"Vlastníctvo územnej samosprávy"},"kod":"5"},
    {"nazov":{"en":"Ownership of associations, political parties and churches","sk":"Vlastníctvo združení, politických strán a cirkví"},"kod":"6"},
    {"nazov":{"en":"Foreign","sk":"Zahraničné"},"kod":"7"},{"nazov":{"en":"International with preponderance of private sector","sk":"Medzinárodné s prevažujúcim súkromným sektorom"},"kod":"8"},
    {"nazov":{"en":"Mixed (a combination of 1 through 8)","sk":"Zmiešané (kombinácia 1 až 8)"},"kod":"9"}
]}

URL služieb pre lokácie:

  • /api/kraje - zodpovedá ŠÚSR číselníku 0049/KRAJ96
  • /api/okresy - zodpovedá ŠÚSR číselníku 0048/OKRES96
  • /api/sidla - zodpovedá ŠÚSR číselníku 0051/ICZUJ

Príklad výstupu:

{"lokacie":[
    {"nazov":{"en":"Region of Bratislava","sk":"Bratislavský kraj"},"kod":"1"},{"nazov":{"en":"Region of Trnava","sk":"Trnavský kraj"},"kod":"2"},
    {"nazov":{"en":"Region of Trenčín","sk":"Trenčiansky kraj"},"kod":"3"},{"nazov":{"en":"Region of Nitra","sk":"Nitriansky kraj"},"kod":"4"},
    {"nazov":{"en":"Region of Žilina","sk":"Žilinský kraj"},"kod":"5"},{"nazov":{"en":"Reg.of Banská Bystrica","sk":"Banskobystrický kraj"},"kod":"6"},
    {"nazov":{"en":"Region of Prešov","sk":"Prešovský kraj"},"kod":"7"},{"nazov":{"en":"Region of Košice","sk":"Košický kraj"},"kod":"8"},
    {"nazov":{"en":"Abroad","sk":"Zahraničie"},"kod":"9"}
]}

Zdroje dát

Pre zdroje dát neexistuje služba, ide o nasledovný pevne daný zoznam (za pomlčkou je vysvetlenie, ktoré nie je súčasťou hodnoty v JSON odpovedi):

  • SUSR - Štatistický úrad Slovenskej republiky
  • SP - systém štátnej pokladnice
  • DC - DataCentrum
  • FRSR - Finančné riaditeľstvo Slovenskej republiky
  • JUS - Jednotné účtovníctvo štátu
  • OVSR - Obchodný vestník Slovenskej republiky
  • CKS - Centrálny konsolidačný systém
  • SAM - Rozpočtový informačný systém pre samosprávu

Licencia


Všetky dáta v rámci RÚZ Open API sú zverejňované pod licenciou CC0.

Zmeny vo verzii API

  • 1.1 (1.3.2014)
    • Pridaná podpora pre zmazané entity. Z dôvodu opravy chýb (duplicita ÚJ, závierok, apod.) môže dôjsť k zmazaniu údajov.
      Viac viď Mazanie údajov v RÚZ
    • Verzia API sa objavuje v HTTP hlavičke "X-API-Version" (napr. "X-API-Version: 1.2"), z JSONu bol vypustený atribút verziaApi.
  • 1.2 (5.6.2014)
    • Pridaná podpora pre konsolidované závierky za štátnu a verejnú správu vo forme boolean príznakov na závierke
      konsolidovanaZavierkaUstrednejStatnejSpravy
      a
      suhrnnaUctovnaZavierkaVerejnejSpravy
      . Tieto dva príznaky a príznak
      konsolidovana
      sa navzájom vylučujú a môže byť prítomný iba jeden z nich.
    • Zmena názvu krycieho listu na titulnú stranu v účtovnom výkaze a zjednodušenie jej reprezentácie.
  • 1.3 (18.5.2015)
    • Pridaná podpora pre ďalšie atribúty titulnej strany účtovného výkazu a to
      typUctovnejJednotky
      ,
      oznacenieObchodnehoRegistra
      ,
      nazovSpravcovskehoFondu
      a
      leiKod
      .
    • Pridaný nový zdroj dát - Rozpočtový informačný systém pre samosprávu.
  • 1.4 (13.8.2015)
    • Odstránenie podpory pre atribút
      krajina
      v účtovnej jednotke.
    • Pridaný nový atribút
      nazovFondu
      do detailu účtovnej závierky.
  • 1.5 (13.10.2015)
    • Pridaný nový typ výročnej správy - "Súhrnná výročná správa SR".
  • 1.6 (16.12.2015)
    • Pridaný nový atribút
      datumZostaveniaK
      do detailu účtovnej závierky.
    • V detaile účtovnej závierky v atribútoch
      obdobieOd
      a
      obdobieDo
      sa už neuvádza deň.
    • V detaile výročnej správy v atribútoch
      obdobieOd
      a
      obdobieDo
      sa už neuvádza deň.
  • 1.7 (15.2.2016)
    • Pridaný nový atribút
      leiKod
      do detailu účtovnej závierky.
    • Pridaný nový atribút
      leiKod
      do detailu výročnej správy.
    • Pridaný nový atribút
      nazovFondu
      do detailu výročnej správy.
  • 1.8 (9.6.2016)
    • Atribút
      jazyk
      presunutý v rámci detailu účtovného výkazu k atribútom v poli
      prílohy
  • 1.9 (23.2.2017)
    • Zdroje dát v atribúte
      zdrojDat
      v detaile účtovnej jednotky, detaile účtovnej závierky, detaile účtovného výkazu a detaile výročnej správy sú poskytované v skrátenom tvare viď Zdroje dát.
    • Pridaný nový atribút
      idUctovnychVykazov
      do detailu výročnej správy. Na výročné správy môžu byť naviazané dodatočné účtovné výkazy (Oznámenie o dátume schválenia, Správa audítora, Výkaz vybraných údajov)
    • Pridaný nový atribút
      datumZostaveniaK
      do detailu výročnej správy.
  • 2.0 (5.9.2017)
    • Pridaný nový atribút
      idVyrocnejSpravy
      do detailu účtovného výkazu. V prípade, že účtovný výkaz patrí k výročnej správe, je v detaile účtovného výkazu uvedené
      idVyrocnejSpravy
      a ak patrí účtovnej závierke tak
      idUctovnejZavierky
      .