Víno originální certifikace - import zatřídění
(RVI_VIZ01A)
Služba poskytuje rozhraní pro vkládání rozhodnutí o zatřídění vín VOC a umožňuje ověřit data vůči Registru vinic na základní kontroly bez vložení do DB RV.
| Název služby | Víno originální certifikace - import zatřídění (RVI_VIZ01A) |
|---|---|
| Popis služby | Služba poskytuje rozhraní pro vkládání rozhodnutí o zatřídění vín VOC a umožňuje ověřit data vůči Registru vinic na základní kontroly bez vložení do DB RV. |
| 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 |
Účel služby
Služba umožní na MZe předat informace o zatřídění vína na VOC. Přijatou datovou větu posoudí příslušné oddělení na MZe a předá zatřídění na ÚKZÚZ. Pokud i ÚKZÚZ souhlasí s obsahem datové věty je zatřídění zveřejněno na stránce zatříděných vín.
Přehled metod
- pro vkládání rozhodnutí - TYPZPRACOVANI je V. Služba poskytuje rozhraní pro vkládání rozhodnutí o zatřídění vín VOC do Registru vinic. Při vkládání jsou data podrobena kontrole a vložena, při pozitivním chybovém nálezu je vracen výpis chyb.
- pro ověření rozhodnutí - TYPZPRACOVANI je O. Služba umožňuje ověřit data vůči Registru vinic na základní kontroly bez vložení do DB RV. Odpověď vrací výpis chyb. Pokud jsou data z volání zpracována bez chyba vrací služba <VYSLEDEK>false</VYSLEDEK> - tedy, že nebyly nalezeny žádné chyby.
Tvrdé chyby vypisují seznam chyb, měkké chyby vypisují chyby a zároveň ukládají.
Tvrdé chyby:
část rozhodnutí:
- Nepodařilo se dohledat osobu a následně jí ani založit.
- Dokument rozhodnutí se nepodařilo uložit.
- Rozhodnutí se nepodařilo uložit.
- Subjekt není VOC.
- Subjekt není k datu člen VOC.
- Subjekt není člen VOC.
část zatřídění:
- Kód zatřídění už existuje v rámci stejného VOC.
- Dokument protokolu se nepodařilo uložit.
- Nevyplnění povinných polí.
- Nedodržení požadovaného formátu pole.
- Existence stejné šarže u subjektu (SARZE).
část vzorek:
- Nedohledána odrůda pro dané VOC a vinici - měkká chyba.
- Nedohledána vinice pro dané VOC - měkká chyba.
- Hrozny se nepodařilo uložit - neznámý kód odrůdy.
- Hrozny se nepodařilo uložit.
Opakované volání
Službu je možné opakovaně volat dokud je zatřídění k posouzení na MZe. Jakmile MZe postoupí zatřídění na ÚKZÚZ nelze již data aktualizovat a služba končí na chybu.
Aktualizační klíč je:
- stejný kód rozhodnutí a VOC,
- stejné rozhodnutí a stejný kód zatřídění.