Reseptin HL7-rajapintamäärittelyt

Sivulla kerrotaan reseptiin liittyvistä HL7-rajapintamäärittelyistä. Taulukkoon on koottu voimassa olevat sekä tulevat versiot. Lisäksi sivulta löytyy reseptin rajapintakuvaus.

Muuttuneet HL7-rajapintamäärittelyt julkaistaan aina omana pakettinaan.

Sähköisen lääkemääräysten määrittelyjen vanhentuneet RC-versiot löydät omalta sivulta:

Määrittelyjen voimassaolo

  • ”Voimassa sertifioinnissa” kertoo, millä aikavälillä järjestelmän yhteistestaus, tietoturvallisuuden arviointi tai vaatimustenmukaisuuden uusiminen tehdään kyseisen version mukaisesti.
  • ”Voimassa tuotantokäytössä” kertoo, millä aikavälillä tuotannossa olevat järjestelmät saavat toimia kyseisen version mukaisesti.
  • Lisätietoja voimassaoloajoista (thl.fi)(avautuu uuteen ikkunaan)
Taulukko: Sähköisen lääkemääräyksen HL7-rajapintamäärittelyt. Päivitetty 29.4.2026.
Määrittelyn nimi ja versio Muutokset edelliseen versioon Voimassa sertifioinnissa Voimassa tuotantokäytössä

versio 5.0.0_RC6, julkaistu 29.4.2026

Kanta-lääkityslistan HL7-rajapintamäärittelyt v5.0.0 RC6 (zip)(avautuu uuteen ikkunaan)

Kanta-lääkityslistan HL7-rajapintamäärittelyn tracking dokumentit V5.0.0 RC1 - RC6 (zip)(avautuu uuteen ikkunaan)

Tarkennettu etenkin roolitietojen tuomista lääkemääräyksen Headerissa. Tarkennuksia myös Lääkemääräyksen sanomat dokumenttiin sekä korjauksia esimerkkeihin. Medical Records-dokumenttiin ei tullut lainkaan muutoksia.

HL7 määrittelyversio v5.0.0 RC6 sisältää samat muutokset kuin HL7 määrittelyversio v5.0.0 RC1, RC2, RC3, RC4 ja RC5 mutta tracking -versiossa RC6:ssa näkyy vain ne muutokset, jotka ovat erona RC5 -versioon. 

V5.0.0 RC1 - RC6 tracking määrittelydokumentit ovat koottu omaan zip-kansioonsa. Dokumenteissa on on trackingillä kaikki muutokset, joita on tehty version 5.0.0 rajapintamäärittelydokumentaatioon verrattuna versioon 4.3.0.

Q1/2025 alkaen 6.2.2027 alkaen

Versio 4.3.0, julkaistu 20.9.2024

Reseptin HL7-rajapintamäärittelyt 4.3.0 (zip)(avautuu uuteen ikkunaan)

Paketti 4.3.0 on Kanta-lääkityslistalle eteenpäin yhteensopiva versio. Lisätty LocalHeaderiin lopettamismerkinnältä palautuvia tietoja sekä määrätyn lääkkeen osatunnisteen ohjeistusta. Q1/2025 alkaen - 6.2.2027 asti

6.2.2027 alkaen  - 30.9.2027 asti

Versio 4.2.1, julkaistu 23.1.2024

Reseptin HL7-rajapintamäärittelyt 4.2.1 (zip)(avautuu uuteen ikkunaan)

  6.2.2027 asti 30.9.2027 asti

Versio 4.1.1, julkaistu 27.2.2023

Reseptin HL7-rajapintamäärittelyt 4.1.1 (zip)(avautuu uuteen ikkunaan)

  6.2.2027 asti 30.9.2027 asti

Versio 4.0.1, julkaistu 21.12.2022

Reseptin HL7-rajapintamäärittelyt v4.0.1 PATCH.(zip)

  6.2.2027 asti 30.9.2027 asti

Versio 4.00, julkaistu 1.5.2022

Reseptin HL7-rajapintamäärittelyt v4.00 (zip)(avautuu uuteen ikkunaan)

Kanta-lääkityslista (vaihe 1) rakenteinen annostus 6.2.2027 asti 30.9.2027 asti

Versio 3.63, julkaistu 17.8.2020

Reseptin HL7- rajapintamäärittelyt v3.63 (zip)(avautuu uuteen ikkunaan)

  30.9.2023 asti 30.9.2023 asti

Versio 3.5, julkaistu 7.9.2017

Reseptin HL7-rajapintamäärittelyt v.3.50 (zip)(avautuu uuteen ikkunaan)

  30.9.2023 asti 30.9.2023 asti

Versio 3.42, julkaistu 15.10.2016

Reseptin HL7-rajapintamäärittelyt v.3.42 (zip)(avautuu uuteen ikkunaan)

  30.9.2023 asti 30.9.2023 asti

Reseptin rajapintakuvaus