Podání písemnosti

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:

neznámá (nutno zapnout javascript)


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í.


Pokud neproběhne uložení písemnosti bez závad
, není platný či uznávaný elektronický podpis nebo písemnost obsahuje tzv. kritické chyby, je zpět vrácen seznam zjištěných chyb ve ve formátu XML podle schématu. 

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>
<Chyba Typ="I" Zkr="TEST_REZIM">
<Text>Podání nebylo přijato, protože bylo odesláno v testovacím režimu.</Text>
</Chyba>
</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.

Při odesílání metodou POST musí být specifikován content-type tak, aby nedošlo k transformaci dat u odesílatele nebo centrální podatelně. Vhodné formáty jsou např. "application/pkcs7-signature" nebo "application/x-pkcs7-signature", případně univerzální "application/octet-stream".
Podporovaná kódování jsou :
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