KISSDO (testna verzija)

Navodila za razvijalce

Uvod:

Dobrodošli na strani spletne storitve za enotni sistem poročanja.

Skupnost Socialnih zavodov Slovenije ima z Ministrstvom za delo, družino, socialne zadeve in enake možnosti podpisano pogodbo o izvajanju javnih pooblastil. Ena izmed nalog je na podlagi priporočil Računskega sodišča vzpostavitev enotnega sistema poročanja. V ta namen Skupnost skupaj z zunanjim izvajalcem pripravlja KISSDO (Krovni Informacijski Sistem Statistik Dolgotrajne Oskrbe), kamor bodo domovi za starejše in posebni socialno varstveni zavodi pošiljali podatke v skladu s podano specifikacijo. Pripravljen je skupen nabor šifrantov in XML shema.

Na tem naslovu vam je na voljo spletni vmesnik, ki vsebuje skupne podatke (šifrante) in tudi servis za oddajo rednih poročil. Servisi delujejo kar najbolj v skladu z REST principom (REpresentational State Transfer), kot format za izmenjavo podatkov uporabljajo XML. Prenos sporočil poteka "stateless", kar pomeni, da so tudi vsi podatki za avtentikacijo pošiljatelja vsebovani v vsakokratnem zahtevku.

Posebej vas želimo opozoriti, da prenos podatkov na testnem sistemu NI USTREZNO ZAVAROVAN, zato vas prosimo, da v času testiranja NE POŠILJATE DEJANSKIH PODATKOV, kateri bi vsebovali bodisi osebne podatke oskrbovancev ali občutljive finančne podatke zavoda.
Za prenos dejanskih podatkov bo promet ustrezno kodiran.

Dostop do šifrantov

Za dostop do vsebine do šifrantov sta vam na voljo dva spletna "servisa", katera oba vračata podatke v XML obliki. Za dostop do šifrantov NE potrebujete uporabniškega imena ali gesla. URL naslova sta naslednja:

• /api/codeliststype/ - SEZNAM ŠIFRANTOV
  Tu se nahaja seznam šifrantov v XML obliki. Vsak šifrant ima svojo "kodo", trenuten razpon je [001, 045].
  Vnosi v ta seznam se praviloma več ne bodo spreminjali, lahko pa da bo v prihodnje dodan še kakšen šifrant.
• /api/codelists/001 - VSEBINA DOLOČENEGA ŠIFRANTA
  Ta naslov vrne vsebino posameznega šifranta, v tem primeru šifranta s kodo 001, prav tako v XML obliki.
  Vsebina teh šifrantov še ni dokončna, prav tako se bo lahko še spreminjal format kode.

Oddaja poročil

Poročila se oddajajo na naslov ~/api/data, s "POST" zahtevkom, kateri vsebuje polja "user", "pass" in "xml".
Zahtevek se obdela na naslednji način:

1. Preveri se uporabniško ime in geslo (za pridobitev pišite na elektronski naslov SSZS).
   Če ni OK, je odgovor 401 - unauthorised.
2. Vsebina XML se validira proti XSD shemi.
   Če ni OK, se vrne koda 400, bad request.
3. Izvršijo se določena vsebinska preverjanja (še v pripravi, tu bo v prihodnje lahko vrnjen seznam vsebinskih napak v XML)
4. Če je vse OK, je vrnjena koda 200, OK ter XML z ustreznim odgovorom.
5. Če pride med obdelavo do nepredvidene napake, sistem vrne kodo 500 in kratk opis napake.

SDK (Sotware Development Kit)

Za vas smo pripravili sdk.zip datoteko, katera vsebuje delujoč program za prevzem šifrantov in pošiljanje XML poročil, skupaj z izvorno kodo v C#. Priložena je tudi XSD shema ter primer pravilno zgrajenega XML-a.
SDK si lahko prenesete od tukaj.