Reseptin FHIR -rajapintamäärittelyt

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

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)

Lääkemääräyksen yksilöintitietojen palautuksessa tarvittavat FHIR resurssien määrittelyt julkaistaan Reseptin Simplifier.net -alustalla.

Määrittelyiden kommentointi tapahtuu FHIRin keskustelupalstalla (chat.fhir.org)(avautuu uuteen ikkunaan)

Taulukko: Sähköisen lääkemääräyksen FHIR-rajapintamäärittelyt. Päivitetty 27.4.2026.
Määrittelyn nimi ja versio Muutokset edelliseen versioon Voimassa sertifioinnissa Voimassa tuotantokäytössä

versio 1.0.0 rc5

julkaistu 1.4.2026

Kanta-lääkityslistan FHIR -rajapintamäärittelyt(avautuu uuteen ikkunaan)

Lisätty mm.

  • lisätty meta.tag -tietoon CDA R2 Header templateId (määrittelypaketin versio), MedicationRequest, MedicationDispense, MedicationRequest (lop.merkintä) ja Basic (renewal ja status) -resursseihin ja näihin resursseihin liittyviä esimerkkejä päivitetty ko. tiedolla
  • lisätty MedicationRequest.dispenseRequest.validityPeriod.start -tietoon reseptin voimassaolon alkupäivä, jos lääkkeen määrääjä on rajoittanut lääkemääräyksen voimassaoloaikaa
 04/2025

6.2.2027 alkaen

 

versio 1.0.0 rc4

julkaistu 24.2.2026

Kanta-lääkityslistan FHIR -rajapintamäärittelyt(avautuu uuteen ikkunaan)

 

Lisätty mm.

  • Invalidation -laajennokseen invalidationReasonCode tieto, sillä lääkemääräyksen mitätöinnin syy voi versiossa 4 olla myös kooditietona
  • esimerkkejä päivitetty mm. muutettu Lääkevaihtokielto -tietoa ja Reseptin voimassaolon loppupäivän muotoa, että se palautuu päivämäärän tarkkuudella (YYYY-MM-DD) esimerkkeihin MedicationRequest, Perushaku_Bundle ja Perushaku_Parameters_Bundle
 Ei käytössä Ei käytössä

versio 1.0.0 RC3

julkaistu 17.10.2025

Kanta-lääkityslistan FHIR -rajapintamäärittelyt(avautuu uuteen ikkunaan)

Lisätty mm.

  • MedicationListMedicationRequest profiiliin separateReport.separateReportText laajennos, jossa palautuu erillisselvitys tekstimuotoisena
  • esimerkkejä päivitetty myös mm. poistettu comment- tiedot.
 Ei käytössä Ei käytössä

versio 1.0.0 RC2

julkaistu 16.4.2025

Kanta-lääkityslistan FHIR -rajapintamäärittelyt(avautuu uuteen ikkunaan)

Lisätty mm.

  • Tietosisällöt kohtaan lisätty miten QR-koodi muodostetaan tulosteille
  • lisätty MedicationListMedicationDispense profiiliin authorizingPrescription.prescriptionSetId laajennos, jossa palautuu lääkemääräyksen setId sekä tähän liittyviä esimerkkejä päivitetty
 Ei käytössä Ei käytössä 

versio 1.0.0 RC1

julkaistu 24.2.2025

Kanta-lääkityslistan FHIR -rajapintamäärittelyt(avautuu uuteen ikkunaan)

Lisätty mm.

  • tulostehaun sekä erikoishaun anjassa palautuvat tiedot
  • tieto perushaun yhteydessä palautuvien ilman käytössä olevien lääkkeiden tunnisteita palautuvista tiedoista

 

 Ei käytössä Ei käytössä
FHIR yksilöintitietojen haun rajapinta       

versio 1.2.0 

julkaistu 24.2.2025

FHIR yksilöintitietojen rajapinta(avautuu uuteen ikkunaan)

Lisätty Kanta-lääkityslistan eteenpäin yhteensopivuuden vaatimat muutokset

  • lääkemääräyksen uudet voimassaolotilat
  • mitätöinnin uudet tyypit
  • rakenteisen annostuksen antoreitin puolisuus
 02/2025  30.9.2027 asti 

versio 1.0, julkaistu 1.5.2022

Reseptin Simplifier-projekti (FHIR Rest API rajapinnat)(avautuu uuteen ikkunaan)

Kanta-lääkityslistan (vaihe 1, rakenteinen annostus) ensimmäinen versio yksilöintitietojen rajapinnasta.

Määrittelypakettiin v3.00 liittyvään HL7-määrittelypakettiin v4.00 tarjotaan HL7 FHIR-standardiin perustuva yksilöintitietojen hakuun uusi rajapinta rakenteisen annostuksen ja muille uusille tietosisällöille sisältäen myös kaikki nykyiset yksilöintitiedoissa palautettavat tiedot. Vanhalla yksilöintitietojen haulla uusia tietosisältöjä ei palauteta.

 6.2.2027 asti 30.9.2027 asti 
Sivua päivitetty 27.4.2026