uvod - implementacija web servisa za... · web viewovo poglavlje opisuje arhitekturu rješenja za...

28
CUS – Implementacija web servisa za Prijem i otpust Opis rješenja 9/1531-FCPBA1101493 Rev C

Upload: others

Post on 14-Feb-2020

0 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

Opis rješenja

9/1531-FCPBA1101493 Rev C

Page 2: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

Verzije dokumentaVerzija Datum Opis AutorA 07/05/2019 Odobrena inačica dokumenta za

opis web servisa Prijema i otpusta

B 05/06/2019 Ažuriranje dokumenta – Poglavlje 4.2.3.2, 4.2.4.2; Prilog A, B, C i D,– dodano novo poglavlje (Poglavlje 5)

C 12/07/2019 Ažuriranje dokumenta – Poglavlje 4.7

9/1531-FCPBA1101493 Rev C

Page 3: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

Sadržaj1 Uvod.........................................................................................................1.1 Svrha........................................................................................................1.2 Definicije, akronimi i kratice......................................................................1.3 Reference.................................................................................................

2 Centralni upravljački sustav..................................................................

3 Slučajevi uporabe...................................................................................3.1 Uvod.........................................................................................................3.2 Poslovni tijek.............................................................................................3.2.1 Prijem i otpust – Slanje prijema i otpusta.................................................3.2.2 Prijem i otpust – Lista konflikata...............................................................3.2.3 Prijem i otpust – Razrješavanje/Odbijanje konflikta.................................3.2.4 Prijem i otpust – Odgovor na odbijanje konflikta......................................

4 Arhitektura cjelokupnog rješenja..........................................................4.1 Opis arhitekture........................................................................................4.2 Web servisi...............................................................................................4.2.1 Prijem i otpust – slanje prijema i otpusta..................................................4.2.2 Prijem i otpust – konflikti.........................................................................4.2.3 Prijem i otpust – odbijanje konflikta........................................................4.2.4 Prijem i otpust – odgovor na odbijanje konflikta.....................................4.3 Implementacija sigurnosnih mehanizama..............................................4.4 Primjeri poruka.......................................................................................4.5 Preduvjeti za implementaciju na certifikaciji...........................................4.6 Preduvjeti za implementaciju na produkciji.............................................4.7 Testiranje i verifikacija............................................................................

5 Primjeri slučajeva.................................................................................5.1 Preklapajući prijem i otpust.....................................................................5.2 Rješavanje konflikata..............................................................................

Prilog A – Primjeri Poruka......................................................................................

Prilog B – WSDL web servisa................................................................................

Prilog C – Popis grešaka sigurnosnog sloja........................................................

Prilog D – Popis grešaka web servisa...................................................................

9/1531-FCPBA1101493 Rev C

Page 4: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

1 Uvod

1.1 Svrha

Svrha ovog dokumenta je opisati arhitekturu rješenja za integraciju bolničkog sustava s CUS web servisima za Prijem i otpust.

1.2 Definicije, akronimi i kratice

CUS Centralni upravljački sustav za upravljanje organizacijskom strukturom zdravstvenog sustava, centralnog sustava komunikacije s bolnicama, sustava za automatsko dnevno prikupljanje svih zdravstvenih indikatora, rudarenje podataka, strukturirane objave na webu iz svih bolnica u Republici Hrvatskoj te nadogradnje sustava fakturiranja iz bolnica

VPN Virtual Private Network – virtualna privatna mreža

BIS Bolnički informacijski sustav

MBO Matični broj osiguranika

WSDL Web Services Description Language – Jezik opisa web usluga

SSL VPN Secure Sockets Layer protocol - Protokol sloja sigurnih utičnica

IPSec Internet Protocol Security – Sigurnost internetskog protokola

SOAP Simple Object Access Protocol – Protokol jednostavnog pristupa objektima

IIS Internet Information Services – Internetske informacijske usluge

SQL Structured Query Language – Jezik strukturiranog upita

CEZIH Centralni Elektronički Zdravstveni Informacijski sustav Republike Hrvatske

HZZO Hrvatski zavod za zdravstveno osiguranje

9/1531-FCPBA1101493 Rev C

Page 5: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

1.3 Reference [REF1] CUS – Opis budućeg rješenja i funkcionalnosti, 7/ETK/K/241-17:144 Uhr

[REF2] CUS – Tehnička dokumentacija za Modul prijem i otpust, 9/1551-FCPBA1101493 Uhr

2 Centralni upravljački sustavCentralni upravljački sustav (CUS) je modularni sustav koji se sastoji od sljedećih cjelina:

1. Šifrarnici

2. Organizacijska struktura zdravstvenih ustanova

3. Slanje obavijesti zdravstvenim djelatnicima

4. Izrada izvještaja

