Rozhraní pro zjištění stavu podání je zárodkem pro elektronické nahlížení do spisu. Je možné pomocí něj zjišťovat stav odeslané písemnosti (podání) za předpokladu, že je známé podací číslo a vygenerované heslo.
Rozhraní je ovládáno pomocí parametrů odesílaných metodou HTTP POST (RFC 2616). Jsou to parametry:
Volací adresa je:
Výsledkem je struktura informací ve formátu XML obsahující hlavní element
<Stav/> a podelementy (textové) nesoucí požadované informace. Seznam
těchto elementů, jejich význam a možné stavy jsou v následující tabulce:
Element | Název | Hodnoty | Popis |
---|---|---|---|
por_podani | Podací číslo | číslo | Zadávané podací číslo písemnosti (identifikátor informací). |
apl_oblpod | Aplikační oblast | 3 znaky např. DSL, DNE,... | Odpovídá první části zkratky označení písemnosti. Odpovídá položce k_uladis v definici struktury souboru. |
typ_podani | Typ podání | 3 znaky např. DAP, PIS | Vyjadřuje typ písemnosti. Odpovídá položce dokument v definici struktury souboru. |
c_ufo_prij | Číslo cílového finančního úřadu | číslo 1 až 499 | Odpovídá číslu finančního úřadu dle číselníku, na který byla písemnost směrována. |
email_ext | Elektronická adresa podavatele (e-mail). | 255 znaků | Element je obsažen pouze pokud byl při podání písemnosti zadán e-mail pro zasílání informací o změně stavu. |
d_podani | Datum odeslání | datum | Datum uložení písemnosti do centrální databáze MF. |
cas_podani | Čas odeslání | čas | Čas uložení písemnosti do centrální databáze MF. |
p_zareppod | Příznak podání s uznávaným elektronickým podpisem | 1 znak | Hodnoty:
A – podání s uznávaným elektronickým podpisem N – podání bez uznávaného elektronického podpisu |
p_platnostpod | Příznak platnosti podpisu podání s uznávaným elektronickým podpisem | 1 znak | Hodnoty:
A – podpis podání je platný N – podpis podání není platný C – podání obsahuje chyby podpisu K – podání čeká na opožděnou kontrolu platnosti podpisu podání |
p_chybapod | Příznak chyby dat podání | 1 znak | Hodnoty:
N – data podání jsou bez chyb S – chyba struktury v datech podání K – kritická chyba v datech podání I – chyba informací v datech podání |
stav_podpre | Stav podání MF | číslo 0 - 5 | Vyjadřuje stav podání v centrálním úložišti na serveru MF. Význam viz následující položka |
stav_podpre_text | Popis stavu podání MF | 255 znaků |
0 – podání uloženo do databáze na MF, ale je nutná ještě opožděná kontrola
platnosti podpisu |
stav_podapl | Stav podání finančního úřadu | číslo 1 - 3 | Stav zpracování podání na finanční úřad. Význam viz. následující položka. |
stav_podapl_text | Popis stavu podání finančního úřadu | 255 znaků |
Stav přijetí podání aplikací na finančního úřadu. Hodnoty:
|
d_pripodapl | Datum zpracování finančním úřadem | datum | Datum zpracování písemnosti příslušnou úlohou na finančního úřadu (přijetí/odmítnutí). |
pozn_pripodapl | Poznámka zpracování aplikací. | 255 znaků | Pokud bylo podání odmítnuto, obsahuje text poznámky, krátké odůvodnění. |