Rozhraní pro podání představuje stěžejní bod, protože je
v něm obsažena hlavní funkce příjmu písemnosti (podání) do daňové
správy.
Volací adresa je:
Ovládání rozhraní je kombinací parametrické řádky a odesílání
neformátovaných dat metodou POST (RFC 2616):
- v parametrické řádce může být jako parametr "&email=......" uveden e-mail
na který mají být posílány informace o změně stavu (zpracování) podání
- obsah zasílaných neformátovaných dat musí odpovídat
struktuře písemnosti ve formátu XML popsané v popisu
souboru (bez kontrolních informací - ty jsou doplněny po kontrole)
- pokud je podání zasílané s uznávaným elektronickým podpisem,
musí být struktura dle předchozího bodu "zabalena" do příslušného
formátu kryptografických struktur tak, jak je popsáno na stránce podpisu
Pokud proběhne kontrola souboru a
jeho uložení bez problémů, je zpět
vráceno tzv. potvrzení podání - což je soubor ve
formátu PKCS#7, elektronicky podepsaný (nekvalifikovaným) certifikátem
podatelny - Společného technického zařízení správců daně, který
obsahuje vložený kompletní soubor tak, jak byl obdržen a dále
doplňující
údaje podatelny (schéma těchto informací je dostupné ve formátu W3C XSD zde. - je obecné a platí i pro
podání).
Obsah důležitých položek XML struktury potvrzení vysvětluje následující
tabulka, ty nejpodstatnější jsou zvýrazněny tučným písmem:
Element / Atribut | Název | Popis |
---|---|---|
Pisemnost | Hlavní element písemnosti | Uzavírající element určující, že se jedná o písemnost. |
Pisemnost/Data | Kopie původního podání | Obsahuje data v hexadecimálním kódování odeslané písemnosti
(třetí strany mohou pouze podávat s uznávaným elektronickým podpisem, proto data obsahují vždy
soubor ve formátu PKCS#7). |
Pisemnost/Kontrola | Kontrolní element aplikace | Element obsahuje kontrolní položky pro podání a pro aplikaci z které bylo podání odesláno. Jejich přesný význam není zveřejněn a tyto položky nejsou pro zpracování potvrzení významné. |
Pisemnost/Podani | Element informací o podání | Element obsahuje atributy s informacemi o učiněném podání. Jejich význam je vysvětlen dále. |
Pisemnost/Podani/@Cislo | Podací číslo | Číslo podání přidělené společným technickým zařízením správců daně ve smyslu §73 odstavce (3) zákona č. 280/2009 Sb., daňový řád, ve znění pozdějších předpisů. Jedná se o referenční údaj, pomocí kterého je možné se na podání odkazovat při styku s Finanční správou. |
Pisemnost/Podani/@KC | Kontrolní číslo podání | Historický údaj, který se již nepoužívá a je uveden jen z důvodu zpětné kompatibility funkcí. |
Pisemnost/Podani/@Datum | Datum a čas podání | Rozhodné datum a čas přijetí podání stanovené společným technickým zařízením správců daně ve smyslu §73 odstavce (3) zákona č. 280/2009 Sb., daňový řád, ve znění pozdějších předpisů. Datum a čas jsou ve standardním formátu XML dle normy. |
Pisemnost/Podani/@Heslo | Heslo pro přístup k informací o podání. | Heslo přidělené systémem. Pomocí podacího čísla a hesla je možné se dotázat na informace o stavu podání. |
Pisemnost/Podani/@ZAREP | true/false | Indikátor, zda podání uložené v elementu Data bylo podáno s uznávaným elektronickým podpisem. |
Pisemnost/Podani/@email | Notifikační e-mail adresa. | E-mail adresa zadaná jako parametr při podání (volitelně). Na adresu je zasíláno (nevěcné a nekonkrétní) upozornění o tom, že došlo ke změně stavu zpracování podání. |
TESTOVACÍ REŽIM
Připravená data je možné na server poslat pouze k otestování, a to přidáním parametru "&test=1" (může být použit v kombinaci s parametrem email). V tomto případě bude podání řádně otestováno (uznávaný elektronický podpis, formální i věcné kontroly struktury a obsahu), ale nebude podáno. Zpět je vždy vrácen pouze XML dokument VŠECH zjištěných chyb podle schématu. Pokud dokument neobsahuje žádné chyby, je vrácena zpět pouze informativní chyba (lze ji identifikovat podle atributu Zkr="TEST_REZIM") v tomto tvaru: <Chyby>KÓDOVÁNÍ Soubory XML přijímané centrální
podatelnou musejí být kódovány některým z níže uvedených typů (ucelený
seznam kódování je k dispozici na adrese
http://www.iana.org/assignments/character-sets). Text musí být v
uvedeném kódován, a pokud se nejedná o UTF-8, tak musí být i v hlavičce
příslušný řádek s deklarací (např. <?XML
version="1.0" encoding="WINDOWS-1250" ?> ). XML v této podobě
musí být (binárně) vložen do objektu PKCS#7.
XML zpráva elektronické potvrzenky (obsah PKCS#7) je vydávaná vždy
v kódování UTF-8.
Do verze aplikace 26.10.1 byly přijímány soubory a vydávány potvrzenky
s
kódováním "Unicode Little Endian Unmarked" jako vnitřní obsah PKCS#7, a
to bez ohledu na deklaraci v hlavičce. Toto kódování je možné rozpoznat
tak, že má na 1,3 a 5 pozici bytového pole znak s kódem 0.
WINDOWS-1250
UTF-8
UTF-16
UNICODE
US-ASCII
ISO-8859-1
ISO-8859-2
ISO-8859-3
ISO-8859-4
ISO-8859-5
ISO-8859-6
ISO-8859-7
ISO-8859-8
ISO-8859-9
EBCDIC-CP-US
EBCDIC-CP-CA
EBCDIC-CP-NL
ISO-Latin-1
ISO Latin-2