Finnish Implementation Guide for SMART App Launch
2.0.0-rc2 - ballot

Publication Build: This will be filled in by the publication tooling

## Resource Profile: FiSMARTMedicationStatement - Mappings

Draft as of 2025-05-11

Mappings for the fi-smart-medication-statement resource profile.

### Mappings for Workflow Pattern (http://hl7.org/fhir/workflow)

FiSMARTMedicationStatement
MedicationStatement | Event
identifier | Event.identifier
basedOn | Event.basedOn
partOf | Event.partOf
status | Event.status
statusReason | Event.statusReason
medication[x] | Event.code
medication[x] (medicationReference) | Event.code
subject | Event.subject
context | Event.context
effective[x] | Event.occurrence[x]
reasonCode | Event.reasonCode
reasonReference | Event.reasonReference
note | Event.note

### Mappings for RIM Mapping (http://hl7.org/v3)

FiSMARTMedicationStatement
MedicationStatement | Entity. Role, or Act, SubstanceAdministration
text | Act.text?
contained | N/A
extension | N/A
modifierExtension | N/A
identifier | .id
basedOn | .outboundRelationship[typeCode=FLFS].target[classCode=SBADM or PROC or PCPR or OBS, moodCode=RQO orPLAN or PRP]
partOf | .outboundRelationship[typeCode=COMP]/target[classCode=SPLY or SBADM or PROC or OBS,moodCode=EVN]
status | .statusCode
statusReason | .inboundRelationship[typeCode=SUBJ].source[classCode=CACT, moodCode=EVN].reasonCOde
category | .inboundRelationship[typeCode=COMP].source[classCode=OBS, moodCode=EVN, code="type of medication usage"].value
medication[x] | .participation[typeCode=CSM].role[classCode=ADMM or MANU]
medication[x] (medicationReference) | .participation[typeCode=CSM].role[classCode=ADMM or MANU]
subject | .participation[typeCode=SBJ].role[classCode=PAT]
context | .inboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN, code="type of encounter or episode"]
effective[x] | .effectiveTime
dateAsserted | .participation[typeCode=AUT].time
informationSource | .participation[typeCode=INF].role[classCode=PAT, or codes for Practioner or Related Person (if PAT is the informer, then syntax for self-reported =true)
derivedFrom | .outboundRelationship[typeCode=SPRT]/target[classCode=ACT,moodCode=EVN]
reasonCode | .reasonCode
reasonReference | .outboundRelationship[typeCode=RSON]/target[classCode=OBS,moodCode=EVN, code="reason for use"].value
note | .inboundRelationship[typeCode=SUBJ]/source[classCode=OBS,moodCode=EVN,code="annotation"].value
dosage | refer dosageInstruction mapping
id | n/a
extension | n/a
modifierExtension | N/A
sequence | .text
text | .text
additionalInstruction | .text
patientInstruction | .text
timing | .effectiveTime
asNeeded[x] | .outboundRelationship[typeCode=PRCN].target[classCode=OBS, moodCode=EVN, code="as needed"].value=boolean or codable concept
site | .approachSiteCode
route | .routeCode
method | .doseQuantity
doseAndRate |
id | n/a
extension | n/a
dose[x] | .doseQuantity
rate[x] | .rateQuantity
maxDosePerPeriod | .maxDoseQuantity
maxDosePerAdministration | not supported
maxDosePerLifetime | not supported

### Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

FiSMARTMedicationStatement
MedicationStatement |
identifier | FiveWs.identifier
status | FiveWs.status
category | FiveWs.class
medication[x] | FiveWs.what[x]
medication[x] (medicationReference) | FiveWs.what[x]
subject | FiveWs.subject[x], FiveWs.subject
effective[x] | FiveWs.done[x]
dateAsserted | FiveWs.recorded
informationSource | FiveWs.source
reasonCode | FiveWs.why[x]
reasonReference | FiveWs.why[x]

### Mappings for HL7 v2 Mapping (http://hl7.org/v2)

FiSMARTMedicationStatement
MedicationStatement |
subject | PID-3-Patient ID List
dosage |
sequence | TQ1-1
text | RXO-6; RXE-21
additionalInstruction | RXO-7
patientInstruction | RXO-7
asNeeded[x] | TQ1-9
site | RXR-2
route | RXR-1
method | RXR-4
doseAndRate | TQ1-2
type | RXO-21; RXE-23
dose[x] | RXO-2, RXE-3
rate[x] | RXE22, RXE23, RXE-24
maxDosePerPeriod | RXO-23, RXE-19