Operaatio $get-custom-data

Lääkityslistan erikoishaku

Lääkityslistan erikoishakuoperaation pyynnössä välitetään kyselyparametrit Parameters (tarkentuu myöhemmin käytetäänkö tätä resurssia vai OperationDefinition resurssia) 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).

Haulla on mahdollista hakea

  • apteekin omien annosjakelupotilaiden uudet lääkemääräykset sekä omien annosjakeluvarattujen lääkemääräysten korjausten, mitätöinnin ja lopetuksen tietoja
  • apteekin omien uusimispyyntöjen käsittelyn tilannetta
  • PKV- ja huumausainelääkemääräyksiä, kun potilaalle ollaan määräämässä vastaavaa lääkettä
  • henkilön määräämiä omia lääkemääräyksiä

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ääkityslistan erikoishaun kyselyparametrit

Alla olevassa taulukossa on kuvattu REST hakuoperaatiossa käytettävät kyselyparametrit, kun apteekki hakee omien uusimispyyntöjen käsittelyn tilannetta tietyltä aikaväliltä. Kyselyparametrit on määritelty käyttäen Parameters resurssia. Hakua käyttää vain apteekkijärjestelmät.

Kyselyparametri Parameter.value[x] Pakollisuus FHIR esimerkki Selite
representedOrganizationId valueIdentifier 1..1 P { "resourceType": "Parameters", "parameter": [ { "name": "representedOrganizationId", "valueIdentifier": { "system": "urn:ief:rfc:3986", "value": "urn:oid:1.2.246.10.8182355.10.1" }} ] } Apteekin OID
clinicalDocumentEffectiveTime valuePeriod 0..1 P { "resourceType": "Parameters", "parameter": [ { "name": "clinicalDocumentEffectiveTime", "valuePeriod": { "start": "2021-02-20", "end": "2021-02-22" }} ] } Asiakirjan luontiaika
statusReason coding 1..1 P { "resourceType": "Parameters", "parameter": [ { "name": "statusReason", "valueCoding": { "system": "urn:oid:1.2.246.537.5.40105.2006", "code": "8" }} ] } Reseptisanoman tyyppi, oltava aina 8 (uusimispyyntö)

Alla olevassa taulukossa on kuvattu REST hakuoperaatiossa käytettävät kyselyparametrit, kun apteekki hakee tietoja omien annosjakelupotilaiden uusista lääkemääräyksistä sekä omien annosjakeluvarattujen lääkemääräysten korjauksista, mitätöinneistä ja lopetuksista. Kyselyparametrit on määritelty käyttäen Parameters resurssia. Hakua käyttää vain apteekkijärjestelmät.

Kyselyparametri Parameter.value[x] Pakollisuus FHIR esimerkki Selite
representedOrganizationId valueIdentifier 1..1 P { "resourceType": "Parameters", "parameter": [ { "name": "representedOrganizationId", "valueIdentifier": { "system": "urn:ief:rfc:3986", "value": "urn:oid:1.2.246.10.8182355.10.1" }} ] } Apteekin OID
clinicalDocumentEffectiveTime valuePeriod 0..1 P { "resourceType": "Parameters", "parameter": [ { "name": "clinicalDocumentEffectiveTime", "valuePeriod": { "start": "2021-02-20", "end": "2021-02-22" }} ] } Asiakirjan luontiaika, hakuaika rajattu 14 vrk kuluvasta päivästä taaksepäin
statusReason coding 1..1 P { "resourceType": "Parameters", "parameter": [ { "name": "statusReason", "valueCoding": { "system": "urn:oid:1.2.246.537.5.40105.2006", "code": "2" }} ] } Dokumenttityypiksi annetaan koodit 1, 2, 3 tai 23
patientIdentifier valueIdentifier 1..1 P { "resourceType": "Parameters", "parameter": [ { "name": "patientIdentifier", "valueIdentifier": { "system": "urn:oid:1.2.246.21", "value": "120385-123P" }} ] } Henkilötunnus, kerralla voi antaa enintään 20 potilaan henkilötunnukset

Alla olevassa taulukossa on kuvattu lisäksi REST hakuoperaatiossa käytettävä kyselyparametri, jolla haetaan PKV- ja huumausainelääkemääräyksiä, kun potilaalle ollaan määräämässä vastaavaa lääkettä. Hakua käyttää vain potilastietojärjestelmät.

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": "120385-123P" }} ] } Henkilötunnus
specialQueryCode part 0..1 { "resourceType": "Parameters", "parameter": [ { "name": "specialQueryCode", "part": [ { "name": "code", "valueCoding": { "system": "urn:oid:1.2.246.537.5.40187.2011", "code": "2" } }, { "name": "value", "valueCoding": { "system": "urn:oid:1.2.246.537.5.40118.2006", "code": "H" } }, { "name": "value", "valueCoding": { "system": "urn:oid:1.2.246.537.5.40118.2006", "code": "P" } },{ "name": "value", "valueCoding": { "system": "urn:oid:1.2.246.537.5.40118.2006", "code": "Z" } },{ "name": "value", "valueCoding": { "system": "urn:oid:1.2.246.537.5.40118.2006", "code": "PA" } },{ "name": "value", "valueCoding": { "system": "urn:oid:1.2.246.537.5.40118.2006", "code": "ZA" } } ] } ] } PKV- ja huumausainelääkemääräysten haku, kun potilaalle ollaan määräämässä vastaavaa lääkettä. Palautuu kaikki PKV- ja huumausainelääkemääräykset kielloista huolimatta. Sähköinen lääkemääräys - Huumausaine / PKV lääkemääräys -koodisto 1.2.246.537.5.40118.2006 ja KanTa-palvelut - Sisäisen hakukysely -koodisto 1.2.246.537.5.40187.2011.
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 päivän tarkkuudella.

Alla olevassa taulukossa on kuvattu lisäksi REST hakuoperaatiossa käytettävä kyselyparametri, kun haetaan tietyn henkilön määräämiä lääkemääräyksiä. Hakua käyttää vain potilastietojärjestelmät.

Kyselyparametri Parameter.value[x] Pakollisuus FHIR esimerkki Selite
patientIdentifier valueIdentifier 1..1 EP { "resourceType": "Parameters", "parameter": [ { "name": "patientIdentifier", "valueIdentifier": { "system": "urn:oid:1.2.246.21", "value": "120385-123P" }} ] } Henkilötunnus
assingAuthorId valueIdentifier 1..1 P { "resourceType": "Parameters", "parameter": [ { "name": "assingAuthorId", "valueIdentifier": { "system": "urn:oid:1.2.246.537.25", "value": "123456" }} ] } Lääkkeen määrääjän yksilöintitunnus (SV-numero)
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 päivän tarkkuudella.