Popis webových služeb ISPOP

1.1.1 Typografické konvence

<?xml version="1.0" encoding="utf-8"?>
<!-- ukázka zdrojového kódu XML -->

1.3.1 Dokumenty

1.3.2 Správa hlášení

1.3.3 Registr ISPOP

1.3.4 Hlášení

1.3.5 Interní služby

2.3.1 Úrovně zabezpečení – bezpečnostní role

3.1.1 Aktuální verze

1. v20110901
   

   Existuje jediná aktuální verze – má označení v20110901.

2. Bugfixing
   

   Žádné opravy služeb nebyly zveřejněny.

3.1.2 Zastaralé verze

3.1.3 Podpůrné služby

3.2.1 DocumentRegistrationInputService

<?xml version="1.0" encoding="utf-8"?>
<xsd:element name="submit">
    <xsd:complexType>
        <xsd:sequence>
            <xsd:element name="indoc" type="xsd:base64Binary">
                <xsd:annotation>
                    <xsd:documentation xml:lang="cs">
                        Vstupní dokument zakódovaný v base64.
                    </xsd:documentation>
                </xsd:annotation>
            </xsd:element>
        </xsd:sequence>
    </xsd:complexType>
</xsd:element>

<?xml version="1.0" encoding="utf-8"?>
<xsd:element name="submitResponse">
    <xsd:complexType>
        <xsd:sequence>
            <xsd:element name="submitResponseDetails" type="SubmitResponseDetails" />
        </xsd:sequence>
    </xsd:complexType>
</xsd:element>

<xsd:complexType name="SubmitResponseDetails">
    <xsd:sequence>
        <xsd:element name="status" type="StatusCode">
            <xsd:annotation>
                <xsd:documentation xml:lang="cs">
                    Informace o úspěchu operace.  Viz //StatusCode.
                </xsd:documentation>
            </xsd:annotation>
        </xsd:element>
        <xsd:element name="documentNumber" type="xsd:string">
            <xsd:annotation>
                <xsd:documentation xml:lang="cs">
                    Číslo dokumentu.
                </xsd:documentation>
            </xsd:annotation>
        </xsd:element>
    </xsd:sequence>
</xsd:complexType>

<xsd:simpleType name="StatusCode">
    <xsd:restriction base="xsd:string">
        <xsd:enumeration value="OK">
            <xsd:annotation>
                <xsd:documentation>Návratová hodnota je v pořádku, nenastala žádná chyba</xsd:documentation>
            </xsd:annotation>
        </xsd:enumeration>
        <xsd:enumeration value="NO_INPUT">
            <xsd:annotation>
                <xsd:documentation>Nastala chyba, nebyl zadán správný vstup pro metodu</xsd:documentation>
            </xsd:annotation>
        </xsd:enumeration>
        <xsd:enumeration value="UNEXPECTED_SERVER_ERROR">
            <xsd:annotation>
                <xsd:documentation>Nastala neočekávaná chyba na serveru</xsd:documentation>
            </xsd:annotation>
        </xsd:enumeration>
        <xsd:enumeration value="UNEXPECTED_ERROR">
            <xsd:annotation>
                <xsd:documentation>Nastala neočekávaná chyba na serveru</xsd:documentation>
            </xsd:annotation>
        </xsd:enumeration>
        <xsd:enumeration value="XSD_ERROR">
            <xsd:annotation>
                <xsd:documentation>Nastala chyba při XSD validaci, formulář neodpovídá spŕavnému formátu
                </xsd:documentation>
            </xsd:annotation>
        </xsd:enumeration>
        <xsd:enumeration value="VALIDATION_ERROR">
            <xsd:annotation>
                <xsd:documentation>Nastala chyba při logické validaci formuláře</xsd:documentation>
            </xsd:annotation>
        </xsd:enumeration>
    </xsd:restriction>
</xsd:simpleType>

3.2.2 DocumentInputService

3.2.3 DocumentValidateService

<?xml version="1.0" encoding="utf-8"?>
<xsd:element name="validate">
    <xsd:complexType>
        <xsd:sequence>
            <xsd:element name="xmldoc" type="xsd:string">
                <xsd:annotation>
                    <xsd:documentation xml:lang="cs">
                        Vstupní dokument -- serializované XML do řetězce.
                    </xsd:documentation>
                </xsd:annotation>
            </xsd:element>
        </xsd:sequence>
    </xsd:complexType>
</xsd:element>

<?xml version="1.0" encoding="utf-8"?>
<xsd:element name="validateResponse">
    <xsd:complexType>
        <xsd:sequence>
            <xsd:element name="validateResponseDetails" type="ValidateResponseDetails" />
        </xsd:sequence>
    </xsd:complexType>
</xsd:element>

<xsd:complexType name="ValidateResponseDetails">
    <xsd:sequence>
        <xsd:element name="status" type="StatusCode">
            <xsd:annotation>
                <xsd:documentation xml:lang="cs">
                    Informace o úspěchu operace.  Viz //StatusCode.
                </xsd:documentation>
            </xsd:annotation>
        </xsd:element>
        <xsd:element name="xsdErrorList" type="XsdErrorList">
            <xsd:annotation>
                <xsd:documentation xml:lang="cs">
                    Seznam XSD chyb.  Výstup parseru XML.  Zprávy jsou v anglickém jazyce podle standardu XML.  Chyby v XSD znamenají automatické zamítnutí dokumentu.
                </xsd:documentation>
            </xsd:annotation>
        </xsd:element>
        <xsd:element name="validationErrorList" type="ValidationErrorList">
            <xsd:annotation>
                <xsd:documentation xml:lang="cs">
                    Seznam chyb, jež zabraňují dalšímu zpracování.
                </xsd:documentation>
            </xsd:annotation>
        </xsd:element>
        <xsd:element name="validationWarningList" type="ValidationErrorList">
            <xsd:annotation>
                <xsd:documentation xml:lang="cs">
                    Seznam chyb, jež nezabraňují dalšímu zpracování.
                </xsd:documentation>
            </xsd:annotation>
        </xsd:element>
        <xsd:element name="validationInfoList" type="ValidationErrorList">
                <xsd:annotation>
                    <xsd:documentation xml:lang="cs">
                        Seznam doplňujících informací.
                    </xsd:documentation>
                </xsd:annotation>
            </xsd:element>
    </xsd:sequence>
</xsd:complexType>

4.1.1 Aktuální verze

1. v20120411
   
   • velké změny v rozhraní a implementaci, klienti komunikující přes starší rozhraní (4.1.2) nebudou funkční.
   • oddělení akcí do jednotlivých oblastí
   • definice číselníků v XML (s vyjímkou číselníku ověřovatelů)
   • samotné definice jsou též chráněny jménem a heslem, více viz zabezpečení
   • pro snadnější orientaci byla použita česká terminologie v názvech typů a elementů s několika málo výjimkami
2. v20130221
   

   Služby navazují na úpravu ISPOP pro rok 2014 – podpora pro daňový řád. Koncepčně jsou zcela stejné jako služby verze v20120411 a platí pro ně to samé (chybové stavy, popis atributů, …). V příslušných sekcích jsou popsána rozšíření proti verzi v20120411.

   • revize webové služby detailu hlášení
     • rozšíření stávajících informací o adresu ohlašovatele; adresa ohlašovatele je pro hlášení podle standardů před rokem 2012 převzata z hlášení, pro nová hlášení po zprovoznění ISZR (informační systém základních registrů) jde o adresu z ISZR platnou v době zaslání hlášení
     • viz 10.3.2, vše ostatní jako pro verzi 4.1.1.1
   • rozšíření webové služby pro správu procesů o daňové workflow
3. Bugfixing
   
   1. 2012-04-15
      
      • revize definice konstant (enum typů)
      • oprava řazení
      • definice chybových stavů
   2. 2012-07-23
      
      • úpravy ve filtraci hlášení (HlaseniFilterTyp) umožňuje filtraci podle více zadaných stavů (stavDokumentu, stavHlaseni)
      • kontrola konverze dat u provozovny (HlaseniListEntryTyp > provozovna > ispopId skutečně obsahuje IČP – což odpovídá požadavkům)
      • opravena konverze dat u ohlašovatele (provozovatele) (HlaseniListEntryTyp > ohlasovatel > ispopId nyní obsahuje IČO (bylo ponecháno prázdné))
      • změna kodu ZNEPLATNENO na PARENT_ZNEPLATNENO v typech StavDokumentuCiselnikTyp a StavWorkflowCiselnikTyp
   3. 2012-08-03
      
      • oprava definice typu StavDokumentuListTyp, StavHlaseniListTyp
   4. 2012-09-23
      
      • oprava filtrovaní podle intervalu – chybné použití intervalu HlaseniFilterTyp.datumPrijetiSystem namísto intervalu HlaseniFilterTyp.datumPrijetiSpravniRad
   5. 2012-12-06
      
      • oprava výpisu seznamu podle filtru – v elementu processId bylo chybně uvedeno číslo ověřovatele a naopak v elementu ispopRoleId (určeno pro ověřovatele) bylo číslo procesu
   6. 2013-07-29
      
      • oprava filtrování o IČP provozovny – filtrovat lze nyní podle IČP
      • možnost řadit výsledek seznamu hlášení podle čísla evidenčního (rozšíření XSD)
   7. 2013-09-09
      
      • odstranění nevyužívaných XSD importů pro detail hlášení v20130221-hlaseniDetailService
      • přidání nové webové služby pro správu procesů s podporou daňového řádu v20130221-hlaseniProcessService
      • rozšíření definic číselníků pro daňový řád
   8. 2014-03-07
      
      • aktualizace číselníkových typů:
        • StavDokumentuCiselnikTyp
        • StavHlaseniCiselnikTyp
        • StavWorkflowCiselnikTyp
   9. 2014-05-05
      
      • aktualizace číselníkových typů:
        • StavDokumentuCiselnikTyp
        • StavHlaseniCiselnikTyp
        • StavWorkflowCiselnikTyp

