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. |