Předání dat evidence použití hnojiv
(EH_PEH01A)

Číselníkové webové služby

Pro identifikaci plodin, produktů, hnojiv a užitkových směrů pěstování služba požaduje využití existujících číselníků používaných v rámci resortu. Pro získání číselníkových dat jsou k dispozici následující webové služby:

• EH_CISPRO01A - číselník produktů;
• EH_CISUSP01A - číselník užitkového směru pěstování plodin;
• EH_CISOZP01A - číselník přiřazení produktů a užitkových směrů pěstování k plodinám;
• RHN_GHN01D - číselník hnojiv;
• LPI_GPL01D - číselník plodin;

Základní pravidla pro předání dat osevů/sklizní

Údaje podání

Typ:

• S – Statistika – podání předávané 1x ročně po skončení kalendářního roku;
• K – Kontrola – podání předávané na základě vyžádání kontrolním orgánem ÚKZÚZ;

Období od-do:

• V případě statistiky musí být období vždy od 1.1. do 31.12. daného roku;
• V případě kontroly je období libovolné, na základě požadavku kontrolora;

Středisko

nepovinná identifikace střediska v rámci subjektu;

Rozsah:

• H – jen aplikace hnojiv;
• P – jen výkaly (pastva);
• Pokud je prázdné, považují se data za úplná – hnojiva i pastva;

Typy chyb

Při volání služby mohou nastat tyto 3 chyby:

• Kritická – data obsahují zásadní chybu neumožňující žádné zpracování (např. vadná identifikace subjektu).
• Vážná chyba – konkrétní záznam osevu, hnojení, pastvy, výnosu obsahuje datovou chybu, která vyřadí konkrétní záznam z dalšího zpracování a bude považován za neplatný (typicky neexistující čtverec/zkrácený kód DPB).
• Upozornění – konkrétní záznam obsahuje nesoulad, ale je možno jej dále zpracovat (např. liší se výměra aplikace překračuje výměru LPIS).

Osevy a sklizně

• V rámci elementu se předávají vždy kompletní data osevů/sklizní spadající do daného období, tj. jakkoliv plodina zasahuje svým obdobím pěstování do příslušného období jsou údaje předány – tj. datum výsevu může předcházet ObdobiOd, nesmí však být větší než ObdobiDo. Pro datum sklizně platí, že musí spadat do ObdobiOd-ObdobiDo.

• Součástí předávaného osevu jsou i meziplodiny, u nichž nebude plněn element sklizně.

• Osev je vždy předáván ve vztahu k čtverci/zkráceném kódu dle LPIS – neexistence DPB u subjektu bude znamenat vážnou chybu, neexistence v příslušném čase pěstování nebo odlišná výměra bude znamenat chybu měkkou.

• Nepovinně se každá jednotka pěstování plodiny může identifikovat jednoznačným identifikátorem a ve vztahu k takto identifikované jednotce lze předávat data aplikací/pastev

• Plodiny jsou identifikovány postřednictvím ID vůči číselníku plodin. Záznam s neplatným ID plodiny bude opatřen vážnou chybou.

• Užitkový směr pěstování musí být uveden u plodin, které jej mají v číselníku definovaný (pšenice, ječmen, zelí). Jeho neuvedení znamená opatření záznamu vážnou chybou, která neumožňuje další vyhodnocení. Uvedení neexistujícího užitkového směru pěstování dle číselníku nebo uvedení neplatné vazby mezi plodinou a užitkovým směrem pěstování povede  ignoraci tohoto záznamu a případné vážné chybě nebo upozornění, podle toho, zda je užitkový směr pro plodinu vyžadován nebo nikoliv.

• Podřízený element sklizně umožňuje předat více sklizní za dané období. Jedna sklizeň může mít jak hlavní, tak i vedlejší produkt identifikovaný ID z číselníku produktů.
  Více sklizní je umožněno např. pro případy, kdy se plodina (např. jetel) v první seči sklidí na zelenou hmotu, v druhé pak na semeno, anebo pro opakované sklizně pícnin.
  Neexistující produkt podle číselníku znamená vážnou chybu, neplatný produkt k datu výsevu znamená upozornění. Neplatná kombinace plodiny a produktu znamená vážnou chybu.
  Pokud nebude u vedlejšího produktu uvedeno množství bude se pro kontrolní účely doplňovat v poměru vůči hlavnímu produktu dle přílohy č. 6 vyhlášky č. 377/2013 Sb.

• U produktu je možné uvést vlastní obsah sušiny, není-li uveden pro další zpracování se přebírá obsah dle přílohy č. 6 vyhlášky č. 377/2013 Sb.

