Žádost o uznání porostu
(OOS_ZUP01C)
Služba slouží k zasílání datové zprávy obsahující žádost o uznání množitelského porostu do Informační systému Odboru osiv a sadby ÚKZÚZ.
| Název služby | Žádost o uznání porostu (OOS_ZUP01C) |
|---|---|
| Popis služby | Služba slouží k zasílání datové zprávy obsahující žádost o uznání množitelského porostu do Informační systému Odboru osiv a sadby ÚKZÚZ. |
| Verze služby | 01C |
| 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 |
Základní popis
V requestu služby se uvádí data odpovídající papírové žádosti o uznání porostů.
Specifikace konkrétního díl půdního bloku (DPB)
DPB je možné zadat
- konkrétním ID (ID DPB je možné získat službou LPI_GDP nebo LPI_DDP),
- nebo čtvercem a zkráceným kódem (Ctverec_DPB a Kod_DPB).
Služba v rámci interních kontrol na zaslaná data vyhodnocuje zaslaný DPB proti systému LPIS. Pokud je identifikace DPB špatná tak se celá žádost o uznání porostu neuloží a volání skončí chybou. Do elementu Identifikace porostu je nutné uvést bližší informaci o porostu nebo uvést např. viz identifikace DPB).
Na vstupu služby je nový element, který stanovuje Typ žádosti o uznání porostu. Varianty jsou tyto:
- U - uznání porostu,
- RL - uznání a předvývozní RL šetření.
Pokud se jedná o žádost standardní uvádí se země vývozu jako prázdný element. V případě předvývozního RL šetření je nutné uvést element ZemeVyvozu.
Typ žádosti je součástí služby OOS_CIS01C.
Vstupní údaje
Zadávání šlechtitelského materiálu bez čísla rozhodnutí se provádí zkratkou šl.mat. v elementu CisloRozhodnuti. U šlechtitelského materiálu se automaticky v systému ISOOS zpracovává výměra ha.
<oos:CisloRozhodnuti>šl.mat.</oos:CisloRozhodnuti>
Některé elementy jsou v requestu povinné, ale je možné je pomocí atributu nil="true" uvést jako prázdné. Ukázka neuvedené země vývozu.
<oos:ZemeVyvozu xsi:nil="true"/>
(namespace xsi="http://www.w3.org/2001/XMLSchema-instance")
Odrůda a druh je možné zadávat pouze vazbou na číselník. Vazbu na číselník je možné realizovat číselným kódem nebo textovým popiskem.
Při zadání vazby číselným kódem systém ignoruje textem zadaný název.
Ukázka 1 - systém pracuje s hodnotou 40 a ignoruje element Nazev:
<oos:Druh>
<oos:Kod>40</oos:Kod>
<oos:Nazev>?</oos:Nazev>
</oos:Druh>
Ukázka 2 - systém pracuje s elementem Nazev:
<oos:Druh>
<oos:Kod xsi:nil="true"/>
<oos:Nazev>pšenice</oos:Nazev>
</oos:Druh>
Podávání žádostí o uznání porostů - souhlas
Od prosince 2023 je připravena verze služby OOS_ZUP01C, která umožňuje na vstupu uvést element, který obsahuje v base64 PDF potvrzující souhlas vlastníka odrůdy. ÚKZÚZ preferuje elektronicky podepsané PDF ze strany vlastníka odrůd, aby mohlo být toto PDF v co nejvyšší míře zpracovávané strojově.
Souhlas je povinný pouze u některých odrůd. Z tohoto důvodu byla služba upravena, aby odbornému SW poskytovala informace, že žádost byla přijata, ale bude nutné dodat dodatečně potvrzení vlastníka odrůdy.
Na druhou stranu služba odmítne žádost pokud bylo potvrzení dodáno, ale odrůda jej nevyžaduje.
| Odrůda vyžaduje souhlas | Odrůda nevyžaduje souhlas | |
| Nevložení potvrzení vlastníka odrůdy |
žádost je přijata a v odpovědi je vyplněn nový element UpozorneniCol s hodnotou Nebyl přiložen souhlas majitele odrůdy k odrůdě, která má přiřazeného majitele. Souhlas majitele odrůdy musí být doručen dodatečně jinou cestou. |
žádost je přijata |
| Vloženým potvrzením vlastníka odrůdy | žádost je přijata a v odpovědi není žádné upozornění |
žádost je celá odmítnuta Element Ulozeno = false a je nutné potvrzení vlastníka nezasílat. |
<ChybaCol/>
<UpozorneniCol>
<Upozorneni>
<Popis>Kontrola dat</Popis>
<Detail>Nebyl přiložen souhlas majitele odrůdy k odrůdě, která má přiřazeného majitele. Souhlas majitele odrůdy musí být doručen dodatečně jinou cestou.</Detail>
</Upozorneni>
</UpozorneniCol>
Předplodiny z LPIS
V systému LPIS jsou uloženy plodiny, které množitel uvedl v rámci jednotné žádosti. Tyto předplodiny je možné získat službou LPI_HPP01A.
Přehled chyb
V odpovědi služby je zobrazen popis chyb. Nejčastější chyby jsou v nesprávné vazbě na číselníkovou službu OOS_CIS01C. Ukázka některých chyb je v přiložených souborech.
Přehled upozornění
Od února 2024 byl zaveden nový element na výstupu služby, který upozorňuje na případné drobné nedostatky žádosti. Žádost je přijata, ale zpětně je dodavateli vrácen seznam těchto nedostatků/upozornění.