5. Fakturiranje

9/1531-FCPBA1101493 Rev C

Page 6: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

Slika 1 Pregled grupa funkcionalnosti

Detaljni opis rješenja i funkcionalnosti nalazi se u [REF 1].

3 Slučajevi uporabe

3.1 Uvod

Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedeće funkcionalnosti:

1. Prijem i otpust – Slanje prijema i otpusta

2. Prijem i otpust – Lista konflikata

3. Prijem i otpust – Razrješavanje/Odbijanje konflikta

9/1531-FCPBA1101493 Rev C

Page 7: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

4. Prijem i otpust – Odgovor na odbijanje konflikta

3.2 Poslovni tijek

Ovo poglavlje opisuje tijek korištenja komponente za slanje prijema i otpusta putem web servisa. Djelatnici bolnice funkcionalnost koriste kroz sučelje BIS-a prilikom prijema pacijenata na stacionarno liječenje, odnosno otpusta pacijenata sa stacionarnog liječenja, gdje se BIS VPN-om spaja do CEZIH-a te povezuje web servisima sa CUS-om.

Kao alternativa web servisa slogove prijema i otpusta može se slati putem CUS web aplikacije učitavanjem datoteka s podacima o prijemu i otpustu pacijenata, ali se preporuča web servis.

3.2.1 Prijem i otpust – Slanje prijema i otpusta

Slučaj uporabe opisan je sljedećim koracima:

1. Administrator u bolnici u BIS unosi podatke o prijemu ili otpustu pacijenta u bolnicu. Prilikom spremanja podataka u BIS potpisana poruka se šalje prema centralnom sustavu.

2. BIS uspostavlja konekciju prema CUS-u i šalje poruke o prijemu/otpustu pojedinačno

3.2.2 Prijem i otpust – Lista konflikata

Konflikt je slučaj kada zdravstvena ustanova (bolnica A) pokuša putem web servisa pokuša poslati prijem za pacijenta za kojeg nije prijavljen otpust iz druge zdravstvene ustanove (bolnica B). Zdravstvena ustanova (bolnica B) pozivanjem metode Konflikti dobiva popis svih konflikata u svojoj ustanovi. Ukoliko se zdravstvena ustanova (bolnica B) slaže da konflikt postoji, prihvaća ga te ga razrješava na način da pošalje otpust ili storno prijema za pacijenta, a ukoliko se ne slaže s konfliktom, odbija ga te prilikom sljedećeg poziva web servisa zdravstvena ustanova (bolnica A) dobiva popis konflikata. Konflikt nije razriješen dok jedna od ustanova ne potvrdi da je na njenoj strani nastali konflikt i razriješi ga.

Slučaj uporabe opisan je sljedećim koracima:

1. Pod pretpostavkom da za pacijenta postoji konflikt koji je napravljen u trenutku slanja sloga u procesu slanja prijema/otpusta kako bi se kasnije mogla povući lista konfliktnih slogova

2. Korisnik pristupa web servisu prijema i otpusta te pozivom metode Konflikti dobije listu konflikata koji su nastali prilikom učitavanja prijema i otpusta pacijenta u druge zdravstvene ustanove (bolnica B)

9/1531-FCPBA1101493 Rev C

Page 8: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

3.2.3 Prijem i otpust – Razrješavanje/Odbijanje konflikta

Slučaj uporabe opisan je sljedećim koracima:

1. Administrator u zdravstvenoj ustanovi (bolnica A) radi prijem pacijenta kod sebe, ali je taj pacijent već zaprimljen u zdravstvenoj ustanovi (bolnica B) koja nije napravila otpust pacijenta

2. Ustanova u kojoj je došlo do konflikta (bolnica B) poziva i gleda listu konflikata te na temelju toga donosi odluku o odbijanju ako smatra da konflikt ne postoji ili razrješenju ako smatra da konflikt postoji

3. Ukoliko u ustanovi (bolnica B) postoji konflikt ona ga razrješava slanjem otpusta ili storno prijema za pacijenta, a ukoliko konflikt ne postoji ona ga odbija

4. Ako je konflikt odbijen od ustanove (bolnica B) dolazi poruka u listi konflikata u drugu ustanovu (bolnica A) za tog pacijenta da je konflikt odbijen

5. Ustanova (bolnica A) odbijeni konflikt od ustanove (bolnica B) prihvaća ili odbija čime se obavijest o konfliktu vraća ustanovi (bolnica B). Ustanova (bolnica B) prilikom sljedećeg dohvata metode Konflikti dobiva listu konflikata

3.2.4 Prijem i otpust – Odgovor na odbijanje konflikta

Slučaj uporabe opisan je sljedećim koracima:

