Předávání chybových zpráv
Chybové zprávy jsou předávány organizacím dvěma základními způsoby. Přes PVS nebo pomocí emailu, jehož adresa byla uvedena při registraci uživatele (asistenta) na okresní správě.
1. Zpráva Submission_error
Chyba, ke které došlo v průběhu zpracování podání je standardně vrácena ve zprávě Submission_error.
Tělo zprávy v tomto případě může obsahovat chybu, která přichází z ČSSZ (DIS serveru).
Struktura těla chybové zprávy:
| Název elementu |
Povinný údaj |
Popis elementu |
| Body |
A |
tělo zprávy s chybou |
| ErrorResponse |
A |
použitý namespace:
http://www.cssz.cz/XMLSchema/reldp/ErrorEnvelope
|
| Application |
A |
|
| Error |
A |
|
| RaisedBy |
A |
název systémové komponenty, kde došlo k chybě |
| Number |
A |
číslo chyby |
| Text |
N |
Stručný popis chyby |
| Protocol |
N |
Přesný protokol s vyhodnocením chyby
atributy:
type - Typ protokolu. Nastaveno na RELDP
version – Verze protokolu. Nastaveno na 1.0 |
Příklad:
<Body>
<ErrorResponse xmlns="http://www.cssz.cz/XMLSchema/reldp/ErrorEnvelope">;
<Application>
<Error>
<RaisedBy>název systémové komponenty</RaisedBy>
<Number>číslo chyby</Number>
<Text>popis chyby</Text>
</Error>
<Protocol type="RELDP" version="1.0">
......
</Protocol>
</Application>
</ErrorResponse>
</Body>
Protokol o zpracování:
element: Protocol
atributy: type, version
| Název elementu |
Povinný údaj |
Popis elementu |
| error |
|
základní údaje o chybě |
| error@type |
A |
zdroj chyby. Pro transakci ročních evidenčních listů: RELDP |
| error@result |
A |
celkový výsledek protokolu OK|WARNING|EOF
OK – všechny reld jsou v pořádku zpracovány
WARNING – chyba při zpracování RELDP. (Př. alespoň jedno reldp obsahuje chybu, nepodařilo se dešifrovat, neutorizovaný přístup apod.)
EOF – nejsou data ke zpracování |
| error@errNumber |
N |
číslo chyby |
| error@errMsg |
N |
popis chyby |
| error@count |
N |
celkový počet zpacovaných reldp (zpracovaných údajů o zaměstnancích) |
| error@countErr |
N |
počet reldp, jejichž zpracování skončilo systémovou chybou. Klientovi se tyto údaje nepředávají.
Vyplněno null nebo neuvedení atributu |
| error@countWar |
N |
počet reldp, jejichž zpracování skončilo logickou chybou způsobenou klientem. |
| error@freeText |
|
Doplňující informace. Např. do kdy má dojít k opravnému podání. |
| head |
N |
Hlavička protokolu, která uvádí názvy sloupců, jak mahou být zobrazeny v sestavě.
Transakce RELDP
Rodné číslo Výsledek zpracování Chyba |
| rec |
N |
každý element odpovídá jedné reldp neboli jednomu zaměstnanci, za kterého bylo provedeno podání
např.
151111111 OK Chybný vyměřovací základ |
Příklad:
<error type="RELDP" result="OK|WARNING|EOF " errNumber="" errMsg="" count="počet reldp" countErr="null" countWar="počet logických chyb" freeText="Proveďte opakované podání do 15 dnů">
<head col1="rodné číslo" result="Výsledek zpracování" errMsg="Chyba"/>
<rec col1="151111111" result="OK" errMsg="Chybný vyměřovací základ"/>
</error>
2. Emailová zpráva
Pokud uživatel, který provedl podání uvedl správnou emailovou adresu během registrace na okresní správě, protokol o chybě je vrácen ve formě emailové zprávy.
Protokol svým obsahem odpovídá chybě uvedené ve zprávě Submission_error.
Příklad:
| Protokol o zpracování e - Podání |
| Typ transakce: |
RELDP |
Výsledek zpracování: |
OK |
| Počet záznamů: |
2 |
Počet systémových chyb: |
0 |
| Počet logických chyb: |
1 |
|
|
| Poznámka: Proveďte opakované podání do 15 dnů |
| rodné číslo |
Výsledek zpracování |
Chyba |
| 151111111 |
OK |
|
| 151111112 |
ERROR |
Chybně vyloučené doby |