Výkup hroznů (PODPORA_VYKUPU_HROZNU)
(RVI_PVH01A)
Služba pro podporu výkupu hroznů
| Název služby | Výkup hroznů (PODPORA_VYKUPU_HROZNU) (RVI_PVH01A) |
|---|---|
| Popis služby | Služba pro podporu výkupu hroznů |
| 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 |
Služba realizuje 5 samostatných dotazů, proto není možné vystavit vzory dotazu a odpovědi v základní tabulce, ale jsou uvedeny zde:
- Ověření hroznů
- Dohledání čísla vinice
- Zápis výkupního lístku
- Zrušení výkupního lístku
- Testovací dotaz
WS1 – ověření hroznů
Tento typ dotazu provádí na základě registračního čísla vinice, kódu odrůdy a hmotnosti následující kontroly:
- Zda uvedená odrůda existuje v registru vinic
- Zda je nepřekročen hektarový výnos (popis výpočtu je níže)
- Zda existuje uvedená vinice
- Zda na dané vinici je zaregistrována daná odrůda
Dále může provádět ověření, zda uvedené rodné číslo, nebo IČ je registrovaný pěstitel na dané vinici.
Algoritmus ověřování nepřekročení hektarového výnosu
Pro výpočet jsou potřeba následující hodnoty
- Pěstitel – informace z registru
- Aktuální plocha skladeb vinice
- Hmotnost již vykoupených hroznů z dané vinice – informace z importovaných výkupních lístků
- Hmotnost právě vykupovaných hroznů – informace od XML rozhraní
Vlastní výpočet probíhá následujícím postupem
- Pěstitel je právnická nebo fyzická osoba uvedená jako pěstitel vinice, jejíž registrační číslo je REG_CISLO_VINICE
- Pro daného pěstitele a jeho vinice se spočítá maximální výnos v kg
- Plochy skladeb vinice (ha) x hektarový výnos pro jakostní víno (konstanta dle legislativy, současná hodnota je 14 000 kg/ha)
- Od tohoto maximálního výnosu se odečte hmotnost již vykoupených hroznů pěstitele
- Výsledek je množství hroznů, které lze ještě od uvedeného pěstitele vykoupit.
- Pokud je hmotnost právě vykupovaných hroznů menší než výsledek, pak atribut L_NEPREKROCEN_VYNOS bude obsahovat hodnotu Ano. V opačném případě bude atribut obsahovat hodnotu Ne.
WS2 – dohledání čísla vinice
Tento typ dotazu je určen pro takové případy, kdy výkupce nezná registrační číslo vinice, z které pocházejí vykupované hrozny.
Cílem tohoto typu dotazu je předat z RV informaci, o registračních číslech vinic, tratích a obcích vinic daného pěstitele případně i dané odrůdy.
WS3 – zápis výkupního lístku
Typ dotazu je určen pro kontrolu a import výkupního lístku. Provádí se kontrola a uložení výkupního lístku výkupce. Data pak slouží jako podklad pro kontrolu výnosu při dalších nákupech od tohoto dodavatele.
WS4 – zrušení výkupního lístku
Typ dotazu pro zrušení výkupního lístku pro případ, kdy dojde k chybě a je nutno výkupní lístek opravit
WS5 – testovací dotaz
Jen testovací dotaz – pro ověření dostupnosti a funkčnosti.