Webové služby Registru chmelnic
Service ID | Název služby, popis | Verze | Typ1 | Datový model3 | WSDL2, 3 | Věcný popis |
---|---|---|---|---|---|---|
RCH_PZC01A |
PUT Žádost o ověření chmele Služba slouží k zasílání datové zprávy obsahující žádost o ověření chmele do Registru chmelnic. |
01A | PF |
prod
test |
prod
test |
Detail |
RCH_PHL01A |
Hlášení (PUT_HLASENI_CHMELNICE) Služba zabezpečuje předání dat z lokálního SW do Registru chmelnic. Ve volání se předávají data prohlášení označovacích štítků. V odpovědi se propaguje stav přijetí dat do registru chmelnic včetně případných chybových stavů. |
01A | PF |
prod
test |
prod
test |
Detail |
RCH_GZC01A |
GET Žádost o ověření chmele Služba slouží k získání datové zprávy obsahující informace o žádosti o ověření chmele z Registru chmelnic. |
01A | PF |
prod
test |
prod
test |
Detail |
RCH_GST01A |
Štítky (GET_STITKY) Služba poskytuje vydané štítky pěstitelům pro certifikaci s informacemi pořízenými v RC na základě přijatých žádosti o přidělení štítků, které pěstitelé podávají před vlastní sklizní. |
01A | PF |
prod
test |
prod
test |
Detail |
RCH_GCH01A |
Chmelnice (GET_CHMELNICE) Služba vrací pro subjekt seznam registrovaných chmelnic k aktuálnímu datu. |
01A | PF |
prod
test |
prod
test |
Detail |
RCH_GCC01A |
Číselník chmelnic (GET_CISELNIK_CHMELNIC) Služba pro získání aktuálního stavu číselníků chmelnic. |
01A | BA |
prod
test |
prod
test |
Detail |
-
Typ služby - zabezpečení
- BA - bez autorizace (služba nevyžaduje žádný prvek autorizace). Služba je volně dostupná veřejnosti.
- PF - služba vyžaduje autorizaci minimálně na úrovni loginu do portálu farmáře a WS klíče
(ve formátu vOKO_wss_token.xml (1 kB)), je možné použít i elektronický podpis (ve formátu xml:Signature). O zřízení přístupu do PF eAGRI lze požádat dle následujícího postupu. Postup tvorby hash je uveden zde. Ověření/vytvoření tokenu pro konkrétní request je možné provést na této stránce.
-
prod/test - obsah políčka u příslušné služby říká, zda je aktuálně daná služba vystavena na testovacím či produkčním prostředí, nebo na obou prostředích. Pokud je u dané služby v příslušném políčku k dispozici "WSDL" (je zde uveden text "WSDL", který zároveň slouží jako odkaz k jeho stažení), pak je služba na daném prostředí vystavena.
-
Důležité upozornění! Mozilla Firefox (a některé další prohlížeče) nezobrazují XML korektně. Více informací najdete na stránce postupy.
-
Informace ke specifickým elementům v requestu služeb:
-
SERVICEID - služby BA i PF
Požadovaná služba se rozlišuje hodnotou parametrem SERVICEID uvnitř každé zprávy (requestu). Tedy: Volání příslušné služby provedete tak, že její identifikátor (např. LPI_DDP01A) vložíte do parametru SERVICEID. -
subjectID - služby PF
Do elementu Subject se vkládá povinný atribut subjectID, který obsahuje SZRID, které přidělilo MZe nebo SZIF v rámci registrace firmy do Portálu farmáře eAGRI. Hodnota SZRID je k dispozici po přihlášení do PF eAGRI.cz a po kliknutí na uživatelské jméno v horním pravém rohu. -
UIDkey - služba PF
Do elementu UIDkey se vkládá povinný atribut přiděleného přidělení login uživatele - 99xxx nebo 98xxx. -
RequestID - služby BA i PF
Jedná se o nepovinný element, který umožňuje "označkovat" request volitelným identifikátorem ze strany informačního systému subjektu. Hodnota se potom vrací v odpovědi služby. -
AppInfo - služby BA i PF
Nepovinný element, kam může konzument umístit specifikaci svého SW a použité verze.
-