Provozovny
(IZR_PRO01B)
Služba poskytuje informace o provozovnách a jejich změnách.
| Název služby | Provozovny (IZR_PRO01B) |
|---|---|
| Popis služby | Služba poskytuje informace o provozovnách a jejich změnách. |
| Verze služby | 01B |
| Způsob autorizace | BA - bez autorizace (služba nevyžaduje žádný prvek autorizace). |
| 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://epomzetest.gov.cz/ssl/nosso-app/EPO/WS/v2Online/vOKOsrv.ashx prod: https://epomze.gov.cz/ssl/nosso-app/EPO/WS/v2Online/vOKOsrv.ashx |
Vstupní data
Služba má 3 varianty:
- Volání na existenci změny v provozovnách registrovaných v IZR dle zadaných podmínek.
- Volání na stažení provozoven registrovaných v IZR dle zadaných podmínek.
- Volání na stažení provozoven konkrétního subjektu (dle SZRID), kdy v response jsou další detailní informace o provozovně (řezy platnosti vlastnictví a druhy zvířat).
Vrácené provozovny lze na vstupu omezit podle následujících podmínek:
- Stav provozovny – A - aktivní / Z - zrušená / X - všechny stavy
- Kód kraje.
- Typ provozovny – v současné době existují tyto typy provozoven:
- H - Hospodářství chovatele (lze pouze v kombinaci s kódem kraje).
- O - Obchodník
- A - Asanační podnik
- S - Shromažďovací středisko
- J - Jatky
- L - Líheň
- U - Uživatelské zařízení
V případě uvedení SZRID na vstup se ignoruje kód kraje a služba vrací všechny provozovny bez rozlišení kraje. Filtrace na stav provozovny je aktivní i u SZRID vstupu. Typ provozovny se nemusí uvádět v případě uvedení SZRID na vstupu. V opačném případě je typ provozovny povinný.
Kódy krajů
| Kód | Název kraje |
|---|---|
| 11 | Hlavní město Praha |
| 62 | Jihomoravský |
| 31 | Jihočeský |
| 53 | Pardubický |
| 52 | Královéhradecký |
| 61 | Vysočina |
| 41 | Karlovarský |
| 51 | Liberecký |
| 71 | Olomoucký |
| 32 | Plzeňský |
| 21 | Středočeský |
| 81 | Moravskoslezský |
| 42 | Ústecký |
| 72 | Zlínský |
Druhy zvířat - vlastnictví
V rámci vlastnictví provozovny jsou evidovány drobně odlišné typy zvířat. WS vrací vždy zkratku i popisný název druhu zvířat. Pro úplnost uvádíme seznam druhů zvířat, které služba vrací:
| Kód druhu | Název druhu |
|---|---|
| BEZ | běžci |
| DRU | drůbež |
| FAR | farmový chov |
| KOZ | kozy |
| KUN | koňovití |
| OVC | ovce |
| PRA | prasata |
| RNP | ryby neplemenné |
| RPL | ryby plemenné |
| SKO | skot |
| TMS | tuři mimo skot |
Historické druhy zvířat, které se mohou výjimečně objevit.
| Kód druhu | Název druhu |
|---|---|
| PST | pštros africký dvouprstý |
| TUR | tuři |
| NAN | nandu pampový |
Chybové stavy
| Kód | Text | Příčina |
|---|---|---|
| 10 | Nelze použít DATUM při GETDATA=false. | Zadána neplatná kombinace vstupních parametrů. |
| 11 | Nelze určit datum poslední změny. | Podle zadaných podmínek nelze určit datum poslední změny. |
| 12 | Zadaný typ provozovny neexistuje v číselníku typů provozoven. | Zadaný typ provozovny nebyl nalezen v číselníku typů provozoven. |
| 14 | Provozovny neobsahují data nebo nemají žádné změněny od uvedeného data. | Tabulka provozoven pro dané podmínky neobsahuje data. |
| 15 | Pro TYPPROVOZOVNY H musí být vyplněn parametr KODKRAJE | Z důvodů rozsáhlosti databáze hospodářství je nutné hospodářství filtrovat s elementem KODKRAJE. |
Změny verzí služeb
Verze B oproti verzi A
Přidána možnost filtrovat provozovny na kraje. U provozovny typu hospodářství je identifikace kraje povinná.