Rozhraní číselníků

Níže najdete číselníky používané v aplikacích Daňového portálu, zejména v aplikaci Elektronická podání pro Finanční správu.

Řádek - obsahuje pořadové číslo číselníku v tabulce.
Název číselníku
Zkratka - identifikátor jednoznačně určující daný číselník.
Datum aktualizace číselníku - datum, kdy došlo k poslední aktualizaci číselníku.
Stažení celého číselníku - sloupec obsahující odkaz na ZIP soubor s číselníkem. ZIP obsahuje soubor ve formátu TXT. V prvním řádku souboru TXT je uvedeno záhlaví a v dalších řádcích jsou pak samotná data číselníku. Jednotlivé hodnoty v souboru TXT s číselníkem jsou odděleny pomocí znaku "|", tzv. „PIPE“.
Popis číselníku - vždy ke konkrétnímu číselníku je možnost vysvětlení položek číselníku.
Ukázka číselníku - ve sloupci je možnost, po kliku na odkaz, zobrazit konkrétní číselník v XML struktuře s parametry volání a ukázkou.
Třídění záznamů - po kliku na názvy sloupců Řádek, Název číselníku a Datum aktualizace číselníku v záhlaví tabulky lze třídit záznamy sestupně/vzestupně.

Aktuální seznam dostupných číselníků

Řádek ↑	Název číselníku	Zkratka	Datum aktualizace číselníku	Stažení celého číselníku ve formátu ZIP	Popis položek číselníku	Ukázka číselníku
1	Územní finanční orgány	ufo	16.04.2024
2	Pracoviště FÚ	pracufo	16.04.2024
3	Země	zeme	16.04.2024
4	Obce	obce	16.04.2024
5	Certifikační autority	ca_cert	16.11.2017
6	Konverzní číselník OKEČ -> NACE	okecnace	16.04.2024
7	Seznam všech úloh (daní) s jejich jmény.	ulohy	24.05.2016
8	Stavy podání	stavy_pod	26.04.2010
9	Celní úřady	ucelur	16.04.2024
10	Celní úřady - PBÚ	pbucelur	16.04.2024
11	Kód předmětů plnění	k_pred_pl	16.04.2024
12	Druhy příjmů - FÚ	dp_fu	16.04.2024
13	Teritoria pro MOSS	c_ter_moss	16.04.2024
14	Obce ČSÚ	cisob	16.04.2024
15	Obce ZUJ	obcezujzko	04.03.2024
16	Právní formy	pfo	16.04.2024
17	DNE - Koeficient 1,5 dle § 11 odst. 3b	koef_k15	19.04.2024
18	DPS - kódy rozlišení příjmů dle § 22 Odst. 1	k_rozl_prij	16.04.2024
19	DPS - sazby daně dle států	stat_sazba	16.04.2024
20	EET - kódy činností provozoven	cinnost_prov	16.04.2024
21	Kód banky	cbanka	16.04.2024
22	Činnosti	okec	16.04.2024
23	DSL - Sazby osobní	sazdslos	16.04.2024
24	DSL - Sazby nákladní	sazdslna	16.04.2024
25	DSL - Osvobození a kód vozidla	dsloskvo	16.04.2024
26	DSL - Osvobození	dapdslos	16.04.2024
27	DSL - výše daně pro zdanitelné vozidlo kategorie N s kódem karoserie BA nebo BB	vysedanna	16.04.2024
28	DSL - výše daně pro zdanitelné vozidlo kategorie N s kódem karoserie BC nebo BD	vysedanta	16.04.2024
29	DSL - výše daně pro zdanitelné vozidlo kategorie O	vysedanpr	16.04.2024
30	DNE - Právní důvody osvobození	dnepduos	16.04.2024
31	DNE - Právní vztahy	dnepv	16.04.2024
32	Katastrální území	katuz	16.04.2024
33	DNE - Soubor lesních typů	dneslt	16.04.2024
34	DNE - Kódy nemovitých věcí	drnem	16.04.2024
35	DNE - Sazby a koeficienty	dnesaz	16.04.2024
36	DNE - koeficienty dle § 6 zákona o dani z nemovitých věcí pro pozemky	koef_poz	19.04.2024
37	DNE - koeficienty dle § 11 zákona o dani z nemovitých věcí pro stavby	koef_sta	19.04.2024
38	DNE - Koeficienty dle § 11 zákona o dani z nemovitých věcí pro jednotky	koef_jed	19.04.2024
39	DNE – místní koeficienty dle § 12 zákona o dani z nemovitých věcí	koef_mistni	19.04.2024
40	DNE - osvobození zeměd.půdy dle §4v ZDNE pro obec a výjimky z osvobození pro pozemky	osv_poz	19.04.2024
41	Cena KU	cena_ku	16.04.2024
42	Orgány OSSZ/PSSZ/MSSZ Brno	par_ossz	16.04.2024
43	Měna	mena	16.04.2024
44	Seznam států daňové rezidence.	statydr	06.11.2013
45	Kontrola formátu podle normy ACDT0xx.	regformat	02.10.2009
46	Seznam dostupných daní (druhů příjmů)	nazdane	16.04.2024