4.1.2 Zastaralé verze

4.2.1 Správa hlášení v systému ISPOP

1. Práce s číselníky
   

   Číselníky jsou v naprosté většině případů podle požadavků součástí definice datových typů (tj. XSD enumerace). Nevýhodou je rozšiřitelnost služby – změna v definici číselníku znamená změnu v rozhraní služby. Výhodou naopak jasná propojenost hodnoty s typem a nemožnost posílat nevalidní hodnoty (resp. možnost kontroly hodnot již na úrovni XSD typů).

   Výjimkou je číselník ověřovatelů, viz 4.3.1.1.

2. Přílohy hlášení
   

   Hlášení do ISPOP může mít jednu ze dvou podob:

   1. XML
   2. PDF s pevně danou datovou větou v podobě XML

   Obě formy umožňují přikládat soubory do hlášení. Systém ISPOP z počátku neextrahoval žádné přílohy. Extrakce příloh z PDF byla doplněna k počátku roku 2012. Extrakce příloh XML k počátku roku 2013.

   Z tohoto důvodu není možné získat přílohy k hlášením:

   1. Pro XML před rokem 2013
   2. Pro PDF před rokem 2012

4.2.2 Chybové stavy

<?xml version="1.0" encoding="utf-8"?>
<xsd:simpleType name="SpravaHlaseniFaultCode">
    <xsd:restriction base="xsd:string">
        <xsd:enumeration value="UNEXPECTED_ERROR"/>
        <xsd:enumeration value="FIND_BY_FILTER_ILLEGAL_INPUT"/>
        <xsd:enumeration value="FIND_BY_FILTER_ORDERING_AND_PAGING_NOT_SPECIFIED"/>
        <xsd:enumeration value="FIND_BY_FILTER_PAGE_NOT_SPECIFIED"/>
        <xsd:enumeration value="FIND_BY_FILTER_MAX_RESULTS_NOT_SPECIFIED"/>
        <xsd:enumeration value="FIND_BY_FILTER_UNKNOWN_SORTING_CRITERION"/>
        <xsd:enumeration value="FIND_BY_FILTER_UNABLE_TO_QUERY_DATABASE"/>
        <xsd:enumeration value="HLASENI_DETAIL_ILLEGAL_INPUT"/>
        <xsd:enumeration value="HLASENI_DETAIL_CISLO_DOKUMENTU_NOT_SPECIFIED"/>
        <xsd:enumeration value="HLASENI_DETAIL_HLASENI_NOT_FOUND"/>
        <xsd:enumeration value="HLASENI_FILE_DATA_ILLEGAL_INPUT"/>
        <xsd:enumeration value="HLASENI_FILE_DATA_CISLO_DOKUMENTU_NOT_SPECIFIED"/>
        <xsd:enumeration value="HLASENI_FILE_DATA_UUID_NOT_SPECIFIED"/>
        <xsd:enumeration value="HLASENI_FILE_DATA_FILE_DATA_NOT_FOUND"/>
        <xsd:enumeration value="HLASENI_PROCESS_TRANSITION_ERROR"/>
    </xsd:restriction>
</xsd:simpleType>

4.3.1 HlaseniListService

1. Filtr
   

   XSD element filtru je samovypovídající.

   <?xml version="1.0" encoding="utf-8"?>
   <xsd:element name="hlaseniFilterDto">
       <xsd:complexType>
           <xsd:sequence>
               <xsd:element name="orderingAndPaging" type="wsc:OrderingAndPagingType"/>
               <xsd:element name="cisloDokumentu" type="frc:MediumStringTyp" minOccurs="0"/>
               <xsd:element name="datumPrijetiSystem" type="wsc:Interval" minOccurs="0"/>
               <xsd:element name="datumPrijetiSpravniRad" type="wsc:Interval" minOccurs="0"/>
               <xsd:element name="stavDokumentu" type="hlc:StavDokumentuCiselnikTyp" minOccurs="0"/>
               <xsd:element name="stavHlaseni" type="hlc:StavHlaseniCiselnikTyp" minOccurs="0"/>
               <xsd:element name="overovatel" type="hlc:OverovatelIdentificationTyp" minOccurs="0"/>
               <xsd:element name="typDokumentu" type="hlc:TypDokumentuCiselnikTyp" minOccurs="0"/>
               <xsd:element name="radneDoplnene" type="hlc:RadneDoplneneCiselnikTyp" minOccurs="0"/>
               <xsd:element name="ohlasovatel" type="hlc:OhlasovatelIdentificationTyp" minOccurs="0"/>
               <xsd:element name="provozovna" type="hlc:ProvozovnaIdentificationTyp" minOccurs="0"/>
               <xsd:element name="ohlasovanyRok" type="xsd:nonNegativeInteger" minOccurs="0"/>
               <xsd:element name="predmet" type="frc:LongStringTyp" minOccurs="0"/>
               <xsd:element name="predmetAdresa" type="frc:AdresaTyp" minOccurs="0"/>
           </xsd:sequence>
       </xsd:complexType>
   </xsd:element>
   

   Jediný povinný atribut je orderingAndPaging, kde zadáváte stránku a počet elementů na stránku. Snažte se pracovat pokud možno s co nejmenší množinou a zbytečně nezatěžovat server. Doporučená velikost stránky je do 100 záznamů. Maximální velikost je 500 záznamů.

   Filtrovat je možné podle:

   1. data, zadávano pomocí intervalů (Interval)
      • datumPrijetiSystem – systémový čas příjmu
      • datumPrijetiSpravniRad – čas příjmu podle správního řádu
   2. stavy hlášení a typ
      • stavHlaseni
      • stavDokumentu
      • typDokumentu
   3. předmět hlášení, ověřovatelé a další

   Všechny číselníkové typy jsou definovány jako výčtové typy v XSD s vyjímkou ověřovatelů. Pro zadání ověřovatelů použijte hodnoty v tabulce tabulka ověřovatelů, sloupec ISPOP_ROLE_ID, který použijete jako hodnotu do elementu ispopRoleId v rámci typu OverovatelIdentificationTyp.

   Pro naplnění elementu //HlaseniFilterDto/orderingAndPaging/sortingCriterion (xsd:string) lze použít řetězcové konstanty, jiné hodnoty nejsou umožněny.

   <?xml version="1.0" encoding="utf-8"?>
   <xsd:simpleType name="HlaseniFilterOrderingTyp">
       <xsd:restriction base="xsd:string">
           <xsd:enumeration value="CISLO_DOKUMENTU"/>
           <xsd:enumeration value="CISLO_EVIDENCNI"/>
           <xsd:enumeration value="DATUM_PRIJETI_SPRAVNI_RAD"/>
           <xsd:enumeration value="DATUM_PRIJETI_SYSTEM"/>
           <xsd:enumeration value="PREDMET"/>
       </xsd:restriction>
   </xsd:simpleType>
   

2. Výstupní seznam
   

   V rámci výstupného seznamu je k dispozici celá řada popisných dat.

   <?xml version="1.0" encoding="utf-8"?>
   <xsd:complexType name="HlaseniListEntryTyp">
       <xsd:sequence>
           <xsd:element name="cisloDokumentu" type="frc:MediumStringTyp"/>
           <xsd:element name="datumPrijetiSystem" type="xsd:dateTime"/>
           <xsd:element name="datumPrijetiSpravniRad" type="xsd:dateTime"  minOccurs="0"/>
           <xsd:element name="datumAutorizaceSystem" type="xsd:dateTime" minOccurs="0"/>
           <xsd:element name="datumAutorizaceSpravniRad" type="xsd:dateTime" minOccurs="0"/>
           <xsd:element name="datumPodaniSpravniRad" type="xsd:dateTime" minOccurs="0"/>
           <xsd:element name="datumVyrizeniSystem" type="xsd:dateTime" minOccurs="0"/>
           <xsd:element name="stavDokumentu" type="hlc:StavWorkflowCiselnikTyp"/>
           <xsd:element name="procesZpracovaniSeznam" type="ProcesZpracovaniListTyp" minOccurs="0"/>
           <xsd:element name="typDokumentu" type="hlc:TypDokumentuCiselnikTyp" minOccurs="0"/>
           <xsd:element name="radneDoplnene" type="hlc:RadneDoplneneCiselnikTyp" minOccurs="0"/>
           <xsd:element name="ohlasovatel" type="SubjektInfoTyp" minOccurs="0"/>
           <xsd:element name="provozovna" type="SubjektInfoTyp" minOccurs="0"/>
           <xsd:element name="ohlasovanyRok" type="xsd:nonNegativeInteger" minOccurs="0"/>
           <xsd:element name="predmet" type="frc:NonEmptyStringTyp" minOccurs="0"/>
           <xsd:element name="predmetAdresa" type="frc:AdresaTyp" minOccurs="0"/>
           <xsd:element name="evidencniCislo" type="frc:NonEmptyStringTyp" minOccurs="0"/>
           <xsd:element name="isdsId" type="frc:NonEmptyStringTyp" minOccurs="0"/>
           <xsd:element name="obsahujeChyby" type="xsd:boolean" minOccurs="0"/>
           <xsd:element name="pocetPriloh" type="xsd:nonNegativeInteger" minOccurs="0"/>
       </xsd:sequence>
   </xsd:complexType>
   
   <xsd:complexType name="ProcesZpracovaniListTyp">
       <xsd:sequence>
           <xsd:element name="procesZpracovani" type="ProcesZpracovaniListEntryTyp" minOccurs="0" maxOccurs="unbounded"/>
       </xsd:sequence>
   </xsd:complexType>
   
   <xsd:complexType name="ProcesZpracovaniListEntryTyp">
       <xsd:sequence>
           <xsd:element name="procesId" type="xsd:nonNegativeInteger"/>
           <xsd:element name="stavHlaseni" type="hlc:StavWorkflowCiselnikTyp"/>
           <xsd:element name="overovatel" type="SubjektInfoTyp"/>
       </xsd:sequence>
   </xsd:complexType>
   

   Významné výstupní informace, které se používají jako vstupy do dalších služeb jsou:

   1. cisloDokumentu
   2. procesId

   cisloDokumentu se využívá pro:

   1. získání detailních informací k danému hlášení (pokud jsou potřeba)
   2. změně stavu vybraného dokumentu

   procesId se využívá ke změně stavu během ověřování hlášení (dokumentu); jeden dokument může mít více asociovaných procesů.