1. Administrator u zdravstvenoj ustanovi an_discharge_hospital_admin (bolnica A) kod koje je nastao konflikt na temelju metode OdbijanjeKonflikta od ustanove (bolnica B) odgovara metodom OdgovorNaOdbijanjeKonflikta

2. Administrator u zdravstvenoj ustanovi an_discharge_hospital_admin (bolnica A) odgovorom:

a. „potvrda“ slaže se s drugom ustanovom (bolnica B) da je konflikt nastao u njegovoj ustanovi (bolnica A) te se slog automatski stornira

b. odgovorom „vrati“ ne slaže se s drugom ustanovom (bolnica B) te se taj konflikt ponovo šalje toj ustanovi

3. Proces se može nastaviti sve dok ustanova (bolnica B) ne pošalje otpust ili storno prijema za pacijenta ili sve dok ustanova (bolnica A) nakon odbijenog konflikta od ustanove (bolnica B) ne prihvati taj konflikt

Korisnik role an_discharge_hospital_admin može pristupiti do sljedećih metoda:

PrijemOtpust Poruka,

9/1531-FCPBA1101493 Rev C

Page 9: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

Konflikti,

OdbijanjeKonflikta,

OdgovorNaOdbijanjeKonflikta,

te ima mogućnost da u ulaznim parametrima šalje podatke od jednog sloga ili podatke od više slogova za koje dobiva povratni odgovor.

Korisnik role an_discharge_central_admin može pristupiti do metode Konflikti te ima mogućnost pregleda svih nastalih konflikata vezanih uz sve zdravstvene ustanove, dok korisnik role an_discharge_hospital_management može pristupiti do metode Konflikti te ima mogućnost pregleda svih nastalih konflikata vezanih uz njegovu zdravstvenu ustanovu.

4 Arhitektura cjelokupnog rješenja

4.1 Opis arhitekture

Ovo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2).

Slika 2 Arhitektura rješenja

G100 poslužitelj, PC klijent ili usmjerivač putem IPSec ili SSL VPN konekcije se spaja na CEZIH mrežu. Pristup do web servisa ostvaruje pomoću klijentskog ili usmjerivačkog (routerskog) certifikata preko CEZIH sigurnosnog sloja.

4.2 Web servisi

Definiran je 1 web servis sa sljedećim metodama:

9/1531-FCPBA1101493 Rev C

Page 10: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

1. Prijem i otpust

a. Slanje prijema i otpusta

b. Konflikti

c. Odbijanje konflikta

d. Odgovor na odbijanje konflikta

4.2.1 Prijem i otpust – slanje prijema i otpusta

4.2.1.1 Ulazni podaci

Tablica 1 ima opisane ulazne podatke.

Tablica 1 PO Ulazni parametri za dohvat podataka

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1 PrijemOtpustZahtjev D PrijemOtpustZahtjev

2 Verzija1 D Int 11 Verzija je verzija poruke koja se šalje. Trenutni broj verzije je 1. Ukoliko bude nadogradnji sljedeće verzije će imati veći broj te će se na ovaj način omogućiti kompatibilnost prelaska s jedne verzije na drugu.

Tablica 2 ima opisanu klasu PrijemOtpustZahtjev.

Tablica 2 PO Klasa PrijemOtpustZahtjev

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1 Zaglavlje N ZaglavljeZahtjev

2SifraUstanove - 2.16.840.1.113883.2.7.3.1.45.25 D string 123456789

3 MBOsiguraneOsobe D string 123456789

4 OznakaPrijamaOtpusta D string P, O

5 DatumPrijamaOtpusta D string09.03.2014

6 VrijemePrijamaOtpusta D* string

0303-0503-501717-0517-15

7

OznakaNacinaPrijamaOtpusta - 2.16.840.1.113883.2.7.3.1.45.292.16.840.1.113883.2.7.3.1.45.30 D int 1

8OznakaTipLijecenja - 2.16.840.1.113883.2.7.3.1.45.31 D int 42

9/1531-FCPBA1101493 Rev C

Page 11: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

9 BrojUpBHPID D string 2013–115

10 OznakaZaPonistenjeSloga D string S ili prazno

11 PrezimeOsiguraneOsobe N** string

HORVAT

12 ImeOsiguraneOsobe N** string IVAN

13 DatumRodjenja N** string

01.01.1992

14

KategorijaOsiguranja - 2.16.840.1.113883.2.7.3.1.45.12 N** string H

15

IdentifikatorPodatka – identifikator podatka u 16. polju N*** int

1,2,3,5,7,8,9,10

16 BrojBolesnickogLista N**** string 125/115566

Napomena: Podaci tu poljima 11 do 16 trenutno nisu obavezni sve dok je u primjeni stari HZZO slog

* vrijeme u minutama nije obavezno

** podatak je obavezan samo za osobe koje nemaju MBO

