Založení zemědělské parcely
(LPI_ZZP01A)

Služba umožňuje provádět založení zemědělské parcely do LPIS bez geometrie a provádění omezených editačních operací v rámci aktualizace údajů parcel.

Název služby Založení zemědělské parcely (LPI_ZZP01A)
Popis služby Služba umožňuje provádět založení zemědělské parcely do LPIS bez geometrie a provádění omezených editačních operací v rámci aktualizace údajů parcel.
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.


WSDL služby
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

Určení služby

Služba je určena k následující operacím nad zemědělskými parcelami.

  • založení,
  • editace.

Založení parcely

Služba je volána s identifikací IDDPB bez identifikace IDPARCELA. V případě úspěšné uložení se vrací IDPARCELY přidělené parcely a STATUS 1 <STATUS>1</STATUS>.

IDDPB konkrétního DPB lze získat službou LPI_GDP11B nebo LPI_DDP01B.

Pokud je výměra parcely vyšší než výměra DPB tak se výměra parcely ořízne na velikost výměry DPB. Nižší výměra parcely zůstane nezměněna. Parcela je potom v LPIS červená.

Při založení parcely se definuje i platnost parcely a dále plodina na parcele. Pokud je platnost plodiny mimo interval platnosti parcely (např. jí předchází), tak je platnost plodiny oříznuta na platnost parcely. Platnost parcely nesmí být mimo platnost DPB (služba končí chybou E06 - chyba při zakládání parcely).

Založení další parcely na stejném DPB

Pokud je požadavek na založení další parcely na DPB tak v requestu musí být zopakovány parcely již nad DPB založené. V případě nedodržení tohoto pravidla končí služba na chybu (Není zadán kompletní výčet parcel na DPB!).

Je nutné poslat údaje o dříve uložených parcelách ve stavu 1:1. Tedy pokud byla využita možnost ořezání výměry nebo platnosti plodiny mimo korektní interval tak v DB jsou hodnoty uloženy správně. Při založení další parcely tak je nutné poslat údaje jak vypadají po revizi a nikoliv opět špatné údaje. V tomto případě by služba selhala na chybu např. E01 - chyba v pěstování;E03 - platnosti pěstování jsou mimo platnost parcely nebo se kříží).

U dalších parcel nad DPB je nutné dodržet jejich číslování - element PORADI. Pokud není dodržena posloupnost PORADI tak služba vrátí chybu E07 - Neodpovídá číselná řada pořadí parcel.

 

Kontrola na číselník plodin

Další kontrolou je existence plodiny v číselníku. Tedy služba provádí kontrolu nad obsahem elementu KODPLODINY a případně se vrátí chyba a STATUS bude mít hodnotu 0.

Geometrie

Parcely je možná následně v LPISu zakreslit a jejich výměru stanovit dle geometrického zákresu.

Založená parcela v odpovědi služby má geometrii DPB. Při stažení údajů o parcele službou LPI_DDP01B s typem dat ZEMPARCELA se vrací geometrie DPB.

Aktualizace parcely

Aktualizace parcely je možná pouze u hodnot:

  • Název parcely,
  • PLATNOSTDO parcely,
  • PLATNOSTDO plodiny,
  • přidání další plodiny.

Při aktualizaci parcel je nutné zadat celou historii parcel a plodin. Pokud není historie zadána tak služba skončí chybou.

Pokud dojde na parcele k ukončení poslední plodiny je na parcele automaticky nastavena plodina Bez plodiny (kód 0). V případě dalšího zahájení plodiny na zemědělské parcele je nutné zaslat i plodinu Bez plodiny s kódem 0.

Vstupní parametry služby

Služba má následující vstupní údaje. Jedná se o zápisovu službu do LPIS a je tedy vhodné requestu věnovat náležitou pozornost:

  • Identifikace DPB nad kterým se má zemědělská parcela zakládat - element IDDPB. Jeho hodnotu je možné získat službou LPI_GDP11A nebo LPI_GDP11B. IDDPB je možné získat i z GUI LPIS, kdy zobrazít po najetí myši na DPB.

 

  • Název parcely - identifikace dle požadavků uživatele (je možné ji aktualizovat dalším requestem).
  • Identifikace parcely (IDPARCELA) - je nutné jej použít v případě aktualizace konkrétní parcely. Pro nové parcely je identifikace stanovena systémem LPIS.
  • Výměra se udává v HA. Pokud je výměra zadána vyšší než výměra DPB tak LPIS použije jako výměru zem. parcely výměru max. odpovídající DPB. Pokud je zadána výměra menší tak je v LPIS zem. parcela červená. Je tak možné založit další parcelu. Pokud je parcele
  • PORADI - pracovní pořadí parcel v rámci DPB. Na DPB nemohou být dvě zemědělské parcely se stejným pořadím. Dále musí být pořadí v navazující řadě. Případnou chybu LPIS kontroluje.
  • Platnost parcely - OD je vždy povinné. DO je možné zadat později při aktualizaci parcely.
  • IDPARCELAPREDEK - volitelný parametr určující návaznou parcely pro potřeby uživatele parcely.
  • Plodiny - na parcelu je možné definovat N plodin včetně meziplodin. Plodiny je nutné zakládat postupně. Služba v případě více plodin v requestu (dosud v LPIS nezapsaných), zpracuje pouze poslední záznam. Tedy není možné založit dvě plodiny (jedna ukončená a jedna platná) v jednom requestu. Vždy je nutné poslat 1 plodinu a potom druhou. ID plodiny se získává ze služby LPI_GPL01C. Platnost OD je u plodiny povinná. Platnost DO je možné dodatečně aktualizovat. Po ukončení plodiny se nastavuje automaticky plodina Bez plodiny. Tedy v případě aktualizace parcely je nutné zaslat i plodinu s kódem 0.
  • Hodnota GPS na plodině - je nepovinná.

V případě aktualizace parcely je vždy nutné posílat všechny parcely na konkrétním DPB. Jinak systém LPIS vrátí chybu.

Pokud se uložení parcely podaří - vrací se STATUS=1 a IDPARCELY. Příklad ukázky úspěšného založení parcely:

<ns2:PARCELA>
   <ns2:STATUS>1</ns2:STATUS>
   <ns2:IDPARCELA>563275</ns2:IDPARCELA>
   <ns2:NAZEV>Založení parcely na 8004/56 (590-1100)</ns2:NAZEV>
   <ns2:VYMERA>10</ns2:VYMERA>
   <ns2:PORADI>1</ns2:PORADI>
   <ns2:PARCELAOD>2017-12-01</ns2:PARCELAOD>
   <ns2:PLODINA>
      <ns2:KODPLODINY>1</ns2:KODPLODINY>
      <ns2:PLATNOSTOD>2017-12-02</ns2:PLATNOSTOD>
   </ns2:PLODINA>
</ns2:PARCELA>

 

Chyby

Kód chyby Popis Vysvětlení
E01 chyba v plodině  
E02 platnost parcely leze mimo platnost DPB  
E03 platnosti pěstování jsou mimo platnost parcely nebo se kříží  
E04 neexistující plodina neexistující plodina
E05 parcela není nalezena IDPARCELA v requestu služby nebylo v DB LPIS nalezono.
E06 chyba při zakládání parcely Obecná chyba - pro řešení je nutné poslat request na HD MZe.

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