Operaatio $get-old-prescriptions
Historiahaku ilman käytössä olevan lääkkeen tunnisteita
Historiahaku ilman käytössä olevan lääkkeen tunnisteita hakuoperaation 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).
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 | MedicationListMedicationRequest | Lääkemääräyksen tiedot |
MedicationDispense | MedicationListMedicationRequest | Lääketoimituksen tiedot |
Medication | MedicationListMedication | Lääkkeen tiedot |
MedicationKnowledge | MedicationListMedicationKnowledge | Lääkkeen tiedot |
MedicationRequest | MedicationListDiscontinuationMedicationRequest | Lääkkeen lopettamismerkinnnän tiedot |
Patient | MedicationListPatient | Potilaan tiedot |
Patient | MedicationListPatient | Potilaan tiedot |
Practitioner, Provenance, Organization, PractitionerRole | MedicationListPractitioner, MedicationListProvenance, MedicationListOrganization, MedicationListPractitionerRole | Lääkkeen määrääjän ja muiden lääkemääräyksen käsittelijöiden tiedot |
Basic | MedicationListRenewalBasic | Uusimispyynnön ja uusimispyynnön käsittelyn tiedot |
Basic | MedicationListStatusBasic | Lukituksen ja varauksien tiedot |
Operaation osoite (URL)
Täydentyy myöhemmin.
Historiahaku ilman käytössä olevan lääkkeen tunnisteita 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 |
---|---|---|---|---|
patientIdentifier | valueIdentifier 1..1 | P | { "resourceType": "Parameters", "parameter": [ { "name": "patientIdentifier", "valueIdentifier": { "system": "urn:oid:1.2.246.21", "value": "030875-999Y" } }, { "name": "patientIdentifier", "valueIdentifier": { "system": "urn:oid:1.2.246.21", "value": "120385-123P" }} ] } | Henkilötunnus - haetaan tietyn potilaan lääkemääräykset, joissa ei ole käytössä olevan lääkkeen tunnnisteita |
authoredOn | valuePeriod 0..1 | V | { "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). |
category | coding 0..n Pakollinen apteekkijärjestelmille ja sairaala-apteekeille | EP | { "resourceType": "Parameters", "parameter": [ { "name": "category", "valueCoding": { "system": "urn:oid:1.2.246.537.6.605.2014", "code": "1" }} ] } | Koodisto: THL - Reseptin laji - 1.2.246.537.6.605.2014 (1 = Resepti, 2 = Sairaala-apteekkiresepti, 3 = Ulkomaanresepti), jos parametria ei ole annettu palautuu kaikkien reseptilajien lääkemääräykset |