*** provjerava se ako podatak postoji

**** za INO osiguranike

Tablica 3 ima opisanu klasu ZaglavljeZahtjev.

Tablica 3 PO Klasa ZaglavljeZahtjev

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1 PorukaId1 N string6f96a97e-0911-4dcc-a418-18f5690612a8

2 VrijemeSlanja D dateTime

2019-03-18T14:25:22.7486863+01:00

1 PorukaId je ID zahtjeva koji se šalje te će taj isti ID biti vraćen u odgovoru na zahtjev.

4.2.1.2 Izlazni podaci

Tablica 4 ima opisane izlazne podatke.

Tablica 4 PO Izlazni parametri za dohvat podataka

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

9/1531-FCPBA1101493 Rev C

Page 12: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

1 PrijemOtpustOdgovor DPrijemOtpustOdgovor

Tablica 5 ima opisanu klasu PrijemOtpustOdgovor.

Tablica 5 PO Klasa PrijemOtpustOdgovor

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1 Zaglavlje N ZaglavljeOdgovor

2 Validan D boolean false

3 SlogID1 D int 157896

4 Greske N ArrayOfListaGresaka Greska prijema

5 KonfliktPoruka D string Konflikt prijema1 SlogID je jedinstveni identifikator pojedine prijave prijema i otpusta u CUS sustavu koji se poslije koristi za komunikaciju za točno određeni prijem i otpust.

Tablica 6 ima opisanu klasu ZaglavljeOdgovor.

Tablica 6 PO Klasa ZaglavljeOdgovor

ID Naziv parametraObavezan (D/N)

Tip podatka Primjer

1 PorukaId1 N string6f96a97e-0911-4dcc-a418-18f5690612a8

2 VrijemeSlanja D dateTime

2019-03-18T14:25:22.7486863+01:00

3 VrijemeZaprimanjaZahtjeva D dateTime

2019-03-18T14:25:19.8989138+01:00

1 PorukaId je ID zahtjeva koji se šalje te će taj isti ID biti vraćen u odgovoru na zahtjev.

Tablica 7 ima opisanu klasu ArrayOfListaGresaka.

Tablica 7 PO Klasa ArrayOfListaGresaka

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

2 SifraGreske N string ERR_PO_0004

3 NazivGreske N string

9/1531-FCPBA1101493 Rev C

Page 13: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

4.2.2 Prijem i otpust – konflikti

4.2.2.1 Ulazni podaci

Tablica 8 ima opisane ulazne podatke.

Tablica 8 PO Ulazni parametri za dohvat podataka

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1 Zaglavlje N ZaglavljeZahtjev

2

SifraUstanove - 2.16.840.1.113883.2.7.3.1.45.25 D string 123456789

3 Verzija1 D int 11 Verzija je verzija poruke koja se šalje. Trenutni broj verzije je 1. Ukoliko bude nadogradnji sljedeće verzije će imati veći broj te će se na ovaj način omogućiti kompatibilnost prelaska s jedne verzije na drugu.

Tablica 9 ima opisanu klasu ZaglavljeZahtjev.

Tablica 9 PO Klasa ZaglavljeZahtjev

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1 PorukaId1 N string6f96a97e-0911-4dcc-a418-18f5690612a8

2 VrijemeSlanja N dateTime

2019-03-18T14:25:22.7486863+01:00

1 PorukaId je ID zahtjeva koji se šalje te će taj isti ID biti vraćen u odgovoru na zahtjev.

4.2.2.2 Izlazni podaci

Tablica 10 ima opisane izlazne podatke.

Tablica 10 PO Izlazni parametri za dohvat podataka

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1 KonfliktiResult N KonfliktOdgovor

Tablica 11 ima opisanu klasu KonfliktOdgovor.

Tablica 11 PO Klasa KonfliktOdgovor

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1 Zaglavlje N ZaglavljeOdgovor

9/1531-FCPBA1101493 Rev C

Page 14: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

2 Konflikt N KonfliktOdgovorKonflikt

Tablica 12 ima opisanu klasu ZaglavljeOdgovor.

Tablica 12 PO Klasa ZaglavljeOdgovor

ID Naziv parametraObavezan (D/N)

Tip podatka Primjer

1 PorukaId1 N string6f96a97e-0911-4dcc-a418-18f5690612a8

2 VrijemeSlanja D dateTime

2019-03-18T14:25:22.7486863+01:00

3 VrijemeZaprimanjaZahtjeva D dateTime

2019-03-18T14:25:19.8989138+01:00

1 PorukaId je ID zahtjeva koji se šalje te će taj isti ID biti vraćen u odgovoru na zahtjev.

Tablica 13 ima opisanu klasu KonfliktOdgovorKonflikt.

Tablica 13 PO Klasa KonfliktOdgovorKonflikt

