Popis datového rozhraní k iFIS*Registr smluv

Přenos informací o smlouvách je realizován pomocí SOAP webové služby. WSDL dokumentace je k dispozici na aplikačním serveru iFIS a nebo na vyžádání u správce iFIS. Data jsou na rozhraní služby předávána ve formátu XML. Přikládáme zjednodušené vzorové soubory Smlouva DATA vzor.xml a Prilohy ke smlouve DATA vzor.xml.

Pro validaci předávaných dat se využívá schéma ifis_smlouvy.xsd, ifis_prilohy.xsd a ifis_common.xsd.

Metody webové služby

VlozSmlouvu (PozadavekRS) – metodě je při volání předáván objekt PozadavekRS. Pro jednoznačnou identifikaci smlouvy je možné použít buď fisovský interní identifikátor RSHIDNO a nebo externí identifikátor SMLID (vizualizované číslo smlouvy). V případě, že požadavek na založení smlouvy neobsahuje externí identifikátor SMLID, pak je tento identifikátor automaticky generován v iFIS*Registr smluv. Služba vrací objekt OdpovedRS, kde je uveden stav operace a identifikátory smlouvy, které byly vygenerovány v iFIS*Registr smluv. Pokud je vkládána smlouva, která již v iFIS existuje (byla vložena dříve), nedojde k žádné změně.

DejSmlouvu (PozadavekRS) – metodě je při volání předáván objekt PozadavekRS. V tomto objektu musí být uveden interní nebo externí identifikátor smlouvy. Metoda vrací objekt OdpovedRS, kde je uveden stav operace a výpis aktuálně evidovaných dat o smlouvě v iFIS*Registru smluv.

DejPoradoveCislo (PozadavekRS) – metodě je při volání předáván objekt PozadavekRS. V tomto objektu musí být v poli identifikátorů uvedeny další parametry rozhodující pro vygenerované číslo SMLID (ULOHA, ROK, MESIC, EJ, STREDISKO a TYP_SMLOUVY). V poli identifikátorů je každý parametr jednoznačně popsán názvem parametru (element zdroj_id) a hodnotou parametru (element hodnota_id). Metoda vrací objekt OdpovedRS, kde je uveden stav operace a číslo smlouvy SMLID vygenerované v závislosti na vstupních parametrech.

CheckWs() – metoda vrací řetězec s výsledkem operace, slouží pouze pro testovací účely

	Poznámka
	Funkcionalita umožňující vložení dokumentu ke smlouvě je obsažena ve webové službě BbmFileWs v metodě VlozObecPril(). Popis této metody je obsahem jiného dokumentu.