Kvůli snadnější integraci s případnými systémy třetích stran bylo nutné vytvořit rozhraní s webovými službami, které by byly dostupné pro kohokoliv. Stejně jako v aplikaci, i přes webové služby se každý dostane pouze k záznamům, ke kterým má právo.

Kvůli absenci podpory pro SOAP volání v PHP verzích 4.x jsme se rozhodli pro stranu serveru využít knihovnu nuSOAP. Stejně tak doporučujeme využít knihovnu nuSOAP i pro klienta. Vzhledem k problémům s kódováním české diakritiky jsme knihovnu byli nuceni modifikovat - na žádost můžeme tuto modifikovanou verzi zaslat. Naše modifikace zároveň umožňují využít zmíněnou knihovnu i v PHP 5.x. Nelze ovšem garantovat 100% kompatibilitu při komunikaci přes jinou knihovnu.

WSDL je k dispozici vždy na stejné adrese: http://vas-kevis/ws/soap/server.php?wsdl - v KEVISu je tato hodnota dostupná v konstatně CFG_WSDL_SERVER (je-li v konfiguraci KEVISu správně nastavena). Využívejte prosím jen webových služeb, které jsou popsány v následujících kapitolách. V KEVISu se nachází i jiné webové služby, např. na testování či pro replikaci dat. Tyto služby nejsou pro běžné použití k ničemu, tak je prosím ani nijak nevolejte.

V následujících kapitolách bude tedy popsáno osm základních webových služeb týkajících se autentikace uživatelů a práce se záznamy. Vzhledem k tomu, že parametry služeb jsou dostupné na WSDL adrese (viz výše), omezíme se v každé kapitole pouze na příklad volání a výsledku.

V případě chyby se vrátí v poli několik popisných údajů: kdo může za chybu (server/klient), typ chyby (viz číselník níže), název volané funkce a co nejpřesnější popis chyby. Typ chyby je pouze orientační a je z následující množiny:

ERR_OK = 0

ERR_BAD_REQUEST = 1

ERR_COMM_ERROR = 2

ERR_INVALID_CONFIG = 3

ERR_UNAUTHORIZED = 4

ERR_NO_DATA = 5

ERR_BAD_RESULT = 6