Rozhraní číselníků je ovládáno pomocí URL parametrické řádky. Číselníky zobrazené po kliknutí na odkaz, ve sloupci "Ukázka číselníku", jsou uloženy ve struktuře XML, která je popsána v tomto univerzálním schématu. Výsledek výběru může obsahovat žádný, jeden, nebo množinu záznamů. Vyhledávání je možné provést různými způsoby (případně kombinací více způsobů):

• hledání nejbližší hodnoty v určitém intervalu (vhodné pro hledání koeficientu podle určitého základu),
• filtrováním podle určité podmínky (na rovnost jednoho nebo více klíčů),
• filtrováním u vybraného klíče podle daného textového řetězce (hodnota klíče začíná tímto textem).

Volací adresa servletu číselníků je: https://adisepo.mfcr.cz/dpr/epo_ciselnik

Pro posílání dotazů na číselníky platí některá další pravidla:

• dotaz musí být ve formátu UTF-8, který je ještě kódován podle specifikace URL (uuencoding - každý znak s kódem >127 je nahrazen znakem "%" + číslem dle ascii kódu uvedeného znaku)

Seznam parametrů, které lze použít při vyhledávání v konkrétním číselníku, je uveden na stránce s popisem číselníku, která se zobrazí po kliknutí na příslušný odkaz ve sloupci "Ukázka číselníku". Nicméně celý číselník lze stáhnout po kliknutí na odkaz "Číselník ve formátu ZIP", ve sloupci "Stažení celého číselníku".

Výstup (odezva) číselníku, pokud byl dotaz v pořádku, je ve formátu XML a odpovídá jeho primární definici podle schématu s tím, že element Ciselnik je obohacen o atribut Dotaz, ve kterém je původní dotaz na číselník.
Pokud dotaz nebyl správný, nebo je nějaký jiný problém, je vráceno hlášení chyby ve formátu XML podle schématu (příklad).

Upozornění: Z důvodu výkonu je zavedeno omezení na velikost výstupu. Pokud odpověď na dotaz obsahuje příliš mnoho záznamů, je z této množiny vráceno pouze prvních 300 nalezených položek. Je doporučeno dotazy optimalizovat pomocí zadání vhodných kritérií tak, aby výstupy nebyly příliš velké. V případě potřeby je možné získat obsah celého číselníku zadáním dotazu s jediným parametrem C=název číselníku, ale toto neplatí pro číselníky označené jako "velký číselník". Pro ně je v případě, že není zadán žádný omezující parametr, vráceno pouze prvních 300 nalezených položek. Pro všechny číselníky je možné získat obsah celého číselníku ke konkrétnímu datu platnosti zadáním dotazu s parametrem "PL=RRRR-MM-DD".