ID Naziv parametraObavezan (D/N)

Tip podatka Primjer

1 SlogID1 D int 1122

2 NazivDatoteke D string 111000000W001

3SifraUstanove - 2.16.840.1.113883.2.7.3.1.45.25 D string 123456789

4 MBOsiguraneOsobe D string 123456789

5 OznakaPrijamaOtpusta D string P,O

6 DatumPrijamaOtpusta D string09.03.2014

7 VrijemePrijamaOtpusta D* string

03-0003-0503-5017-0017-0517-15

8

OznakaNacinaPrijamaOtpusta - 2.16.840.1.113883.2.7.3.1.45.292.16.840.1.113883.2.7.3.1.45.30 D int 1

9OznakaTipLijecenja - 2.16.840.1.113883.2.7.3.1.45.31 D int 42

10 BrojUpBHPID D string 2013–115

11 OznakaZaPonistenjeSloga D string S

12 PrezimeOsiguraneOsobe N** string

HORVAT

9/1531-FCPBA1101493 Rev C

Page 15: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

13 ImeOsiguraneOsobe N** string IVAN

14 DatumRodjenja N** string

01.01.1992

15

KategorijaOsiguranja - 2.16.840.1.113883.2.7.3.1.45.12 N** string H

16 IdentifikatorPodatka N*** int 1,2,3,5,7,8,9,10

17 BrojBolesnickogLista N**** string 125/115566

18 KonfliktOpis D string

Konflikt Opis

19 KonfliktOdgovor_id D int

1 Konflikt odbijen2 Slog storniran3 Evidentiran otpust4 Konflikt ponovo poslan5 Konflikt potvrđen

20 KonfliktOdgovorNaziv N string Konflikt Odgovor Naziv

1 SlogID je jedinstveni identifikator pojedine prijave prijema i otpusta koji je bio generiran prilikom prve prijave pojedinog prijema i otpusta u CUS sustavu.

Napomena: Podaci tu poljima 12 do 17 trenutno nisu obavezni sve dok je u primjeni stari HZZO slog

* vrijeme u minutama nije obavezno** podatak je obavezan samo za osobe koje nemaju MBO*** provjerava se ako podatak postoji**** za INO osiguranike

4.2.3 Prijem i otpust – odbijanje konflikta

4.2.3.1 Ulazni podaci

Tablica 14 ima opisane ulazne podatke.

Tablica 14 PO Ulazni parametri za dohvat podataka

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1 Zaglavlje N ZaglavljeZahtjev

2 SlogID1 D int 1122

3 Verzija2 D int 11 SlogID je jedinstveni identifikator pojedine prijave prijema i otpusta koji je bio generiran prilikom prve prijave pojedinog prijema i otpusta u CUS sustavu.

9/1531-FCPBA1101493 Rev C

Page 16: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

2 Verzija je verzija poruke koja se šalje. Trenutni broj verzije je 1. Ukoliko bude nadogradnji sljedeće verzije će imati veći broj te će se na ovaj način omogućiti kompatibilnost prelaska s jedne verzije na drugu.

Tablica 15 ima opisanu klasu ZaglavljeZahtjev.

Tablica 15 PO Klasa ZaglavljeZahtjev

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1 PorukaId1 N string6f96a97e-0911-4dcc-a418-18f5690612a8

2 VrijemeSlanja N dateTime

2019-03-18T14:25:22.7486863+01:00

1 PorukaId je ID zahtjeva koji se šalje te će taj isti ID biti vraćen u odgovoru na zahtjev.

4.2.3.2 Izlazni podaci

Tablica 16 ima opisane izlazne podatke.

Tablica 16 PO Izlazni parametri za dohvat podataka

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1 OdbijanjeKonfliktResult N OdbijanjeKonfliktOdgovor

Tablica 17 ima opisanu klasu OdbijanjeKonfliktOdgovor.

Tablica 17 PO Klasa OdbijanjeKonfliktOdgovor

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1 Zaglavlje N ZaglavljeOdgovor

2 Validan D boolean

3 Poruka N string

4 Greska NOdbijanjeKonfliktOdgovorGreska

Tablica 18 ima opisanu klasu ZaglavljeOdgovor.

Tablica 18 PO Klasa ZaglavljeOdgovor

ID Naziv parametraObavezan (D/N)

Tip podatka Primjer

1 PorukaId1 N string6f96a97e-0911-4dcc-a418-18f5690612a8

2 VrijemeSlanja D dateTime

2019-03-18T14:25:22.7486863+01:00

9/1531-FCPBA1101493 Rev C

Page 17: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

3 VrijemeZaprimanjaZahtjeva D dateTime

2019-03-18T14:25:19.8989138+01:00

1 PorukaId je ID zahtjeva koji se šalje te će taj isti ID biti vraćen u odgovoru na zahtjev.

