Příjem dat evidence POR
(EPOR_PPOR01A)
Služba určená k předávání dat z elektronické evidence použití POR.
| Název služby | Příjem dat evidence POR (EPOR_PPOR01A) |
|---|---|
| Popis služby | Služba určená k předávání dat z elektronické evidence použití POR. |
| 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 |
Informace o službě
Služba slouží k zápis dat o použití POR do prostředí MZe. Služba v případě úspěšného uložení dat (viz chyby níže) odpoví http statusem 200 s informací o uložení dat.
Informace o následném zpracování dat ze strany MZe jsou poskytovány tzv. chybníkovou službou - EPOR_CHPOR01A.
Použití služby - doplňující informace
S ohledem na složitější použití služby je níže v přílohách vystaveno XLS soubor, který obsahuje podrobnější popis jednotlivých elementů.
Výtah nejdůležitějších informací
ObdobiOd, ObdobiDo
|
IdPozemek
| Povinný údaj - identifikuje plochu (tj. i část DPB), na které je plodina pěstována. Identifikátor může být původem z vlastního komerčního systému anebo lze používat i ID_PARCELA původem z LPIS. |
IdPestovani
| Klíčový identifikátor konkrétního jednoho pěstování plodiny, na který jsou vázány aplikace s Typem = P. Optimální stav je, aby dané jedno pěstování od výsevu/výsadby po sklizeň mělo právě jedno ID. Systém ale bude tolerovat i technicky rozdělené pěstování např. v důsledku přečíslování DPB. |
Vazba na číselníky
V rámci requestu dat je nutné zachovat vazbu na číselníky MZe. Předmětné číselníky jsou následující:
- číselník škodlivých organismů - webová služby EPH_GSO01B. Do služby se vkládá ID škodlivého organismu. Číselník škodlivých organismů obsahuje více typů a pro účely této služby je nutné pracovat s typem SK - škůdce
- číselník obchodních jmen přípravků - webová služba EPH_GCP01G nebo použití exportu dat do XLS/XML.
Přehled chyb
Webová služba může skončit na SOAP chybu, kdy nedojde k zápis dat do prostředí MZe a tato data nejsou ani vidět v tzv. chybníkové službě.
| Kód chyby | Popis |
| 11 | Subjekt se podle SZR ID nepodařilo načíst |
| 12 | Období od musí být vždy 1.7. |
| 13 | Období do musí být větší než období od. |
| 14 | Rok u období do musí být o 1 větší jako u období od (kromě roku 2023) |
| 15 | Období do musí být vždy poslední den v měsíci. |
| 16 | Období do nesmí být větší než poslední den v aktuálním měsíci |
| 17 | Podání nelze zpracovat. Již bylo bylo podáno za novější období. |
| 18 | Období od musí být minimálně 1.7.2023. |
Chybníková služba
Pokud proběhne uložení aplikací do systému MZe (zaslaná data nejsou vyhodnocena na výše uvedené chyby), provede systém MZe formální kontrolu dat. Výsledek této kontroly je k dispozici tzv. chybníkovou webovou službou, kdy se pro konkrétní GuidPodani vrací informace o chybách jednotlivých aplikací.