Tältä sivulta löydät Kanta-rajapintoihin liittyvät HL7-rajapintamäärittelyt. Muut HL7-määrittelyt löytyvät HL7-yhdistyksen omilta sivuilta .
Kanta-palvelujen HL7-sivujen tarkempi sisältö on saatavissa vain suomeksi.
Kanta HL7 HelpDesk (Kanta-palveluiden HL7-rajapintoihin liittyvät kysymykset)
HUOM! Sähköpostiosoite on muuttunut ja yhteenvetodokumentin ylläpito on lopetettu.
Kanta-rajapintoja koskevat HL7-kysymykset osoitetaan jatkossa osoitteeseen kantakehitys@kanta.fi
Lisää vastauksia HL7-kysymyksiin löydät "Kysymyksiä ja vastauksia Potilastiedon arkiston määrittelyistä" -dokumentit Potilastiedon arkiston määrittelyt -sivulla.
HL7 Finland HelpDesk (yleiset HL7-kysymykset)
Sähköpostiosoite: Timo.Kaskinen[ät]salivirta.fi
HL7 HelpDesk kysymykset ja vastaukset 2010-2014
Esimerkkiasiakirjat ja -sanomat
Potilastiedon arkiston esimerkkiasiakirjat ja -sanomat (zip) 20.8.2020
| Potilastiedon arkisto -määritykset - 2016 tietosisältö | ||
|---|---|---|
| Kanta Optometrian CDA R2 v1.01OID: 1.2.246.777.11.2018.11 | Sisältää optometrian CDA R2 asiakirjarakenteet | HL7 teknisen komitean sekä Kelan hyväksymä. |
| Ensihoitokertomus V1.10_RC2 (zip) 24.8.2020, OID: 1.2.246.777.11.2017.7
| Määrittely kuvaa vain ensihoitopalvelun tulevaan kansalliseen kenttäjohtamisen järjestelmään KEJO:on tuottamat kirjaukset Ensihoitokertomus (ENSIH)- näkymälle. | Määrittelyn sisältö on hyväksytty HL7 Finland standardiksi. Huom. 28.9.2017 julkaistu versio 1.10 vedettiin pois käytöstä ja julkaistiin uudelleen 15.8.2019 Release Candidate 1 (RC1) statuksella ja samalla dokumentin OID-tunnisteella. Nyt dokumentista on julkaistu 24.8.2020 RC2 versio samalla dokumentin OID-tunnisteella. Lopullisen versio julkaistaan, kun ensihoitokertomusta tuottava järjestelmä saadaan testattua ja sen kokemukset huomioitua määrittelyssä. |
| Tiedonhallintapalvelun koosteet ja ylläpidettävät asiakirjat OID: 1.2.246.777.11.2018.12 v.1.10 (13.11.2018) v.1.10.1 (15.5.2019) v1.10.2 (28.1.2020) | Sisältää Tiedonhallintapalvelun kooste-asiakirjojen CDA R2 rakennemäärittelyt sekä ylläpidettävissä asiakirjoissa huomioitavia CDA R2 ominaispiirteitä. | Määrittelyn sisältö on hyväksytty TC:n ja Kelan toimesta sen ollessa osa Kertomus ja lomakkeet määrittelyä. HL7 TC:ssä hyväksyttiin määrittelyn asioiden eriyttäminen omaksi dokumentaatiokseen. Kela on toteuttanut tämän eriyttämisen ja tehnyt määrittelyn selkeyttämistä ja tarkennuksia. Versio 1.10.1 sisältää täydennyksiä ja aikaisempien versioiden errata-merkinnät. |
| Potilastiedon arkiston Kertomus ja lomakkeet, v5.112.12.2015, OID: 1.2.246.777.11.2015.30
| Sisältää kertomustietojen siirron ja säilytyksen CDA R2-muodon ja rakenteen sekä kertomuksen lomakkeet | HL7 teknisen komitean sekä Kelan hyväksymä. Huom. tästä versiosta on eriytetty Tiedonhallintapalvelun koosteiden ja ylläpidettävien asiakirjojen määrittelyt omaksi dokumentaatiokseen. |
| Kanta, lähetteen ja hoitopalautteen CDA R2-rakenne V 5.2
| Sisältää dokumentin Lähetteen ja hoitopalautteen CDA R2-rakenne V 5.2 ja tietosisältötaulukon (Liite C). Esimerkkiasiakirjat sisältyvät Potilastiedon arkiston yhteiseen esimerkkikokoelmaan. | Hyväksytty HL7 TC:n ja Kelan toimesta. |
| Suun terveydenhuollon CDA R2 potilaskertomusrakenne
Suun terveydenhuollon CDA R2 potilaskertomusrakenne | Suun terveydenhuollon tekninen CDA R2 -määritys V2.10 Suun terveydenhuollon tekninen CDA R2 -määritys V3.00 | Hyväksytty HL7 TC:n ja Kelan toimesta. HL7 teknisen komitean sekä Kelan hyväksymä. |
| Terveys- ja hoitosuunnitelma - CDA R2 potilaskertomusrakenneOID: 1.2.246.777.11.2015.32 v.1.21 (22.10.2015) v1.21.1 (15.5.2019) | Sisältää Terveys- ja hoitosuunnitelman teknisen CDA R2 rakenteen määrittelyt | HL7 teknisen komitean sekä Kelan hyväksymä. |
| Kanta kuvantamisen CDA R2 merkinnät, v2.21
| Sisältää kuvantamisen CDA R2 asiakirjarakenteet | HL7 teknisen komitean sekä Kelan hyväksymä. |
| Kanta Laboratorion CDA R2 merkinnät, v4.21
| Sisältää laboratorion CDA R2 asiakirjarakenteet | HL7 teknisen komitean sekä Kelan hyväksymä. |
| Potilastiedon arkiston yhteiset määritykset - 2014 ja 2016 tietosisältöjen osalta | ||
|---|---|---|
| Potilastiedon arkiston Medical RecordsOID: 1.2.246.777.11.2015.37 v.2.02 (2.12.2015) v.2.02.1 (15.5.2019) | Potilastiedon arkiston Medical Records. Muutoshistoria on eritelty dokumentin versiohistoria kohdassa. | Dokumentti hyväksytty HL7 TC:n ja Kelan taholta. V2.02 ja v2.02.1 sis. Kelan tekemiä päivityksiä. |
| Potilastiedon arkiston Medical Records (zip) OID: 1.2.246.777.11.2019.10 v.2.03 RC3 (20.8.2020) | Potilastiedon arkiston Medical Records. Muutoshistoria on eritelty dokumentin versiohistoria kohdassa. | V2.03 RC3 sis. Kelan tekemiä päivityksiä. |
| Potilastiedon arkiston CDA R2 Header (zip) OID: 1.2.246.777.11.2015.38 v.4.66 (2.12.2015) v.4.66.1 (15.5.2019) v.4.66.2 RC3 (20.8.2020) | CDA R2 Header sisältää CDA dokumentin kuvailu eli metatiedot, joita käytetään Suomessa ensisijaisesti asiakirjahallintoon. Tässä dokumentissa kuvataan CDA R2 Headerin tietojen käyttö Suomessa. | Dokumentti hyväksytty HL7 TC:n ja Kelan taholta. V4.66, v4.66.1 ja v.4.66.2 RC3 sis. Kelan tekemiä päivityksiä. |
| Potilastiedon arkisto -määritykset - 2014 tietosisältö | ||
|---|---|---|
| Kanta – Rokotustiedot V1.10 31.1.2012, OID: 1.2.246.777.11.2012.5 | Paketti sisältää kansallisesti määriteltyihin ydintietoihin liittyvälle rokotustiedolle CDA R2 -rakenteen. | 24.1.2012, HL7 teknisen komitean sekä Kelan hyväksymä. |
| Kanta – eArkiston Kertomus ja lomakkeet V4.68
| Sisältää kertomustietojen siirron ja säilytyksen CDA R2-muodon ja rakenteen sekä kertomuksen lomakkeet | HL7 teknisen komitean sekä Kelan hyväksymä. |
| OpenCDA2009 – Laboratoriovastaukset v. 3.9 15.9.2009, OID: 1.2.246.777.11.2009.4 | Kliinisen kemian ja mikrobiologian määräyksien/tilauksien ja tutkimustuloksien CDA R2- rakenne | Hyväksytetty HL7-lausuntokierroksella 15.9.2009, HL7 tekninen komitea |
| Kanta – Kuvantamisen CDA R2-rakenne V1.22 12.9.2013, OID: 1.2.246.777.11.2013.16 | Kanta kuvantamisen CDA R2 asiakirjarakenteet | Päivitetty: 13.9.2013, HL7 tekninen komitea & Kela hyväksymä. |
| Kanta – Lääkityksen merkintöjen CDA R2-rakenne V4.31 8.4.2014 OID: 1.2.246.777.11.2014.11 | Lääkityksen merkintöjen CDA R2-rakenne | Päivitetty 11.4.2011 HL7 tekninen komitea & Kela hyväksymä. |
| Potilastiedon arkisto, Vanhojen potilasasiakirjojen arkistointi: aineiston tekniset vaatimukset V1.22 8.8.2018 OID: 1.2.246.777.11.2018.8 | Potilastiedon arkistoon tallennetavan vanhan aineiston tekniset määrittelyt ja esimerkit. Kokonaisuus ei sisällä perusjärjestelmän toiminnallisuuksien määrittelyä. | Alunperin hyväksytetty HL7-lausuntokierroksella 26.12.2013. 5.8.2014, pakettiin lisätty HUS:lta saadut esimerkkiasiakirjat. 28.4.2015, korjattu Metatieto hl7fi:typeCode:n koodiston OID vastaamaan koodistopalvelua. Tarkennettu PDF/A -muotoisen aineiston kokoamisen vaatimuksia 19.1.2017. Määritystä tarkennettu ja laajennettu koskemaan kaikkea Potilastiedon arkistoon toimitettavaa vanhaa aineistoa. Katselmoitu 28.3.2018 tietojärjestelmätoimittajien kanssa. |
| Tulevat Potilastiedon arkiston määritykset | ||
|---|---|---|
| Ajanvarausasiakirjan HL7 CDA R2 –soveltamisopas Versio 1.00 RC1, 21.1.2020, OID: 1.2.246.777.11.2020.1 | Määrittely kuvaa ajanvarausasiakirjan tuottaja- ja ajanvarausasiakirjan hyödyntäjä-roolissa toimivien tietojärjestelmien HL7 CDA R2 rajapinnan potilastiedon arkistoon. | Määrittelyn v1.00 sisältö on hyväksytty HL7 Finland standardiksi 23.1.2020. Versio 1.00 on julkaistu Release Candidate 1 (RC1) statuksella. Lopullinen versio julkaistaan, kun sisältöä tuottavia järjestelmiä on saatu testattua ja palaute testauksesta on saatu huomioitua määrittelyssä. |
| Sähköinen lääkemääräys -määritykset Reseptikeskukseen tallennettavien asiakirjojen määrittelyiden versiointikäytännöt (pdf) | |
|---|---|
| Reseptin määrittelyt (zip) V4.00 RC2 | 17.8.2020: Päivitetty versio 4.00 RC2, johon lisätty 3.63 tehdyt päivitykset (TotalAmount tietotyyppi). 3.7.2020: Julkaistu versio 4.00 RC2, johon lisätty 3.63 tehdyt päivitykset, sekä korjattu erityislupavarauksen ja erityislupavarauksen purun effectiveTimeä. Päivitetty esimerkkipakettia ja lisätty lääkemääräyksen korjauksen esimerkki. 31.3.2020: Versioon 4.00 on päivitetty rakenteinen annostus ja Lääketietokannan muutokset. Muutokset kohdistuvat erityisesti lääkemääräyksen body-osaan. Versio 4.00 on julkaistu Release Candidate 1 (RC1) statuksella. Lopullinen versio julkaistaan, kun sisältöä tuottavia järjestelmiä on saatu testattua ja palaute testauksesta on saatu huomioitua määrittelyssä. Hyväksytty 26.3.2020 HL7 teknisessä komiteassa. |
| Rajat ylittävän reseptin MR-määrittelyt (zip) V1.3 | Kelan tekemä Rajat ylittävän reseptin MR-määrittelyt, jotka pohjautuvat Reseptin määrittelyihin (V3.62). Lisätty ulkomaalaisten reseptien esimerkkejä. |
| Liite: Rajat ylittävän reseptin poikkeavuudet kansallisista sähköisen reseptin CDA R2 -määrittelyistä V1.1 | Kelan tekemä määrittely Rajat ylittävän reseptin CDA R2 -määrittelyjen poikkeavuuksista Reseptin määrittelyistä (V3.62). Yhdistetään jatkossa osaksi Reseptin määrittelypakettia. |
| Reseptin määrittelyt (zip) V3.63 | Kelan tekemät päivitykset Reseptin HL7-rajapintoihin. 17.8.2020: Päivitetty MR-scheman TotalAmountin tietotyyppiä. 17.6.2020: Lisätty alaikäisen puolesta-asioinnin authorization rakenteen tunnistava templateId header-määrittelyihin ja esimerkkiin. |
| Rajat ylittävän reseptin MR-määrittelyt V1.2 7.12.2018 | Kelan tekemät Rajat ylittävän reseptin MR-määrittelyt, jotka pohjautuvat Reseptin määrittelyihin (V3.50). |
| Rajat ylittävän reseptin MR-määrittelyt V1.1 22.8.2018 | Kelan tekemät Rajat ylittävän reseptin MR-määrittelyt, jotka pohjautuvat Reseptin määrittelyihin (V3.50). HL7 Teknisen komitean hyväksymä. Esimerkkejä tullaan julkaisemaan lisää myöhemmin. 22.8.2018: Lisätty reseptiasiakirjahaun esimerkkisanoma. |
| Rajat ylittävän reseptin MR-määrittelyt V1.0 7.5.2018 | Kelan tekemät Rajat ylittävän reseptin MR-määrittelyt, jotka pohjautuvat Reseptin määrittelyihin (V3.50). HL7 Teknisen komitean hyväksymä. Esimerkkejä tullaan julkaisemaan lisää myöhemmin. |
| Liite: Rajat ylittävän reseptin poikkeavuudet kansallisista sähköisen reseptin CDA R2 -määrittelyistä V1.0 30.4.2018 | Kelan tekemä määrittely Rajat ylittävän reseptin CDA R2 -määrittelyjen poikkeavuuksista Reseptin määrittelyistä (V3.50). HL7 Teknisen komitean hyväksymä. Yhdistetään jatkossa osaksi Reseptin määrittelypakettia. Esimerkit julkaistaan myöhemmin. |
| Reseptin määrittelyt V3.50 Voimassa oleva versio | Kelan tekemät päivitykset Reseptin HL7-rajapintoihin. |
| Sähköisen lääkemääräyksen määrittelyt V3.42 15.10.2016 | Kelan tekemät päivitykset sähköisen lääkemääräyksen HL7-rajapintoihin. |
| Sähköisen lääkemääräyksen esimerkit V3.42 14.2.2017 | Kelan tekemät päivitykset sähköisen lääkemääräyksen CDA-esimerkkeihin |
| Sähköisen lääkemääräyksen määrittelyt V3.30 Lain muutosten 2. vaiheen muutoshallinnan tarkennetut määrittelyt. Määrittelyiden mukaisia muutoksia ei saa viedä tuotantoon ennen yhteistä aikataulua. | Kelan tekemät päivitykset sähköisen lääkemääräyksen HL7-rajapintoihin. |
| Sähköisen lääkemääräyksen määrittelyt V3.1 06.3.2014 | Kelan tekemät päivitykset sähköisen lääkemääräyksen HL7-rajapintoihin. |
| Sähköisen lääkemääräyksen määrittelyt V3.0 30.8.2011 | Kelan tekemät päivitykset sähköisen lääkemääräyksen HL7-rajapintoihin. |
| Sosiaalihuollon asiakastiedon arkiston määritykset | |
|---|---|
| Medical Records -sanomat V3.3 | Määrittelyn sisältö on hyväksytty HL7 Finland standardiksi. |
| Medical Records -sanomat V3.2 Määrittely kuvaa Sosiaalihuollon asiakastiedon arkiston viestinvälitysrajapinnan ja käytettävät arkistosanomat. Muutoshistoria on eritelty dokumentin versiohistoria kohdassa. | Määrittelyn sisältö on hyväksytty HL7 Finland standardiksi. |
| Medical Records -sanomat V3.1 Määrittely kuvaa Sosiaalihuollon asiakastiedon arkiston viestinvälitysrajapinnan ja käytettävät arkistosanomat. Muutoshistoria on eritelty dokumentin versiohistoria kohdassa. | Määrittelyn sisältö on hyväksytty HL7 Finland standardiksi. |
| Medical Records -sanomat V3.0 Määrittely kuvaa Sosiaalihuollon asiakastiedon arkiston viestinvälitysrajapinnan ja käytettävät arkistosanomat. Muutoshistoria on eritelty dokumentin versiohistoria kohdassa. | Määrittelyn sisältö on hyväksytty HL7 Finland standardiksi. |
| Medical Records -sanomat V2.9 Määrittely kuvaa Sosiaalihuollon asiakastiedon arkiston viestinvälitysrajapinnan ja käytettävät arkistosanomat. Muutoshistoria on eritelty dokumentin versiohistoria kohdassa. | Määrittelyn sisältö on hyväksytty HL7 Finland standardiksi. |
| Medical Records -sanomat V2.8 Määrittely kuvaa Sosiaalihuollon asiakastiedon arkiston viestinvälitysrajapinnan ja käytettävät arkistosanomat. Muutoshistoria on eritelty dokumentin versiohistoria kohdassa. | Määrittelyn sisältö on hyväksytty HL7 Finland standardiksi. |
| Medical Records -sanomat V2.4 Määrittely kuvaa Sosiaalihuollon asiakastiedon arkiston viestinvälitysrajapinnan ja käytettävät arkistosanomat. Muutoshistoria on eritelty dokumentin versiohistoria kohdassa. | Määrittelyn sisältö on hyväksytty HL7 Finland standardiksi. |
| Medical Records -sanomat V2.3 Määrittely kuvaa Sosiaalihuollon asiakastiedon arkiston viestinvälitysrajapinnan ja käytettävät arkistosanomat. Muutoshistoria on eritelty dokumentin versiohistoria kohdassa. | Määrittelyn sisältö on hyväksytty HL7 Finland standardiksi. |
| Medical Records -sanomat V2.1 Määrittely kuvaa Sosiaalihuollon asiakastiedon arkiston viestinvälitysrajapinnan ja käytettävät arkistosanomat. Muutoshistoria on eritelty dokumentin versiohistoria kohdassa. | Määrittelyn sisältö on hyväksytty HL7 Finland standardiksi. |
| Asiakirjastandardi V2.1 Määrittely kuvaa yhtenäisen tiedostotason esitysmuodon sosiaalihuollon asiakirjojen arkistointiin ja siirtämiseen. | Määrittelyn sisältö on hyväksytty HL7 Finland standardiksi. |
| Kanta-palvelujen yhteiset HL7 V3 määritykset | ||
|---|---|---|
| OID: 1.2.246.777.11.2010.30 v2.20 (14.10.2010) v2.20.1 (1.11.2018) | HL7 Finlandin suositus V3-viestien käyttöönottoon | Päivitetty 1.11.2018 Hyväksytty HL7 äänestyskierroksella. 23.9.2008, HL7 Tekninen komitea |
| OID: 1.2.246.777.11.2015.25 v1.41 (25.6.2015) v.1.41.1 (15.5.2019) | Tietotyypit - määrittelydokumentti kuvaa Suomessa käytettävät tietotyypit ja niiden suositellun käyttötavan. | Päivitykset määrityksen versiohistoriassa. Dokumentti hyväksytty HL7 TC:n ja Kelan taholta. V1.41 sis. Kelan tekemiä päivityksiä. |
| Muita oppaita ja määrityksiä | ||
|---|---|---|
| ISO OID-yksilöintitunnuksen käytön kansalliset periaatteet sosiaali- ja terveysalalla versio 1.0 14.2.2007 | Oppaan tavoitteena on selvittää periaatteet, kuinka ISO OID -yksilöintimenettely toteutetaan sosiaali- ja terveydenhuollon sähköisissä järjestelmissä. Opas pohjautuu Stakesin 22.11.2004 julkaiseman ohjeen "ISO OID-tunnuksen käyttö sosiaali- ja terveydenhuollossa versio 1.0 2" pilottikäytön kokemuksiin ja JUHTA- suositukseen 159 "ISO OID -yksilöintitunnuksen soveltaminen julkishallinnossa". | Hyväksytty Koodistopalvelun johtoryhmässä 14.2.2007 |
| Kanta – Notifikaatiosanoma v1.0 HUOM. Tämä on työdokumentti, määrittely ei ole tullut käyttöön Potilastiedon arkistoon. | Notifikaatiosanomamäärittely - Tiivistelmä eArkiston MR-sanomadokumentaatioon siirrettävistä kohdista sekä sanomaa varten määritellyt uudet skeemat. | Hyväksytetty HL7-lausuntokierroksella. |
| Kansallisesti vaadittujen tietojen välittäminen ydin- ja erillisjärjestelmien välillä 28.3.2012 OID: 1.2.246.777.11.2012.1 | Kansallisesti vaadittujen tietojen välittäminen ydin- ja erillisjärjestelmien välillä | 2.4.2012, HL7 tekninen komitea. |
Kanta HL7 HelpDesk-kysymysten yhteenvetodokumenttien arkisto
- Kanta HL7 HelpDeskin kysymykset ja vastaukset 2014 (pdf), päivitetty 9.4.2014
- Kanta HL7 HelpDeskin kysymykset ja vastaukset 2013 (pdf), päivitetty 17.1.2014
- Kanta HL7 HelpDeskin kysymykset ja vastaukset 2012 (pdf, 237 kt)
- Kanta HL7 HelpDeskin kysymykset ja vastaukset 2011 (pdf, 469 kt)
- Kanta HL7 HelpDeskin kysymykset ja vastaukset 2010 (pdf, 118 kt)