Aplikační rozhraní informačního systému registru smluv (ISRS)
Podrobný popis aplikačního rozhraní včetně XSD šablon povolených pokynů naleznete v souboru pod tímto odkazem. Následující text uvádí pouze stručně nejdůležitější principy komunikace externí aplikace s ISRS.
1) Příjem zpráv
ISRS přijímá pokyny k provedení operací výhradně jako zprávy dodané do určené datové schránky s identifikátorem whbt3kp. Všechny přijímané zprávy mají v tomto směru společné rysy. Jednou datovou zprávou je možné zadat pouze jednu operaci. V příloze datové zprávy může být tedy právě jedna příloha předepsaného typu XML. Očekává se, že XML zprávy bude vloženo s typem dmFileMetaType = main. Další přílohy smlouvy budou vloženy s typem dmFileMetaType = enclosure. Pokud v příloze datové zprávy typu main nebude nalezeno žádné XML odpovídající názvem jedné z definovaných operací, bude celá zpráva odmítnuta jako neznámá. Pokud odesílatel vloží do datové zprávy další přílohy, které nejsou uvedeny v XML zprávy (např. průvodní dopis v PDF nebo cokoli dalšího), ISRS bude další přílohy ignorovat. Pokud odesílatel nevloží do datové zprávy všechny přílohy, které jsou uvedeny v XML zprávy, bude zpráva zamítnuta s chybovou odpovědí. Všechny přílohy datové zprávy se očekávají v elementu dmEncodedContent.
Externí aplikace odesílá datovou zprávu pomocí aplikačního rozhraní Informačního systému datových schránek (ISDS), které je popsáno v Provozním řádu ISDS.
2) Povolené typy operací
Obecně platí, že subjekt, který zadává pokyn k provedení operace se nemusí v metadatech sám identifikovat, protože jeho identifikace je odvozena z datové schránky, ze které ISRS datovou zprávu s pokynem obdržel.
- Zveřejnění záznamu
- Přidání přílohy
- Modifikace záznamu
- Znepřístupnění záznamu
- Zmocnění k publikaci
- Zrušení zmocnění k publikaci
3) Povolené formáty dokumentů
ISRS přijímá ke zveřejnění pouze soubory ve formátech v níže uvedené tabulce. Systém nekontroluje, zda soubor obsahuje textovou vrstvu. Antivirová a integritní kontrola je prováděna v perimetru Informačního systému datových schránek (ISDS). S ohledem na omezení velikosti datové zprávy v ISDS je maximální velikost příloh v jedné datové zprávě omezena na 20 MB.
Název formátu | Přípona |
---|---|
Portable Document Format | |
Word 97-2003 | DOC |
Office Open XML | DOCX |
Rich Text Format | RTF |
OpenDocument Text | ODF |
Plain Text | TXT |
4) Potvrzení o provedení operace (např. o zveřejnění)
Na každou přijatou datovou zprávu ISRS odpovídá buď potvrzením o úspěšném zpracování nebo oznámením o chybě. Kromě PDF verze odpovědi je přiloženo též strojově čitelné potvrzení o provedení či odmítnutí operace z důvodů chyby. Odpověď je odesílána do datové schránky, ze které byl pokyn odeslán. Volitelně je též totožná odpověď odeslána na emailovou adresu, která byla uvedena v pokynu. V případě zveřejnění či modifikace smlouvy je potvrzení o zveřejnění zasíláno též ostatním smluvním stranám, za předpokladu, že v metadatech smlouvy byly uvedeny identifikátory jejich datové schránky. V případě pokynu ke zveřejnění smlouvy budou součástí odpovědi všechna metadata záznamu + identifikátor záznamu, jeho kontrolní součet (hash) a kryptografické prvky zajišťující integritu a původ dat (el. značka + časové razítko).
Potvrzení o zveřejnění smlouvy bude zasíláno navíc i všem uvedeným smluvním stranám do jejich datových schránek (za předpokladu, že metadata smlouvy obsahovaly identifikátory datových schránek protistran) a navíc volitelně emailem na adresu uvedenou v pokynu.
Pro usnadnění zpracování odpovědí, které generuje ISRS a odesílá je do datové schránky, ze které obdržel pokyn k provedení operace, jsou zavedena následující pravidla práce s údaji v obálkách odpovědních datových zpráv.
- Do pole „věc“ odpovědní datové zprávy je doplňována „věc“ z iniciační datové zprávy.
- Do pole „vaše číslo jednací“ je vkládána hodnota „naše číslo jednací“ z iniciační datové zprávy.
- Do pole „vaše spisová značka“ je vkládána hodnota „naše spisová značka“ z iniciační datové zprávy.
- Do pole „naše číslo jednací“ je vkládán identifikátor iniciační datové zprávy.
- Do pole „naše spisová značka“ je vkládán identifikátor záznamu (pokud je znám).