4.3.2 HlaseniDetailService

1. Verze v20120411
   
   1. Metoda getHlaseniDetail
      
      1. Vstup
         

         <?xml version="1.0" encoding="utf-8"?>
         <xsd:complexType name="HlaseniDetailRequestTyp">
             <xsd:sequence>
                 <xsd:element name="cisloDokumentu" type="frc:MediumStringTyp" />
             </xsd:sequence>
         </xsd:complexType>
         

      2. Výstup
         

         <?xml version="1.0" encoding="utf-8"?>
         <xsd:complexType name="HlaseniDetailTyp">
             <xsd:sequence>
                 <xsd:element name="cisloDokumentu" type="frc:MediumStringTyp" />
                 <xsd:element name="validateResponseDetails" type="dcc:ValidateResponseDetails" minOccurs="0"/>
                 <xsd:element name="fileReferenceList" type="FileReferenceListTyp" minOccurs="0"/>
             </xsd:sequence>
         </xsd:complexType>
         

         Výstup udává informace o:

         • validačních chybách (pokud je možné ho poskytnout)
         • fyzických datech hlášení (originální dokument, XML data, přílohy)
   2. Metoda getHlaseniFileData
      

      Využívá jako vstup uuidDokumentu poskytované skrze getHlaseniDetail a vrací požadovaná data.

      1. Vstup
         

         <?xml version="1.0" encoding="utf-8"?>
         <xsd:complexType name="HlaseniFileDataRequestTyp">
             <xsd:sequence>
                 <xsd:element name="cisloDokumentu" type="frc:MediumStringTyp" />
                 <xsd:element name="uuidDokumentu" type="frc:MediumStringTyp" />
             </xsd:sequence>
         </xsd:complexType>
         

      2. Výstup
         

         <?xml version="1.0" encoding="utf-8"?>
         <xsd:complexType name="HlaseniFileDataTyp">
             <xsd:sequence>
                 <xsd:element name="fileData" type="wsc:FileData" />
             </xsd:sequence>
         </xsd:complexType>
         
         <xsd:complexType name="FileData">
             <xsd:sequence>
                 <xsd:element name="fileName" type="frc:LongStringTyp"/>
                 <xsd:element name="data" type="xsd:base64Binary" />
                 <xsd:element name="contentType" type="frc:MediumStringTyp" />
             </xsd:sequence>
         </xsd:complexType>
         

2. Verze v20130221
   

   Platé to samé co pro verzi v20120411 (chybové stavy, popis atributů, …). Byl rozšířen výstup metod:

   getHlaseniDetail	Získá detailní informace hlášení. Oproti HlaseniDetailServiceWsdl2012-summary vrací i adresu ohlašovatele.
   getHlaseniFileData	Získá příslušný soubor k danému hlášení (přílohu, originál, …). Stejné jako HlaseniDetailServiceWsdl2012-summary.

4.3.3 HlaseniProcessService

<?xml version="1.0" encoding="utf-8"?>
<xsd:complexType name="HlaseniProcesDetailTyp">
    <xsd:sequence>
        <xsd:choice>
            <xsd:element name="cisloDokumentu" type="frc:MediumStringTyp" />
            <xsd:element name="procesId" type="xsd:nonNegativeInteger"/>
        </xsd:choice>
        <xsd:element name="zprava" type="frc:ExtraLongStringTyp"/>
    </xsd:sequence>
</xsd:complexType>

<?xml version="1.0" encoding="utf-8"?>
<xsd:complexType name="HlaseniProcesResultTyp">
    <xsd:sequence>
        <xsd:element name="datumSystem" type="xsd:dateTime"/>
    </xsd:sequence>
</xsd:complexType>

1. Verze v20120411
   

   autorizujHlaseni	Provede autorizaci workflow.	ROLE_AUTORIZUJICI, ROLE_BRIGADNIK
   overHlaseni	Provede oveření hlášení (správní řad bezpoplatkové).	ROLE_OVEROVATEL
   zamitniOvereniHlaseni	Zamítne hlášení (správní řád).	ROLE_OVEROVATEL
   postupProNeprislusnost	Postoupí pro nepříslušnost (správní řád).	ROLE_OVEROVATEL
   zahajSpravniRizeni	Zahájí správní řízení.	ROLE_OVEROVATEL
   prerusSpravniRizeni	Přeruší správní řízení.	ROLE_OVEROVATEL
   vydejPoplatkovyVymer	Vydá poplatkový výměr (správní řád).	ROLE_OVEROVATEL
   zastavSpravniRizeni	Zastaví správní řízení.	ROLE_OVEROVATEL
   vydejStanovisko	Vydá stanovisko (správní řád).	ROLE_OVEROVATEL
   odlozBezpoplatkoveHlaseni	Odloží bezpoplatkové hlášení (správní řád).	ROLE_OVEROVATEL

2. Verze v20130221
   

   Platé to samé co pro verzi v20120411 (chybové stavy, popis atributů, …). Byly přidány metody pro změny stavů daňového řádu:

   autorizujHlaseni	Provede autorizaci workflow.	ROLE_AUTORIZUJICI, ROLE_BRIGADNIK
   overHlaseni	Provede oveření hlášení (správní řad bezpoplatkové).	ROLE_OVEROVATEL
   zamitniOvereniHlaseni	Zamítne hlášení (správní řád).	ROLE_OVEROVATEL
   srPostupProNeprislusnost	Postoupí pro nepříslušnost (správní řád).	ROLE_OVEROVATEL
   zahajSpravniRizeni	Zahájí správní řízení.	ROLE_OVEROVATEL
   prerusSpravniRizeni	Přeruší správní řízení.	ROLE_OVEROVATEL
   vydejPoplatkovyVymer	Vydá poplatkový výměr (správní řád).	ROLE_OVEROVATEL
   zastavSpravniRizeni	Zastaví správní řízení.	ROLE_OVEROVATEL
   vydejStanovisko	Vydá stanovisko (správní řád).	ROLE_OVEROVATEL
   odlozBezpoplatkoveHlaseni	Odloží bezpoplatkové hlášení (správní řád).	ROLE_OVEROVATEL
   provedAtrakci	Provede atrakci (daňový řád).	ROLE_OVEROVATEL
   provedDelegaci	Provede delegaci (daňový řád).	ROLE_OVEROVATEL
   zahajRizeni	Zahají řízení (daňový řád).	ROLE_OVEROVATEL
   zastavRizeni	Zastaví řízení (daňový řád).	ROLE_OVEROVATEL
   zpracujVadyPodani	Zpracuje vady podání (daňový řád).	ROLE_OVEROVATEL
   vydejPlatebniVymer	Vydá platební výměr (daňový řád).	ROLE_OVEROVATEL
   vydejPlatebniVymerNaNulu	Vydá platební výměr na nulu (daňový řád).	ROLE_OVEROVATEL
   drPostupProNeprislusnost	Postoupí pro nepříslušnost (daňový řád).	ROLE_OVEROVATEL

5.1.1 Aktuální verze

1. v20130505
   

5.1.2 Zastaralé verze

5.3.1 Struktura WSDL a XSD