• Uvedení předplodin je nepovinné, nicméně je žádoucí z důvodu zjištění návaznosti plodin a případného správného vyhodnocení bilance živin a omezení hnojení v podzimním období. U předplodin je kontrolována existence ID plodiny a ID užitkového směru pěstování a jejich správná kombinace. V případě chyby se jedná o vážnou chybu.

Základní pravidla pro předání dat aplikací/pastev

• V rámci podání se předávají vždy kompletní data aplikací nebo pastev jakkoliv spadajících do příslušného období.

• Aplikace/Pastvy jsou vždy předávány ve vztahu k čtverci/zkráceném kódu dle LPIS – neexistence DPB u subjektu bude znamenat vážnou chybu a nemožnost použití záznamu pro další vyhodnocení, neexistence pouze k datu AplikaceZahajení/ZapraveniUkonceni bude znamenat upozornění.

• Aplikace / Pastvy jsou vždy předávány ve vztahu k čtverci a zkráceném kódu dle LPIS - neexistence DPB u subjektu znamená vážnost chybu a nemožnost použití záznamu pro další vyhodnocení. Neexistence DPB pouze k datu zahájení aplikace nebo datu zapravení znamená upozornění.

• Pastva se předává jako hnojivo dle číselníku hnojiv. Musí být uvedeno hnojivo s atributem Vykaly = 1, v opačném případě je záznam vyhodnocen jako chybný s upozorněním. Zahájení a ukončení cyklu pastvy se předává v elementech DatAplikaceZahajeni a DatZapraveniUkonceni.
• U aplikace se uvádí ID pozemku.
• Aplikace může časově předcházet datum výsevu plodiny.
• Výměra aplikace se může lišit od výměry plodiny, nemůže být větší (v takovém případě bude stanovena chyba typu upozornění a přísun N bude přepočten na výměru plodiny).
• Pro každou aplikaci, s výjimkou rostlinných zbytků musí být uvedeno:
  • Množství (dávka) nebo Množstvi (celkem)
  • Měrná jednotka;
  • Rozklad slámy;
• Identifikaci hnojiva lze provádět pomocí identifikátoru ve vztahu k číselníku hnojiv, v takovém případě se neuvádí obsahy živin. Pokud hnojivo dle ID neexistuje, znamená to vážnou chybu. Pokud je hnojivo dle číselníku k datu aplikace neplatné, jedná se o upozornění
• V případě, že není uvedeno ID hnojiva, musí se uvést název hnojiva a obsahy živin. Dle vyhlášky č. 377/2013 se uvádí obsahy živin v prvkové formě, z důvodu kontinuity s dosavadním pojetím je možné uvádět i v oxidové formě a ve zpracování bude obsah přepočten.

   

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_CHEH01A.

V případě neúspěšného volání může systém vrátit jednu z následujících chyb rozhraní:

Kód	Popis
11	Typ musí být S=Statistika nebo K=Kontrola
12	Období do musí být větší než období od
13	U typu S musí být období od 1.1
14	U typu S musí být období od 31.12
15	Rozsah musí být P=pastva, H=hnojivo nebo prázdný
21	U osevu musí být zadaný hlavní nebo vedlejší produkt
22	Obsah sušiny u hlavního produktu zadaného k osevu musí být 0-100
23	Obsah sušiny u vedlejšího produktu zadaného k osevu musí být 0-100
24	Typ aplikace musí být P=pastva, H=hnojeni, K=kaly nebo S=pomocné půdní látky/biostimulanty/substráty
25	Měrná jednotka u aplikace musí být t, kg nebo l
26	Metoda živin musí být P=prvková forma nebo O=oxidová forma
27	Musí být zadané množství celkem nebo množství ha, měrná jednotka a rozklad slámy
28	Musí být zadané množství celkem nebo množství na ha
29	Pokud není zadané ID hnojiva, musí být zadaný název
30	Při zadávání živin u aplikace musí být uvedena metoda
31	Pokud je zadané HnojivoId nebo je typ = S, nesmí být zadané živin

Zpracování podání

Podání je možné předat webovou službou opakovaně. U statistických podání se za platné požaduje poslední podání pro dané období, daný subjekt a středisko (pokud je středisko zadáno).

Po předání podání proběhne automatická kontrola předaných dat. Na základě výsledku kontroly je vygenerován PDF soubor s potvrzením podání, případně PDF soubor s přehledem chyb (chybník).

Výsledek volání může být určitý typ chyby (viz výše) nebo stavy

• Zpracovává se – pracovní stav před dokončením kontroly dat. Podání je viditelné pouze přes webové rozhraní, chybník v tomto stavu nelze získat webovou službou EH_CHEH01A.
• Zpracováno.

V případě úspěšného předání dat (volání služby neskončilo chybou rozhraní) je možné získat výsledek volání včetně předaných dat službou EH_CHEH01A. Pro identifikaci volání se použije GUID podání, který je odpovědí služby EH_PEH01A.

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í.