uvod - cezih · web viewuvod ovo poglavlje opisuje slučajeve uporabe za korištenje sljedećih...
TRANSCRIPT
CUS - Implementacija web servisa šifrarnika
Opis rješenja
Rev E
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
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
Prilog C – WSDL web servisa..........................................................................................
Prilog D – Popis grešaka sigurnosnog sloja.................................................................
Prilog E – Popis grešaka web servisa............................................................................
NAPOMENE 73
Rev E
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
[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
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
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
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
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
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
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
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
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
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
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
"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
<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
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
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
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
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
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
"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
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
"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
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
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
<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
<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
<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
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
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
.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
"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
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
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
<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
2 requestType D String GET Tip zahtjeva
3 responseType D String application/xml
Oblik odgovora: za XML koristiti application/xml, za JSON application/json,
4 parametars D String
?_lastUpdated=ge2019-11-13&active=true
Datum od kojeg želimo dohvatiti promjene ne stariji od mjesec dana, za dohvat samo aktivnih djelatnika postaviti kao u primjeru active=true, za dohvat samo neaktivnih active=false, dok za dohvat aktivnih i neaktivnih izostaviti atribut active
4.2.8.5 Izlazni podaci
Datum po kojemu se dohvaćaju podaci ograničen je na broj dana i broj pronađenih rezultata. Ukoliko je datum stariji od mjesec dana, servis će vratiti upozorenje. Ukoliko je prekoračen broj podataka, u headeru izlaznih podataka će se ispisati podatak da postoji još elemenata, ali je potrebno suziti pretragu.
Tablica 19 Izlazni parametri za dohvat podataka
ID Naziv parametra Obavezan (D/N) Tip podatka Primjer Značenje
1 FHIR_Data D objekt Identifikator zahtjeva
2 Status D String 1 Status zahtjeva
3 Data D String PEJ1bmRsZSB4bWx…. Base64 kodirani podaci
Izgled odgovora:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Body> <hr:FHIR_Data xmlns:hr="http://hr.ericsson.etk.cezih.fhir.resource.wsdl"> <hr:status>1</hr:status> <hr:data>KODIRANI PODACI
</hr:data> </hr:FHIR_Data> </soapenv:Body></soapenv:Envelope>
Tablica 20 Parametri dekodiranih podataka – XML format
ID Naziv parametraObavezan (D/N)
Tip podatka Primjer
Značenje
1 Bundle 1..1 D
2Bundle.id 1..1 D
String b2ccbf8d-d99c-40fb-95a0-d038f24d6
Id upita
Rev E
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
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
</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
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
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
"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
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
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
"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
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
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
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
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
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
<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
<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
"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
"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
"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
"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
"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
}] }, "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
}] }
.
.
. ] }, "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
"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
"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
}, "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
. ] }, "search": {"mode": "match"} } ]}
Rev E
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
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
{ "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
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
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
<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
{ "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
"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
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