Tablica 19 ima opisanu klasu OdbijanjeKonfliktOdgovorGreska.

Tablica 19 PO Klasa OdbijanjeKonfliktOdgovorGreska

ID Naziv parametraObavezan (D/N)

Tip podatka Primjer

1 SifraGreske N string ERR_PO_0004

2 NazivGreske N string

4.2.4 Prijem i otpust – odgovor na odbijanje konflikta

4.2.4.1 Ulazni podaci

Tablica 20 ima opisane ulazne podatke.

Tablica 20 PO Ulazni parametri za dohvat podataka

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1 Zaglavlje N ZaglavljeZahtjev

2 SlogID1 D int 1122

3 Odgovor D boolean true ili false

4 Verzija2 D int 11 SlogID je jedinstveni identifikator pojedine prijave prijema i otpusta koji je bio generiran prilikom prve prijave pojedinog prijema i otpusta u CUS sustavu. 2 Verzija je verzija poruke koja se šalje. Trenutni broj verzije je 1. Ukoliko bude nadogradnji sljedeće verzije će imati veći broj te će se na ovaj način omogućiti kompatibilnost prelaska s jedne verzije na drugu.

Tablica 21 ima opisanu klasu ZaglavljeZahtjev.

Tablica 21 PO Klasa ZaglavljeZahtjev

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1 PorukaId1 N string6f96a97e-0911-4dcc-a418-18f5690612a8

2 VrijemeSlanja N dateTime

2019-03-18T14:25:22.7486863+01:00

1 PorukaId je ID zahtjeva koji se šalje te će taj isti ID biti vraćen u odgovoru na zahtjev.

9/1531-FCPBA1101493 Rev C

Page 18: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

4.2.4.2 Izlazni podaci

Tablica 22 ima opisane izlazne podatke.

Tablica 22 PO Izlazni parametri za dohvat podataka

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1OdgovorNaOdbijanjeKonfliktResult N

OdgovorNaOdbijanjeKonfliktOdgovor

Tablica 23 ima opisanu klasu OdgovorNaOdbijanjeKonfliktOdgovor.

Tablica 23 PO Klasa OdgovorNaOdbijanjeKonfliktOdgovor

ID Naziv parametraObavezan (D/N) Tip podatka Primjer

1 Zaglavlje N ZaglavljeOdgovor

2 Validan D boolean

3 Poruka N string

4 Greska NOdgovorNaOdbijanjeKonfliktOdgovorGreska

Tablica 24 ima opisanu klasu ZaglavljeOdgovor.

Tablica 24 PO Klasa ZaglavljeOdgovor

ID Naziv parametraObavezan (D/N)

Tip podatka Primjer

1 PorukaId1 N string6f96a97e-0911-4dcc-a418-18f5690612a8

2 VrijemeSlanja D dateTime

2019-03-18T14:25:22.7486863+01:00

3 VrijemeZaprimanjaZahtjeva D dateTime

2019-03-18T14:25:19.8989138+01:00

1 PorukaId je ID zahtjeva koji se šalje te će taj isti ID biti vraćen u odgovoru na zahtjev.

Tablica 25 ima opisanu klasu OdbijanjeKonfliktOdgovorGreska.

Tablica 25 PO Klasa OdbijanjeKonfliktOdgovorGreska

ID Naziv parametraObavezan (D/N)

Tip podatka Primjer

1 SifraGreske N string ERR_PO_0004

2 NazivGreske N string

4.2.4.3 Digitalni certifikati i sigurnost

Poruka se potpisuje digitalnim klijentskim certifikatom.

9/1531-FCPBA1101493 Rev C

Page 19: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

Poruka se šalje VPN rutom napravljenom od bolnice do CEZIH-a, https kanalom gdje se veza uspostavila s bolničkim aplikativnim certifikatom.

4.3 Implementacija sigurnosnih mehanizama

Sigurnosni mehanizmi implementirani su na sljedeći način:

Svaka poruka se potpisuje klijentskim certifikatom

Svaka poruka koja se šalje prolazi kroz VPN

Role koje se moraju dodijeliti klijentskom certifikatu su:

o an_discharge_central_admin

o an_discharge_hospital_admin

o an_discharge_hospital_management

Role koje se moraju dodijeliti klijentima, ovisno o tome koje će funkcionalnosti koristiti su:

o an_discharge_central_admin (za pregled konflikata, administrator sustava)

o an_discharge_hospital_admin (za slanje prijema i otpusta, pregled konflikata, odbijanje konflikata i dobivanje odgovora na odbijanje konflikata, administratori u bolnicama)

o an_discharge_hospital_management (za pregled konflikata, uprava zdravstvene ustanove)

4.4 Primjeri poruka

