Finnish PHR Medication Statement Profile
Note. The Finnish PHR Medication Statemement Profile is still a draft version. The final versionswill be specified, when there is a real life use case to refine the profile.
Finnish PHR profile for FHIR® Medication Statement describing a record of a medication that is being consumed by a patient. A medication statement may indicate that the patient may be taking the medication now, or has taken the medication in the past or will be taking the medication in the future.
A full list of the extensions, constraints and a structured definition of this profile can be found in Simplifier. There are also different views of the profile (details, mappings, table, XML, JSON).
Mandatory elements for Finnish PHR Medication Statement
| Content | Name in structure | Description / Type of information |
|---|---|---|
| Language | language | Language used in the medication statement stored in Kanta PHR. Language SHALL be chosen from the FHIR languages ValueSet. |
| Narrative | text | A text summary of the medication statement. SHALL include all content for a human to understand the essential clinical and business information of the medication statement. |
| Unique identifier | identifier | One globally unique identifier SHALL be provided for the medication statement. NB! Will be updated to match the Finnish PHR Vital Signs UPDATED profile This identifier may be used to uniquely identify the medication statement if the application doesn't receive an id for the medication statement provided by Kanta PHR. |
| Status | status | The status of the medication statement. Status SHALL be either 'active' or 'intended' (from FHIR Medication Statement Status ValueSet). |
| Medication taken | medication CodeableConcept |
The possible identifier/code and name of the medication. - When the medication can be uniquely identified, the VNR code of the medication and the brand name of the medication SHALL be given which SHALL match the name in the pharmaceutical database. - When the medication can not be uniquely identified (no VNR code available), only the name of the medication SHALL be given. The name can be one of the following: 1) brand name of the medication, in which case it must match the name in the pharmaceutical database, 2) name of the active ingredient(s) of the medication if the brand name is not applicable, or 3) some other name entered by the user. |
| Time when medication was taken | effectiveDateTime/ effectivePeriod |
A specific time during which the medication is/was taken. If the medication is still being taken, only the starting date may be given. |
| When the statement was asserted | dateAsserted | The date when the medication statement was asserted. |
| Who received the medication | subject | The person receiving the medication. The reference SHALL be to a Patient resource stored in Kanta PHR (that conforms to the Finnish PHR Patient profile). |
| Was the medication taken | taken | Indicator of whether the medication was taken. The code SHALL be from FHIR Medication Statement Taken ValueSet. |
Optional elements for Finnish PHR Medication Statement
| Content | Name in structure | Description / Type of information |
|---|---|---|
| Who is responsible for the statement | informationSource | The person who provided the information about the taking of this medication. The reference SHALL be to a Patient resource stored in Kanta PHR (that conforms to the Finnish PHR Patient profile). |
| Reason why the medication was not taken | reasonNotTaken | A code or text indicating why the medication was not taken. The code is preferred and SHALL be from the THL - Lääkehoidon muutoksen syy code system. |
| Reason for why the medication is being/was taken | reasonCode | If there is a need to give details of the reason why the medication is being/was taken, the details MAY be given in text. |
| Additional information | note | Extra information about the medication statement that is not conveyed by the other attributes. |
| Dosage | dosage | Details of how medication is/was taken or should be taken. |
Elements in the Medication Statement profile filled by the Kanta PHR platform
| Content | Name in structure | Description / Type of information |
|---|---|---|
| Application that created or updated the resource | extension: creatingApplication |
Is used to represent information about the application (id and name) that created or updated the resource. See the definition for the Finnish PHR Application Information extension. Kanta PHR platform will fill in this data automatically to each stored resource (if the application has entered some data in this extension, it will be overwitten). |
Finnish PHR Medication Statement Narrative guide
Narrative SHALL contain following mandatory information taken from the elements of the resource instance:
- Name of the medication: <MedicationStatement.medicationCodeableConsept.coding.text>
- Time: <MedicationStatement.effectiveDateTime>
- Taken: <MedicationStatement.taken>
Narrative SHOULD contain following optional information if given in the resource instance:
- Medication code: <MedicationStatement.medicationCodeableConsept.coding.display>(<MedicationStatement.medicationCodeableConsept.coding.code>)
- Dosage: <MedicationStatement.dosage.dose><MedicationStatement.dosage.text>
- Device: <MedicationStatement.device>
- Reason not take: <MedicationStatement.reasonNotTaken.text>(<MedicationStatement.reasonNotTaken.coding.code>)
- Reason code: <MedicationStatement.reasonCode.text>
If element is missing from resource, it shall not be mentioned in narrative.
Example:
Name of the medication: SOMAC CONTROL
Time: 27.5.2019 15:05
Taken: y