uvod - cezih · web viewuvod ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih...
TRANSCRIPT
![Page 1: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/1.jpg)
CUS - Implementacija web servisa šifrarnika
Opis rješenja
Rev E
![Page 2: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/2.jpg)
Verzije dokumenta
Verzija Datum Opis AutorA 01/02/2019 Odobrena inačica dokumenta
B 15/05/2019 Dodani HL7 FHIR JSON resursi Codesystem i Practitioner te je izdvojena lista zdravstvenih djelatnika
C 15/11/2019 Nadopunjeni HL7 FHIR JSON resursi i dodani XML resursi CodeSystem i Practitioner
D 18/12/2019 Nadodan dohvat liste zdravstvenih djelatnika
E 11/03/2020 Za FHIR GET resurse dodan opis zaglavlja i biranja JSON ili XML,Za FHIR resurse 4.2.5 i 4.2.6 dodan filter po OIDu kodnih listiUklonjen dohvat pojedinačnih djelatnika po MBO / HZJZ šifri
Rev E
![Page 3: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/3.jpg)
Sadržaj1 Uvod51.1 Svrha..................................................................................................................1.2 Definicije, akronimi i kratice...............................................................................1.3 Reference..........................................................................................................
2 Centralni upravljački sustav...........................................................................
3 Slučajevi uporabe............................................................................................3.1 Uvod 83.2 Poslovni tijek......................................................................................................3.2.1 Dohvat kodnih listi / šifrarnika............................................................................3.2.2 Dohvat trenutne liste zdravstvenih djelatnika....................................................
4 Arhitektura cjelokupnog rješenja...................................................................4.1 Opis arhitekture..................................................................................................4.2 Web servisi......................................................................................................4.2.1 Dohvat popisa svih kodnih listi.........................................................................4.2.2 Dohvat naziva svojstava (kolone) pojedine kodne liste...................................4.2.3 Dohvat svih elemenata pojedine kodne liste (preuzimanje šifrarnika).............4.2.4 HL7 FHIR Dohvat svih elemenata pojedine kodne liste (preuzimanje
šifrarnika).........................................................................................................4.2.5 HL7 FHIR Dohvat naziva svih kodnih lista.......................................................4.2.6 HL7 FHIR Dohvat elemenata kodnih lista izmijenjenih na određeni
datum ili nakon određenog datuma (preuzimanje šifrarnika)...........................4.2.7 HL7 FHIR Dohvat elemenata kodnih lista izmijenjenih na određeni
datum (preuzimanje šifrarnika)........................................................................4.2.8 Dohvat liste zdravstvenih djelatnika promijenjene na uneseni datum ili
nakon njega.....................................................................................................4.2.9 Dohvat liste zdravstvenih djelatnika.................................................................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.....................................................................................
Prilog A – Primjeri Poruka...............................................................................................1. Dohvat popisa svih kodnih listi.........................................................................2. Dohvat naziva svojstava (kolone) pojedine kodne liste...................................3. Dohvat svih elemenata pojedine kodne liste (preuzimanje šifrarnika).............4. HL7 FHIR Dohvat svih elemenata pojedine kodne liste (preuzimanje
šifrarnika).........................................................................................................5. HL7 FHIR Dohvat svih naziva kodnih listi........................................................6. HL7 FHIR Dohvat elemenata kodnih lista izmijenjenih na određeni
datum ili nakon određenog datuma (preuzimanje šifrarnika)...........................7. HL7 FHIR Dohvat elemenata kodnih lista izmijenjenih na određeni
datum (preuzimanje šifrarnika)........................................................................8. Dohvat liste zdravstvenih djelatnika promijenjene na određeni datum ili
nakon njega.....................................................................................................
Rev E
![Page 4: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/4.jpg)
Prilog C – WSDL web servisa..........................................................................................
Prilog D – Popis grešaka sigurnosnog sloja.................................................................
Prilog E – Popis grešaka web servisa............................................................................
NAPOMENE 73
Rev E
![Page 5: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/5.jpg)
1 Uvod
1.1 Svrha
Svrha ovog dokumenta je opisati arhitekturu rješenja za integraciju bolničkog sustava s centralnim CUS web servisima šifrarnika.
1.2 Definicije, akronimi i kratice
MIZ Ministarstvo zdravstva
HZZO Hrvatski zavod za zdravstveno osiguranje
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
BIS Bolnički informacijski sustav
CTS Common Terminology Services
SVS Sharing value sets
XML Extensible Markup language
JSON JavaScript Object Notation
WSDL Web Service Description Language
SOAP Simple Object Access Protocol
REST Representational state transfer
CEZIH Centralni elektronički zdravstveni informacijski sustav RH
VPN Virtual Private Network
HTTPS Hypertext transfer protocol secure
FHIR Fast Healthcare Interoperability Resources
1.3 Reference
[REF1] CUS – Opis budućeg rješenja i funkcionalnosti, 7/ETK/K/241-17:144
Rev E
![Page 6: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/6.jpg)
[REF2] SOAP https://www.w3.org/TR/2000/NOTE-SOAP-20000508/
[REF3] XML https://tools.ietf.org/html/rfc4825
[REF4] CTS , SVS ANSI/HL7 V3 CTS R2-2015
[REF5] HL7 FHIR – CodeSystem resurs https://www.hl7.org/fhir/codesystem.html
[REF6] HL7 FHIR – Practitioner resurs https://www.hl7.org/fhir/practitioner.html
Rev E
![Page 7: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/7.jpg)
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
Slika 1 Pregled grupa funkcionalnosti
Detaljni opis rješenja i funkcionalnosti nalazi se u [REF1].
Rev E
![Page 8: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/8.jpg)
3 Slučajevi uporabe
3.1 Uvod
Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti:
1. Dohvat kodnih listi / šifrarnika
2. Dohvat trenutne liste zdravstvenih djelatnika
Preporuča se implementacija sučelja navedenih u poglavljima 4.2.4 - 4.2.9 ovog dokumenta.
3.2 Poslovni tijek
3.2.1 Dohvat kodnih listi / šifrarnika
Ovo poglavlje opisuje tijek korištenja komponente za dohvat kodnih listi/šifrarnika putem web servisa. Djelatnici bolnice funkcionalnost koriste neizravno kroz sučelje BIS-a, gdje se BIS putem VPN-a do CEZIH-a, povezuje web servisima sa CUS-om. Manje preporučena alternativa je putem sučelja Internet preglednika zbog koncentracije informacija u jednom centralnom programu – BISu.
Slučaj uporabe za CUS web servise obavijesti opisan je sljedećim koracima:
1. Administrator u MIZ/HZZO-u unosi u CUS izmjenu u bilo kojem postojećem šifrarniku ili stvara novi šifrarnik. Nakon objave podataka kroz sustav šifrarnik u tom trenutku postaje vidljiv svim djelatnicima koji imaju pravo dohvatiti tu obavijest (nakon propagacije kroz priručnu memoriju) CEZIH sigurnosnog sloja.
2. BIS poslužitelj povremeno – npr. jednom u 30 min radi provjeru broja novo-pristiglih revizija šifrarnika- Napomena: u svrhu učinkovitog rada sustava i optimiziranje količine prometa - preporuča se dohvat sa centralne lokacije za sve BIS klijente unutar zdravstvene ustanove
3. Informacije o novo-pristiglim revizijama BIS pohranjuje u lokalnu bazu podataka te uspostavlja konekciju s CUS-om i dohvaća kompletne nove revizije putem CUS web servisa sa svim svojstvima i „retcima“- preporuča se dohvat sa centralne lokacije za sve BIS klijente unutar zdravstvene ustanove
4. BIS ažurira lokalno stanje šifrarnika prema zadnje zaprimljenim sa CUS web servisa – Napomena- preporučljivo je lokalno pohranjivanje starijih revizija šifrarnika zbog potreba slanja podataka o fakturiranju i prijemima/otpustima u slučaju konflikata-grešaka u slogovima. Povijesno stanje svih šifrarnika moguće je dohvatiti i sa CUS sustava specifikacijom točnog šifrarnika i revizije.
Rev E
![Page 9: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/9.jpg)
3.2.2 Dohvat trenutne liste zdravstvenih djelatnika
Ovo poglavlje opisuje tijek korištenja komponente za dohvat liste zdravstvenih djelatnika. Slučaj uporabe za CUS web servise obavijesti opisan je sljedećim koracima:
1. Lista trenutno aktivnih korisnika se ažurira automatski gotovo svakodnevno
2. BIS poslužitelj jednom dnevno – npr. početkom rada – dohvaća podatke o djelatnicima te šalje zadnji datum kad su podaci lokalni osvježeni- Ukoliko ima novih podataka, bit će vraćeni klijentu.Napomena: u svrhu učinkovitog rada sustava i optimiziranje količine prometa - preporuča se dohvat sa centralne lokacije za sve BIS klijente unutar zdravstvene ustanove
3. BIS ažurira lokalno stanje šifrarnika prema zadnje zaprimljenim sa CUS web servisa – Napomena- preporučljivo je lokalno pohranjivanje starijih revizija šifrarnika zbog potreba slanja podataka o fakturiranju i prijemima/otpustima u slučaju konflikata-grešaka u slogovima.
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 Kodne liste - šifrarnike (Slika 2).
Slika 2 Arhitektura rješenja
Bolnički informacijski sustav je u ovom dijagramu prikazan kao „Klijent web servisa“. Prilikom slanja zahtjeva sustavu, sigurnosni sloj za jedan set zahtjeva provjerava poslani certifikat tj. potpis napravljen sa certifikatom, te za sve zahtjeve provjerava valjanost parametara poruke (npr. postojanje poslanih identifikatora prema izvoru identifikatora) te ukoliko nema pogrešaka propušta poruku prema CUS web servisima šifrarnika. Potpis poruke/zahtjeva u sigurnosnom sloju obavezan je za sve servise koji su vezani za dohvat zdravstvenih djelatnika (resurs Practitioner).
Rev E
![Page 10: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/10.jpg)
U slučaju da pojedini zahtjev nema ispravne parametre ili ne konformira propisanoj strukturi poruke prema WSDLu , poruka o pogrešci će biti vraćena pošiljatelju.
CUS web servis kodnih listi implementira međunarodni standard HL7 CTS. To je programsko sučelje za definiciju terminološkog sadržaja. Služi opisivanju zajedničkih karakteristika kodnih sustava temeljenih na identifikatorima resursa i oznakama kodova. Kodni sustav poput šifrarnika naselja u kojem je moguće definirati relacije između drugog kodnog sustava poput šifrarnika županija. Specifikacije atributa su proširive kao i dodavanje novih kodnih sustava, identifikatora i relacija.
Svaka kodna lista je jednoznačno određena sa OID brojem, dok svaki element svake revizije kodne liste ima svoj jedinstiveni identifikator.
Sadržaj šifrarnika je moguće preuzimati koristeći HL7 CTS XML zapis ili HL7 FHIR JSON/XML zapisom – resurs CodeSystem.
Šifrarnik zdravstvenih djelatnika izdvojen je u zasebnu listu koji implementira HL7 FHIR JSON/XML resurs Practitioner.
4.2 Web servisi
Definirana su 4 web servisa sa izdvojenim sljedećim metodama iz CTS specifikacije [REF4]:
1. Dohvat popisa svih kodnih listi
2. Dohvat naziva svojstava (kolone) pojedine kodne liste
3. Dohvat svih elemenata pojedine kodne liste (preuzimanje šifrarnika)
4. (HL7-FHIR) Dohvat svih elemenata pojedine kodne liste (preuzimanje šifrarnika)
5. (HL7-FHIR) Dohvat svih naziva kodnih lista
6. (HL7-FHIR) Dohvat elemenata kodnih lista izmijenjenih na određeni datum ili nakon određenog datuma (preuzimanje šifrarnika)
7. (HL7-FHIR) Dohvat elemenata kodnih lista izmijenjenih na određeni datum (preuzimanje šifrarnika)
8. (HL7-FHIR) Dohvat elementa iz liste zdravstvenih djelatnika izmjenjenih na određeni datum ili nakon tog datuma
9. Dohvat liste zdravstvenih djelatnika
Osim navedenih izdvojenih metoda, nužnih za osnovne operacije preuzimanja podataka kodnih listi, sustav implementira puni CTS standard sa svim pripadajućim metodama ( CTS Message API, CTS Vocabulary API, CTS Mapping API) što je vidlljivo u WSDL specifikaciji. Dodatno implementiran je SVS profil.
Rev E
![Page 11: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/11.jpg)
4.2.1 Dohvat popisa svih kodnih listi
4.2.1.1 Tip zahtjeva
HTTP POST
4.2.1.2 Format tijela zahtjeva
SOAP
4.2.1.3 Adresa metode
[HOST]/ctsadmin/service/vocab/runtime/getSupportedCodeSystems
4.2.1.4 Ulazni podaci
Donja tablica ima opisane ulazne podatke.
Tablica 1 Ulazni parametri za dohvat podataka
ID Naziv parametra Obavezan (D/N) Tip podatka Primjer Značenje
1 time_limit D Int 0
Vrijeme odgovora u milisekundama, 0 za neograničeno
2 Size_limit D int 0
Maksimalan broj podržanih kodnih sustava u responseu , 0 za neograničeno
4.2.1.5 Izlazni podaci
Donja tablica ima opisane izlazne podatke.
Tablica 2 Izlazni parametri dohvata podataka
ID Naziv parametraObavezan (D/N) Tip podatka Primjer Značenje
1 getSupportedCodeSystemsReturn D objektVršni objekt koji sadrži listu objekata sa donjim svojstvima
2 codeSystem_id D String 1.2.3.4.5.6.7.8.9 Identifikator kodne liste
3 codeSystem_name D String DTP postupci Naziv kodne liste
4 copyright: string N String HZZO Oznaka vlasništva kodne liste
5 codeSystem_versions D objekt 33Objekt sa verzijama kodne liste
6 codeSystem_versions/item D int 8 Dostupna revizija kodne liste
Rev E
![Page 12: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/12.jpg)
4.2.1.6 Digitalni certifikati i sigurnost
Poruka se šalje VPN rutom napravljenom od zdravstvene ustanove do CEZIH-a, HTTPS kanalom gdje se veza uspostavila certifikatom.
4.2.2 Dohvat naziva svojstava (kolone) pojedine kodne liste
4.2.2.1 Tip zahtjeva
HTTP POST
4.2.2.2 Format tijela zahtjeva
SOAP
4.2.2.3 Adresa metode
[HOST]/ctsadmin/service/vocab/runtime/lookupCodeSystemInfo
4.2.2.4 Ulazni podaci
Donja tablica ima opisane ulazne podatke.
Tablica 3 Ulazni parametri za dohvat podataka
ID Naziv parametraObavezan (D/N) Tip podatka Primjer
Značenje
1 codeSystem_id D String 1.2.3.4.5.6.7.8.9 Identifikator kodne liste
2 codeSystem_name D String DTP postupci Naziv kodne liste
3 codeSystem_version D Int 11 Revizija kodne liste
4.2.2.5 Izlazni podaci
Donja tablica ima opisane izlazne podatke.
Tablica 4 Izlazni parametri dohvata podataka
ID Naziv parametraObavezan (D/N)
Tip podatka Primjer
Značenje
1 lookupCodeSystemInfoReturn D 1..1 OBJEKT OK_LIMITIRAN
Detaljne informacije o šifrarniku
2 codeSystem_id D 1..1 String 1.2.3.4.6Identifikator šifrarnika
Rev E
![Page 13: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/13.jpg)
3 codeSystem_name D 1..1 String ICD10 Naziv šifrarnika
4 copyright N 0..1 datetime HZZO Autorsko pravo
5 codeSystem_version D 1..1 Objekt Verzija šifrarnika
6 codeSystem_versions/item D 1..1 datetime 1
7 fullName D 1..1 String ICD10Puni naziv kodne liste
8 codeSystemDescription N 0..1 String opis Opis šifrarnika
9 codeSystemValidFrom N 0..1 date 2015-01-01+06:00Validnost od datuma
10 codeSystemValidTo N 0..1 date 2020-01-01+06:00Validnost do datuma
11 supportedLanguages D 1..1 objekt Podržani jezici
12 supportedLanguages/item D 1.. * String HR
13 supportedRelations D 1..1 objekt Podržane relacije
14 supportedRelations/item N 0.. * string hasPartPo CTS specifikaciji
15 supportedProperties D 1..1 objekt Podržana svojstva
16 supportedProperties/item N 0.. * string cijenaNaziv svojstva /kolone
17 supportedMimeTypes D 1..1 objektPodržani MIME tipovi
18 supportedMimeTypes/item: string D 1.. * string text/plain
19 supportedRelationQualifiers D 1..1 objektRelacijski kvalifikatori
20 supportedRelationQualifiers/item: string N 0.. * string test1
4.2.2.6 Digitalni certifikati i sigurnost
Poruka se šalje VPN rutom napravljenom od zdravstvene ustanove do CEZIH-a, HTTPS kanalom gdje se veza uspostavila certifikatom.
4.2.3 Dohvat svih elemenata pojedine kodne liste (preuzimanje šifrarnika)
4.2.3.1 Tip zahtjeva
HTTP POST
4.2.3.2 Format tijela zahtjeva
SOAP
Rev E
![Page 14: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/14.jpg)
4.2.3.3 Adresa metode
[HOST]/ctsadmin/service/vocab/ browser/lookupConceptCodesByCodeSystem
4.2.3.4 Ulazni podaci
Donja tablica ima opisane ulazne podatke.
Tablica 5 Ulazni parametri za dohvat podataka
ID Naziv parametraObavezan (D/N) Tip podatka Primjer
Značenje
1 codeSystem_id D String 1.2.3.4.5.6.7.8.9 Identifikator kodne liste
2 codeSystem_name N String DTP postupci Naziv kodne liste
3 codeSystem_version N Int 11 Revizija kodne liste
4.2.3.5 Izlazni podaci
Donja tablica ima opisane izlazne podatke.
Tablica 6 Izlazni parametri dohvata podataka
ID Naziv parametraObavezan (D/N)
Tip podatka Primjer Značenje
1 LookupConceptCodesByCodeSystemReturn D objektPopis svih kodnih lista
2 concept_id D objekt
3 codeSystem_id D String 3001Identifikator kodne liste
4 concept_code D String 1 Šifra
5 conceptStatus_code D String Active Status šifre
6 codeSystem_version D Objekt Verzija šifrarnika
7 designatedBy D Objekt
8 designatedBy/item N Objekt
9 designatedBy/item/designation D String SPECT Oznaka šifre
10 designatedBy/item/language_code D String HR Jezik oznake šifre
11designatedBy/item/ preferredForLanguage D String false
Preferirani jezik oznake šifre
12 hasProperties D Objekt
13 hasProperties/item N Objekt
14 hasProperties /item/property_code D String Tip opreme Svojstvo
Rev E
![Page 15: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/15.jpg)
15 hasProperties /item/propertyValue D String 2.16.840.1.1.... Vrijednost svojstva
16 hasProperties /item/language_code D Objekt HR Jezik svojstva
17 hasProperties /item/mimeType_code D String MIME tip svojstva
4.2.3.6 Digitalni certifikati i sigurnost
Poruka se šalje VPN rutom napravljenom od zdravstvene ustanove do CEZIH-a, HTTPS kanalom gdje se veza uspostavila certifikatom.
4.2.4 HL7 FHIR Dohvat svih elemenata pojedine kodne liste (preuzimanje šifrarnika)
4.2.4.1 Tip zahtjeva
HTTP GET
4.2.4.2 Format tijela zahtjeva
URL
Format zaglavlja zahtjeva
Izlazni podaci se bez dodatnih elemenata zahtjeva vraćaju u JSON zapisu.Izlazne podatke je moguće prikazati i u XML formatu unosom „application/fhir+xml“ ili „application/xml+fhir“ ili „application/xml“ u HTTP zaglavlje poruke npr Accept: application/xml.
4.2.4.3 Adresa metode
[HOST]/fhir/CodeSystem/ID[HOST]/fhir/CodeSystem/ID/_history/version
4.2.4.4 Ulazni podaci
Donja tablica ima opisane ulazne podatke.
Tablica 7 Ulazni parametri za dohvat podataka
ID Naziv parametra Obavezan (D/N) Tip podatka Primjer Značenje
1 ID D String 1.2.3.4.5.6.7.8.9 Identifikator kodne liste - OID
2 version N Int 11
Revizija kodne liste(ako se ne navede, vraća se zadnja revizija kodne liste)
Rev E
![Page 16: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/16.jpg)
4.2.4.5 Izlazni podaci
Izlazni podaci ispisuju se u JSON formatu.
Tablica 8 Izlazni parametri dohvata podataka– JSON format
ID Naziv parametraObavezan (D/N)
Tip podatka Primjer
Značenje
1 resourceType 1..1 D String CodeSystem Tip resursa - fiksno
2 id 1..1 D String 1.2.3.4.5.6.7.8.9Identifikator kodne liste - OID
3 meta 1..1 D
4 meta.versionId 1..1 D String 11 Verzija kodne liste
5 meta. lastUpdated 1..1 D String
2019-05-23T13:59:57.791+00:00 Datum objave
6 name 1..1 D String Tip prijama Naziv kodne liste
7 status 1..1 D String activeStatus (Active ili Retired – ako se više ne koristi)
8 content 1..1 D String complete
9 concept 0..* NLista objekata
Sadrži niz sa elementima kodne liste
10 concept.code 1..1 D String 9 Jedinstvena šifra unosa
11 concept.designation 1..1 D Objekt
12 concept.designation.value 1..1 D String Interna uputnica Naziv šifre
13 concept.designation.language 1..1 D String hr
14 concept.property 0..* NLista objekata
Dodatni atributi kodne liste
15 concept.property.code 1.. 1 D String datod Naziv atributa
16 concept.property.valueString 1..1 D String 01.01.2012 Vrijednost atributa
Izgled JSON odgovora:
{ "resourceType": "CodeSystem", "id": "OID", "meta": { "versionId": "VERZIJA", "lastUpdated": "2019-02-04T11:31:35Z" }, "name": "NAZIV KODNE LISTE", "status": "active", "content": "complete",
Rev E
![Page 17: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/17.jpg)
"concept": [ { "code": "ŠIFRA", "designation": [ { "value": "Naziv šifre", "language": "hr" }], "property": [ { "code": "NAZIV ATRIBUTA", "valueString": "VRIJEDNOST ATRIBUTA" }] } ]}
Tablica 9 Izlazni parametri dohvata podataka – XML format
ID Naziv parametraObavezan (D/N) Tip podatka Primjer
Značenje
1 CodeSystem 1..1 D String CodeSystem Tip resursa
2 CodeSystem.id 1..1 D String 1.2.3.4.5.6.7.8.9.10Identifikator kodne liste - OID
3 CodeSystem.meta 1..1 D
4 CodeSystem.meta.versionId 1..1 D String 1Verzija kodne liste
5 CodeSystem.meta.lastUpdated 1..1 D String2019-11-08T10:43:00Z
Datum i vrijeme objave kodne liste
9 CodeSystem.name 1..1 D String Tip prijamaNaziv kodne liste
10 CodeSystem.status 1..1 D String active
Status (Active ili Retired – ako je kodna lista umirovljena)
11 CodeSystem.content 1..1 D String complete
12 CodeSystem.concept 0..* N
Sadrži niz sa elementima kodne liste
13 CodeSystem.concept.code 1..1 D String 9Jedinstvena šifra unosa
14 CodeSystem.designation 1..1 D
15 CodeSystem.concept.designation.value 1..1 D String Interna uputnicaNaziv šifre
16 CodeSystem.concept.designation.language 1..1 D String hr Jezik naziva
17 CodeSystem.concept.property 0..* N
18 CodeSystem.concept.property.code 1..1 D String CijenaNaziv dodatnog atributa/kolone
19 CodeSystem.concept.property.valueString 1..1 D String 10,00
Vrijednost dodatnog atributa/kolone
Izgled XML odgovora:
Rev E
![Page 18: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/18.jpg)
<CodeSystem xmlns="http://hl7.org/fhir"> <id value="OID"/> <meta> <versionId value="VERZIJA"/> <lastUpdated value="2019-03-21T15:43:50Z"/> </meta> <name value="NAZIV KODNE LISTE"/> <status value="active"/> <content value="complete"/> <concept> <code value="ŠIFRA"/> <designation> <value value="Naziv šifre"/> <language value="hr"/> </designation> <property> <code value="NAZIV ATRIBUTA"/> <valueString value="VRIJEDNOST ATRIBUTA"/> </property> </concept></CodeSystem>
4.2.4.6 Digitalni certifikati i sigurnost
Poruka se šalje VPN rutom napravljenom od zdravstvene ustanove do CEZIH-a, HTTPS kanalom gdje se veza uspostavila certifikatom.
4.2.5 HL7 FHIR Dohvat naziva svih kodnih lista
4.2.5.1 Tip zahtjeva
HTTP GET
4.2.5.2 Format tijela zahtjeva
URL
Format zaglavlja zahtjeva
Izlazni podaci se bez dodatnih elemenata zahtjeva vraćaju u JSON zapisu.Izlazne podatke je moguće prikazati i u XML formatu unosom „application/fhir+xml“ ili „application/xml+fhir“ ili „application/xml“ u HTTP zaglavlje poruke npr Accept: application/xml.
4.2.5.3 Adresa metode
[HOST]/fhir/CodeSystem?_elements=name
Rev E
![Page 19: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/19.jpg)
4.2.5.4 Ulazni podaci
Donja tablica ima opisane ulazne podatke. U parametar elements dodaje se name kako bi se ispisali Šifrarnici i njihovi nazivi.
Tablica 10 Ulazni parametri za dohvat podataka
ID Naziv parametraObavezan (D/N) Tip podatka Primjer
Značenje
1 _elements D String_elements=name Ispisuju se imena šifrarnika
4.2.5.5 Izlazni podaci
Izlazni podaci ispisuju se u JSON formatu.Izlazne podatke je moguće prikazati i u XML formatu unosom „application/fhir+xml“ ili „application/xml+fhir“ ili „application/xml“ u HTTP zaglavlje poruke npr Accept: application/xml.
Tablica 11 Izlazni parametri dohvata podataka – JSON format
ID Naziv parametraObavezan (D/N) Tip podatka Primjer
Značenje
1 resourceType 1..1 D String Bundle Tip resursa
2 id 1..1 D String
b2ccbf8d-d99c-40fb-95a0-d038f24d63a4 Id upita
3 type 1..1 D String searchset Tip pretrage
4 total 1..1 D Integer 4 Broj kodnih lista
5 link 1..1 DLista (jedan objekt)
6 link.relation 1..1 D String self
7 link.url 1..1 D String?_elements=name
Kontekst izvršenog upita
8 entry 0..* NLista objekata
9 entry.resource 1..1 D Objekt
10 entry.resource.resourceType 1..1 D String CodeSystem Tip resursa
11 entry.resource.id 1..1 D String 1.2.3.4.5.6.7.8.9.10
Identifikator kodne liste - OID
12 entry.resource.meta 1..1 D Objekt
13 entry.resource.meta.versionId 1..1 D String 1Verzija kodne liste
Rev E
![Page 20: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/20.jpg)
14 entry.resource.meta.lastUpdated 1..1 D String2019-11-08T10:43:00Z
Datum objave kodne liste
15 entry.resource.meta.tag 0..1 NLista (jedan objekt)
16 entry.resource.meta.tag.code 1..1 D String SUBSETTED
17 entry.resource.meta.tag.display 1..1 D String
Resource encoded in summary mode
18 entry.resource.name 1..1 D String Tip prijamaNaziv kodne liste
19 entry.resource.status 1..1 D String Active
Status (Active ili Retired – ako je kodna lista umirovljena)
20 entry.resource.content 1..1 D String Complete
21 entry.search 1..1 D Objekt
22 entry.search.mode 1..1 D String match
{ "resourceType": "Bundle", "id": "2df0d1ff-4d91-4a12-ae4a-b695da14fef6", "type": "searchset", "total": BROJ NAĐENIH KODNIH LISTA, "link": [ { "relation": "self", "url": "CodeSystem?_lastUpdated=geDATUM&_elements=name" }], "entry": [ { "resource": { "resourceType": "CodeSystem", "id": "OID", "meta": { "versionId": "VERZIJA", "lastUpdated": "2019-11-20T12:55:07Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode" }] }, "name": "NAZIV KODNE LISTE", "status": "active", "content": "complete" }, "search": {"mode": "match"} } ] }
Rev E
![Page 21: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/21.jpg)
4.2.6 HL7 FHIR Dohvat elemenata kodnih lista izmijenjenih na određeni datum ili nakon određenog datuma (preuzimanje šifrarnika)
4.2.6.1 Tip zahtjeva
HTTP GET
4.2.6.2 Format tijela zahtjeva
URL
Format zaglavlja zahtjeva
Izlazni podaci se bez dodatnih elemenata zahtjeva vraćaju u JSON zapisu.Izlazne podatke je moguće prikazati i u XML formatu unosom „application/fhir+xml“ ili „application/xml+fhir“ ili „application/xml“ u HTTP zaglavlje poruke npr Accept: application/xml.
4.2.6.3 Adresa metode
[HOST]/fhir/CodeSystem?_lastUpdated=geDATUM&_elements=element1,element2&_id=OID1,OID2,..
element1 – name
element2 – concept
_id- jedan ili više OID-a šifrarnika odvojenih zarezom po kojima će biti filtrirani rezultati
4.2.6.4 Ulazni podaci
Donja tablica ima opisane ulazne podatke. U parametar elements moguće je unijeti name za ispis naziva kodne liste i/ili concept za ispis podataka iz kodne liste, kako bi se smanjio opseg izlaznih podataka. Parametri elements su neobavezni, ukoliko se ne navedu, ispisuju se kodne liste sa svim parametrima (OID, Verzija, Naziv kodne liste i šifre). Kao dodatan filter moguće je unijeti i određene OID-e u parametar _id te pretragu suziti na točno određene šifrarnike.
Tablica 12 Ulazni parametri za dohvat podataka
ID Naziv parametraObavezan (D/N) Tip podatka Primjer
Značenje
1 _lastUpdated N* String ge2019-05-25
Datum za filtriranje - ukoliko postoji verzija koja odgovara traženom uvjetu - bit će vraćeni podaci.
2 _elements N* String name
Nazivi elemenata koji će ispisati odgovarajuće podatke o kodnoj listi
Rev E
![Page 22: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/22.jpg)
3 _id N* String 1.2.3.4.5.6.7.8.9
1 ili više (zarezom odvojen) OID (resource.entry.id) šifrarnika da se izlaz filtira
*minimalno 1 parametar za filtriranje treba biti poslan, a može ih biti I više u istom pozivu
U slučaju da se ne navede vrijednost_lastUpdated parametra, ne radi se ograničavanje ispisaprema datumu u odgovoru koji se poklapaju sa ostalim filterima
U slučaju da se ne navedu vrijednosti za _elements parametar, vraćaju se I šifre I nazivi šifrarnika u odgovoru koji se poklapaju ostalim filterima
U slučaju da se ne navede vrijednost za _id parametar, vraćaju se svi šifrarnici koji se poklapaju sa ostalim filterima
4.2.6.5 Izlazni podaci
Izlazni podaci ispisuju se u JSON formatu.Izlazne podatke je moguće prikazati i u XML formatu unosom „application/fhir+xml“ ili „application/xml+fhir“ ili „application/xml“ u HTTP zaglavlje poruke npr Accept: application/xml.
Tablica 13 Izlazni parametri dohvata podataka – JSON format
ID Naziv parametraObavezan (D/N) Tip podatka Primjer
Značenje
1 resourceType 1..1 D String Bundle Tip resursa
2 id 1..1 D String
b2ccbf8d-d99c-40fb-95a0-d038f24d63a4 Id upita
3 type 1..1 D String searchset Tip pretrage
4 total 1..1 D Integer 4 Broj kodnih lista
5 link 1..1 DLista (jedan objekt)
6 link.relation 1..1 D String self
7 link.url 1..1 D String
CodeSystem?_lastUpdated=eq2019-10-16
Kontekst izvršenog upita
8 entry 0..* NLista objekata
9 entry.resource 1..1 D Objekt
10 entry.resource.resourceType 1..1 D String CodeSystem Tip resursa
11 entry.resource.id 1..1 D String 1.2.3.4.5.6.7.8.9.10
Identifikator kodne liste - OID
12 entry.resource.meta 1..1 D Objekt
13 entry.resource.meta.versionId 1..1 D String 1Verzija kodne liste
Rev E
![Page 23: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/23.jpg)
14 entry.resource.meta.lastUpdated 1..1 D String2019-11-08T10:43:00Z
Datum objave kodne liste
15 entry.resource.meta.tag 0..1 NLista (jedan objekt)
16 entry.resource.meta.tag.code 1..1 D String SUBSETTED
17 entry.resource.meta.tag.display 1..1 D String
Resource encoded in summary mode
18 entry.resource.name 1..1 D String Tip prijamaNaziv kodne liste
19 entry.resource.status 1..1 D String Active
Status (Active ili Retired – ako je kodna lista umirovljena)
20 entry.resource.content 1..1 D String Complete
21 entry.resource.concept 0..* NLista objekata
Sadrži niz sa elementima kodne liste
22 entry.resource.concept.code 1..1 D String 9Jedinstvena šifra unosa
23 entry.resource.concept.designation 1..1 DLista (jedan objekt)
24 entry.resource.concept.designation.value 1..1 D String Interna uputnica Naziv šifre
25 entry.resource.concept.designation.language 1..1 D String HrJezik naziva šifre
26 entry.resource.concept.property 0..* NLista objekata
27 entry.resource.concept.property.code 1..1 D String datod Naziv atributa
28 entry.resource.concept.property.valueString 1..1 D String 01.01.2012Vrijednost atributa
29 entry.search 1..1 D Objekt
30 entry.search.mode 1..1 D String match
Izgled JSON odgovora za upit CodeSystem?_lastUpdated=geDATUM:
{ "resourceType": "Bundle", "id": "b2ccbf8d-d99c-40fb-95a0-d038f24d63a4", "type": "searchset", "total": BROJ NAĐENIH KODNIH LISTA, "link": [ { "relation": "self", "url": "CodeSystem?_lastUpdated=geDATUM" }], "entry": [ { "resource": { "resourceType": "CodeSystem", "id": "OID",
Rev E
![Page 24: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/24.jpg)
"meta": { "versionId": "VERZIJA", "lastUpdated": "2019-11-08T10:43:00Z" }, "name": "NAZIV KODNE LISTE", "status": "active", "content": "complete", "concept": [ { "code": "ŠIFRA", "designation": [ { "value": "NAZIV ŠIFRE", "language": "hr" }]
"property": [ { "code": "NAZIV ATRIBUTA", "valueString": "VRIJEDNOST ATRIBUTA" }] } ] }, "search": {"mode": "match"} } ]}
Izgled JSON odgovora za upit CodeSystem?_lastUpdated=geDATUM&_elements=name:
{ "resourceType": "Bundle", "id": "2df0d1ff-4d91-4a12-ae4a-b695da14fef6", "type": "searchset", "total": BROJ NAĐENIH KODNIH LISTA, "link": [ { "relation": "self", "url": "CodeSystem?_lastUpdated=geDATUM&_elements=name" }], "entry": [ { "resource": { "resourceType": "CodeSystem", "id": "OID", "meta": { "versionId": "VERZIJA", "lastUpdated": "2019-11-20T12:55:07Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode" }] }, "name": "NAZIV KODNE LISTE", "status": "active", "content": "complete" }, "search": {"mode": "match"} } ]}
Rev E
![Page 25: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/25.jpg)
Izgled JSON odgovora za upit CodeSystem?_lastUpdated=geDATUM&_elements=name,concept:
{ "resourceType": "Bundle", "id": "e91c6ff0-c691-4d1c-8828-5ac28131e261", "type": "searchset", "total": BROJ NAĐENIH KODNIH LISTA, "link": [ { "relation": "self", "url": "CodeSystem?_lastUpdated=geDATUM&_elements=name,concept" }], "entry": [ { "resource": { "resourceType": "CodeSystem", "id": "OID", "meta": { "versionId": "VERZIJA", "lastUpdated": "2019-11-20T12:57:45Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode" }] }, "name": "NAZIV KODNE LISTE", "status": "active", "content": "complete", "concept": [ { "code": " ŠIFRA", "designation": [ { "value": "NAZIV ŠIFRE", "language": "hr" }], "property": [ { "code": "NAZIV ATRIBUTA", "valueString": "VRIJEDNOST ATRIBUTA" } ] } ] }, "search": {"mode": "match"} } ]}
Izgled JSON odgovora za upit CodeSystem?_lastUpdated=geDATUM&_elements=name,concept&_id=OID1:
{ "resourceType": "Bundle", "id": "e91c6ff0-c691-4d1c-8828-5ac28131e261", "type": "searchset",
Rev E
![Page 26: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/26.jpg)
"total": BROJ NAĐENIH KODNIH LISTA, "link": [ { "relation": "self", "url": "CodeSystem?_lastUpdated=geDATUM&_elements=name,concept&_id=OID1" }], "entry": [ { "resource": { "resourceType": "CodeSystem", "id": "OID1", "meta": { "versionId": "VERZIJA", "lastUpdated": "2019-11-20T12:57:45Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode" }] }, "name": "NAZIV KODNE LISTE", "status": "active", "content": "complete", "concept": [ { "code": " ŠIFRA", "designation": [ { "value": "NAZIV ŠIFRE", "language": "hr" }], "property": [ { "code": "NAZIV ATRIBUTA", "valueString": "VRIJEDNOST ATRIBUTA" } ] } ] }, "search": {"mode": "match"} } ]}
U slučaju da nema podataka koji odgovaraju traženom kriteriju, vraća se odgovor (“total“:0) u kojem je istaknuto da nema elemenata koji odgovaraju poslanom kriteriju.
Izgled JSON odgovora bez podataka:
{ "resourceType": "Bundle", "id": "9a2b1525-6dc3-4b7c-843f-3f3e89499f0b", "type": "searchset", "total": 0, "link": [ { "relation": "self", "url": "CodeSystem?_lastUpdated=ge2019-11-15" }]}
Rev E
![Page 27: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/27.jpg)
Tablica 14 Izlazni parametri dohvata podataka – XML format
ID Naziv parametraObavezan (D/N)
Tip podatka Primjer
Značenje
1 Bundle 1..1 D
2 Bundle.id 1..1 D String
b2ccbf8d-d99c-40fb-95a0-d038f24d63a4 Id upita
3 Bundle.type 1..1 D Stringsearchset Tip pretrage
4 Bundle.total 1..1 D String 4Broj kodnih lista
5 Bundle.link 1..1 D
6 Bundle.link.relation 1..1 D String self
7 Bundle.link.url 1..1 D String
CodeSystem?_lastUpdated=eq2019-10-16
Kontekst izvršenog upita
8 Bundle.entry 0..* N
9 Bundle.entry.resource 1..1 D
10 Bundle.entry.resource.CodeSystem 1..1 D Tip resursa
11 Bundle.entry.resource.CodeSystem.id 1..1 D String
1.2.3.4.5.6.7.8.9.10
Identifikator kodne liste - OID
12 Bundle.entry.resource.CodeSystem.meta 1..1 D
13 Bundle.entry.resource.CodeSystem.meta.versionId 1..1 D String 1Verzija kodne liste
14 Bundle.entry.resource.CodeSystem.meta.lastUpdated 1..1 D String
2019-11-08T10:43:00Z
Datum objave kodne liste
15 Bundle.entry.resource.CodeSystem.meta.tag 0..1 N
16 Bundle.entry.resource.CodeSystem.meta.tag.code 1..1 D StringSUBSETTED
17 Bundle.entry.resource.CodeSystem.meta.tag.display 1..1 D String
Resource encoded in summary mode"/>
Rev E
![Page 28: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/28.jpg)
18 Bundle.entry.resource.CodeSystem.name 1..1 D StringTip prijama
Naziv kodne liste
19 Bundle.entry.resource.CodeSystem.status 1..1 D String active
Status (Active ili Retired – ako je kodna lista umirovljena)
20 Bundle.entry.resource.CodeSystem.content 1..1 D String complete
21 Bundle.entry.resource.CodeSystem.concept 0..* N
Sadrži niz sa elementima kodne liste
22 Bundle.entry.resource.CodeSystem.concept.code 1..1 D String 9Jedinstvena šifra unosa
23 Bundle.entry.resource.CodeSystem.designation 1..1 D
24 Bundle.entry.resource.CodeSystem.concept.designation.value 1..1 D StringInterna uputnica Naziv šifre
25 Bundle.entry.resource.CodeSystem.concept.designation.language 1..1 D String hrJezik naziva šifre
26 Bundle.entry.resource.CodeSystem.concept.property 0..* N
27 Bundle.entry.resource.CodeSystem.concept.property.code 1.. 1 D String datod Naziv atributa
28 Bundle.entry.resource.CodeSystem.concept.property.valueString 1..1 D String01.01.2012
Vrijednost atributa
29 Bundle.entry.search 1..1 D
30 Bundle.entry.search.mode 1..1 D String match
Oznaka uspješne pretrage
Izgled XMLodgovora za CodeSystem?_lastUpdated=geDATUM:
<Bundle xmlns="http://hl7.org/fhir"> <id value="fe02fc0d-3b48-4134-b78b-e31aec4547b5"/> <type value="searchset"/> <total value="BROJ NAĐENIH KODNIH LISTA"/> <link> <relation value="self"/> <url value="CodeSystem?_lastUpdated=geDATUM"/> </link>
<entry><resource>
<CodeSystemxmlns="http://hl7.org/fhir"><id value="OID"/><meta>
<versionId value="VERZIJA KODNE LISTE"/>
<lastUpdated value="2019-11-20T12:57:45Z"/>
</meta><name value="NAZIV KODNE LISTE"/>
Rev E
![Page 29: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/29.jpg)
<status value="active"/><content value="complete"/><concept>
<code value="ŠIFRA"/><designation>
<value value="NAZIV ŠIFRE"/><language value="hr"/>
</designation><property> <code value="NAZIV ATRIBUTA"/>
<valueString value="VRIJEDNOST ATRIBUTA"/>
</property></concept>
</CodeSystem></resource><search>
<mode value="match"/></search>
</entry></Bundle>
Izgled XMLodgovora za CodeSystem?_lastUpdated=geDATUM&_elements=name:
<Bundle xmlns="http://hl7.org/fhir"> <id value="26941ab7-4169-48c4-b1fe-e20310732131"/> <type value="searchset"/> <total value="BROJ NAĐENIH KODNIH LISTA"/> <link> <relation value="self"/> <url value="CodeSystem?_lastUpdated=geDATUM&_elements=name"/> </link> <entry> <resource> <CodeSystem xmlns="http://hl7.org/fhir"> <id value="OID"/> <meta> <versionId value="VERZIJA KODNE LISTE"/> <lastUpdated value="2019-11-20T12:55:07Z"/> <tag> <code value="SUBSETTED"/> <display value="Resource encoded in summary mode"/> </tag> </meta> <name value="NAZIV KODNE LISTE"/> <status value="active"/> <content value="complete"/> </CodeSystem> </resource> <search> <mode value="match"/> </search> </entry></Bundle>
Izgled XML odgovora za upit CodeSystem?_lastUpdated=geDATUM&_elements=name,concept:
Rev E
![Page 30: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/30.jpg)
<Bundle xmlns="http://hl7.org/fhir"> <id value="2c9538c9-1c89-4a5b-bb17-862478b102f5"/> <type value="searchset"/> <total value="BROJ NAĐENIH KODNIH LISTA"/> <link> <relation value="self"/> <url value="CodeSystem?_lastUpdated=ge2019-11-20&_elements=name,concept"/> </link> <entry> <resource> <CodeSystem xmlns="http://hl7.org/fhir"> <id value="OID"/> <meta> <versionId value="VERZIJA KODNE LISTE"/> <lastUpdated value="2019-11-20T12:57:45Z"/> <tag> <code value="SUBSETTED"/> <display value="Resource encoded in summary mode"/> </tag> </meta> <name value="NAZIV KODNE LISTE"/> <status value="active"/> <content value="complete"/> <concept> <code value="ŠIFRA"/> <designation> <value value="NAZIV ŠIFRE"/> <language value="hr"/> </designation> <property> <code value="NAZIV ATRIBUTA"/> <valueString value="VRIJEDNOST ATRIBUTA"/> </property> </concept> </CodeSystem> </resource> <search> <mode value="match"/> </search> </entry></Bundle>
Izgled XML odgovora za upit CodeSystem?_lastUpdated=geDATUM&_elements=name,concept&_id=OID1:
<Bundle xmlns="http://hl7.org/fhir"> <id value="2c9538c9-1c89-4a5b-bb17-862478b102f5"/> <type value="searchset"/> <total value="BROJ NAĐENIH KODNIH LISTA"/> <link> <relation value="self"/> <url value="CodeSystem?_lastUpdated=ge2019-11-20&_elements=name,concept&_id=OID1"/> </link> <entry>
Rev E
![Page 31: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/31.jpg)
<resource> <CodeSystem xmlns="http://hl7.org/fhir"> <id value="OID1"/> <meta> <versionId value="VERZIJA KODNE LISTE"/> <lastUpdated value="2019-11-20T12:57:45Z"/> <tag> <code value="SUBSETTED"/> <display value="Resource encoded in summary mode"/> </tag> </meta> <name value="NAZIV KODNE LISTE"/> <status value="active"/> <content value="complete"/> <concept> <code value="ŠIFRA"/> <designation> <value value="NAZIV ŠIFRE"/> <language value="hr"/> </designation> <property> <code value="NAZIV ATRIBUTA"/> <valueString value="VRIJEDNOST ATRIBUTA"/> </property> </concept> </CodeSystem> </resource> <search> <mode value="match"/> </search> </entry></Bundle>
Izgled XML odgovora bez podataka:
<Bundle xmlns="http://hl7.org/fhir"> <id value="9943e57f-b1e6-458e-98b6-5812488811b3"/> <type value="searchset"/> <total value="0"/> <link> <relation value="self"/> <url value="CodeSystem?_lastUpdated=ge2019-11-21"/> </link></Bundle>
4.2.6.6 Digitalni certifikati i sigurnost
Poruka se šalje VPN rutom napravljenom od zdravstvene ustanove do CEZIH-a, HTTPS kanalom gdje se veza uspostavila certifikatom.
Rev E
![Page 32: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/32.jpg)
4.2.7 HL7 FHIR Dohvat elemenata kodnih lista izmijenjenih na određeni datum (preuzimanje šifrarnika)
4.2.7.1 Tip zahtjeva
HTTP GET
4.2.7.2 Format tijela zahtjeva
URL
Format zaglavlja zahtjeva
Izlazni podaci se bez dodatnih elemenata zahtjeva vraćaju u JSON zapisu.Izlazne podatke je moguće prikazati i u XML formatu unosom „application/fhir+xml“ ili „application/xml+fhir“ ili „application/xml“ u HTTP zaglavlje poruke npr Accept: application/xml.
4.2.7.3 Adresa metode
[HOST]/fhir/CodeSystem?_lastUpdated=eqDATUM&_elements=element1,element2&_id=OID1,OID2,..
element1 – name
element2 – concept
_id- jedan ili više OIDa šifrarnika odvojenih zarezom po kojima će biti filtrirani rezultati
4.2.7.4 Ulazni podaci
Donja tablica ima opisane ulazne podatke. U parametar elements moguće je unijeti name za ispis naziva kodne liste i/ili concept za ispis podataka iz kodne liste, kako bi se smanjio opseg izlaznih podataka. Parametri elements su neobavezni, ukoliko se ne navedu, ispisuju se kodne liste sa svim parametrima (OID, Verzija, Naziv kodne liste i šifre). Kao dodatan filter moguće je unijeti i određene OID-e u parametar _id te pretragu suziti na točno određene šifrarnike.
Tablica 15 Ulazni parametri za dohvat podataka
ID Naziv parametraObavezan (D/N) Tip podatka Primjer
Značenje
1 _lastUpdated N* String eq2019-05-25
Datum za filtriranje - ukoliko postoji verzija koja odgovara traženom uvjetu - bit će vraćeni podaci.
2_elements
N* String name elements=name – ispisuje se naziv šifrarnika, elements=concept –
Rev E
![Page 33: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/33.jpg)
ispisuje se cijeli šifrarnik, elements=name,element – ispisuje se cijeli šifrarnik i naziv
3 _id N* String 1.2.3.4.5.6.7.8.9
1 ili više (zarezom odvojen) OID (resource.entry.id) šifrarnika da se izlaz filtira
*minimalno 1 parametar za filtriranje treba biti poslan, a može ih biti I više u istom pozivu
U slučaju da se ne navede vrijednost_lastUpdated parametra, ne radi se ograničavanje ispisaprema datumu u odgovoru koji se poklapaju sa ostalim filterima
U slučaju da se ne navedu vrijednosti za _elements parametar, vraćaju se I šifre I nazivi šifrarnika u odgovoru koji se poklapaju ostalim filterima
U slučaju da se ne navede vrijednost za _id parametar, vraćaju se svi šifrarnici koji se poklapaju sa ostalim filterima
4.2.7.5 Izlazni podaci
Izlazni podaci vidljivi su u slučaju da je datum verzije šifrarnika jednak zatraženom datumu u ulaznim podacima. Podaci se ispisuju u JSON formatu ukoliko nije naveden drugi format ispisa.Izlazne podatke je moguće prikazati i u XML formatu unosom „application/fhir+xml“ ili „application/xml+fhir“ ili „application/xml“ u HTTP zaglavlje poruke npr Accept: application/xml.
Tablica 16 Izlazni parametri dohvata podataka – JSON format
ID Naziv parametraObavezan (D/N) Tip podatka Primjer
Značenje
1 resourceType 1..1 D String Bundle Tip resursa
2 id 1..1 D String
b2ccbf8d-d99c-40fb-95a0-d038f24d63a4 Id upita
3 type 1..1 D String searchset Tip pretrage
4 total 1..1 D Integer 4 Broj kodnih lista
5 link 1..1 DLista (jedan objekt)
6 link.relation 1..1 D String self
7 link.url 1..1 D String
CodeSystem?_lastUpdated=eq2019-10-16
Kontekst izvršenog upita
8 entry 0..* N Lista objekata
9 entry.resource 1..1 D Objekt
10 entry.resource.resourceType 1..1 D String CodeSystem Tip resursa
11entry.resource.id 1..1 D
String 1.2.3.4.5.6.7.8.9Identifikator kodne liste - OID
Rev E
![Page 34: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/34.jpg)
.10
12 entry.resource.meta 1..1 D Objekt
13 entry.resource.meta.versionId 1..1 D String 1 Verzija kodne liste
14 entry.resource.meta.lastUpdated 1..1 D String2019-11-08T10:43:00Z
Datum objave kodne liste
15 entry.resource.meta.tag 0..1 NLista (jedan objekt)
16 entry.resource.meta.tag.code 1..1 D String SUBSETTED
17 entry.resource.meta.tag.display 1..1 D String
Resource encoded in summary mode
18 entry.resource.name 1..1 D String Tip prijama Naziv kodne liste
19 entry.resource.status 1..1 D String active
Status (Active ili Retired – ako je kodna lista umirovljena)
20 entry.resource.content 1..1 D String complete
21 entry.resource.concept 0..* N Lista objekata
Sadrži niz sa elementima kodne liste
22 entry.resource.concept.code 1..1 D String 9Jedinstvena šifra unosa
23 entry.resource.concept.designation 1..1 DLista (jedan objekt)
24 entry.resource.concept.designation.value 1..1 D String Interna uputnica Naziv šifre
25 entry.resource.concept.designation.language 1..1 D String hr Jezik naziva šifre
26 entry.resource.concept.property 0..* N Lista objekata
27 entry.resource.concept.property.code 1.. 1 D String datod Naziv atributa
28 entry.resource.concept.property.valueString 1..1 D String 01.01.2012 Vrijednost atributa
29 entry.search 1..1 D Objekt
30 entry.search.mode 1..1 D String match
Izgled JSON odgovora:
{ "resourceType": "Bundle", "id": "a3054f52-ecb6-4310-85a6-3d152622e925", "type": "searchset", "total": BROJ NAĐENIH KODNIH LISTA, "link": [ { "relation": "self", "url": "CodeSystem?_lastUpdated=eqDATUM&_id=OID1,OID2,.."}],
Rev E
![Page 35: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/35.jpg)
"entry": [{ "resource": { "resourceType": "CodeSystem", "id": "OID1", "meta": { "versionId": "VERZIJA", "lastUpdated": "2019-10-16T00:30:27Z"}, "name": "Naziv kodne lste", "status": "active", "content": "complete", "concept": [{ "code": "ŠIFRA", "designation": [ { "value": "NAZIV ŠIFRE", "language": "hr"}],
"property": [ { "code": "NAZIV ATRIBUTA", "valueString": "VRIJEDNOST ATRIBUTA" }]
}]},
"search": {"mode": "match"} }]}
U slučaju da nema podataka koji odgovaraju traženom kriteriju, vraća se odgovor u kojem je istaknuto ("total": 0) da nema elemenata koji odgovaraju poslanom kriteriju.
Izgled JSON odgovora bez podataka za traženi kriterij:
{ "resourceType": "Bundle", "id": "9a2b1525-6dc3-4b7c-843f-3f3e89499f0b", "type": "searchset", "total": 0, "link": [ { "relation": "self", "url": "CodeSystem?_lastUpdated=eq2019-10-04&_id=OID1" }]}
Tablica 17 Izlazni parametri dohvata podataka– XML format
ID Naziv parametraObavezan (D/N)
Tip podatka Primjer
Značenje
1 Bundle 1..1 D
2 Bundle.id 1..1 D String
b2ccbf8d-d99c-40fb-95a0-d038f24d63a4 Id upita
3Bundle.type 1..1 D
String searchseTip pretrage
Rev E
![Page 36: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/36.jpg)
t
4 Bundle.total 1..1 D String 4Broj kodnih lista
5 Bundle.link 1..1 D
6 Bundle.link.relation 1..1 D String self
7 Bundle.link.url 1..1 D String
CodeSystem?_lastUpdated=eq2019-10-16
Kontekst izvršenog upita
8 Bundle.entry 0..* N
9 Bundle.entry.resource 1..1 D
10 Bundle.entry.resource.CodeSystem 1..1 D StringCodeSystem Tip resursa
11 Bundle.entry.resource.CodeSystem.id 1..1 D String
1.2.3.4.5.6.7.8.9.10
Identifikator kodne liste - OID
12 Bundle.entry.resource.CodeSystem.meta 1..1 D
13 Bundle.entry.resource.CodeSystem.meta.versionId 1..1 D String 1Verzija kodne liste
14 Bundle.entry.resource.CodeSystem.meta.lastUpdated 1..1 D String
2019-11-08T10:43:00Z
Datum objave kodne liste
15 Bundle.entry.resource.CodeSystem.meta.tag 0..1 N
16 Bundle.entry.resource.CodeSystem.meta.tag.code 1..1 D StringSUBSETTED
17 Bundle.entry.resource.CodeSystem.meta.tag.display 1..1 D String
Resource encoded in summary mode"/>
18 Bundle.entry.resource.CodeSystem.name 1..1 D StringTip prijama
Naziv kodne liste
19 Bundle.entry.resource.CodeSystem.status 1..1 D String active
Status (Active ili Retired – ako je kodna lista umirovljena)
20 Bundle.entry.resource.CodeSystem.content 1..1 D String complete
21 Bundle.entry.resource.CodeSystem.concept 0..* N
Sadrži niz sa elementima kodne liste
22 Bundle.entry.resource.CodeSystem.concept.code 1..1 D String 9Jedinstvena šifra unosa
Rev E
![Page 37: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/37.jpg)
23 Bundle.entry.resource.CodeSystem.designation 1..1 D
24 Bundle.entry.resource.CodeSystem.concept.designation.value 1..1 D StringInterna uputnica Naziv šifre
25 Bundle.entry.resource.CodeSystem.concept.designation.language 1..1 D String hrJezik naziva šifre
26 Bundle.entry.resource.CodeSystem.concept.property 0..* N
27 Bundle.entry.resource.CodeSystem.concept.property.code 1.. 1 D String datod Naziv atributa
28 Bundle.entry.resource.CodeSystem.concept.property.valueString 1..1 D String01.01.2012
Vrijednost atributa
29 Bundle.entry.search 1..1 D
30 Bundle.entry.search.mode 1..1 D String match
Oznaka uspješne pretrage
Izgled XML odgovora:
<Bundle xmlns="http://hl7.org/fhir"> <id value="fe02fc0d-3b48-4134-b78b-e31aec4547b5"/> <type value="searchset"/> <total value="BROJ NAĐENIH KODNIH LISTA"/> <link> <relation value="self"/> <url value="CodeSystem?_lastUpdated=eqDATUM&_id=OID1,OID2,.."/> </link>
<entry><resource>
<CodeSystemxmlns="http://hl7.org/fhir"><id value="OID"/><meta>
<versionId value="VERZIJA KODNE LISTE"/>
<lastUpdated value="2019-11-20T12:57:45Z"/>
</meta><name value="NAZIV KODNE LISTE"/><status value="active"/><content value="complete"/><concept>
<code value="ŠIFRA"/><designation>
<value value="NAZIV ŠIFRE"/><language value="hr"/>
</designation><property> <code value="NAZIV ATRIBUTA"/>
<valueString value="VRIJEDNOST ATRIBUTA"/>
</property></concept>
</CodeSystem></resource>
Rev E
![Page 38: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/38.jpg)
<search> <mode value="match"/></search>
</entry></Bundle>
Izgled XML odgovora bez podataka
<Bundle xmlns="http://hl7.org/fhir"> <id value="b03cc2c5-9d16-4978-bb94-d0844221b56f"/> <type value="searchset"/> <total value="0"/> <link> <relation value="self"/> <url value="CodeSystem?_lastUpdated=eq2019-11-21&_id=OID1"/> </link></Bundle>
4.2.7.6 Digitalni certifikati i sigurnost
Poruka se šalje VPN rutom napravljenom od zdravstvene ustanove do CEZIH-a, HTTPS kanalom gdje se veza uspostavila certifikatom.
4.2.8 Dohvat liste zdravstvenih djelatnika promijenjene na uneseni datum ili nakon njega
4.2.8.1 Tip zahtjeva
HTTP POST
4.2.8.2 Format tijela zahtjeva
SOAP
4.2.8.3 Adresa metode
[HOST]/fhir/Practitioner
4.2.8.4 Ulazni podaci
Donja tablica ima opisane ulazne podatke.
Tablica 18 Ulazni parametri za dohvat podataka
ID Naziv parametraObavezan (D/N) Tip podatka Primjer
Značenje
1 requestID N String 11111 Identifikator zahtjeva
Rev E
![Page 39: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/39.jpg)
2 requestType D String GET Tip zahtjeva
3 responseType D String application/xml
Oblik odgovora: za XML koristiti application/xml, za JSON application/json,
4 parametars D String
?_lastUpdated=ge2019-11-13&active=true
Datum od kojeg želimo dohvatiti promjene ne stariji od mjesec dana, za dohvat samo aktivnih djelatnika postaviti kao u primjeru active=true, za dohvat samo neaktivnih active=false, dok za dohvat aktivnih i neaktivnih izostaviti atribut active
4.2.8.5 Izlazni podaci
Datum po kojemu se dohvaćaju podaci ograničen je na broj dana i broj pronađenih rezultata. Ukoliko je datum stariji od mjesec dana, servis će vratiti upozorenje. Ukoliko je prekoračen broj podataka, u headeru izlaznih podataka će se ispisati podatak da postoji još elemenata, ali je potrebno suziti pretragu.
Tablica 19 Izlazni parametri za dohvat podataka
ID Naziv parametra Obavezan (D/N) Tip podatka Primjer Značenje
1 FHIR_Data D objekt Identifikator zahtjeva
2 Status D String 1 Status zahtjeva
3 Data D String PEJ1bmRsZSB4bWx…. Base64 kodirani podaci
Izgled odgovora:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Body> <hr:FHIR_Data xmlns:hr="http://hr.ericsson.etk.cezih.fhir.resource.wsdl"> <hr:status>1</hr:status> <hr:data>KODIRANI PODACI
</hr:data> </hr:FHIR_Data> </soapenv:Body></soapenv:Envelope>
Tablica 20 Parametri dekodiranih podataka – XML format
ID Naziv parametraObavezan (D/N)
Tip podatka Primjer
Značenje
1 Bundle 1..1 D
2Bundle.id 1..1 D
String b2ccbf8d-d99c-40fb-95a0-d038f24d6
Id upita
Rev E
![Page 40: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/40.jpg)
3a4
3 Bundle.meta 1..1 D
4 Bundle.meta. lastUpdated 1..1 D String
2019-11-14T00:30:42Z
Datum zadnje izmjene u listi djelatnika
3 Bundle.type 1..1 D String searchset Tip pretrage
4 Bundle.total 1..1 D String 2
Broj pronađenih rezultata
5 Bundle.link 1..1 D
6 Bundle.link.relation 1..1 D String self
7 Bundle.link.url 1..1 D String
Practitioner?_lastUpdated=geDATUM&active=true
Kontekst izvršenog upita
8 Bundle.entry 0..* N
9 Bundle.entry.resource 1..1 D
10 Bundle.entry.resource.Practitioner 1..1 D
11 Bundle.entry.resource.Practitioner.id 1..1 D String 2345678 HZJZ šifra
12 Bundle.entry.resource.Practitioner.meta 1..1 D
13 Bundle.entry.resource.Practitioner.meta.versionId 1..1 D String 1Verzija zapisa liste
14 Bundle.entry.resource.Practitioner.meta.lastUpdated 1..1 D String
2019-11-08T10:43:00Z
Datum I vrijeme zadnje izmjene
15 Bundle.entry.resource.Practitioner.identifier 1..1 D
16 Bundle.entry.resource.Practitioner.identifier.value 1..1 D String 234567890 MBO
17 Bundle.entry.resource.Practitioner.name 1..1 D
18 Bundle.entry.resource. Practitioner.name.given 1..1 D String IvanIme zdr. djelatnika
19 Bundle.entry.resource.Practitioner.name family 1..1 D String HorvatPrezime zdr. djelatnika
20 Bundle.entry.resource.Practitioner.qualification 2 D
21 Bundle.entry.resource.Practitioner.qualification.identifier 1..1 D
22 Bundle.entry.resource.Practitioner.qualification.identifier.value 1..1 D String
234567890/23456789012 MBO/OIB
23 Bundle.entry.resource.Practitioner.qualification.code 1..1 D
Rev E
![Page 41: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/41.jpg)
24 Bundle.entry.resource.Practitioner.qualification.code.text 1..1 D String MBO/OIBNaziv parametra
25 Bundle.entry.resource.Practitioner.active 1..1 D String true
Aktivan ili neaktivan djelatnik
26 Bundle.entry.search.mode 1..1 D String match
Oznaka uspješne pretrage
Izgled dekodiranih podataka u XML formatu:
<Bundle xmlns="http://hl7.org/fhir"> <id value="57c887ea-210e-4a71-b683-14906d20b9f5"/> <meta> <lastUpdated value="2019-10-11T16:07:12Z"/> </meta> <type value="searchset"/> <total value="2"/> <link> <relation value="self"/> <url value="Practitioner?_lastUpdated=geDATUM&active=true"/> </link> <entry> <resource> <Practitioner> <id value="HZJZ šifra 1"/> <meta> <versionId value="Verzija zapisa djelatnika"/> <lastUpdated value="2019-10-08T00:00:00Z"/> </meta> <identifier> <value value="MBO-vrijednost 1"/> </identifier> <name> <given value="Ime 1"/> <family value="Prezime 1"/> </name> <qualification> <identifier> <value value="MBO-vrijednost 1"/> </identifier> <code> <text value="MBO"/> </code> </qualification> <qualification> <identifier> <value value="OIB-vrijednost 1"/> </identifier> <code> <text value="OIB"/> </code> </qualification> <active value="true"/> </Practitioner> </resource> <search> <mode value="match"/> </search>
Rev E
![Page 42: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/42.jpg)
</entry> <entry> <resource> <Practitioner> <id value="HZJZ šifra 2"/> <meta> <versionId value="Verzija zapisa djelatnika"/> <lastUpdated value="2019-10-08T00:10:00Z"/> </meta> <identifier> <value value="MBO-vrijednost 2"/> </identifier> <name> <given value="Ime 2"/> <family value="Prezime 2"/> </name> <qualification> <identifier> <value value="MBO-vrijednost 2"/> </identifier> <code> <text value="MBO"/> </code> </qualification> <qualification> <identifier> <value value="OIB-vrijednost 2"/> </identifier> <code> <text value="OIB"/> </code> </qualification> <active value="true"/> </Practitioner> </resource> <search> <mode value="match"/> </search> </entry></Bundle>
Tablica 21 Parametri dekodiranih podataka – JSON format
ID Naziv parametra Obavezan (D/N) Tip podatka Primjer Značenje
1 resourceType 1..1 D String Bundle
2 id 1..1 D String
b2ccbf8d-d99c-40fb-95a0-d038f24d63a4 Id upita
3 meta 1..1 D
4 meta. lastUpdated 1..1 D String2019-11-14T00:30:42Z
Datum zadnje izmjene u listi djelatnika
3 type 1..1 D String searchset Tip pretrage
Rev E
![Page 43: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/43.jpg)
4 total 1..1 D Int 2Broj pronađenih rezulatata
5 link 1..1 DLista (jedan objekt)
6 link.relation 1..1 D String self
7 link.url 1..1 D String
Practitioner?_lastUpdated=geDATUM&active=true
Kontekst izvršenog upita
8 entry 0..* NLista objekata
9 entry.resource 1..1 D Objekt
10 entry.resource. resourceType 1..1 D String Practitioner
Vrsta podataka/resursa
11 entry.resource..id 1..1 D String 2345678 HZJZ šifra
12 entry.resource.meta 1..1 D Objekt
13 entry.resource.meta.versionId 1..1 D String 1Verzija zapisa liste
14 entry.resource.meta.lastUpdated 1..1 D String2019-11-08T10:43:00Z
Datum I vrijeme zadnje izmjene
15 entry.resource.identifier 1..1 DLista (jedan objekt)
16 entry.resource.identifier.value 1..1 D String 234567890 MBO
17 entry.resource.name 1..1 DLista (jedan objekt)
18 entry.resource.name.given 1..1 D String IvanIme zdr. djelatnika
19 entry.resource.name family 1..1 D String HorvatPrezime zdr. djelatnika
20 entry.resource.qualification 2 DLista dva objekta
21 entry.resource.qualification.identifier 1..1 DLista (jedan objekt)
22 entry.resource.qualification.identifier.value 1..1 D String234567890 /23456789012 MBO / OIB
23 entry.resource.qualification.code 1..1 D Objekt
24 entry.resource.qualification.code.text 1..1 D String MBO/OIB Naziv parametra
25 entry.resource.active 1..1 D String true
Aktivan ili neaktivan djelatnik
26 entry.search.mode 1..1 D String match
Oznaka uspješne pretrage
Rev E
![Page 44: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/44.jpg)
Izgled dekodiranih podataka u JSON formatu:
{ "resourceType": "Bundle", "id": "18c139cf-3d26-4811-b2d7-df1e13e4e26f", "meta": {"lastUpdated": "2019-10-11T16:07:12Z"}, "type": "searchset", "total": 2, "link": [ { "relation": "self", "url": "Practitioner?_lastUpdated=geDATUM&active=true" }], "entry": [ { "resource": { "resourceType": "Practitioner", "id": "HZJZ šifra 1", "meta": { "versionId": "Verzija zapisa djelatnika", "lastUpdated": "2019-10-08T00:00:00Z" }, "identifier": [{"value": "MBO-vrijednost 1"}], "name": [ { "given": "Ime 1", "family": "Prezime 2" }], "qualification": [ { "identifier": [{"value": "MBO-vrijednost 1"}], "code": {"text": "MBO"} }, { "identifier": [{"value": "OIB-vrijednost 1"}], "code": {"text": "OIB"} } ], "active": true }, "search": {"mode": "match"} } { "resource": { "resourceType": "Practitioner", "id": "HZJZ šifra 2", "meta": { "versionId": "Verzija zapisa djelatnika", "lastUpdated": "2019-10-08T00:00:00Z" }, "identifier": [{"value": "MBO-vrijednost 2"}], "name": [ { "given": "Ime 2", "family": "Prezime 2" }], "qualification": [ { "identifier": [{"value": "MBO-vrijednost 2"}], "code": {"text": "MBO"} }, {
Rev E
![Page 45: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/45.jpg)
"identifier": [{"value": "OIB-vrijednost 2"}], "code": {"text": "OIB"} } ], "active": true }, "search": {"mode": "match"} } ]}
4.2.8.6 Digitalni certifikati i sigurnost
Poruka se šalje VPN rutom napravljenom od zdravstvene ustanove do CEZIH-a, HTTPS kanalom gdje se veza uspostavila certifikatom. Poruka se potpisuje klijentskim certifikatom.
4.2.9 Dohvat liste zdravstvenih djelatnika
4.2.9.1 Tip zahtjeva
HTTP GET
4.2.9.2 Format tijela zahtjeva
URL
4.2.9.3 Adresa metode
[HOST]/ctsadmin/Practitioners/lista_zdr_djelatnika.zip
4.2.9.4 Izlazni podaci
Izlazni podatak je zip datoteka koja u sebi sadrži listu zdravstvenih djelatnika u JSON.
Tablica 22 Izlazni podaci u JSON formatu
ID Naziv parametra Obavezan (D/N) Tip podatka Primjer Značenje
1 resourceType 1..1 D String Bundle
2 id 1..1 D String
b2ccbf8d-d99c-40fb-95a0-d038f24d63a4 Id upita
3 meta 1..1 D
4 meta. lastUpdated 1..1 D String2019-11-14T00:30:42Z
Datum zadnje izmjene u listi djelatnika
Rev E
![Page 46: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/46.jpg)
3 type 1..1 D String searchset Tip pretrage
4 total 1..1 D Int 2Broj pronađenih rezulatata
5 link 1..1 DLista (jedan objekt)
6 link.relation 1..1 D String self
7 link.url 1..1 D String PractitionerKontekst izvršenog upita
8 entry 0..* NLista objekata
9 entry.resource 1..1 D Objekt
10 entry.resource. resourceType 1..1 D String Practitioner
Vrsta podataka/resursa
11 entry.resource..id 1..1 D String 2345678 HZJZ šifra
12 entry.resource.meta 1..1 D Objekt
13 entry.resource.meta.versionId 1..1 D String 1Verzija zapisa liste
14 entry.resource.meta.lastUpdated 1..1 D String2019-11-08T10:43:00Z
Datum I vrijeme zadnje izmjene
15 entry.resource.identifier 1..1 DLista (jedan objekt)
16 entry.resource.identifier.value 1..1 D String 234567890 MBO
17 entry.resource.name 1..1 DLista (jedan objekt)
18 entry.resource.name.given 1..1 D String IvanIme zdr. djelatnika
19 entry.resource.name family 1..1 D String HorvatPrezime zdr. djelatnika
20 entry.resource.qualification 2 DLista dva objekta
21 entry.resource.qualification.identifier 1..1 DLista (jedan objekt)
22 entry.resource.qualification.identifier.value 1..1 D String234567890 /23456789012 MBO / OIB
23 entry.resource.qualification.code 1..1 D Objekt
24 entry.resource.qualification.code.text 1..1 D String MBO/OIB Naziv parametra
25 entry.resource.active 1..1 D String true
Aktivan ili neaktivan djelatnik
26 entry.search.mode 1..1 D String match
Oznaka uspješne pretrage
Rev E
![Page 47: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/47.jpg)
Izgled podataka u JSON formatu:
{ "resourceType": "Bundle", "id": "18c139cf-3d26-4811-b2d7-df1e13e4e26f", "meta": {"lastUpdated": "2019-10-11T16:07:12Z"}, "type": "searchset", "total": 20526, "link": [ { "relation": "self", "url": "Practitioner" }], "entry": [ { "resource": { "resourceType": "Practitioner", "id": "HZJZ šifra 1", "meta": { "versionId": "Verzija zapisa djelatnika", "lastUpdated": "2019-10-08T00:00:00Z" }, "identifier": [{"value": "MBO-vrijednost 1"}], "name": [ { "given": "Ime 1", "family": "Prezime 2" }], "qualification": [ { "identifier": [{"value": "MBO-vrijednost 1"}], "code": {"text": "MBO"} }, { "identifier": [{"value": "OIB-vrijednost 1"}], "code": {"text": "OIB"} } ], "active": true }, "search": {"mode": "match"} } { "resource": { "resourceType": "Practitioner", "id": "HZJZ šifra 2", "meta": { "versionId": "Verzija zapisa djelatnika", "lastUpdated": "2019-10-08T00:00:00Z" }, "identifier": [{"value": "MBO-vrijednost 2"}], "name": [ { "given": "Ime 2", "family": "Prezime 2" }], "qualification": [ { "identifier": [{"value": "MBO-vrijednost 2"}], "code": {"text": "MBO"} }, { "identifier": [{"value": "OIB-vrijednost 2"}],
Rev E
![Page 48: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/48.jpg)
"code": {"text": "OIB"} } ], "active": true }, "search": {"mode": "match"} },
.
.
.
. ]}
4.2.9.5 Digitalni certifikati i sigurnost
Poruka se šalje VPN rutom napravljenom od zdravstvene ustanove do CEZIH-a, HTTPS kanalom gdje se veza uspostavila certifikatom.
Rev E
![Page 49: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/49.jpg)
4.3 Implementacija sigurnosnih mehanizama
Sigurnosni mehanizmi implementirani su na sljedeći način:
Svaka poruka se nakon uspostave VPN konekcije šalje
o Klijentskim certifikatom
Svaka poruka koja se šalje prolazi kroz VPN
Role koje se moraju dodijeliti aplikativnom certifikatu su:
o an_monitoring_psl_ra_user
o an_code_list_user
Role koje se moraju dodijeliti klijentima, ovisno o tome koje će funkcionalnosti koristiti su:
o an_monitoring_psl_ra_admin
o an_code_list_admin
o an_monitoring_psl_ra_user
o an_code_list_user
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. Prijaviti bolnicu za početak produkcije HZZO-u s molbom da korištenom certifikatu dodaju gore opisane role
2. Tražiti HZZO dodjelu rola testnim korisnicima
3. Dohvatiti barem 1 kompletnu kodnu listu u 2 revizije
4.6 Preduvjeti za implementaciju na produkciji
Potrebno je odraditi sljedeće preduvjete:
1. Uspješno završiti implementaciju na certifikaciji
Rev E
![Page 50: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/50.jpg)
2. Prijaviti bolnicu za početak produkcije HZZO-u s molbom da bolničkom aplikativnom useru dodaju gore opisane certifikate
3. Tražiti HZZO dodjelu rola svim ili određenim djelatnicima bolnice
4. Dohvatiti barem 1 kompletnu kodnu listu u 2 revizije
4.7 Testiranje i verifikacija
Certifikacijski link:
https://certws.cezih.hr:49443/ctsadmin/service/vocab/browser
https://certws.cezih.hr:49443/ctsadmin/service/vocab/runtime
https://certws.cezih.hr:49443/fhir/CodeSystem
https://certws.cezih.hr:49443/fhir/Practitioner
https://certws.cezih.hr:49443/ctasadmin/Practitioners
Produkcijski link:
https://ws.cezih.hr:15443/ctsadmin/service/vocab/browser
https://ws.cezih.hr:15443/ctsadmin/service/vocab/runtime
https://ws.cezih.hr:15443/fhir/CodeSystem
https://ws.cezih.hr:15443/fhir/Practitioner
https://ws.cezih.hr:15443/ctasadmin/Practitioners
Rev E
![Page 51: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/51.jpg)
Prilog A – Primjeri Poruka
1. Dohvat popisa svih kodnih listi
Primjer zahtjeva:
<soapenv:Envelope xmlns:cts="urn://hl7.org/CTSVAPI" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"><soapenv:Header><wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"/></soapenv:Header> <soapenv:Body> <cts:getSupportedCodeSystems> <cts:time_limit>0</cts:time_limit> <cts:size_limit>0</cts:size_limit> </cts:getSupportedCodeSystems> </soapenv:Body></soapenv:Envelope>
Primjer odgovora:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <getSupportedCodeSystemsResponse xmlns="urn://hl7.org/CTSVAPI"> <getSupportedCodeSystemsReturn> <codeSystem_id>0.4.0.127.0.16.1.1.2.1</codeSystem_id> <codeSystem_name>EDQM Standard Terms</codeSystem_name> <copyright xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> <codeSystem_versions> <item>2</item> </codeSystem_versions> </getSupportedCodeSystemsReturn>... <getSupportedCodeSystemsReturn> <codeSystem_id>2.16.840.1.113883.2.7.3.1.42</codeSystem_id> <codeSystem_name>Ishod liječenja</codeSystem_name> <copyright xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> <codeSystem_versions> <item>2</item> </codeSystem_versions> </getSupportedCodeSystemsReturn> </getSupportedCodeSystemsResponse> </soap:Body></soap:Envelope>
Rev E
![Page 52: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/52.jpg)
2. Dohvat naziva svojstava (kolone) pojedine kodne liste
Primjer zahtjeva:
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/"> <Body> <lookupCodeSystemInfo xmlns="urn://hl7.org/CTSVAPI"> <codeSystem_id>2.16.840.1.113883.2.7.3.1.45.39</codeSystem_id> <codeSystem_name>Rezervni antibiotici</codeSystem_name> <codeSystem_version>1</codeSystem_version> </lookupCodeSystemInfo> </Body></Envelope>
Primjer odgovora:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <lookupCodeSystemInfoResponse xmlns="urn://hl7.org/CTSVAPI"> <lookupCodeSystemInfoReturn> <codeSystem> <codeSystem_id>2.16.840.1.113883.2.7.3.1.45.39</codeSystem_id> <codeSystem_name>Rezervni antibiotici</codeSystem_name> <copyright xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> <codeSystem_versions> <item>1</item> </codeSystem_versions> </codeSystem> <fullName>Rezervni antibiotici</fullName> <codeSystemDescription xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> <codeSystemValidFrom xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> <codeSystemValidTo>2018-11-19+01:00</codeSystemValidTo> <supportedLanguages> <item>HR</item> </supportedLanguages> <supportedRelations> <item>smallerThan</item> <item>hasSubtype</item> <item>hasPart</item> </supportedRelations> <supportedProperties> <item>zaštićeno ime lijeka</item> </supportedProperties> <supportedMimeTypes> <item>text/plain</item> </supportedMimeTypes> <supportedRelationQualifiers/> </lookupCodeSystemInfoReturn> </lookupCodeSystemInfoResponse> </soap:Body></soap:Envelope>
Rev E
![Page 53: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/53.jpg)
3. Dohvat svih elemenata pojedine kodne liste (preuzimanje šifrarnika)
Primjer zahtjeva:
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/"> <Body> <lookupConceptCodesByCodeSystem xmlns="urn://hl7.org/CTSVAPI"> <codeSystem_id>2.16.840.1.113883.2.7.3.1.45.110</codeSystem_id> <codeSystem_name></codeSystem_name> <codeSystem_version></codeSystem_version> </lookupConceptCodesByCodeSystem> </Body></Envelope>
Primjer odgovora:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <lookupConceptCodesByCodeSystemResponse xmlns="urn://hl7.org/CTSVAPI"> <lookupConceptCodesByCodeSystemReturn> <concept_id> <codeSystem_id>2005</codeSystem_id> <concept_code>G45</concept_code> </concept_id> <conceptStatus_code>Active</conceptStatus_code> <codeSystem_version xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> <designatedBy> <item> <designation>Prolazni cerebralni ishemijski napadaji i sindromi u vezi s njima</designation> <language_code>HR</language_code> <preferredForLanguage>false</preferredForLanguage> </item> </designatedBy> <hasProperties> <item> <property_code>datod</property_code> <propertyValue>1.6.2018</propertyValue> <language_code>HR</language_code> <mimeType_code xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> </item> <item> <property_code>datdo</property_code> <propertyValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> <language_code>HR</language_code>
Rev E
![Page 54: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/54.jpg)
<mimeType_code xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> </item> </hasProperties> </lookupConceptCodesByCodeSystemReturn> <lookupConceptCodesByCodeSystemReturn> <concept_id> <codeSystem_id>2005</codeSystem_id> <concept_code>G45.0</concept_code> </concept_id> <conceptStatus_code>Active</conceptStatus_code> <codeSystem_version xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> <designatedBy> <item> <designation>Sindrom vertebro-bazilarne arterije</designation> <language_code>HR</language_code> <preferredForLanguage>false</preferredForLanguage> </item> </designatedBy> <hasProperties> <item> <property_code>datod</property_code> <propertyValue>1.6.2018</propertyValue> <language_code>HR</language_code> <mimeType_code xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> </item> <item> <property_code>datdo</property_code> <propertyValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> <language_code>HR</language_code> <mimeType_code xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> </item> </hasProperties> </lookupConceptCodesByCodeSystemReturn>
.
.
.
<lookupConceptCodesByCodeSystemReturn> <concept_id> <codeSystem_id>2005</codeSystem_id> <concept_code>G45.9</concept_code> </concept_id> <conceptStatus_code>Active</conceptStatus_code> <codeSystem_version xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> <designatedBy> <item> <designation>Prolazni cerebralni ishemijski napadaj, nespecificiran</designation> <language_code>HR</language_code>
Rev E
![Page 55: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/55.jpg)
<preferredForLanguage>false</preferredForLanguage> </item> </designatedBy> <hasProperties> <item> <property_code>datod</property_code> <propertyValue>1.6.2018</propertyValue> <language_code>HR</language_code> <mimeType_code xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> </item> <item> <property_code>datdo</property_code> <propertyValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> <language_code>HR</language_code> <mimeType_code xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> </item> </hasProperties> </lookupConceptCodesByCodeSystemReturn> </lookupConceptCodesByCodeSystemResponse> </soap:Body></soap:Envelope>
4. HL7 FHIR Dohvat svih elemenata pojedine kodne liste (preuzimanje šifrarnika)
Primjer zahtjeva:
[HOST]/fhir/CodeSystem/2.16.840.1.113883.2.7.3.1.45.30
Primjer odgovora:
{ "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.30", "meta": { "versionId": "11", "lastUpdated": "2019-02-15T11:06:28Z" }, "name": "Tip prijama", "status": "active", "content": "complete", "concept": [ { "code": "9", "designation": [ { "value": "Interna uputnica", "language": "hr" }], "property": [ {
Rev E
![Page 56: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/56.jpg)
"code": "datod", "valueString": "01.01.2012" }] }, { "code": "8", "designation": [ { "value": "Telemedicina", "language": "hr" }], "property": [ { "code": "datod", "valueString": "01.01.2012" }] }
.
.
. { "code": "1", "designation": [ { "value": "Jedinstvena lista naručivanja", "language": "hr" }], "property": [ { "code": "datod", "valueString": "03.11.2011" }] } ]}
Primjer zahtjeva:
[HOST]/fhir/CodeSystem/2.16.840.1.113883.2.7.3.1.45.30/_history/5
Primjer odgovora:
{ "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.30", "meta": { "versionId": "5", "lastUpdated": "2019-02-04T11:31:35Z" }, "name": "Tip prijama", "status": "active", "content": "complete", "concept": [ { "code": "9", "designation": [ { "value": "Interna uputnica", "language": "hr" }], "property": [ { "code": "datod",
Rev E
![Page 57: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/57.jpg)
"valueString": "01.01.2012" }] }, { "code": "8", "designation": [ { "value": "Telemedicina", "language": "hr" }], "property": [ { "code": "datod", "valueString": "01.01.2012" }] }
.
.
. ]}
5. HL7 FHIR Dohvat svih naziva kodnih listi
Primjer zahtjeva:
[HOST]/fhir/CodeSystem?_elements=name
Primjer odgovora:
{ "resourceType": "Bundle", "id": "e2f2efa6-af70-446e-bcca-74665d7c7504", "type": "searchset", "total": 3, "link": [ { "relation": "self", "url": "?_elements=name" }], "entry": [{ "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.92", "meta": { "versionId": "1", "lastUpdated": "2018-11-16T11:05:31Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode" }] }, "name": "Trijažne kategorije", "status": "active", "content": "complete" }, "search": {"mode": "match"} }, {
Rev E
![Page 58: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/58.jpg)
"resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.9.29", "meta": { "versionId": "2", "lastUpdated": "2018-12-07T11:10:02Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode" }] }, "name": "Šifra djelatnosti", "status": "active", "content": "complete" }, "search": {"mode": "match"} }, { "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.9.29", "meta": { "versionId": "1", "lastUpdated": "2018-12-04T13:18:57Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode" }] }, "name": "Šifra djelatnosti", "status": "active", "content": "complete" }, "search": {"mode": "match"} }
]}
6. HL7 FHIR Dohvat elemenata kodnih lista izmijenjenih na određeni datum ili nakon određenog datuma (preuzimanje šifrarnika)
Primjer zahtjeva:
[HOST]/fhir/CodeSystem?_lastUpdated=ge2019-11-08
Primjer odgovora:
{ "resourceType": "Bundle", "id": "b2ccbf8d-d99c-40fb-95a0-d038f24d63a4", "type": "searchset", "total": 2, "link": [ {
Rev E
![Page 59: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/59.jpg)
"relation": "self", "url": "CodeSystem?_lastUpdated=ge2019-11-08" }], "entry": [ { "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.152", "meta": { "versionId": "1", "lastUpdated": "2019-11-08T10:43:00Z" }, "name": "Područje rada fizikalna medicina", "status": "active", "content": "complete", "concept": [ { "code": "fmr028", "designation": [ { "value": "BELI MANASTIR", "language": "hr" }] }, ... { "code": "fmr018", "designation": [ { "value": "ĐURĐEVAC i KOPRIVNICA", "language": "hr" }] } ] }, "search": {"mode": "match"} }, { "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.153", "meta": { "versionId": "1", "lastUpdated": "2019-11-08T12:33:13Z" }, "name": "Područje rada psihijatrija", "status": "active", "content": "complete", "concept": [ { "code": "psi031", "designation": [ { "value": "BELI MANASTIR", "language": "hr" }] }, .... { "code": "psi033", "designation": [ {
Rev E
![Page 60: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/60.jpg)
"value": "ĐAKOVO", "language": "hr" }] } ] }, "search": {"mode": "match"} } ]}
Primjer zahtjeva:
[HOST]/fhir/CodeSystem?_lastUpdated=ge2019-11-08&_elements=name
Primjer odgovora:
{ "resourceType": "Bundle", "id": "89d43029-0097-459c-a22e-ccc11d0d5b0c", "type": "searchset", "total": 2, "link": [ { "relation": "self", "url": "CodeSystem?_lastUpdated=ge2019-11-08&_elements=name" }], "entry": [ { "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.152", "meta": { "versionId": "1", "lastUpdated": "2019-11-08T10:43:00Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode" }] }, "name": "Područje rada fizikalna medicina", "status": "active", "content": "complete" }, "search": {"mode": "match"} }, { "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.153", "meta": { "versionId": "1", "lastUpdated": "2019-11-08T12:33:13Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode"
Rev E
![Page 61: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/61.jpg)
}] }, "name": "Područje rada psihijatrija", "status": "active", "content": "complete" }, "search": {"mode": "match"} } ]}
Primjer zahtjeva:
[HOST]/fhir/CodeSystem?_lastUpdated=ge2019-11-08&_elements=concept
Primjer odgovora:
{ "resourceType": "Bundle", "id": "6ff15179-2079-4033-9d83-4f9c894cf0ff", "type": "searchset", "total": 2, "link": [ { "relation": "self", "url": "CodeSystem?_lastUpdated=ge2019-11-08&_elements=concept" }], "entry": [ { "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.152", "meta": { "versionId": "1", "lastUpdated": "2019-11-08T10:43:00Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode" }] }, "status": "active", "content": "complete", "concept": [ { "code": "fmr028", "designation": [ { "value": "BELI MANASTIR", "language": "hr" }] }, { "code": "fmr063", "designation": [ { "value": "BENKOVAC, BIOGRAD, GRAČAC i OBROVAC", "language": "hr"
Rev E
![Page 62: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/62.jpg)
}] }
.
.
. ] }, "search": {"mode": "match"} }, { "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.153", "meta": { "versionId": "1", "lastUpdated": "2019-11-08T12:33:13Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode" }] }, "status": "active", "content": "complete", "concept": [ { "code": "psi031", "designation": [ { "value": "BELI MANASTIR", "language": "hr" }] }, { "code": "psi068", "designation": [ { "value": "BENKOVAC, BIOGRAD, GRAČAC i OBROVAC", "language": "hr" }] }
.
.
. ] }, "search": {"mode": "match"} } ]}
Primjer zahtjeva:
[HOST]/fhir/CodeSystem?_lastUpdated=ge2019-11-08&_elements=name,concept
Primjer odgovora:
{ "resourceType": "Bundle", "id": "c4b0d62c-c578-4ce5-919f-cbd0645fa345",
Rev E
![Page 63: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/63.jpg)
"type": "searchset", "total": 2, "link": [ { "relation": "self", "url": "CodeSystem?_lastUpdated=ge2019-11-08&_elements=name,concept" }], "entry": [ { "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.152", "meta": { "versionId": "1", "lastUpdated": "2019-11-08T10:43:00Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode" }] }, "name": "Područje rada fizikalna medicina", "status": "active", "content": "complete", "concept": [ { "code": "fmr028", "designation": [ { "value": "BELI MANASTIR", "language": "hr" }] }, { "code": "fmr063", "designation": [ { "value": "BENKOVAC, BIOGRAD, GRAČAC i OBROVAC", "language": "hr" }] },
.
.
. ] }, "search": {"mode": "match"} }, { "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.153", "meta": { "versionId": "1", "lastUpdated": "2019-11-08T12:33:13Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode" }] }, "name": "Područje rada psihijatrija",
Rev E
![Page 64: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/64.jpg)
"status": "active", "content": "complete", "concept": [ { "code": "psi031", "designation": [ { "value": "BELI MANASTIR", "language": "hr" }] }, { "code": "psi068", "designation": [ { "value": "BENKOVAC, BIOGRAD, GRAČAC i OBROVAC", "language": "hr" }] },
.
.
. ] }, "search": {"mode": "match"} } ]}
Primjer zahtjeva:
[HOST]/fhir/CodeSystem?_lastUpdated=ge2019-11-08&_elements=name,concept&_id=2.16.840.1.113883.2.7.3.1.45.153, 2.16.840.1.113883.2.7.3.1.45.154
Primjer odgovora:
{ "resourceType": "Bundle", "id": "c4b0d62c-c578-4ce5-919f-cbd0645fa345", "type": "searchset", "total": 2, "link": [ { "relation": "self", "url": "CodeSystem?_lastUpdated=ge2019-11-08&_elements=name,concept&_id=2.16.840.1.113883.2.7.3.1.45.153,2.16.840.1.113883.2.7.3.1.45.154" }], "entry": [ { "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.154", "meta": { "versionId": "1", "lastUpdated": "2019-11-08T10:43:00Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode" }]
Rev E
![Page 65: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/65.jpg)
}, "name": "Područje rada interna medicina "status": "active", "content": "complete", "concept": [ { "code": "int028", "designation": [ { "value": "DONJA STUBICA", "language": "hr" }] }, { "code": " int001", "designation": [ { "value": "BJELOVAR", "language": "hr" }] },
.
.
. ] }, "search": {"mode": "match"} }, { "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.153", "meta": { "versionId": "1", "lastUpdated": "2019-11-08T12:33:13Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode" }] }, "name": "Područje rada psihijatrija", "status": "active", "content": "complete", "concept": [ { "code": "psi031", "designation": [ { "value": "BELI MANASTIR", "language": "hr" }] }, { "code": "psi068", "designation": [ { "value": "BENKOVAC, BIOGRAD, GRAČAC i OBROVAC", "language": "hr" }] },
.
.
Rev E
![Page 66: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/66.jpg)
. ] }, "search": {"mode": "match"} } ]}
Rev E
![Page 67: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/67.jpg)
7. HL7 FHIR Dohvat elemenata kodnih lista izmijenjenih na određeni datum (preuzimanje šifrarnika)
Primjer zahtjeva:
[HOST]/fhir/CodeSystem?_lastUpdated=eq2019-10-16
Primjer odgovora:
{ "resourceType": "Bundle", "id": "a3054f52-ecb6-4310-85a6-3d152622e925", "type": "searchset", "total": 1, "link": [ { "relation": "self", "url": "CodeSystem?_lastUpdated=eq2019-10-16" }], "entry": [ { "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.24", "meta": { "versionId": "16", "lastUpdated": "2019-10-16T00:30:27Z" }, "name": "Tip ustanove", "status": "active", "content": "complete", "concept": [ { "code": "999", "designation": [ { "value": "HZZO PODRUČNI URED (REZERVIRANO ZA POTREBE HZJZ)", "language": "hr" }] }, { "code": "998", "designation": [ { "value": "SURADNE USTANOVE HZZO (REZERVIRANO ZA POTREBE HZJZ)", "language": "hr" }] }, ] }, "search": {"mode": "match"} } ]}
Rev E
![Page 68: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/68.jpg)
Primjer zahtjeva:
[HOST]/fhir/CodeSystem?_lastUpdated=eq2019-10-16&_elements=name
Primjer odgovora:
{ "resourceType": "Bundle", "id": "cb47859c-d648-43c4-b48b-0ef7da5a7ff6", "type": "searchset", "total": 1, "link": [ { "relation": "self", "url": "CodeSystem?_lastUpdated=eq2019-10-16&_elements=name" }], "entry": [ { "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.24", "meta": { "versionId": "16", "lastUpdated": "2019-10-16T00:30:27Z", "tag": [ { "code": "SUBSETTED", "display": "Resource encoded in summary mode" }] }, "name": "Tip ustanove", "status": "active", "content": "complete" }, "search": {"mode": "match"} } ]}
Primjer zahtjeva:
[HOST]/fhir/CodeSystem?_lastUpdated=eq2019-10-16&_id=2.16.840.1.113883.2.7.3.1.45.25, 2.16.840.1.113883.2.7.3.1.45.24
Primjer odgovora:
{ "resourceType": "Bundle", "id": "a3054f52-ecb6-4310-85a6-3d152622e925", "type": "searchset", "total": 2, "link": [ { "relation": "self", "url": "CodeSystem?_lastUpdated=eq2019-04-03&_id=2.16.840.1.113883.2.7.3.1.45.25,2.16.840.1.113883.2.7.3.1.45.24" }], "entry": [
Rev E
![Page 69: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/69.jpg)
{ "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.24", "meta": { "versionId": "17", "lastUpdated": "2019-04-03T00:30:27Z" }, "name": "Tip ustanove", "status": "active", "content": "complete", "concept": [ { "code": "010", "designation": [ { "value": "DOM ZDRAVLJA", "language": "hr" }] },... ] }, "search": {"mode": "match"} }, { "resource": { "resourceType": "CodeSystem", "id": "2.16.840.1.113883.2.7.3.1.45.25", "meta": { "versionId": "30", "lastUpdated": "2019-04-03T00:30:27Z" }, "name": "Zdravstvene ustanove", "status": "active", "content": "complete", "concept": [ { "code": "049704974", "designation": [ { "value": "OPĆA BOLNICA ZADAR", "language": "hr" }] },... ] }, "search": {"mode": "match"} } ]}
Rev E
![Page 70: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/70.jpg)
8. Dohvat liste zdravstvenih djelatnika promijenjene na određeni datum ili nakon njega
Primjer zahtjeva:
[HOST]/fhir/Practitioner
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:hr="http://hr.ericsson.etk.cezih.fhir.resource.wsdl"> <soapenv:Header/> <soapenv:Body> <hr:FHIR_Query> <hr:requestID>11111</hr:requestID> <hr:requestType>GET</hr:requestType> <hr:responseType>application/xml</hr:responseType> <hr:parametars>?_lastUpdated=ge2019-11-13&active=true</hr:parametars> </hr:FHIR_Query> </soapenv:Body></soapenv:Envelope>
Primjer odgovora:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Body> <hr:FHIR_Data xmlns:hr="http://hr.ericsson.etk.cezih.fhir.resource.wsdl"> <hr:status>1</hr:status> <hr:data> ew0KICAgInJlc291cmNlVHlwZSI6ICJCdW5kbGUiLA0KICAgImlkIjogIjBlZjlhZmIxLTUyNGMtNGFlYS05OTE1LWQ4YjBmZTc1MWM0YyIsDQogICAibWV0YSI6IHsibGFzdFVwZGF0ZWQiOiAiMjAxOS0xMC0xMVQxNjowNzoxMloifSwNCiAgICJ0eXBlIjogInNlYXJjaHNldCIsDQogICAidG90YWwiOiAyLA0KICAgImxpbmsiOiBbICAgew0KICAgICAgInJlbGF0aW9uIjogInNlbGYiLA0KICAgICAgInVybCI6ICJQcmFjdGl0aW9uZXI/X2xhc3RVcGRhdGVkPWdlMjAxOS0xMC0xMSINCiAgIH1dLA0KICAgImVudHJ5IjogICAgWw0KICAgICAgICAgICAgew0KICAgICAgICAgInJlc291cmNlIjogICAgICAgICAgew0KICAgICAgICAgICAgInJlc291cmNlVHlwZSI6ICJQcmFjdGl0aW9uZXIiLA0KICAgICAgICAgICAgImlkIjogIjgwOTcwMTEiLA0KICAgICAgICAgICAgIm1ldGEiOiAgICAgICAgICAgICB7DQogICAgICAgICAgICAgICAidmVyc2lvbklkIjogIjUiLA0KICAgICAgICAgICAgICAgImxhc3RVcGRhdGVkIjogIjIwMTktMTAtMTFUMDA6MDA6MDBaIg0KICAgICAgICAgICAgfSwNCiAgICAgICAgICAgICJpZGVudGlmaWVyIjogW3sidmFsdWUiOiAiMTA1NDE0MTM0In1dLA0KICAgICAgICAgICAgIm5hbWUiOiBbICAgICAgICAgICAgew0KICAgICAgICAgICAgICAgImdpdmVuIjogIkltZTE1NiIsDQogICAgICAgICAgICAgICAiZmFtaWx5IjogIlByZXppbWUxNTYiDQogICAgICAgICAgICB9XSwNCiAgICAgICAgICAgICJxdWFsaWZpY2F0aW9uIjogICAgICAgICAgICAgWw0KICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgew0KICAgICAgICAgICAgICAgICAgImlkZW50aWZpZXIiOiBbeyJ2YWx1ZSI6ICIxMDU0MTQxMzQifV0sDQogICAgICAgICAgICAgICAgICAiY29kZSI6IHsidGV4dCI6ICJNQk8ifQ0KICAgICAgICAgICAgICAgfSwNCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIHsNCiAgICAgICAgICAgICAgICAgICJpZGVudGlmaWVyIjogW3sidmFsdWUiOiAiNTMzNjczOTY1MzYifV0sDQogICAgICAgICAgICAgICAgICAiY29kZSI6IHsidGV4dCI6ICJPSUIifQ0KICAgICAgICAgICAgICAgfQ0KICAgICAgICAgICAgXSwNCiAgICAgICAgICAgICJhY3RpdmUiOiB0cnVlDQogICAgICAgICB9LA0KICAgICAgICAgInNlYXJjaCI6IHsibW9kZSI6ICJtYXRjaCJ9DQogICAgICB9LA0KICAgICAgICAgICAgew0KICAgICAgICAgInJlc291cmNlIjogICAgICAgICAgew0KICAgICAgICAgICAgInJlc291cmNlVHlwZSI6ICJQcmFjdGl0aW9uZXIiLA0KICAgICAgICAgICAgImlkIjogIjgwOTcwMjAiLA0KICAgICAgICAgICAgIm1ldGEiOiAgICAgICAgICAgICB7
Rev E
![Page 71: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/71.jpg)
DQogICAgICAgICAgICAgICAidmVyc2lvbklkIjogIjUiLA0KICAgICAgICAgICAgICAgImxhc3RVcGRhdGVkIjogIjIwMTktMTAtMTFUMDA6MDA6MDBaIg0KICAgICAgICAgICAgfSwNCiAgICAgICAgICAgICJpZGVudGlmaWVyIjogW3sidmFsdWUiOiAiMTE3MDMxMDc5In1dLA0KICAgICAgICAgICAgIm5hbWUiOiBbICAgICAgICAgICAgew0KICAgICAgICAgICAgICAgImdpdmVuIjogIkltZTE1NSIsDQogICAgICAgICAgICAgICAiZmFtaWx5IjogIlByZXppbWUxNTUiDQogICAgICAgICAgICB9XSwNCiAgICAgICAgICAgICJxdWFsaWZpY2F0aW9uIjogICAgICAgICAgICAgWw0KICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgew0KICAgICAgICAgICAgICAgICAgImlkZW50aWZpZXIiOiBbeyJ2YWx1ZSI6ICIxMTcwMzEwNzkifV0sDQogICAgICAgICAgICAgICAgICAiY29kZSI6IHsidGV4dCI6ICJNQk8ifQ0KICAgICAgICAgICAgICAgfSwNCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIHsNCiAgICAgICAgICAgICAgICAgICJpZGVudGlmaWVyIjogW3sidmFsdWUiOiAiMzg2MjQ0Mjc3NjMifV0sDQogICAgICAgICAgICAgICAgICAiY29kZSI6IHsidGV4dCI6ICJPSUIifQ0KICAgICAgICAgICAgICAgfQ0KICAgICAgICAgICAgXSwNCiAgICAgICAgICAgICJhY3RpdmUiOiB0cnVlDQogICAgICAgICB9LA0KICAgICAgICAgInNlYXJjaCI6IHsibW9kZSI6ICJtYXRjaCJ9DQogICAgICB9DQogICBdDQp9</hr:data>
</hr:FHIR_Data> </soapenv:Body></soapenv:Envelope>
Dekodiran odgovor XML format:
<Bundle xmlns="http://hl7.org/fhir"> <id value="955ecd70-d89f-4727-b43e-0b1a38e8ea00"/> <meta> <lastUpdated value="2019-10-11T16:07:12Z"/> </meta> <type value="searchset"/> <total value="2"/> <link> <relation value="self"/> <url value="Practitioner?_lastUpdated=ge2019-10-11&active=true"/> </link> <entry> <resource> <Practitioner> <id value="8097011"/> <meta> <versionId value="5"/> <lastUpdated value="2019-10-11T00:00:00Z"/> </meta> <identifier> <value value="105414134"/> </identifier> <name> <given value="Ime156"/> <family value="Prezime156"/> </name> <qualification> <identifier> <value value="105414134"/> </identifier> <code> <text value="MBO"/> </code> </qualification>
Rev E
![Page 72: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/72.jpg)
<qualification> <identifier> <value value="53367396536"/> </identifier> <code> <text value="OIB"/> </code> </qualification> <active value="true"/> </Practitioner> </resource> <search> <mode value="match"/> </search> </entry> <entry> <resource> <Practitioner> <id value="8097020"/> <meta> <versionId value="5"/> <lastUpdated value="2019-10-11T00:00:00Z"/> </meta> <identifier> <value value="117031079"/> </identifier> <name> <given value="Ime155"/> <family value="Prezime155"/> </name> <qualification> <identifier> <value value="117031079"/> </identifier> <code> <text value="MBO"/> </code> </qualification> <qualification> <identifier> <value value="38624427763"/> </identifier> <code> <text value="OIB"/> </code> </qualification> <active value="true"/> </Practitioner> </resource> <search> <mode value="match"/> </search> </entry></Bundle>
Dekodiran odgovor JSON format:
Rev E
![Page 73: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/73.jpg)
{ "resourceType": "Bundle", "id": "0ef9afb1-524c-4aea-9915-d8b0fe751c4c", "meta": {"lastUpdated": "2019-10-11T16:07:12Z"}, "type": "searchset", "total": 2, "link": [ { "relation": "self", "url": "Practitioner?_lastUpdated=ge2019-10-11&active=true" }], "entry": [ { "resource": { "resourceType": "Practitioner", "id": "8097011", "meta": { "versionId": "5", "lastUpdated": "2019-10-11T00:00:00Z" }, "identifier": [{"value": "105414134"}], "name": [ { "given": "Ime156", "family": "Prezime156" }], "qualification": [ { "identifier": [{"value": "105414134"}], "code": {"text": "MBO"} }, { "identifier": [{"value": "53367396536"}], "code": {"text": "OIB"} } ], "active": true }, "search": {"mode": "match"} }, { "resource": { "resourceType": "Practitioner", "id": "8097020", "meta": { "versionId": "5", "lastUpdated": "2019-10-11T00:00:00Z" }, "identifier": [{"value": "117031079"}], "name": [ { "given": "Ime155", "family": "Prezime155" }], "qualification": [ { "identifier": [{"value": "117031079"}], "code": {"text": "MBO"} }, { "identifier": [{"value": "38624427763"}],
Rev E
![Page 74: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/74.jpg)
"code": {"text": "OIB"} } ], "active": true }, "search": {"mode": "match"} } ]}
Prilog C – WSDL web servisa
Prilog D – Popis grešaka sigurnosnog slojaTablica 29 Opis grešaka u razmjeni podataka web servisom na sigurnosnom
slojuIdentifikator pogreške Tekst pogreškeERR_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 E – Popis grešaka web servisaTablica 30 Opis grešaka u razmjeni podataka web servisom
Identifikator pogreške Tekst pogreške
Rev E
![Page 75: Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih](https://reader036.vdocuments.site/reader036/viewer/2022090810/611bd4553d9c5108091d325e/html5/thumbnails/75.jpg)
UnexpectedError Generalna greškaTimeoutError Istek vremenaUnknownCodeSystem Nepostojeći šifrarnikUnknownConceptCode Nepostojeća šifraCodeSystemNameIdMismatch Nepodudarajući Identifikator imena šifrarnika UnknownLanguageCode Nepostojeća šifra jezikaUnknownRelationshipCode Nepostojeća šifra relacijeUnknownRelationQualifier Nepostojeći kvalifikator relacijeNoApplicableDesignationFound Nepostojeći naziv kod pretrageUnknownMatchAlgorithm Nepostojeći algoritam pretrageUnknownPropertyCode Nepostojeće svojstvo šifreUnknownMimeTypeCode Nepostojeća vrsta objektaUnknownMapName Nepostojeća mapaBadlyFormedMatchText Pogrešno formatiran tekst pretrageInvalidExpansionContext Nepoznat kontekst proširenjaMappingNotAvailable Nedozvoljeno mapiranjeMapNameSourceMismatch Neispravan naziv izvorišne mapeMapNameTargetMismatch Neispravan naziv odredišne mapeAmbiguousMapRequest Mapirano više od dva šifrarnikaUnableToMap Nemoguće mapirati
NAPOMENEKonačni izgled i sadržaj dokumenta može biti podložan izmjenama usred prilagodbe postojećem stanju na CUS sustavu i CEZIH sustavu te detaljima implementacije.
U sklopu dokumentacije nije predviđena izrada integracijske komponente za potrebe konzumacije metoda opisanog web servisa, već je predviđeno da klijenti samostalno implementiraju pozive prema web servisu koristeći strojni opis strukture web servisa u standardnim SOAP/WSDL i REST/JSON tehnologijama.
Rev E