Primjeri odlaznih i dolaznih poruka nalaze se u prilogu uz ovaj dokument.

4.5 Preduvjeti za implementaciju na certifikaciji

Potrebno je odraditi sljedeće preduvjete:

1. G100 proizvođači aplikacija šalju zahtjev HZZO-u za pristup do certifikacijske okoline.

2. G100 proizvođač uz zahtjev dostavlja popis postojećih testnih kartica prema HZZO za dodjelu rola. Ukoliko iste ne posjeduje, šalje zahtjev za dodjelu testne kartice.

3. Na certifikacijskoj okolini, G100 proizvođač aplikacija mora uspješno poslati i dobiti ispravan odgovor prema WSDL definiciji sljedeće poruke u svrhu testiranja:

9/1531-FCPBA1101493 Rev C

Page 20: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

a. jednu poruku prijema i otpusta pacijenta sa svim obaveznim podacima iz web servisa,

b. jednu poruku prijema pacijenta koji još nije otpušten iz druge zdravstvene ustanove ili svoje zdravstvene ustanove sa svim obaveznim podacima iz web servisa,

c. jednu poruku za pregled konflikta,

d. jednu poruku za odbijanje konflikta,

e. jednu poruku za dobivanje odgovora na odbijanje konflikta.

4. Ukoliko je G100 proizvođač aplikacija zadovoljio sve uvjete na certifikacijskoj okolini, njegove bolnice su spremne priključiti se na produkciju.

4.6 Preduvjeti za implementaciju na produkciji

1. G100 proizvođači su zadovoljili certifikaciju.

2. Ovlaštena osoba iz bolnice koja se spaja na produkciju, mora zatražiti za administratore u bolnicama i upravu zdravstvene ustanove HZZO dodjelu role an_discharge_central_admin, an_discharge_hospital_admin i an_discharge_hospital_management za korištenje web servisa za prijem i otpust.

4.7 Testiranje i verifikacija

Certifikacijski linkovi:

https://certws.cezih.hr:49443/cus-services/prijem-otpust

Produkcijski linkovi:

https://ws.cezih.hr:15443/cus-services/prijem-otpust

5 Primjeri slučajeva

5.1 Preklapajući prijem i otpust

Ukoliko dođe do preklapajućeg prijema i otpusta uz slučaj:

Ustanova A Ustanova B

Prijem 01.04.2019 Prijem 10.04.2019 (sporni prijem)

9/1531-FCPBA1101493 Rev C

Page 21: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

Otpust 11.04.2019

Ustanova A zaprima pacijenta 01.04.2019 te radi otpust 11.04.2019. Paralelno s tim Ustanova B zaprima pacijenta 10.04.2019 te u listi pogrešaka dobiva obavijest da je prijem odbijen radi preklapajućeg ležanja iz Ustanove A. Ukoliko je Ustanova A poslala krivi otpust korigira otpust, a ukoliko je Ustanova B poslala krivi prijem korigira prijem.

5.2 Rješavanje konflikata

Ukoliko dođe do konflikta uz slučaj:

Ustanova A Ustanova B

Prijem 01.04.2019 Prijem 10.04.2019 (sporni prijem)

Otpust nije poslan npr.

Ustanova B dobiva poruku o stvorenom konfliktu s Ustanovom A. Konflikt se rješava na način da kada Ustanova A vidi konflikt ili bude upućena od strane Ustanove B da razriješe konflikt, šalje otpust ili storno prijema da bi se konflikt razriješio. Ukoliko se Ustanova A ne slaže s konfliktom ona metodom OdbijanjeKonflikata odbija konflikt i na taj način želi reći Ustanovi B da je pacijent još uvijek npr. kod njih na liječenju. Tada metodom OdgovorNaOdbijanjeKonflikata koju poziva Ustanova B šalje true ili false vrijednosti (true - slaže se s ustanovom A, te se Prijem u Ustanovi B automatski stornira; false – ne slaže se s ustanovom A, te im ponovno vraća konflikt da razriješe. U tom slučaju Ustanova A ponovno poziva metodu OdbijanjeKonflikata, dok Ustanova B opet poziva metodu OdgovorNaOdbijanjeKonflikata dok se konflikt ne riješi).

Napomena: Ustanova B unatoč konfliktu može poslati otpust pacijenta.

Prilog A – Primjeri Poruka

9/1531-FCPBA1101493 Rev C

Page 22: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

Prilog B – WSDL web servisa

Prilog C – Popis grešaka sigurnosnog slojaTablica 26 Opis grešaka u razmjeni podataka web servisom na sigurnosnom

slojuIdentifikator pogreške

Tekst pogreške

