Ověřování a zasílání hlášení - Tuři (dávkové zpracování N hlášení za více provozoven a stájí)
(IZR_OZT01B)
Služba umožňuje ověřování validity hlášení nebo zasílání nových hlášení pro druh TUR (Tuři) do ústřední evidence zvířat. Zaslané hlášení se zpracovává pouze pokud neobsahuje žádné validační chyby. Pokud se vyskytuje chyba, tak je celé hlášení odmítnuto.
Název služby | Ověřování a zasílání hlášení - Tuři (dávkové zpracování N hlášení za více provozoven a stájí) (IZR_OZT01B) |
---|---|
Popis služby | Služba umožňuje ověřování validity hlášení nebo zasílání nových hlášení pro druh TUR (Tuři) do ústřední evidence zvířat. Zaslané hlášení se zpracovává pouze pokud neobsahuje žádné validační chyby. Pokud se vyskytuje chyba, tak je celé hlášení odmítnuto. |
Verze služby | 01B |
Způsob autorizace |
PF -
služba vyžaduje autorizaci na základě WS klíče, který je možné získat po přihlášení na eAGRI. Autentizace je řešena hashovanou zprávou, kdy je do requestu vkládán unikátní HASH requestu. Postup pro generování HASHe je zde. Místo hashované zprávy je také možné použít certifikát. Veřejnou část certifikát je nutné nejdříve ve spolupráci s HD MZe do prostředí MZe importovat.
|
Datový model služby | Datový modely služby obsahuje podrobné popisy jednotlivých elementů, které jsou na vstupu nebo výstupu služby. Před implementací služby je vhodné se s obsahem datového modelu seznámit. prod test |
WSDL služby | prod test |
Adresy serverů | test: https://epomzetest.gov.cz/ssl/nosso-app/EPO/WS/v2Online/vOKOsrv.ashx prod: https://epomze.gov.cz/ssl/nosso-app/EPO/WS/v2Online/vOKOsrv.ashx |
Všechny hlášení za konkrétní provozovnu a volitelně stáj jsou zpracovávány jako jedna dávka (hromadně). Ve verzi 01A se na každý request pohlíželo jako na oddělené hlášení na provozovnu stáj a v některých případech docházelo k odmítnutí hlášení kvůli nesprávnému pořadí. Ve verzi 01B je celý obsah dávky zpracován dle obvyklého pořadí zpracování událostí (narození, odsun, apod). Nedojde tak k odmítnují hlášení například přísunu zvířete na jinou provozovnu.
Vstupní data
Struktura vstupních dat je uvedena v datovém modelu služby.
Pokud je parametr jenOverit nastaven na true, provede se pouze ověření validity hlášení, v opačném případě se hlášení odešle.
Hlášení se odešle pouze v případě, že ověření validity celého hlášení nevrátí žádnou chybu. Pokud se v dávce více hlášení identifikuje jakákoliv chyba, tak se hlášení pro celou dávku neodešle.
- V případě, že validace není v pořádku, tak vrací chybový stav 5, který obsahuje kolekci validačních chyb
- V případě že je validace v pořádku, tak služba vrací stav 1,
- parametr Email - pokud bude tento parametr vyplněn, pak systém po zpracování volání služby s parametrem JenOverit = false odešle na uvedenou e-mailovou adresu mail potvrzující přijetí hlášení do systému IZR a v případě, že bude zpracování hlášení WEB službu v režimu on-line, pak i výsledek zpracování (stejně, jako se např. zasílá při zpracování hlášení z portálu farmáře).
- Pokud parametr vyplněn není a zaslané hlášení je zpracováno On-line, pak je výsledek tohoto on-line zpracování odeslán na e-mailovou adresu, kterou má subjekt na portálu farmáře nastavenu v konfiguraci o odesílání mailů po on-line zpracování.
- Kódy 88 a 89 může hlásit jen SVS.
Odpověď služby
V response je ke provozovně vracen status 1, v případě že je validace v pořádku. Jinak se vrací chybový stav 5, který obsahuje kolekci validačních chyb.
Rozdíl verzí
IZR_OZT01B/C vs. IZR_OZT01A
Oproti verzi 01A je možné v rámci 1 requestu/dávce předat více hlášení za různé provozovny a stáje. Všechny hlášení za konkrétní provozovnu a volitelně stáj jsou zpracovávány jako jedna dávka (hromadně). Ve verzi 01A se na každý request pohlíželo jako na oddělené hlášení na provozovnu stáj a v některých případech docházelo k odmítnutí hlášení kvůli nesprávnému pořadí. Ve verzi 01B je celý obsah dávky zpracován dle obvyklého pořadí zpracování událostí (narození, odsun, apod.). Nedojde tak k odmítnutí hlášení například přísunu zvířete na jinou provozovnu.
IZR_OZT01B
Zaslané hlášení se zpracuje pouze pokud se nevyskytuje žádný chybový stav 5. V případě výskytu min. jedné validační chyba se celé hlášení nezpracuje.
IZR_OZT01C
Verze 01C odešle ke zpracování vždy celou dávku (i zvířata s chybou), v rámci zpracování bude k chybným řádkům vygenerováno příslušný chybový záznam.
Hlášení pohybů
Pohyb 10 - porodní hmotnost
Pohybem 10 probíhá zápis/změna porodní hmotnosti turů. Při pohybu 10 je nutné do elementu PorodniHmotnost uvést povolenou hodnotu (0 rušící, 10-99 váha v kg).
Vstupní element PorodniHmotnost nesmí být používá s jiným pohybem než 10.
Případné chyby při zpracování porodní hmotnosti jsou ve výsledku zpracování.
Chybové stavy služby
Kritické chyby - HTTP status 500
Kód | Text | Příčina |
---|---|---|
6 | Subjekt s IDSZR XXX nebyl v IZR nalezen. | Subjekt s daným IDSZR nebyl nalezen v tabulce chovatelů v databázi IZR. |
1 | Neplatná hodnota pro údaj PROVOZOVNA. Délka musí být právě 8 znaků. | V parametru PROVOZOVNA byl předán jiný počet znaků než 8. |
2 | Neplatná hodnota pro údaj PROVOZOVNA. Provozovna s registračním číslem XXX neexistuje. | Provozovna s daným registračním číslem nebyla nalezena v tabulce provozoven v databázi IZR. |
4 | Provozovna XXX není vlastněna subjektem YYY. | Daná provozovna má v databázi IZR v současnosti vazbu na jiný subjekt, než byl předán. |
88 | Zaslané hlášení neobsahuje řádky hlášení | Element ZasilaneHlaseni neobsahuje v poli Hlaseni ani jeden záznam |
89 | Zaslané hlášení neobsahuje v řádku zvířete XXX validní rozsah hodnoty pro porodní hmotnost (0, 10-99) | Nevalidní rozsah hodnoty |
90 | V zaslaném hlášení chybí u řádku zvířete XXX hodnota kód pohybu (10) při současném vyplnění hodnoty porodní hmotnosti | Chybí zadání kódu pohybu, který je pro zaslání hodnoty porodní hmotnosti povinný |
91 | Zaslané hlášení neobsahuje v řádku zvířete XXX definovaný kód pohybu (10) při současném vyplnění hodnoty porodní hmotnosti | Nevalidní kód pohybu, který musí být pro zaslání hodnoty porodní hmotnosti nastaven na 10. |
92 | Zaslané hlášení obsahuje v řádku zvířete XXX kód pohybu 10, ale chybí vyplnění hodnoty porodní hmotnosti (0, 10-99) | Pro kód pohybu 10 musí být vyplněna i hodnota porodní hmotnosti. |
95 | Neplatný kód pohybu (88, 89 jsou určeny jen SVS). | Chovatelé nesmí zasílat pohyby 88, 89. To smí jen SVS. |
666 | Odmítnuto z důvodu chyby u jiného zvířete v dávce | Chyba u jiného zvířete v dávce. |
Chyby zpracování - HTTP status 200
- Status 1 - validace proběhla v pořádku
- Status 5 - validace neproběhla v pořádku, výčet chyb ve zpracování dat je součástí odpovědi