Předání dat evidence použití hnojiv
(EH_PEH02A)
Služba určená k předání dat evidence použití hnojiv. 02 verze vznikla z důvodů změny související s legislativou a plně nahrazuje verzi 01.
| Název služby | Předání dat evidence použití hnojiv (EH_PEH02A) |
|---|---|
| Popis služby | Služba určená k předání dat evidence použití hnojiv. 02 verze vznikla z důvodů změny související s legislativou a plně nahrazuje verzi 01. |
| Verze služby | 02A |
| 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 |
Zásadní odlišnosti služby verze 02A od verze 01A
Doplnění režimu volání
(RezimVolani) s hodnotami
- O = ostré volání,
- T = testovací volání.
Při volání v režimu T se data nepropisují do platných dat. Systém, ale pro data vytvoří chybník, který je možné stáhnout službou EH_CHEH02A. Pokud nebude uveden režim volání, považuje se volání za ostré. Hlavní účel zavedení volání v režimu T je možnost efektivnějšího vývoje ze strany dodavatelů SW proti ostrým datům.
Rozlišení typu volání
Rozslišení typu volání na S (statistika), K (kontrola) a B(bilance), které mají specifické nároky na předaný rozsah dat
- S (statistika) - pole HospRok se plní rokem za, který jsou posílána data. Očekávají se data osevů spadajících do tohoto hospodářského roku a současně k tomu navázané aplikace, pastvy a sklizně. Na trvalých kulturách se hospodářský rok rovná kalendářnímu. ObdobiOd a ObdobiDo se neplní.
- K (data pro kontrolu) – plní se ObdobiOd a ObdobiDo časovým rozmezím stanoveným kontrolorem. Očekávají se data osevů, aplikací a pastev spadající do tohoto období a sklizně navázané na osevy spadající do tohoto období. Tato data se následně přímo předávají do kontrolního modulu ÚKZÚZ v přípaě zahájené kontoly
- B (bilance) - pole HospRok se plní rokem za, který jsou posílána data. Očekávají se data osevů a na to navázaných sklizní spadajících do tohoto hospodářského roku a do předchozího hospodářského roku. Aplikace se zasílají za období 1.7. roku N-1 do 30.6. roku N. ObodbiOd a ObdobiDo se neplní. Účelem dat je výpočet bilance N, P, do budoucna i bilance organické hmoty.
Zavedení blokové struktury služby dle již funkčního předávání POR
- Osevy – řešeno shodně jako v případě předávání POR s tím, že existuje navíc nepovinné pole IdUzitkovySmer, které může rozlišovat účel pěstované pšenice (potravinářská x nepotravinářská) a ječmene (krmný x sladovnický).
- Aplikace – systémově řešeno shodně jako v případě POR – tj. navázání přes IdPestovani, případně přes IdPozemek, jestliže cílové pěstování plodiny nelze uvést a jedná se o aplikaci na Bez plodiny.
- Pastvy – nová struktura umožňující předat data evidence pastvy v lépe čitelné formě pro následující práci s daty než pokud je pastva předávána jako aplikace „výkalů“. Obě možnosti jsou zachovány. Vazba záznamů pastvy je nastavena na IdPozemek (v případě TTP pěstování nemá relevanci).
- Sklizně – vazba je nastavena přímo na IdPestovani konkrétní sklizené plodiny. Oproti verzi 01A došlo ke zrušení data sklizně a předává se jen množství a výměra sklizně hlavního či vedlejšího produktu. Při vícenásobné sklizni se uvádí výměra plochy max. do výše výměry pozemku.
Vazby na číselníky
- Veškeré DPB musí být evidované v LPIS, pokud nejsou v čase aplikace evidované na dotyčný subjekt, je nastavena chyba na úrovni Upozornění.
- Každá plodina musí být vedena a platná v čase aplikace v číselníku plodin MZe (LPI_GPL02A).
- Užitkový směr, pokud je uveden musí mít kód z číselníku užitkových směrů (EH_CISUSP01A)
- Hnojiva mohou být identifikována pomocí ID z registru hnojiv (RHN_GHN01D). Nejsou-li takto identifikována, musí se uvádět obsah živin a v případě cíle použít data pro bilanci, pak i některé další údaje jako KategorieN nebo Druhhnojiva anebo TypoveIdHnojivo. Systém umožní tyto chybějící údaje v aplikaci JUDEH doplnit ex-post poslání, protože nemusí být v primárním SW vedeny.
- Druh zvířete a kategorie zvířete musí být z výčtu dle služby IZR_CKD01A. Jestliže bude použita vlastní kategorie, pak je obdobně jako v případě vlastních hnojiv nutné uvádět další atributy, které by jinak si systém dopočetl sám
- Id produktů musí být z číselníku produktů (EH_CISPRO01A) a musí být použito ve správné kombinaci s plodinou dle číselníku vazby produkt x plodina (EH_CISOZP01A)
Další podstatná pravidla
- Každé podání se řeší autonomně – tj. z každého podání se vytváří statistika, kontrola nebo bilance. Podání se nijak nespojují. Výběr konkrétního podání pro kontrolu či bilanci si určuje uživatel.
- Jestliže podání není zcela odmítnuto na nepropustnou chybu (kritická chyby volání), jsou data zpracována a opatřena chybníkem. V případě úspěšného volání je v odpovědi služby GUID podání vytvořený při uložení do systému. GUID podání slouží jako identifikátor pro volání služby EH_CHEH02A.
- Výskyt jakékoliv tvrdé chyby (vážné) by měl být důvodem k opravě a opětovném zaslání dat.
- Přehled chyb je zároveň možné ve formátu PDF získat přes webovou aplikaci, a to i pro podání ve stavu „Kritická chyba volání“. Ve webové aplikaci je možné také stáhnout potvrzení podání.
Detailní popis jednotlivých polí ve službě je k dispozici v popisu datového modelu.
Odpověď služby
V případě úspěšného volání je v odpovědi služby GUID podání vytvořený při uložení do systému. GUID podání slouží jako identifikátor pro volání služby EH_CHEH02A.
Chyby služby
V případě vyskytu níže uvedených chyb se nevrací GUID podání a podání je zahozeno jako celek - podání nejde do dalšího zpracování.
11 - Subjekt se podle SZR ID nepodařilo načíst
12 - Jedná se typ podání u kterého musí být vyplněno období od i období do.
13 - Jedná se typ podání u kterého nemá být vyplněno období od i období do, ale pouze hospodářský rok.
14 - Jedná se typ podání u kterého musí být vyplněn hospodářský rok.
15 - Jedná se typ podání u kterého nemá být vyplněn hospodářský rok, ale pouze období od a období do.
Podrobnější popis je potom následující:
K – data pro kontrolu – plní se ObdobiOd a ObdobiDo časovým rozmezím stanoveným kontrolorem. Očekávají se data osevů, aplikací a pastev spadající do tohoto období a sklizně navázané na osevy spadající do tohoto období.
S – data pro statistku – plní se HospRok rokem za, který jsou posílána data. Očekávají se data osevů spadajících do tohoto hospodářského roku a současně k tomu navázané aplikace, pastvy a sklizně. Na trvalých kulturách se hospodářský rok rovná kalendářnímu. ObdobiOd a ObdobiDo se neplní.
B – data pro bilanci – plní se HospRok rokem za, který jsou posílána data. Očekávají se data osevů a na to navázaných sklizní spadajících do tohoto hospodářského roku a do předchozího hospodářského roku. Aplikace se zasílají za období 1.7. roku N-1 do 30.6. roku N. ObodbiOd a ObdobiDo se neplní.