ERR_SEC_90000 Internal System ErrorERR_SEC_90001 Invalid SSL CertificateERR_SEC_90002 Limit ReachedERR_SEC_90004 Sender not authorizedERR_SEC_90005 Invalid MessageERR_SEC_90006 Message not according to HL7 schemaERR_SEC_90007 Message has no messageIDERR_SEC_90008 Message has no sendig appIDERR_SEC_90009 Message has no receiving appIDERR_SEC_90010 Message has no Certificate in SignatureERR_SEC_90011 Invalid signature certificateERR_SEC_90012 Invalid Message SignatureERR_SEC_90013 Invalid signature certificateERR_SEC_90014 No Author in MessageERR_SEC_90015 No UID Attribute in Signer Certificate DNERR_SEC_90016 Signer not authorizedERR_SEC_90017 Signer does not match authorERR_SEC_90018 Invalid Message Element NameERR_SEC_90019 Message encoding validation failed

Prilog D – Popis grešaka web servisaTablica 27 Opis grešaka u razmjeni podataka web servisomIdentifikator pogreške

Tekst pogreške

ERR_PO_0001 Ova akcija nije dopuštena.

ERR_PO_0002 Dogodila se interna greška u servisu u {datum i vrijeme} sati. Molimo obratite se administratoru sustava.

ERR_PO_0003 Pogrešna šifra bolnice.

9/1531-FCPBA1101493 Rev C

Page 23: Uvod - Implementacija web servisa za... · Web viewOvo poglavlje opisuje arhitekturu rješenja za uspostavu konekcije između BIS-a i CUS web servisa za prijem i otpust (Slika 2)

CUS – Implementacija web servisa za Prijem i otpust

ERR_PO_0004 Pogrešna oznaka prijema/otpusta.ERR_PO_0005 Pogrešan datum prijema/otpust.ERR_PO_0006 Pogrešan sat prijema/otpust.ERR_PO_0007 Pogrešna šifra načina prijema.ERR_PO_0008 Pogrešna šifra načina otpusta.ERR_PO_0009 Pogrešna oznaka tipa liječenja.ERR_PO_0010 Neispravan datum rođenja. ERR_PO_0011 Neispravna kategorija osiguranja. ERR_PO_0012 Neispravan identifikator INO. ERR_PO_0013 Neispravan broj INO. Pogrešan MBO pacijenta

ERR_PO_0014 Pacijent već ima zatvoreno stacionarno liječenje za ovu uputnicu/BHP!

ERR_PO_0015 Pacijent ima datum otpusta manji od datum prijema, ili podaci o otpustu nisu u skladu s poslanim prijemom!

ERR_PO_0016Pacijent ima datum prijema manji od datum otpusta prijašnjeg boravka u Vašoj ustanovi! Provjerite ispravnost Vaših podataka!

ERR_PO_0017U bazi podataka nema podatka o prijemu pacijenta sa datumom manjim od datuma otpusta. Stoga nije moguće evidentirati otpust!

ERR_PO_0018 Pogrešan MBO pacijenta.ERR_PO_0019 Šifra bolnice ne odgovara nazivu datoteke.ERR_PO_0020 Oznaka za prijem/otpust je obvezan podatak.ERR_PO_0021 Pogrešan broj hitnog prijema.ERR_PO_0022 Pogrešan broj uputnice.ERR_PO_0023 Poništenje nije moguće evidentirati. U bazi ne postoji slog s

upisanim podacima.ERR_PO_0024 Poništenje nije moguće evidentirati. Slog je već poništen.

ERR_PO_0025 Poništenje nije moguće evidentirati - Pogrešna oznaka za storno.

ERR_PO_0026 Prezime je neispravan podatak.ERR_PO_0027 Ime je neispravan podatak.ERR_PO_0029 Broj hitnog prijama već je upisan. Pacijent je već zaprimljen.ERR_PO_0030 Broj uputnice već je upisan. Pacijent je već zaprimljen.ERR_PO_0031 Pogrešna šifra načina prijema 2 - dozvoljen je za istu

uputnicu (B2) u slučaju da je razmak između liječenja veći od jedan dan.

ERR_PO_0032 Pogrešna šifra načina prijema 4 - dozvoljen je za istu uputnicu (B2) u slučaju da nema razmaka između liječenja.

ERR_PO_0033 Poruka nije dozvoljena! Šaljete podatke za ustanovu u kojoj ne radite.

ERR_PO_0034 Broj INO može biti upisan samo ukoliko je osiguranje „H“.ERR_PO_0035 Pacijent ne može biti otpušten na dan zaprimanja.ERR_PO_0036 Slog s takvim ID ne postoji u bazi.ERR_PO_0037 U vašoj ustanovi već postoji aktivna prijava za ovog

pacijenta. Molimo razriješite si konflikt slanjem otpusta ili storniranjem.

9/1531-FCPBA1101493 Rev C