Operaatio $get-history-medications

Lääkkeen historiahaku

Lääkkeen historiahakuoperaation pyynnössä välitetään kyselyparametrit Parameters resurssissa ja vastauksessa palautetaan Bundle resurssi, joka sisältää lääkemääräyksen sisältäviä MedicationRequest resursseja lääkemääräyskohtaisesti. Yksi MedicationRequest resurssi sisältää yhden lääkemääräyksen tietoja, vastauksessa palautuu myös resurssista viittattuja resursseja (Patient, Medication, PractitionerRole, Basic). Lääkkeen tiedot tulevat Medication ja MedicationKnowledgessä. Lääkkeen määrääjän, lopettajan, käsittelijän ja lääketoimituksen kirjaajan tiedot (Practitioner, Provenance, Organization, PractitionerRole).

Lisäksi MedicationRequest resurssilla palautetaan pakottamisen tai potilaan antamien virheellisten tietojen takia tai hoidollisella syyllä mitätöityjen lääkemääräysten tiedot. Näistä ei palauteta muuta kuin lääkemääräykset.

MedicationRequest resurssia käytetään myös lääkkeen lopettamismerkinnän esittämiseen. Yksi MedicationRequest resurssi sisältää myös lopetettujen lääkkeiden tietoja. Lopetetulla lääkkeellä tarkoitetaan lääkejatkumoa, johon asetettu lääkkeen lopetuspäivä (lopettamismerkintä) on menneisyydessä.

Basic resurssia käytetään uusimipyynnön ja sen vastauksen tietojen esittämiseen. Uusimipyyntöjen tiedot palautuvat, jos lääkemääräyksen uusimistila on "käsittelemätön", "tallennettu" tai "vanhentunut". Basic resurssia käytetään myös lukituksen ja eri varauksien tietojen esittämiseen.

Bundle resurssi sisältää myös MedicationDispense resursseja toimituskohtaisesti. Yksi MedicationDispense resurssi sisältää jatkumon uusimman toimitusmerkinnän tietoja, resurssissa viitataan siihen lääkemääräykseen mihin toimitusmerkintä liittyy (viittaus lääkemääräyksen OID:n).

Yllä olevista resursseista on profiloitu seuraavasti:

Resurssi	Profiili	Selite
MedicationRequest	MedicationListMedicationrRequest	Lääkemääräys
MedicationRequest	MedicationListDiscontinuationMedicationRequest	Lopettamismerkintä
Medication	MedicationListMedication	Lääkkeen tiedot
Medication	MedicationListMedicationKnowledge	Lääkkeen tiedot

Operaation osoite (URL)

Täydentyy myöhemmin.

Lääkkeen historiahaun kyselyparametrit

Alla olevassa taulukossa on kuvattu potilastieto- ja apteekkijärjestelmien REST hakuoperaatiossa käytettävät kyselyparametrit. Kyselyparametrit on määritelty käyttäen Parameters resurssia.

Kyselyparametri	Parameter.value[x]	Pakollisuus	FHIR esimerkki	Selite
medicineIdId	valueIdentifier 1..n	P	{ "resourceType": "Parameters", "parameter": [ { "name": "medicineId", "valueIdentifier": { "system": "urn:ietf:rfc:3986", "value": "1.2.246.10.11111111.93001.2023.11685363591384123.0" } } ] }	Käytössä olevan lääkkeen tunniste. Haussa on mahdollista antaa max 50 käytössä olevan lääkkeen tunnistetta kerrallaan
authoredOn	valuePeriod 0..1	P	{ "resourceType": "Parameters", "parameter": [ { "name": "authoredOn", "valuePeriod": { "start": "2021-02-20", "end": "2021-02-22" }} ] }	Lääkemääräykset tietyltä aikaväliltä määräyspäivän mukaan, oletus: palautuu kaikki lääkemääräykset, jos aikaväliä ei ole annettu. Enimmäishakuaika on 36 kuukautta.
latestDispenseOnly	Boolean 1..1	P	{ "resourceType": "Parameters", "parameter": [ { "name": "latestDispenseOnly", "valueBoolean": true } ] }	Lääkemääräyksen uusin toimitusmerkintä (=true) tai kaikki toimitusmerkinnät (false).