1. Obvyklé operace a typy
   

   V rámci každé oblasti jsou typicky implementovány CRUD operace typu:

   • práce se seznamem
   • přístup k detailu
   • editační operace
     • vytvoření
     • editace – editačních operací je typicky více – logicky související celky se mění dohromady
   1. Základní typy
      

      XSD definice využívají společné typy z namespace http://ispop.cz/wscommon. Tento namespace je importován všemi ostatními balíky.

      Důležité typy v namespace http://ispop.cz/wscommon:

      NonEmptyString	Bázový typ pro 99% string definic.
      IntervalDto	Typ pro zadávání časového intervalu.
      AbstractDto	Bázový typ pro většinu komplexních typů, jež si vyměňuje server a klient.
      CommonAce	Základní typ pro nastavení práv nad objektem (ACL).
      PageInfo, OrderType, AbstractResultListDto	Typy pro podporu stránkování v dotazech.
      CommonFault	Pomocný typ pro využití ve výjimečných stavech (Exception).

   2. Stránkování
      

      Všechny metody, které jako návratový typ uvádějí kolekci určitého typu, dodržují tyto konvence:

      1. Vstupem je objekt, filtr, s jehož pomocí lze omezit výsledný seznam. Každý filtr obsahuje minimálně {http://ispop.cz/wscommon}PageInfo (tj. stránku a počet objektů na stránce) a kritéria řazení.
      2. Výstupní seznam obsahuje výslednou kolekci a informaci o celkovém počtu objektů s ohledem na aktuálně nastavená kriteria filtru.

      Díky těmto informacím je možné efektivně stránkovat ve velkých kolekcích dat.

      1. Filtr
         

         <?xml version="1.0" encoding="utf-8"?>
         <xsd:complexType name="CatalogNameFilterDto">
             <xsd:sequence>
                 <xsd:element name="pageInfo" type="wscommon:PageInfo" />
                 <xsd:element name="sortCriteria" type="tns:CatalogNameSortCriteriaDto" minOccurs="0" maxOccurs="unbounded" />
             </xsd:sequence>
         </xsd:complexType>
         

         Na příkladu je vidět minimalistický filtr, použitý ve filtrování pro CatalogService (Číselníky). Jako každý filtr obsahuje element pageInfo, kde je na vstupu povinně zadaná stránka (číslováno od nuly!) a počet záznamů na stránku.

         Jméno pageInfo (typ {http://ispop.cz/wscommon}PageInfo) je striktně dodržováno a umožňuje tak při pokročilém využití bindingu do konkrétního jazyka (např. Java XJB) zobecnit kusy kódu například tím, že všechny filtry implementují určité rozhraní.

         Dále obsahuje každý filtr sortCriteria (jedno či více), což je seznam konstant, jež určují řazení výsledné kolekce. Názvy jsou voleny tak, aby odpovídaly ostatním elementům filtru – je tak jasné, podle čeho se bude řadit.

      2. Výstupní kolekce
         

         <?xml version="1.0" encoding="utf-8"?>
         <xsd:complexType name="CatalogNameResultListDto">
             <xsd:complexContent>
                 <xsd:extension base="wscommon:AbstractResultListDto">
                     <xsd:sequence>
                         <xsd:element name="list" type="tns:CatalogName" minOccurs="0" maxOccurs="unbounded" />
                     </xsd:sequence>
                 </xsd:extension>
             </xsd:complexContent>
         </xsd:complexType>
         

         Každá výstupní kolekce dědí z {http://ispop.cz/wscommon}AbstractResultListDto, kde je definován element /AbstractResultListDto/totalCount, který uvádí celkový počet řádků pro aktuální filtrační ktriteria.

         Konkrétní implementace mají navíc element list (pojmenování je opět dodržováno) obsahující jednotlivé položky seznamu; zde seznam elementu CatalogName.

   3. Číselníky
      

      Číselníkové hodnoty se vyskytují napříč webovými službami. Úvodní verze číselníků je definována v namespace http://ispop.cz/catalog/v20130505, jež je popsán v souborech:

      • catalog.xsd – SOAP zprávy pro CatalogService (Číselníky)
      • catalog-common.xsd – bázové typy pro číselníky
      • catalog-types.xsd – jednotlivé číselníkové typy

      V catalog-common.xsd lze nalézt:

      AbstractCatalogDto	Bázový typ všech číseníků. Používá se jako vstupní objekt z klienta (lze zadat jen /AbstractCatalogDto/code) i jako výstupní objekt ze serveru (pak jsou naplněny všechny elementy). Ostatní číselníky jsou odvozeny z tohoto typu.
      CatalogValueFilterDto a CatalogValueResultListDto	Filtr a návratový seznam pro hodnoty číselníku.

      Byť na straně serveru je pro číselníky rozlišována platnost, webové služby mají jednodušší rozhraní (bez platnosti). Platí, že kód číselníku je unikátní (tj. /AbstractCatalogDto/code) a klient dostává všechny hodnoty (i ty neplatné).

2. Chybové stavy
   

   <?xml version="1.0" encoding="utf-8"?>
   <xsd:complexType name="CommonFault">
       <xsd:sequence>
           <xsd:element name="code" type="xsd:string" />
           <xsd:element name="message" type="xsd:string" />
       </xsd:sequence>
   </xsd:complexType>
   

   Volání na server nemusí být vždy úspěšné. Každý výjimečný stav vrácený klientovi obsahuje podrobnější informaci {http://ispop.cz/wscommon}CommonFault, přičemž je snaha, aby element /CommonFault/message obsahoval rozumný popis chyby, který lze prezentovat uživateli, ostatní informace jsou interní a slouží ke zpětnému dohledání chyby v lozích serveru.

   Každá operace, vyjma těch nejtriviálnějších definuje vlastní chybové zprávy (zpravidla jednu) a na základě kódu (/CommonFault/code) je možné provést podrobnější ošetření chyby.

   Pro každé volání na server je definována precondition a postcondition. Cílem implementace je v precondition provést všechny potřebné testy a kontroly tak, aby bylo zřejmé, zda vyvolaná operace uspěje či nikoliv. Pokud není šance na úspěch, je navozen výjimečný stav a je nastaven CommonFault.

   Kód	Příčina	Ošetření
   AccessDeniedError	Chyba v oprávněních. Uživatel (volající) nemá právo vyvolat danou operaci, popř. nemá právo vyvolat danou operaci pro daný objekt.	Zobrazení rozumné informace pro uživatele. Nemá smysl operaci opakovat.
   ValidationError	Během provádění precondition bylo na serveru zjištěno, že z určitých důvodů nelze operaci provést. /CommonFault/message pak obsahuje podrobnější zprávu.	Zobrazení /CommonFault/message uživateli. Ten by měl posoudit, zda a případně jak změnit vstup; je možné opětovné volání.
   CommunicationError	Chyba komunikace s ISPOP. Chybný vstup požadavku (nevalidní XSD jako vstup do webové služby apod.).	Zobrazení rozumné informace pro uživatele. Pokud nejde o chybu klienta, může být vhodné operaci zkusit znovu po určité době.
   Jiný kód	Neočekávaná chyba.	Zobrazení informace uživateli. Nemá smysl opakovat. Kontaktovat správce systému.

5.3.2 Jmenné konvence

1. Typy
   

   Číselníkové typy končí na CatalogDto (PartyTypeCatalogDto).

   Pro každou oblast webových služeb typicky existuje:

   Pro práci se seznamem, viz Stránkování.

   Bean ListEntryDto	LegalSubjectListEntryDto	Prvek seznamu pro danou entitu.
   Bean ResultListDto	LegalSubjectResultListDto	Seznam objektů pro danou entitu
   Bean FilterDto	LegalSubjectFilterDto	Filtr pro vyhledávací operaci findByFilter

   Pro konkrétní instance:

   Bean DetailDto	LegalSubjectDetaulDto	Detailní data dané entity.
   Bean InfoDto	LegalSubjectInfoDto	Základní informace o entitě – používáno například v referencích.
   Bean Ident	LegalSeubjectIdent	Jedinečný identifikátor entity.

   Prefix Abstract je rezervován pro abstraktní typy; slouží jako bázové typy pro ostatní entity.

2. Operace
   

   WSDL jsou rozdělena do 3 skupin:

   • oblast .wsdl (čtecí operace – přístup k datům)

   findByFilter	Metoda pro vyhledávání, vrací kolekce s ohledem na pořadí (BeanResultListDto), přebírá BeanListFilter, pokud není určeno řadící kritérium, je zvoleno přednastavené, aby bylo garantováno korektní stránkování.
   getDetail	Metoda pro získání detailu entity, přebírá BeanIdent a vrací BeanDetailDto

   • oblast edit.wsdl – pro operace modifikace je většinou dostupných více metod pro úpravu souvisejících informací, vstupy a výstupy těchto operací jsou většinou závislé na konkrétní operaci. Obecně platí, že při tvorbě objektů vracíme jejich identy (BeanIdent) volajícímu.

   oblast process.wsdl – pokud existuje workflow a jeho obsluha je publikována pro třetí stranu, jednotlivé metody definují přechody mezi stavem workflow.

5.3.3 Chybové stavy

<?xml version="1.0" encoding="utf-8"?>
<xsd:complexType name="CommonFault">
    <xsd:sequence>
        <xsd:element name="code" type="xsd:string" />
        <xsd:element name="message" type="xsd:string" />
    </xsd:sequence>
</xsd:complexType>

5.4.1 Číselníky

1. CatalogService
   

   CatalogService

   catalog.wsdl

   Autorizovaná služba pro vyhledání a získání hodnot číselníků

   

   getCatalogNames	Vrací seznam číselníků exportovaných pro webové služby.	ROLE_UZIVATEL
   getCatalogValues	Vrací seznam hodnot pro daný číselník (vstup do metody lze získat z předchozího volání getCatalogNames).	ROLE_UZIVATEL

   Služba poskytutuje přístup k libovolnému číselníku. Pomocí metody getCatalogNames získá klient seznam všech číselníků. Ostatní webové služby vyžadují jako vstup číselník konkrétního typu. Lze jednoduše odvodit (podle jména), jak získat hodnoty daného číselníku voláním getCatalogValues. Vrácené hodnoty lze jednoduše použít k vytvoření vstupních hodnot do zbylých webových služeb. V principu jde o transformaci mezi obecným typem AbstractCatalogDto do konkrétního číselníku, kdy pro vstup do webové služby stačí pouze vyplnit jedinou povinnou položku – /AbstractCatalogDto/code:

   <?xml version="1.0" encoding="utf-8"?>
   <xsd:complexType name="AbstractCatalogDto" abstract="true">
       <xsd:sequence>
           <xsd:element name="code" type="tns:CatalogCode"/>
           <xsd:element name="label" type="wscommon:LongString" minOccurs="0" />
           <xsd:element name="name" type="tns:CatalogName" minOccurs="0"/>
       </xsd:sequence>
   </xsd:complexType>
   

5.4.2 Dokumenty

1. DocumentService
   

   DocumentService

   document.wsdl

   Autoriovaná služba pro přístup k dokumentům (fyzickým souborům zaslaným do ISPOP)

   

   getDocument

   Vrací data (binární stream) souboru, který byl někdy vložen do systému ISPOP.

   ROLE_UZIVATEL

   Každý dokument, který byl zaslán do ISPOP (hlášení, příloha hlášení, příloha zmocnění, autorizace, …) získává automaticky jedinečné UUID (/Uuid/). Ostatní webové služby nikdy nevrací fyzická data přímo – vždy jen v podobě UUID. UUID slouží jako vstup do této metody a volající získá nazpět zaslaná data.

5.4.3 Subjekty

1. LegalSubjectService
   

   5.4.3.1

   legalsubject.wsdl

   Autorizovaná služba pro vyhledání a získání subjektu

   

   findByFilter	Vrací seznam subjektů (tj. právních subjektů s rolí ohlašovatel, ověřovatel nebo recenzent).	ROLE_OHLASOVATEL, ROLE_RECENZENT, ROLE_BRIGADNIK, ROLE_READER, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR
   getDetail	Vrací detail pro daný subjekt, vstupem je ident subjektu (LegalSubjectIdent).	ROLE_OHLASOVATEL, ROLE_RECENZENT, ROLE_BRIGADNIK, ROLE_READER, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR
   getBriefDetail	Vrací specifický detail pro daný subjekt, vstupem je opět ident subjektu (LegalSubjectIdent). Operace getDetail vrací zevrubný a rozsáhlý seznam hodnot a je náročná na CPU a paměť. Pro základní prezentaci použijte tuto metodu.	ROLE_OHLASOVATEL, ROLE_RECENZENT, ROLE_BRIGADNIK, ROLE_READER, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR

   Jedná se o klasický případ master–detail. Stejným způsobem funguje i řada dalších služeb, viz Struktura WSDL a XSD.

   1. Model tříd
      

      

2. LegalSubjectEditService
   

   5.4.3.2

   legalsubjectedit.wsdl

   Autorizovaná služba pro změny v subjektech

   

   updateRobInfo	Aktualizace údajů z ROS. Privilegovaná operace.	ROLE_OPERATOR, ROLE_SPRAVCE_SUBJEKTU
   updateRosInfo	Aktualizace údajů z ROS. Privilegovaná operace.	ROLE_OPERATOR, ROLE_SPRAVCE_SUBJEKTU
   createDoklad	Přidá doklad do sezamu dokladů; dokladem může být občanský průkaz či pas.	ROLE_OPERATOR, ROLE_SPRAVCE_SUBJEKTU
   updateDoklad	Aktualizuje vybraný doklad.	ROLE_OPERATOR, ROLE_SPRAVCE_SUBJEKTU
   deleteDoklad	Odstraní doklad ze seznamu dokladů.	ROLE_OPERATOR, ROLE_SPRAVCE_SUBJEKTU
   updateLegalSubjectContacts	Slouží k aktualizaci vybraných kontaktních údajů.	ROLE_OPERATOR, ROLE_SPRAVCE_SUBJEKTU
   updateLegacyPerson	Slouží k aktualizaci údajů pro subjekt – fyzickou osobu pro data před napojením ISPOP na ISZR (Informační systém základních registrů).	ROLE_OPERATOR, ROLE_SPRAVCE_SUBJEKTU
   updateLegacyPersonWithoutIc	Slouží k aktualizaci údajů pro subjekt bez IČ pro data před napojením ISPOP na ISZR.	ROLE_OPERATOR, ROLE_SPRAVCE_SUBJEKTU
   updateLegacyOrganization	Slouží k aktualizaci údajů pro subjekt s IČ pro data před napojením ISPOP na ISZR.	ROLE_OPERATOR, ROLE_SPRAVCE_SUBJEKTU

   Neexistuje metoda pro vytvoření subjektu. Subjekt může v ISPOP vzniknout pouze registračním procesem, který podléhá speciálnímu workflow a je řízen provozovatelem systému.

   U privilegovaných operací může správce subjektu měnit jen některé údaje.

5.4.4 Místa užívání vody (= Elemetární zdroje)

1. ElementarniZdrojService
   

   ElementarniZdrojService

   elementarnizdroj.wsdl

   Autoriovaná služba pro přístup k elementárním zdrojům (místům užívání vody)

   

   findVypustByFilter	Vrací seznam elementárních zdrojů typu Vypouštění na základě parametrů ve filtru.	ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR
   findAkumulaceByFilter	Vrací seznam elementárních zdrojů typu Akumulace na základě parametrů ve filtru.	ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR
   findOdbernePodzemniMistoByFilter	Vrací seznam elementárních zdrojů typu Podzemní odběrné místo na základě parametrů ve filtru.	ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR
   findOdbernePovrchoveMistoByFilter	Vrací seznam elementárních zdrojů typu Povrchové odběrné místo na základě parametrů ve filtru.	ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR
   findByFilter	Vrací obecný seznam elementárních zdrojů na základě parametrů ve filtru.	ROLE_OHLASOVATEL, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR, ROLE_READER, ROLE_BRIGADNIK
   getVypustDetail	Vrací konkrétní elementární zdroj typu Vypouštění.	ROLE_OHLASOVATEL, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR, ROLE_READER, ROLE_BRIGADNIK
   getAkumulaceDetail	Vrací konkrétní elementární zdroj typu Akumulace.	ROLE_OHLASOVATEL, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR, ROLE_READER, ROLE_BRIGADNIK
   getOdbernePovrchoveDetail	Vrací konkrétní elementární zdroj typu Povrchové odběrné místo.	ROLE_OHLASOVATEL, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR, ROLE_READER, ROLE_BRIGADNIK
   getOdbernePodzemniDetail	Vrací konkrétní elementární zdroj typu Podzemní odběrné místo .	ROLE_OHLASOVATEL, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR, ROLE_READER, ROLE_BRIGADNIK

2. ElementarniZdrojEditService
   

   ElementarniZdrojEditService

   elementarnizdrojedit.wsdl

   Autoriovaná služba pro změny elementárních zdrojů (míst užívání vody)

   

   Metody poskytují kompletní CRUD operace nad elementárními zdroji a nějaké další specifické operace.

   createVypust	Vytvoří elementární zdroj typu vypouštění.	ROLE_VOD_OPERATOR
   createAkumulace	Vytvoří elementární zdroj typu akumulace.	ROLE_VOD_OPERATOR
   createOdbernePovrchoveMisto	Vytvoří elementární zdroj typu povrchové místo.	ROLE_VOD_OPERATOR
   createOdbernePodzemniMisto	Vytvoří elementární zdroj typu podzemní místo.	ROLE_VOD_OPERATOR
   updateZakladniInformace	Upraví základní informace sloužících k identifikaci a základnímu popisu elementárního zdroje. jedná se o společnou službu pro všechny typy elementárních zdrojů.	ROLE_VOD_OPERATOR
   updateKontaktniUdaje	Upraví kontaktní informace povinného subjektu na elementárním zdroji. Jedná se o společnou službu pro všechny typy elementárních zdrojů.	ROLE_VOD_OPERATOR
   updatePovinnySubjekt	Upraví povinný subjekt na elementárním zdroji. Jedná se o společnou službu pro všechny typy elementárních zdrojů.	ROLE_VOD_OPERATOR
   updateNace	Upraví druh ekonomické činnosti který je evidován na elementárním zdroji. Jedná se o společnou službu pro všechny typy elementárních zdrojů.	ROLE_VOD_OPERATOR
   updateJtsk	Upraví Jtsk souřadnice elementárního zdroje. Jedná se o společnou službu pro všechny typy elementárních zdrojů.	ROLE_VOD_OPERATOR
   updatePovinnostiPriloh	Upraví informace o povinnosti specifických typů příloh k danému zdroji.	ROLE_VOD_OPERATOR
   updateUmisteniZdroje	Upraví informací o umístění zdroje (obec, katastrální území).	ROLE_VOD_OPERATOR
   updateVypustAttributes	Operace pro změnu rozšířené množiny specifických atributů zdroje typu Vypouštění.	ROLE_VOD_OPERATOR
   updateAkumulaceAttributes	Operace pro změnu rozšířené množiny specifických atributů zdroje typu Akumulace.	ROLE_VOD_OPERATOR
   updateOdbernePovrchoveMistoAttributes	Operace pro změnu rozšířené množiny specifických atributů zdroje typu Odběrné povrchové místo.	ROLE_VOD_OPERATOR
   updateOdbernePodzemniMistoAttributes	Operace pro změnu rozšířené množiny specifických atributů zdroje typu Odběrné podzemní místo.	ROLE_VOD_OPERATOR
   updateVypust	Operace pro změnu úplné množiny atributů zdroje typu Vypouštění.	ROLE_VOD_OPERATOR
   updateAkumulace	Operace pro změnu úplné množiny atributů zdroje typu Akumulace.	ROLE_VOD_OPERATOR
   updateOdbernePovrchoveMisto	Operace pro změnu úplné množiny atributů zdroje typu Odběrné povrchové místo.	ROLE_VOD_OPERATOR
   updateOdbernePodzemniMisto	Operace pro změnu úplné množiny atributů zdroje typu Odběrné podzemní místo.	ROLE_VOD_OPERATOR
   invalidate	Znaplatní elementární zdroj k danému časovému okamžiku. V potaz se bere datumová i časová složka. Jedná se o společnou službu pro všechny typy elementárních zdrojů.	ROLE_VOD_OPERATOR
   restore	Znaplatní elementární zdroj k danému časovému okamžiku. V potaz se bere datumová i časová složka. Jedná se o společnou službu pro všechny typy elementárních zdrojů.	ROLE_VOD_OPERATOR
   changeOwner	Změna vlastníka elementárního zdroje. Jedná se o společnou službu pro všechny typy elementárních zdrojů.	ROLE_VOD_OPERATOR

3. RozhodnutiService
   

   RozhodnutiService

   rozhodnuti.wsdl

   Autoriovaná služba pro přístup k rozhodnutím (míst užívání vody)

   

   Všechny operace vrací seznam vodoprávních rozhodnutí pro elementární zdroje. Jednotné operace typu get* jsou specializované pro jednotlivé typy elementárních zdrojů. Dále je k dispozici obecnější operace findRozhodnutiByFilter pro dotažení seznamu vodoprávních rozhodnutí na základě podrobnějšího zadání ve formě filtru.

   getRozhodnutiAkumulaceDetail	Vrací seznam vodoprávních rozhodnutí pro elementární zdroje typu Akumulace typu Povolení akumulace.	ROLE_OHLASOVATEL, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR, ROLE_READER, ROLE_BRIGADNIK
   getRozhodnutiSchvaleniManipRaduDetail	Vrací seznam vodoprávních rozhodnutí typu Schválení manipulačního řadu.	ROLE_OHLASOVATEL, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR, ROLE_READER, ROLE_BRIGADNIK
   getRozhodnutiOdberPodzDetail	Vrací seznam vodoprávních rozhodnutí pro elementární zdroje typu Odběr podzemních vod : Povolení odběru podzemních vod.	ROLE_OHLASOVATEL, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR, ROLE_READER, ROLE_BRIGADNIK
   getRozhodnutiOdberPovrDetail	Vrací seznam vodoprávních rozhodnutí pro elementární zdroje typu Odběr povrchovách vod : Povolení odběru povrchových vod.	ROLE_OHLASOVATEL, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR, ROLE_READER, ROLE_BRIGADNIK
   getRozhodnutiOchranePasmoDetail	Vrací seznam vodoprávních rozhodnutí typu Stanovení ochranného pásma.	ROLE_OHLASOVATEL, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR, ROLE_READER, ROLE_BRIGADNIK
   getRozhodnutiVypousteniDetail	Vrací seznam vodoprávních rozhodnutí pro elementární zdroje typu Vypouštění : Povolení vypouštění.	ROLE_OHLASOVATEL, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR, ROLE_READER, ROLE_BRIGADNIK
   findRozhodnutiByFilter	Vrací seznam vodoprávních rozhodnutí na základě parametrů filtru.	ROLE_OHLASOVATEL, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR, ROLE_READER, ROLE_BRIGADNIK

4. RozhodnutiEditService
   

   RozhodnutiEditService

   rozhodnutiedit.wsdl

   Autoriovaná služba pro přístup k rozhodnutím (míst užívání vody)

   

   Operace slouží pro vytváření nebo změnu vodoprávních rozhodnutí pro elementární zdroje. Operace jejichž jméno má předponu create* slouží k přidání nového vodoprávního rozhodnutí daného typu. Nově vytvořené rozhodnutí nejsou připojeny k elementárnímu zdroji. K připojení slouží služba ElemZdrojRozhodnutiEditService. Operace jejichž jméno má předponu update* slouží ke změně existujícího vodoprávního rozhodnutí daného typu. Měnit lze atributy jednotlivých rozhodnutí ale ne přiřazení k elementárním zdrojům. ke změně přiřazení k elementárním zdrojům slouží služba ElemZdrojRozhodnutiEditService.

   createRozhodnutiAkumulace	Vytvoření nového vodoprávního rozhodnutí pro elementární zdroje Akumulace typu Povolení akumulace.	ROLE_VOD_OPERATOR
   createRozhodnutiSchvaleniManipRadu	Vytvoření nového vodoprávního rozhodnutí Schválení manipulačního řadu.	ROLE_VOD_OPERATOR
   createRozhodnutiOdberPodz	Vytvoření nového vodoprávního rozhodnutí pro elementární zdroje typu Odběr podzemních vod : Povolení odběru podzemních vod.	ROLE_VOD_OPERATOR
   createRozhodnutiOdberPovr	Vytvoření nového vodoprávního rozhodnutí pro elementární zdroje typu Odběr povrchových vod : Povolení odběru povrchových vod.	ROLE_VOD_OPERATOR
   createRozhodnutiOchranePasmo	Vytvoření nového vodoprávního rozhodnutí typu Stanovení ochranného pásma.	ROLE_VOD_OPERATOR
   createRozhodnutiVypousteni	Vytvoření nového vodoprávního rozhodnutí pro elementární zdroje typu Vypouštění : Povolení vypouštění.	ROLE_VOD_OPERATOR
   updateRozhodnutiAkumulace	Úprava existujícího vodoprávního rozhodnutí pro elementární zdroje Akumulace typu Povolení akumulace.	ROLE_VOD_OPERATOR
   updateRozhodnutiSchvaleniManipRadu	Úprava existujícího vodoprávního rozhodnutí Schválení manipulačního řadu.	ROLE_VOD_OPERATOR
   updateRozhodnutiOdberPodz	Úprava existujícího vodoprávního rozhodnutí pro elementární zdroje typu Odběr podzemních vod : Povolení odběru podzemních vod.	ROLE_VOD_OPERATOR
   updateRozhodnutiOdberPovr	Úprava existujícího vodoprávního rozhodnutí pro elementární zdroje typu Odběr povrchovách vod : Povolení odběru povrchových vod.	ROLE_VOD_OPERATOR
   updateRozhodnutiOchranePasmo	Úprava existujícího vodoprávního rozhodnutí typu Stanovení ochranného pásma.	ROLE_VOD_OPERATOR
   updateRozhodnutiVypousteni	Úprava existujícího vodoprávního rozhodnutí pro elementární zdroje typu Vypouštění : Povolení vypouštění.	ROLE_VOD_OPERATOR

5. ElemZdrojRozhodnutiService
   

   ElemZdrojRozhodnutiService

   elemzdrojrozhodnuti.wsdl

   Autorizovaná služba pro přístup k vazbám mezi elementárními zdroji (místy užívání vody) a rozhodnutími

   

   Operace slouží pro získání informace o přiřazení vodoprávních rozhodnutí k elementárním zdrojům.

   findByFilter	Získání objektů obsahujíácí informace o přiřazení vodoprávních rozhodnutí k elementárním zdrojům na základě parametrů ve filtru.	ROLE_OHLASOVATEL, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR, ROLE_READER, ROLE_BRIGADNIK
   findElemZdrojRozhodnutiByIdentification	Získání objektu obsahujícího informaci o přiřazení vodoprávního rozhodnutí k elementárnímu zdroji na základě identifikace vazby mezi rozhodnutím a elem. zdrojem.	ROLE_OHLASOVATEL, ROLE_VOD_OPERATOR, ROLE_PZV_OPERATOR, ROLE_READER, ROLE_BRIGADNIK

6. ElemZdrojRozhodnutiEditService
   

   ElemZdrojRozhodnutiEditService

   elemzdrojrozhodnutiedit.wsdl

   Autoriovaná služba pro změny vazeb elementárních zdrojů (míst užívání vody) a rozhodnutí

   

   Operace slouží pro vytvoření nebo změnu vazby mezi existujícím elementárním zdrojem a existujícím vodoprávním rozhodnutím. Omezující podmínky:

   • K elemetárnímu zdroji daného typu lze připojovat rozhodnutí stejného typu.
   • K elemetárnímu zdroji lze mít připojeno více vodoprávních rozhodnutí stejného typu.
   • Součástí atributů vazby je časová platnost. V daný časový okamžik může být připojeno maximálně jedno platné vodoprávní rozhodnutí k jednomu elementárnímu zdroji.

   createElemZdrojRozhodnuti	Vytvoření vazby mezi existujícím elementárním zdrojem a existujícím vodoprávním rozhodnutím.	ROLE_VOD_OPERATOR
   updateElemZdrojRozhodnuti	Změna vazby mezi existujícím elementárním zdrojem a existujícím vodoprávním rozhodnutím.	ROLE_VOD_OPERATOR
   invalidate	Zneplatnění vazby mezi existujícím elementárním zdrojem a existujícím vodoprávním rozhodnutím.	ROLE_VOD_OPERATOR
   restore	Obnovení platnosti vazby mezi existujícím elementárním zdrojem a existujícím vodoprávním rozhodnutím.	ROLE_VOD_OPERATOR

   zneplatneni – k dnesnimu dni, tzn. poslu dnesek, dnes jeste plati a prestava platit od zacatku pristiho dn

5.4.5 Zmocnění

1. ZmocneniService
   

   ZmocneniService

   zmocneni.wsdl

   Autoriovaná služba pro přístup ke zmocnění (vazba subjekt (zmocnitel) – subjekt (zmocněnec))

   

   findByFilter	Vrací seznam zmocnění evidovaných v ISPOP (tj. vztahů mezi subjekty ISPOP).	ROLE_UZIVATEL
   getDetail	Vrací detail pro danou entitu, vstupem je ident vztahu (ZmocneniIdent).	ROLE_UZIVATEL

5.4.6 Uživatelé

1. UserService
   

   UserService

   user.wsdl

   Autoriovaná služba pro přístup k uživatelům

   

   findByFilter	Vrací seznam uživatelských účtů evidovaných v ISPOP (tj. fyzických osob s uživatelským účtem v ISPOP).	ROLE_UZIVATEL
   getDetail	Vrací detail pro danou entitu, vstupem je ident uživatele (UserIdent).	ROLE_UZIVATEL
   getElpnoPrivileges	Vrací nastavení oprávnění ELPNO pro danou entitu, vstupem je ident uživatele (UserIdent).	ROLE_UZIVATEL

2. UserEditService
   

   UserEditService

   userEdit.wsdl

   Autoriovaná služba pro změny u uživatelů

   

   updateElpnoPrivileges

   Provede nastavení oprávnění ELPNO pro danou entitu.

   ROLE_UZIVATEL

5.4.7 Správcovství

1. SpravcovstviService
   

   SpravcovstviService

   spravcovstvi.wsdl

   Autoriovaná služba pro přístup ke správcovství (vazba subjekt (spravovaný subjekt) – uživatel (správce))

   

   findByFilter	Vrací seznam správcovství evidovaných v ISPOP (tj. vztahů mezi subjektem ISPOP a jeho správcem (uživatelem)).	ROLE_UZIVATEL
   getDetail	Vrací detail pro danou entitu, vstupem je ident vztahu (SpravcovstviIdent).	ROLE_UZIVATEL

5.4.8 Zaměstnání (tj. běžní uživatelé)

1. EmploymentService
   

   EmploymentService

   employment.wsdl

   Autoriovaná služba pro přístup k zaměstnáncům (vazba subjek (zaměstnavatel) – uživatel (zaměstnanec))

   

   findByFilter	Vrací seznam zmocnění evidovaných v ISPOP (tj. vztahů mezi subjekty ISPOP).	ROLE_UZIVATEL
   getDetail	Vrací detail pro danou entitu, vstupem je ident vztahu (EmploymentIdent).	ROLE_UZIVATEL

2. EmploymentEditService
   

   EmploymentEditService

   employmentEdit.wsdl

   Autoriovaná služba pro změny u zaměstnanců

   

   updateElpnoPrivileges

   Provede nastavení oprávnění ELPNO vázaných na subjekt pro danou entitu .

   ROLE_UZIVATEL

6.1.1 Aktuální verze

1. v20130505
   

   Existuje jediná aktuální verze – má označení v20130505.

2. Bugfixing
   

   Žádné opravy služeb nebyly zveřejněny.

6.2.1 HlaseniUploadService

1. validate
   

   Metoda validate příjímá serializované XML a provádí validaci dokumentu jako v případě 6.2.2 s tím rozdílem, že vyžaduje autorizaci uživatele a díky tomu může provést (vedle jiných) i validaci příslušnosti k subjektu, tj. validaci, která ověří, že daný uživatel má právo zaslat hlášení do ISPOP za daný subjekt.

   Vstup a výstup je stejný jako v případě 6.2.2.

2. upload
   

   Metoda nahrazuje metodu submit z DocumentInputService

   Stejně jako zmíněná submit i upload příjímá binární stream dat a vrací číslo dokumentu jako výsledek. Číslo dokumentu je základní identifikátor dokumentu v systému ISPOP. Pokud klient v budoucnu bude provádět s dokumentem další operace (například řízení workflow), měl by si číslo dokumentu uchovat. Dokument je tak přijat ke zpracování. Metoda musí přijmout jakýkoli stream dat a vždy reaguje vrácením čísla dokumentu.

   Navíc však může provést i validaci dokumentu před samotným příjmem dokumentu, pokud klient poskytne XML data serializovaná v elementu /HlaseniUploadDto/hlaseniValidateDto. Dokument je přijat jen v případě, že validace proběhne v pořádku. Pro vyhodnocení validace příslušnosti k subjektu je použit uživatel, který hlášení odesílá.

   Jde o konvenci, která je zavedena s ohledem na optimální výkon. Bylo by možné získat v reálném čase XML přímo z binárních dat, nicméně to je náročná operace na CPU a I/O, zejména v případě, kdy jde o PDF formulář. V době ohlašovací špičky může ISPOP přijímat tisíce hlášení za hodinu. Tím že, data poskytnete klient ve stejné podobě jako pro validaci – jde o ten samý datový typ – je možné provést validaci online.

   Budiž explicitně uvedeno – metodu upload je možné provolat i bez validace (stačí neuvést /HlaseniUploadDto/hlaseniValidateDto) – a tak zaslat libovolná data, nicméně validace bude v průběhu zpracování stejně provedena, takže její vykonání před odesláním lze jen doporučit – uživateli je tak možné ušetřit dost času.

   Vstup:

   <?xml version="1.0" encoding="utf-8"?>
   <xsd:complexType name="HlaseniUploadDto">
       <!-- use all instead of sequence as this gets called from Adobe Acrobat, which is unable to handle sequence correctly -->
       <xsd:all>
           <xsd:element name="hlaseniUpload" type="tns:HlaseniUpload">
               <xsd:annotation>
                   <xsd:documentation xml:lang="cs">
                       Vstupní dokument.
                   </xsd:documentation>
               </xsd:annotation>
           </xsd:element>
           <xsd:element name="hlaseniValidateDto" type="hlasenivalidate:HlaseniValidateDto" minOccurs="0">
               <xsd:annotation>
                   <xsd:documentation xml:lang="cs">
                       Pokud je zaslané hlášení v binární podobě (element /HlaseniUploadDto/hlasenidoc) v jiném
                       formátu, než XML, je možné vyplnit tento element odpovídajícím XML k danému hlášení.
                       Pokud se tak stane, je hlášení před samotným postoupením systému zvalidováno a pokud jsou
                       zjištěny závažné chyby, je odmítnuto. Validační chyby jsou pak součástí odpovědi serveru
                       (/HlaseniUploadResultDto/hlaseniValidationResultDto).
                       Vyplnění tohoto elementu je volitelné.
                       Ať již element vyplněn je nebo není, je hlášení během následujícího procesu zpracování podrobeno
                       stejným validačním kontrolám.
                       Tento element by měl vyplnit inteligentní klient, jehož cílem je varovat uživatele pokud možno
                       dopředu, že s hlášením není vše v pořádku a nečekat až na následné zpracování serverem.
                   </xsd:documentation>
               </xsd:annotation>
           </xsd:element>
       </xsd:all>
   </xsd:complexType>
   
   <xsd:complexType name="HlaseniUpload">
       <!-- use all instead of sequence as this gets called from Adobe Acrobat, which is unable to handle sequence correctly -->
       <xsd:all>
           <xsd:element name="binarydoc" type="xsd:base64Binary">
               <xsd:annotation>
                   <xsd:documentation xml:lang="cs">
                       Data hlášení zakódovaná v base64.
                   </xsd:documentation>
               </xsd:annotation>
           </xsd:element>
           <xsd:element name="name" type="wscommon:MediumString" minOccurs="0">
               <xsd:annotation>
                   <xsd:documentation xml:lang="cs">
                       Volitelný název hlášení.
                   </xsd:documentation>
               </xsd:annotation>
           </xsd:element>
           <xsd:element name="comment" type="wscommon:LongString" minOccurs="0">
               <xsd:annotation>
                   <xsd:documentation xml:lang="cs">
                       Volitelná libovolná vlastní poznámka k dokumentu.
                   </xsd:documentation>
               </xsd:annotation>
           </xsd:element>
       </xsd:all>
   </xsd:complexType>
   

   Výstup pak kombinuje výstup validace s případným číslem dokumentu:

   <?xml version="1.0" encoding="utf-8"?>
   <xsd:complexType name="HlaseniUploadResultDto">
       <xsd:sequence>
           <xsd:element name="documentNumber" type="wscommon:ShortString" minOccurs="0">
               <xsd:annotation>
                   <xsd:documentation xml:lang="cs">
                       Číslo dokumentu. Klient by si měl ve vlastním zájmu uchovat číslo dokumentu. Jde o význačný
                       identifikátor, který doprovází dokument během celého jeho zpracování.
                       Dokument lze pomocí něho vyhledat, posouvat ve workflow apod.
                       Není nastaveno jen v případě, že v požadavku bylo uvedeno XML k validaci
                       (/HlaseniUploadDto/hlaseniValidateDto) a byly zjištěny zásadní nedostatky během validace, blíže
                       viz /HlaseniUploadResultDto/hlaseniValidateResultDto.
                   </xsd:documentation>
               </xsd:annotation>
           </xsd:element>
           <xsd:element name="hlaseniValidateResultDto" type="hlasenivalidate:HlaseniValidateResultDto" minOccurs="0">
               <xsd:annotation>
                   <xsd:documentation xml:lang="cs">
                       Pokud byl vyplněn element /HlaseniUploadDto/hlaseniValidateDto, obsahuje tento element výstup
                       validace (viz /HlaseniValidateResultDto).
                   </xsd:documentation>
               </xsd:annotation>
           </xsd:element>
       </xsd:sequence>
   </xsd:complexType>
   

6.2.2 HlaseniValidateService

<?xml version="1.0" encoding="utf-8"?>
<xsd:complexType name="HlaseniValidateDto">
    <!-- use all instead of sequence as this gets called from Adobe Acrobat, which is unable to handle sequence correctly -->
    <xsd:all>
        <xsd:element name="xmldoc" type="xsd:string">
            <xsd:annotation>
                <xsd:documentation xml:lang="cs">
                    XML hlášení serializované do řetězce.
                </xsd:documentation>
            </xsd:annotation>
        </xsd:element>
        <xsd:element name="provideFormattedValidationOutput" type="xsd:boolean">
            <xsd:annotation>
                <xsd:documentation xml:lang="cs">
                    Pokud je nastaveno na true, bude nastaven formátovaný výstup validace
                    /HlaseniValidateResultDto/formattedValidationOutpu.
                </xsd:documentation>
            </xsd:annotation>
        </xsd:element>
    </xsd:all>
</xsd:complexType>

<?xml version="1.0" encoding="utf-8"?>
<xsd:simpleType name="ValidationStatus">
    <xsd:restriction base="xsd:string">
        <xsd:enumeration value="OK">
            <xsd:annotation>
                <xsd:documentation>Validace proběhla v pořádku, nenastala žádná chyba, hlášení může být odesláno na
                    server.
                </xsd:documentation>
            </xsd:annotation>
        </xsd:enumeration>
        <xsd:enumeration value="VALIDATION_ERROR">
            <xsd:annotation>
                <xsd:documentation>Chyba při logické validaci -- dokument je formálně dobře, obsahuje ale zasadní
                    logické chyby. Dokument není možné odeslat.
                </xsd:documentation>
            </xsd:annotation>
        </xsd:enumeration>
        <xsd:enumeration value="XSD_ERROR">
            <xsd:annotation>
                <xsd:documentation>Chyba XSD -- tj. chyba ve struktuře dokumentu. Dokument není možné odeslat.
                </xsd:documentation>
            </xsd:annotation>
        </xsd:enumeration>
        <xsd:enumeration value="DOCUMENT_VERSION_NOT_SUPPORTED">
            <xsd:annotation>
                <xsd:documentation>Verze vstupního dokumentu není podporovaná.
                </xsd:documentation>
            </xsd:annotation>
        </xsd:enumeration>
        <xsd:enumeration value="UNEXPECTED_ERROR">
            <xsd:annotation>
                <xsd:documentation>Nastala neočekávaná chyba na serveru. Kontaktujte správce webových služeb.
                </xsd:documentation>
            </xsd:annotation>
        </xsd:enumeration>
    </xsd:restriction>
</xsd:simpleType>

7.1.1 Verze

1. v20111116
   

   Aktuální služby

   • dostupnost na URL (chráněno heslem)
     • produkce (porty 80, 443 (https), 8081):
       • https://www.ispop.cz/ispop/ispop-ws/ispopSpisovaSluzba/v20111116/v20111116-ispopSpisovaSluzbaWsdl.wsdl
     • vývoj:
       • http://90.182.205.50/ispop/ispop-ws/ispopSpisovaSluzba/v20111116/v20111116-ispopSpisovaSluzbaWsdl.wsdl
   1. Bugfixing
      

      Žádné opravy služeb nebyly zveřejněny.

2. Zastaralé verze
   

   Pro komunikaci se spisovou službou existují ještě další zastaralé verze (bez označení); již nejsou podporované.

7.1.2 Princip fungování

7.1.3 Model tříd

7.1.4 Popis služeb

1. IspopSpisovaSluzbaService
   

   

   submitDocument

   Metoda pro vyhledání hlášení. Vrací seznam vyhovující zadaným kritériím.

   ROLE_UZIVATEL

2. CeniaSpisovaSluzbaService
   

   

   notifyDocumentProcessing

   Notifikace o zpracování zasílaná do spisové služby.

   ROLE_UZIVATEL

9.1.1 Validace dokumentu

<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v20="http://ispop.cz/document/v20110901">
   <soapenv:Header/>
   <soapenv:Body>
      <v20:validate>
         <v20:xmldoc>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;xfa:data xmlns:xfa=&quot;http://www.xfa.org/schema/xfa-data/1.0/&quot;
&gt;&lt;F_IRZ revision=&quot;2&quot; version=&quot;2011&quot;
&gt;&lt;meta-info
&gt;&lt;user-agent
&gt;LC&lt;/user-agent
&gt;&lt;user-agent-version
&gt;2011-11-28.7741&lt;/user-agent-version
&gt;&lt;/meta-info
&gt;&lt;section1
&gt;&lt;radneDoplneneHlaseni
&gt;&lt;rd
&gt;R&lt;/rd
&gt;&lt;radne
/&gt;&lt;/radneDoplneneHlaseni
&gt;&lt;rok
&gt;2011&lt;/rok
&gt;&lt;hlaseniVyplnil
&gt;&lt;vyplnil
&gt;&lt;jmeno
&gt;Spr&#225;vce&lt;/jmeno
&gt;&lt;prijmeni
&gt;Ispop&lt;/prijmeni
&gt;&lt;/vyplnil
&gt;&lt;kontakt
&gt;&lt;email
&gt;spravce@cenia.cz&lt;/email
&gt;&lt;telefon
&gt;&lt;predvolba
&gt;+420&lt;/predvolba
&gt;&lt;cislo
&gt;1&lt;/cislo
&gt;&lt;/telefon
&gt;&lt;fax
&gt;&lt;predvolba
&gt;+420&lt;/predvolba
&gt;&lt;/fax
&gt;&lt;/kontakt
&gt;&lt;datum
&gt;2011-11-22&lt;/datum
&gt;&lt;/hlaseniVyplnil
&gt;&lt;ohlasovatel
&gt;&lt;spolecnostVyberVycet
&gt;PRAVNICKA_OSOBA&lt;/spolecnostVyberVycet
&gt;&lt;spolecnostVyber
&gt;&lt;pravnickaOsoba
&gt;&lt;nazev
&gt;Elkoplast Slu&#353;ovice s.r.o.&lt;/nazev
&gt;&lt;pravniForma
&gt;112&lt;/pravniForma
&gt;&lt;ic
&gt;26235757&lt;/ic
&gt;&lt;/pravnickaOsoba
&gt;&lt;/spolecnostVyber
&gt;&lt;adresa
&gt;&lt;kraj
&gt;Zl&#237;nsk&#253;&lt;/kraj
&gt;&lt;okres
&gt;Zl&#237;n&lt;/okres
&gt;&lt;obec
&gt;Slu&#353;ovice&lt;/obec
&gt;&lt;obecKod
&gt;585777&lt;/obecKod
&gt;&lt;mestkaCast
&gt;Slu&#353;ovice&lt;/mestkaCast
&gt;&lt;ulice
&gt;Dlouh&#225;&lt;/ulice
&gt;&lt;psc
&gt;76315&lt;/psc
&gt;&lt;cisloPopisne
&gt;134&lt;/cisloPopisne
&gt;&lt;kodZeme
&gt;CZ&lt;/kodZeme
&gt;&lt;/adresa
&gt;&lt;/ohlasovatel
&gt;&lt;ohlasovatelOstatni
&gt;&lt;lau1
&gt;CZ0724&lt;/lau1
&gt;&lt;/ohlasovatelOstatni
&gt;&lt;provozovna
&gt;&lt;icp
&gt;CZ55729230&lt;/icp
&gt;&lt;nazev
&gt;EKOPLAST Slu&#353;ovice - laminov&#225;n&#237; plast&#367;&lt;/nazev
&gt;&lt;jtskX
&gt;1163637&lt;/jtskX
&gt;&lt;jtskY
&gt;511502&lt;/jtskY
&gt;&lt;wgs84CoordinateX
&gt;&lt;degrees
&gt;49&lt;/degrees
&gt;&lt;minutes
&gt;14&lt;/minutes
&gt;&lt;seconds
&gt;49.16583600001216&lt;/seconds
&gt;&lt;/wgs84CoordinateX
&gt;&lt;wgs84CoordinateY
&gt;&lt;degrees
&gt;17&lt;/degrees
&gt;&lt;minutes
&gt;47&lt;/minutes
&gt;&lt;seconds
&gt;44.70547199999859&lt;/seconds
&gt;&lt;/wgs84CoordinateY
&gt;&lt;adresa
&gt;&lt;kraj
&gt;Zl&#237;nsk&#253;&lt;/kraj
&gt;&lt;okres
&gt;Zl&#237;n&lt;/okres
&gt;&lt;obec
&gt;Slu&#353;ovice&lt;/obec
&gt;&lt;ulice
&gt;Dlouh&#225;&lt;/ulice
&gt;&lt;psc
&gt;76315&lt;/psc
&gt;&lt;cisloPopisne
&gt;134&lt;/cisloPopisne
&gt;&lt;kodZeme
&gt;CZ&lt;/kodZeme
&gt;&lt;/adresa
&gt;&lt;lau1
&gt;CZ0724&lt;/lau1
&gt;&lt;povodi
&gt;1&lt;/povodi
&gt;&lt;nace
&gt;353010&lt;/nace
&gt;&lt;/provozovna
&gt;&lt;/section1
&gt;&lt;section2
&gt;&lt;cinnosti
&gt;&lt;jeEPRTR
&gt;0&lt;/jeEPRTR
&gt;&lt;cinnostiEPRTR
/&gt;&lt;cinnostiOstatni
&gt;&lt;cinnostOstatniSeq
&gt;&lt;nazevCinnosti
&gt;1&lt;/nazevCinnosti
&gt;&lt;pocet
&gt;1&lt;/pocet
&gt;&lt;/cinnostOstatniSeq
&gt;&lt;/cinnostiOstatni
&gt;&lt;/cinnosti
&gt;&lt;/section2
&gt;&lt;section3
&gt;&lt;unikyOvzdusi
/&gt;&lt;unikyVoda
/&gt;&lt;unikyPuda
/&gt;&lt;prenosyOdpVody
/&gt;&lt;prenosyOdpady
/&gt;&lt;ostatniOdpady
/&gt;&lt;nebezpecneOdpady
/&gt;&lt;/section3
&gt;&lt;/F_IRZ
&gt;&lt;/xfa:data
&gt;</v20:xmldoc>
      </v20:validate>
   </soapenv:Body>
</soapenv:Envelope>

<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <ns2:validateResponse xmlns:ns2="http://ispop.cz/document/v20110901">
         <ns2:validateResponseDetails>
            <ns2:status>VALIDATION_ERROR</ns2:status>
            <ns2:xsdErrorList/>
            <ns2:validationErrorList>
               <ns2:validationError>
                  <ns2:code>DATA_VALIDATION_DOCUMENT_ERROR</ns2:code>
                  <ns2:message>Ve formuláři je nutné vyplnit alespoň jeden z úniků, přenosů látek nebo přenosů odpadů mimo provozovnu.</ns2:message>
               </ns2:validationError>
            </ns2:validationErrorList>
            <ns2:validationWarningList/>
            <ns2:validationInfoList/>
         </ns2:validateResponseDetails>
      </ns2:validateResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

10.1.1 Seznam ověřovatelů