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://eagritest.cz/ssl/nosso-app/EPO/WS/v2Online/vOKOsrv.ashx
prod: https://eagri.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

Tyto webové stránky využívají k analýze návštěvnosti soubory cookies. Pokud váš internetový prohlížeč má v nastavení cookies povoleny, je nezbytný váš souhlas s použitím této technologie.

Více informací

Chyba komunikace se serverem

Nastaly technické problémy. Zkontrolujte prosím připojení k síti, a pokud pracujete jako přihlášený uživatel, ověřte prosím nastavení VPN a stav přihlášení.