MetaDataMedicationRequest

MetaDataMedicationRequest profiilia käytetäään Lääkemääräyksen yksilöintitietojen hakuoperaation vastauksessa ja siihen on profiloitu palautettavat Lääkemääräyksen yksilöintitiedot.

Kanta-lääkityslistan siirtymävaiheeseen on MetaDataMedicationRequestista profiloitu versio 1.2.0. Siihen on lisätty lääkkeen lopetuksen tietoja, laajennus medicineDiscontinuation, jossa palautuu Lääkkeen lopetuspäivä ja Lääkkeen lopetuksen syy, jos palautettava lääkemääräys liittyy käytössä olevan lääkkeen lääkejatkumoon ja jatkumossa on lopettamismerkintä, jonka lopettamismerkinnäntila on "voimassa" tai "toteutunut". Sekä rajapinnassa palautuu myös Määrätyn määrän esittämistapa = 9 (ei toimitettavaa määrää) tieto ja muita määrättyyn määrään liittyviä tietoja ei palaudu.

Alempana status elementin mappaus kohdassa kerrottu Kanta-lääkityslistan siirtymävaiheessa palautuvat lääkemääräyksen voimassaolotilat.

Määrittelyssä on pyritty noudattamaan mahdollisimman paljon FHIR standardia. Lisäksi on jouduttu tekemään laajennuksia. Tarvittavat laajennukset on kuvattu kootusti omassa osiossaan Laajennukset.

Linkki Simplifierista löytyvään profiilimäärittelyyn:

MedicationRequest.status (Required) ja MedicationRequest.statusReason (Example) tiedot

• MedicationRequest.status tieto on pakollinen tieto MedicationRequest resurssissa. Se on koodattu tieto ja tieto on annettava pakollisella FHIR koodistolla http://hl7.org/fhir/valueset-medicationrequest-status.html.
  • Lääkemääräyksen yksilöintitiedoissa palautettava Voimassolotila -tieto on mapattu tähän tietoon.
  • Voimassaolotila ilmaistaan Kansallisen koodistopalvelun Sähköinen lääkemääräys - Lääkemääräyksen voimassaolontila -koodiston koodeilla.
  • Lääkemääräyksen yksilöintitietojen hakuoperaation vastauksessa on käytettävä FHIR koodiston arvoja ja nämä koodiston arvot on mapattu Voimassaolotila-koodeihin alla olevan taulukon mukaisesti.

Kanta-lääkityslistan siirtymävaiheessa palautuu myös yllä olevien voimassaolotilojen lisäksi päättynyt ja lopetettu voimassaolotilat ja ne on mapattu:

• MedicationRequest.statusReason tieto on optionaalinen MedicationRequest resurssissa ja se on koodattu tieto. Koodattuun tietoon on sallittua sitoa oma koodisto.
  • Lääkemääräyksen yksilöintitiedoissa palautettava Reseptisanoman tyyppi on mapattu tähän tietoon.
  • Reseptisanoman tyyppi ilmaistaan Kansallisen koodistopalvelun Sähköinen lääkemääräys - Reseptisanoman tyyppi -koodiston koodeilla.
  • Tämän koodiston käyttö on kuvattu alla olevan taulukon mukaisesti.

Esimerkki: voimassaolontila 1=voimassa ja reseptisanoman tyyppi 1=lääkemääräys:

"status": "active",
"statusReason": {
    "coding": {
       "system": "urn:oid:1.2.246.537.5.40105.2006",
       "code": "1"
    }

MedicationRequest.dosageInstruction.doseAndRate.dose (doseRange/doseQuantity)

• Yksilöintitietojen palautuksen FHIR-rapapinnassa Dosage.doseAndRate.dose (doseRange/doseQuantity) -elementin tietoa doseRange käytetään kun palautetaan annos, jossa annokseen sisältyvä lääkkeen määrä on annettu lukuvälinä (esim. 1-2 tablettia) ja doseQuantity tietoa käytetään kun palautetaan annos, jossa annokseen sisältyvä lääkkeen määrä on annettu tarkkana lukuna (esim. 1 tabletti).

• Potilasystävällisen ja fysikaalisen annoksen annos ja annosyksikkö palautuvat molemmat yllä mainituissa elementeissä. Ne ovat keskenään vaihtoehtoisia tietoja lääkemääräyksellä, jos potilasystävällinen annos ja annosyksikkö on annettu, silloin fysikaalista annos ja annosyksikköä ei ole voitu antaa.

FHIRssa rakenteisen annostuksen tiedot esitetään toistuvassa MedicationRequest.dosageInstruction rakenteessa.

Vaihtuvat annokset esim. ”2 tablettia aamulla ja 1 tabletti illalla 6 päivän ajan” annetaan toistamalla koko dosageInstruction rakennetta (sequence-toistuma), tätä on käytetty mm. MedicationRequest esimerkissä 2.

FHIR .dosageInstruction toistuman seurauksena osa THL tietosisältömäärittelyn rakenteisen annostuksen tiedoista toistuu per vaihtuva annos. Näitä toistuvia tietoja ovat mm. THL tietosisällön Annostelukausi-rakenteen tiedot toistuvat (paitsi annostus tarvittaessa –tieto) ja myös ylemmän tason rakenteiset tiedot Annostusohje (lääkkeenantoreitti ja –tapa, käyttöohjeen lisätieto) ja Annostustiedot (annostusohje vain tekstinä, tekstimuotoinen annostusohje, sic-merkintä) toistuvat.

Vastaavasti FHIR toistuman seurauksena Annostelukausi tiedot (annostelukauden kesto, annostelukauden alkuaika ja päättymisaika, annosjakson pituus) ja Annoksen tiedot (annosajankohta, annosaika ja annosjakson päivä) toistuvat per vaihtuva annos. Tämä johtuu siitä, että nämä THL tietosisällön tiedot menevät dosageInstruction rakenteen timing elementtiin (joka on tietotyyppiä Timing) ja se ei ole toistuva tieto.

THL:n tietosisällön ja FHIR tietomallin rakenteisen annostuksen erot:

FHIRssa annoksen toistumissa hyödynnetään MedicationRequest.dosageInstruction.timing.frequency ja MedicationRequest.dosageInstruction.timing.frequencyMax elementtejä. FHIRssa esim. ” 1 tabletti 3 kertaa päivässä” ei vaadi saman sisältöisen Annokset rakenteen toistamista kolmea kertaa, vaan toistuma voidaan ilmoittaa yhdellä erillisellä tiedolla. Esimerkissä 1 on käytetty frequency tietoa (”1 tabletti 2 kertaa päivässä) ja esimerkissä 4 on käytetty frequency ja frequencyMax –tietoa (”1-2 tablettia 1 – 3 kertaa päivässä”). Rakenteita frequency ja frequencyMax käytettäessä, ei ole tarvetta toistaa Annokset rakennetta. Mutta tällöin myöskään Annos tarvittaessa tieto ei toistu ja ei siis mene kuten S1 Kirjaa ja muodosta rakenteinen annostusohje –määrittelyssä, jossa ensimmäisessä toistumassa Annos tarvittaessa = false ja muissa toistumissa Annos tarvittaessa = true. Itse asiassa kyseessä S1-määrittelyssä ei ole Annos tarvittaessa tiedosta, että se tulisi annostusohjeelle, vaan tällä ratkaisulla saadaan S1-määrittelyssä tuotettua annostusohjeelle 1-3 kertaa (sama tieto ”Annos tarvittaessa” on siis kahdessa merkityksessä). Jos tarvittaessa tieto on annettava FHIR-rakenteessa per annos, pitäisi se FHIRssa antaa toistamalla MedicationRequest.dosageInstruction rakennetta.

Tämän oppaan osiossa Esimerkit - MedicationRequest on kuvattu erilaiset MetaDataMedicationRequest profiiliin liittyvät esimerkit.

Dosage tietotyyppiin liittyvä Timing ja sen yleiset käyttötarkoitukset on kuvattu Timing yhteenvetotaulukossa.

MedicationRequest resurssin palautumista Bundle-resurssin sisällä sekä viitattujen resurssien palautumista on kuvattu tämän oppaan osiossa Vastauksen HTTP body