Práce s aplikací Číselníky
Seznam číselníků
Aplikace slouží ke stahování aktuálně platných číselníkových datových souborů.
Ve výchozím stavu je zobrazen seznam všech číselníků.
Výsledný seznam lze zúžit v horní části pomocí rozbalovací nabídky Sada.
Seznam se zobrazuje ve formě tabulky se sloupci:
| Identifikátor | jednoznačný název číselníku |
| Verze | verze struktury číselníku |
| Stav | stav číselníku: A - aktivní, T - testovací |
| Popis | popis číselníku |
| Aktualizováno | datum poslední aktualizace |
| Platnost struktury | datum začátku a konce platnosti struktury číselníku |
Kliknutím na identifikátor záznamu v tabulce se otevře detail daného záznamu.
Vyhledávání
Číselníky lze dále hledat pomocí vyhledávacího pole v záhlaví aplikace.
Po kliknutí do pole se načte celý seznam číselníků do vyhledávací nabídky.
Vyhledávací pole funguje jako našeptávač. Psaním textu lze hledat číselníky odpovídající zadanému výrazu.
V našeptávači lze hledat pouze podle identifikátoru číselníku.
Kliknutím na položku v nabídce se otevře detail daného záznamu.
Detail číselníku
Detail číselníku slouží k zobrazení dat vybraného záznamu. Data jsou prezentována formou tabulky.
Filtrování
V tabulce lze vyhledávat pomocí filtrů nad tabulkou.
Kliknutím na tlačítko Výchozí filtr dojde ke zrušení všech filtrů a zobrazené výsledky se vrátí do původního stavu.
Rozšířený filtr
Pro filtrování nad konkrétním sloupcem v tabulce lze využít jeho rozšířený filtr.
Rozšířený filtr se zobrazí po kliknutí na ikonu vpravo od názvu sloupce.
Možnosti
Pravá strana hlavičky číselníku obsahuje možnosti pro práci s daným číselníkem.
Změna prohlížené verze
Některé číselníky mají více verzí. Pro rychlou změnu prohlížené verze ji lze vybrat z nabídky verzí.
Popis struktury
Kliknutím na tlačítko Popis struktury se zobrazí popis struktury prohlíženého číselníku.
API
Po kliknutí na tlačítko API se otevře modální dialog, obsahující API endpoint pro získání dat zobrazeného číselníku.
Data lze získat ve formátu JSON, XML nebo CSV.
K dispozici je také možnost Aktuálně platné, která nastaví datum platnosti získaných dat k dnešnímu dni.
Popis webového rozhraní naleznete v sekci Pro vývojáře.
Stahování
Data číselníku lze lokálně uložit kliknutím na tlačítko Stáhnout. Po kliknutí se zobrazí nabídka formátů ke stažení. Data číselníku lze stáhnout v běžné nebo komprimované podobě.
Pro vývojáře
| URL webového API | https://app.celnisprava.gov.cz/ciselnikyws/ |
| Popis webového API | Otevřít |
| Testovací aplikace | Stáhnout |