Aktuálně chovaná zvířata
(IZR_GAZ01B)
Služba pro získání dat o individuálně evidovaných zvířatech. Služba logicky nahrazuje stahování dat pro stájový registr.
| Název služby | Aktuálně chovaná zvířata (IZR_GAZ01B) |
|---|---|
| Popis služby | Služba pro získání dat o individuálně evidovaných zvířatech. Služba logicky nahrazuje stahování dat pro stájový registr. |
| 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 |
Vstupní parametry
Službu lze volat ve 2 variantách:
- Volání na existenci změny v číselníku.
- Volání na stažení obsahu číselníku.
Při variantě 1 je vstupu je uvedena hodnota 0 v elementu GETDATA. V tomto případě bude v odpovědi datum poslední změny v datech a nebudou vráceny žádné údaje k DPB. Tento režim je určen pro snadnější způsob administrace verzí dat na straně konzumentského systému.
Při variantě 2 je na vstupu uvedena hodnota 1 v elementu GETDATA a systém vrátí úplný číselník.
Další volitelné parametry na vstupu služby:
- PROVOZOVNA - možnost filtrace dat pouze za určitou provozovnu.
- DRUH - možnost filtrace dat pouze za příslušný druh zvířat.
- DATUM - Datum ke kterému dni byla zvířata na hospodářství umístěna. Pokud datum není vyplněn jedná se o aktuální (dnešní) datum. V případě, že je parametr GETDATA=0, parametr datum se ignoruje.
- KATEGORIEAEO - Pokud bude hodnota = true, použije se pro zařazení zvířat do krmných kategorií číselník platný do 31.12.2013. Pokud bude hodnota = false, použije se pro zařazení zvířat do krmných kategorií aktuálně platný číselník od 1.1.2014. Pokud bude hodnota = null (parametr na vstupu nevyplněn), pak request nebude obsahovat elementy KRMNAKATEGORIE a KRMNAKATEGORIEKOD (zvířata nebudou zařazena do kategorií).
Pokud bude hodnota DATUM <= 31.12.2013 a hodnota KATEGORIEAEO = false, pak služba odpoví business chybou „Pro stav zvířat před 1.1.2014 nelze použít aktuálně platný číselník kategorií.
Změny B verze oproti verzi A
Request byl rozšířen o:
- kategorii AEO.
Response byl rozšířen o:
- PRIZNAK - Příznak zvířete.
- KRMNAKATEGORIE - Popis položky z číselníku krmných kategorií, do které je zvíře zařazeno.
- KRMNAKATEGORIEOD - Kód položky z číselníku krmných kategorií, do které je zvíře zařazeno.
- MATKAOD - Datum, od kdy je samice evidována jako matka (datum narození 1. potomka, zmetání, nebo mrtvě narozené tele).