Zadání přípravy vývozu a vygenerování odpovídajících PLS
(IZR_VPLS01A)

Služba pro zadání přípravy vývozu a vygenerování odpovídajících PLS. V případě, že kolekce ušních známek obsahuje chybu, se příprava vývozu do IZR neukládá a PLS se negenerují.

Název služby	Zadání přípravy vývozu a vygenerování odpovídajících PLS (IZR_VPLS01A)
Popis služby	Služba pro zadání přípravy vývozu a vygenerování odpovídajících PLS. V případě, že kolekce ušních známek obsahuje chybu, se příprava vývozu do IZR neukládá a PLS se negenerují.
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. test
WSDL služby	test
Adresy serverů	test: https://epomzetest.gov.cz/ssl/nosso-app/EPO/WS/v2Online/vOKOsrv.ashx prod: https://epomze.gov.cz/ssl/nosso-app/EPO/WS/v2Online/vOKOsrv.ashx

Použití služby

Vstupem služby jsou údaje o hospodářství a zvířatech. Hospodářství se zadává bez hodnoty CZ. Pro hospodářství se následně uvádí ušní známky.

Výstupní formát

Na vstupu služby je možné specifikovat nepovinně výstupní formát PLS. Tento element EPLSTYP je nepovinný a může mít hodnoty:

ZipStream (výchozí formát pokud není na vstupu element EPLSTYP uveden),
ZipFile,
PDF.

V elementu EPLS se poté vrací binární obsah kódovaný v BASE64.
U typu ZipFile se vrací zip soubor obsahující 1 PDF soubor, který má název dle čísla zvířete.

Chyba v response

Pokud jsou vstupní údaje korektní, tak v response služby je hodnota Stav = Ok:

Pokud vstupní údaje nejsou korektní tak se vrací Stav = Chyba nebo Upozorneni a dále je blížší popis:

<STAV>Chyba</STAV>
<CHYBA>Nelze generovat PLS. Zvíře nemá vhodnou polohu (přísun) u chovatele.</CHYBA>

nebo upozornění

<STAV>Upozorneni</STAV>
<UPOZORNENI>Zvíře se nenachází na provozovně odkud je plánován přísun</UPOZORNENI>

Email na vstupu služby

Pokud je na vstupu služby uveden email, tak systém IZR nevrací EPLS v response služby, ale je EPLS zasláno na uvedený email. EPLS element v tomto případě není vůbec v response uveden. Pro všechny EPLS se zasílá jeden email, který obsahuje jeden PDF soubor, který obsahuje všechna PLS.

Přehled chyb

Webová služba může skončit na SOAP chybu.

Kód chyby	Popis
11	Subjekt s IDSZR XXX nebyl v IZR nalezen.

21	Neplatná hodnota pro údaj PROVOZOVNAHLAS. Délka musí být právě 8 znaků.
22	Neplatná hodnota pro údaj PROVOZOVNAHLAS. Provozovna s registračním číslem XXX neexistuje.
23	Hlásící provozovna XXX není vlastněna subjektem XXX.
24	Hlásící provozovna XXX není shromažďovací středisko.
25	Neplatná hodnota pro údaj PROVOZOVNAHLAS.

31	Neplatná hodnota pro údaj PROVOZOVNAPLANPRISUN. Délka musí být právě 8 znaků.
32	Neplatná hodnota pro údaj PROVOZOVNAPLANPRISUN. Provozovna s registračním číslem XXX neexistuje.
35	Neplatná hodnota pro údaj PROVOZOVNAPLANPRISUN.

41	Přípravu vývozu nelze plánovat v minulosti.
42	Přípravu vývozu lze plánovat max. 3 dny dopředu.

51	Nebyla zadána žádná ušní známka pro tisk PLS.
52	Kolekce ušních známek obsahuje duplicitní známku XXX.
53	Byl překročen maximální počet ušních (20) známek pro jeden request.