Pull notifikacije
Ova metoda preuzimanja notifikacija o promjenama stanja i metapodataka kliničkih dokumenata omogućava periodičko slanje zahtjeva za dohvat notifikacija.
Informacijski sustav šalje zahtjev za dohvat notifikacija za određenu zdravstvenu organizaciju putem za to predviđenog servisa. Ukoliko postoje notifikacije za tu zdravstvenu organizaciju CEZIH vraća jednu ili više notifikacija u odgovoru.
Primjer zahtjeva za dohvat notifikacija
GET https://cezih.hr/API/notificationService/getNotifications?recepient=http://fhir.cezih.hr/specifikacije/identifikatori/HZZO-sifra-zdravstvene-organizacije|1234567&recepient_type=organization&date_from=2022-07-17T00:00:00.000+02:00&date_to=2022-07-19T00:00:00.000+02:00
gdje je
recepient - identifikator primatelja notifikacije za kojeg se žele preuzeti notifikacije. Oblik identifikatora je [tip_identifikatora]|[identifikator] gdje je: tip_identifikatora (obavezno) - url koji definira tip identifikatora identifikator (obavezno) - identifikator
recepient_type - tip primatelja notifikacija koji može biti zdravstvena organizacija (organization), zdravstveni djelatnik (practitioner), medicinski uređaj ili informacijski sustav (device).
date_from (opcionalno) - specificira da se žele preuzeti notifikacije čije je vrijeme kreiranja novije od navedenog datuma. Ukoliko se ne navede ovaj parametar to znaći da će se preuzeti sve poruke koje postoje u CEZIH sustavu. Vrijeme čuvanja notifikacija je konfigurabilno no za sada će biti podešeno na 6 mjeseci. To znači da se mogu preuzeti notifikacije kreirane do 6 mjeseci od trenutka slanja zahtjeva
date_to (opcionalno) - specificira da se žele preuzeti notifikacije čije je vrijeme kreiranja starije od navedenog datuma. Ukoliko se ne navede ovaj parametar to znači da će se preuzeti sve notifikacije čije je vrijeme kreiranja starije od vremena slanja zahtjeva
Preporuča se da informacijski sustav sprema vremensku oznaku zadnje preuzete notifikacije. Time će mu biti omogućeno definiranje parametra date_from kako nebi preuzimao notifikacije koje je već preuzeo.
Primjer odgovora ukoliko postoje notifikacije za tu organizaciju
[
{
"uuid": "1fe95e79-e93f-42b0-a7de-aaad58d5cdbe",
"timestamp": "2022-09-15T08:12:03.123+02:00",
"resource": {
.....
},
"status": "ACTIVE",
"recepient": "http://fhir.cezih.hr/specifikacije/identifikatori/HZZO-sifra-zdravstvene-organizacije|1234567",
"recepient_type": "organization",
"intendedRecepients": {
"http://fhir.cezih.hr/specifikacije/identifikatori/HZJZ-broj-zdravstvenog-djelatnika|1234567",
"http://fhir.cezih.hr/specifikacije/identifikatori/HZJZ-broj-zdravstvenog-djelatnika|5555544"
}
},
{
"uuid": "9b4f43e2-d5a3-4ddf-859b-1f245cd12185",
"resource": {
.....
},
"status": "ACTIVE",
"organization": "http://fhir.cezih.hr/specifikacije/identifikatori/HZZO-sifra-zdravstvene-organizacije|1234567",
}
]
gdje je uuid - jedinstveni identifikator notifikacije
timestamp - vremenska oznaka kreiranja notifikacije
resource - DocumentReference. DocumentReference resurs se šalje u slučaju promjena u registraciji, statusu i metapodatcima kliničkih dokumenata SGP nalaza. Specifikacija DocumentReference resursa se nalazi u sklopu specifikacije IHE MHD integracijskog profila.
status - status notifikacije ACTIVE - aktivna, CLOSED - zatvorena
recepient - identifikator primatelja notifikacije. Ovisno o tipu primatelja (recepient_type) može biti zdravstvena organizacija, zdravstveni djelatnik, medicinski uređaj ili informacijski sustav.
recepient_type - tip primatelja notifikacije. Može biti zdravstvena organizacija (organization), zdravstveni djelatnik (practitioner), medicinski uređaj ili informacijski sustav (device).
intendedRecepients - identifikatori osoba unutar zdravstvene organizacije kojima je namijenjena notifikacija.
Primjer odgovora u slučaju greške u obradi zahtjeva:
{
"error":{
"errorCode": {
"system": "http://ent.hr/fhir/CodeSystem/message-error-type",
"code": "NOT-1111"
},
"errorDescription": "Nepoznata organizacija"
}
}
Ova specifikacija definira dvije operacije "getNotifications" i changeNotificationState". "changeNotificationState" operacija se ne koristi za potrebe razmjene kliničkih dokumenata..