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

Služba určená k předání dat evidence použití hnojiv.

Název služby Předání dat evidence použití hnojiv (EH_PEH01A)
Popis služby Služba určená k předání dat evidence použití hnojiv.
Verze služby 01A
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

Čí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:

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

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