BASH implementácia pre open api finančnej správy

Pre fungovanie je treba zaregistrovat sa a získať privátny kľúč na stránke finančnej správy.

Získanie autorizačného kľúča

1. Na stránke finančnej správy vyplníme kontaktné údaje
2. Kľúč príde mailom

Import autorizačného kľúča

Môžeme využiť súbor s názvom key do parent priečinku s ./config súborom alebo uložiť kľúč do premennej (export OAFS_KEY=[kľúč]).

Súbory

iz.sh

Vyhľadávanie v REST API pre OpenData FS Information Lists API.

Otvorenie helpu k cli:

./iz.sh --help

Zoznam všetkých dostupných informačných zoznamov z API (information lists):

./iz.sh -al | jq

Result:

• každý zoznam je identifkovaný podľa atribútu slug
• atribút searchable definuje vyhľadávacuie stĺpce

[
  {
    "name": "Zoznam subjektov registrovaných k DPH",      
    "slug": "ds_dphs",
    "url": "https://report.financnasprava.sk/ds_dphs.zip",
    "update_date": "2022-02-04 05:00:02",
    "searchable": [
      "ic_dph"
    ]
  },
  {
    "name": "Zoznam platiteľov dane z pridanej hodnoty, u ktorých nastali dôvody na zrušenie registrácie pre DPH",
    "slug": "ds_dphz",
    "url": "https://report.financnasprava.sk/ds_dphz.zip",
    "update_date": "2022-02-04 05:00:27",
    "searchable": [
      "ic_dph"
    ]
  },
  {
    "name": "Zoznam daňových dlžníkov",
    "slug": "ds_dsdd",
    "url": "https://report.financnasprava.sk/ds_dsdd.zip",
    "update_date": "2021-12-31 13:30:54",
    "searchable": [
      "nazov_subjektu"
    ]
  },
  {
    "name": "Zoznam platiteľov DPH s číslom účtu správcu dane vedeným pre daňový subjekt",
    "slug": "ds_dph_oud",
    "url": "https://report.financnasprava.sk/ds_dph_oud.zip",
    "update_date": "2022-02-04 05:05:02",
    "searchable": [
      "ic_dph"
    ]
  },
  {
    "name": "Zoznam platiteľov DPH s číslami bankových účtov, ktoré používajú na podnikanie",
    "slug": "ds_dph_iban",
    "url": "https://report.financnasprava.sk/ds_dph_iban.zip",
    "update_date": "2022-02-04 05:30:02",
    "searchable": [
      "ic_dph"
    ]
  }
]

Detail o zozname Zoznam platiteľov DPH s číslom účtu správcu dane vedeným pre daňový subjekt.

./iz.sh -l ds_dph_oud | jq

Result:

{
  "name": "Zoznam platiteľov DPH s číslom účtu správcu dane vedeným pre daňový subjekt",
  "slug": "ds_dph_oud",
  "url": "https://report.financnasprava.sk/ds_dph_oud.zip",
  "update_date": "2022-01-31 05:05:02",
  "searchable": [
    "ic_dph"
  ]
}

Získanie prvej strany všetkých daňových dlžníkov slug=ds_dsdd:

./iz.sh -d ds_dsdd

Result (aktuálne ich je 68 144 :O ):

{

   "page":1,
   "pages":69,
   "itemsCount":68144,
   "itemsPerPage":1000,
   "data":[
      ...
   ]
}

Vyhľadávanie v jednotlivých zoznamoch podľa atribútu slug=ds_dphs a stĺpca ic_dph s hodnotou SK2020317068. V zozname platitelov DPH nájdeme spoločnosť s ICDPH SK2020317068

# Nájdeme v zozname platitelov DPH všetkých podľa ic_dph SK2020317068
./iz.sh -d ds_dphs -s SK2020317068 -c ic_dph | jq

Result

{
  "page": 1,
  "pages": 1,
  "itemsCount": 1,
  "itemsPerPage": 1000,
  "data": [
    {
      "ic_dph": "SK2020317068",
      "ico": "31333532",
      "nazov_ds": "ESET, spol. s r.o.",
      "obec": "Bratislava - mestská časť Petržalka",
      "psc": "85101",
      "ulica_cislo": "Einsteinova 24",
      "stat": "Slovensko",
      "druh_reg_dph": "§4",
      "datum_reg": "11.10.2000",
      "datum_zmeny_druhu_reg": null
    }
  ]
}