89
CUS - Implementacija web servisa šifrarnika Opis rješenja Rev E

Uvod - CEZIH · Web viewUvod Ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih funkcionalnosti: Dohvat kodnih listi / šifrarnika Dohvat trenutne liste zdravstvenih

  • Upload
    others

  • View
    2

  • Download
    0

Embed Size (px)

Citation preview

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

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

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

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

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

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

[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

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

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

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

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

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

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

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

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

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

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

"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

<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

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

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

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

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

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

"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

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

"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

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

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

<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

<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

<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

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

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

.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

"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

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

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

<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

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&amp;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

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

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

</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

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

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

"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

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

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

"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

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

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

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

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

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

<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

<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

"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

"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

"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

"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

"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

}] }, "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

}] }

.

.

. ] }, "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

"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

"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

}, "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

. ] }, "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

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

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

{ "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

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

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

<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

{ "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

"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

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