Pull notifikacije
Ova metoda preuzimanja notifikacija o promjenama stanja procesa SGP uputnice i registracije, promjene stanja i metapodataka kliničkih dokumenata SGP nalaza 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). U COD projektu se koristi samo notifikacije za zdravstvene ustanove
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 - FHIR resurs Task ili DocumentReference. Task FHIR resurs se šalje za notifikacije o promjeni stanja procesa SGP uputnice. DocumentReference resurs se šalje u slučaju promjena u registraciji, statusu i metapodatcima kliničkih dokumenata SGP nalaza. Specifikacija task resursa koji se šalje se nalazi ovdje. 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. Za potrebe COD projekta koristit će se samo zdravstvena organizacija.
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 COD projekta.