Medications
Source Object: Medications
Overview and Usage: The "Medications" source object in the athena EHR system is designed to manage and store patient medication information. Developers can access and utilize this object to retrieve, update, and manage patient medication data. Key data fields include:
- Encounter ID: Identifies the patient's medical encounter associated with the medication.
- Events (Event Date, Type, User Display Name): Records events related to medication changes, such as dosage adjustments and renewals.
- Medication: Specifies the name or description of the medication.
- Medication Entry ID: Uniquely identifies each medication entry.
- Stop Reason: Indicates the reason for discontinuing the medication.
- Structured SIG (Dosage Action, Additional Instructions, Dosage Duration, Frequency, Quantity, Route): Provides structured dosage information for the medication.
- Approved By: Indicates the user who approved the medication.
- Billing NDC: Contains the National Drug Code (NDC) for billing purposes.
- Pharmacy (NCPDP ID): Identifies the pharmacy where the medication was filled.
- Prescribed By: Specifies the healthcare provider who prescribed the medication.
- Quantity, Quantity Unit, Refills Allowed: Specifies the quantity, unit, and number of refills allowed for the medication.
- Route: Indicates the administration route of the medication.
- Status: Represents the current status of the medication (e.g., active, discontinued).
- Therapeutic Class: Specifies the therapeutic class or category of the medication.
- Unstructured SIG: Contains unstructured dosage instructions for the medication.
Developers can leverage the "Medications" source object to create applications that manage patients' medication records, helping healthcare providers make informed decisions regarding patient care and prescriptions.
Mapping Table
Data Field | Example Value | Source Data Field Description | Source Field Data Type | Source Data Field Cardinality | Mapped FHIR++ Resource | Mapped FHIR Data Field | Augmented Mapping | Associated Coding System | Associated FHIR Data Field Extension | Mapping Context |
---|---|---|---|---|---|---|---|---|---|---|
encounterid | 1 | If this was a prescription, this contains the ID of the encounter where it was ordered or administered | Integer | 0..1 | MedicationStatement | context.reference | - | - | - | Top Level |
events | - | The list of events for this medication. Can be START, END, ORDER, ENTER, FILL, or HIDE. | Object | 0..* | MedicationStatement | - | - | - | - | Top Level |
events.eventdate | 01/01/2001 | The date this event occurred | String | 0..1 | MedicationStatement | effectivePeriod.start/effectivePeriod.end | - | - | - | Top Level |
events.type | START | The event type. Can be START, END, ORDER, ENTER, FILL, or HIDE. | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | event-type | Top Level |
events.userdisplayname | sample-name | The display name for the user most relevant for this event. May be null. | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | user-display-name | Top Level |
medication | medication-name | The name of the medication. | String | 0..1 | MedicationStatement | medicationCodeableConcept.coding[1].display | - | - | - | Top Level |
medicationentryid | entered | Primary ID for this medication entry. Those starting with C are clinical prescriptions, and those starting with H are historical (entered, downloaded, etc). | String | 0..1 | MedicationStatement | id | - | - | - | Top Level |
medicationid | 224617 | athena ID for this medication. | Integer | 1..1 | MedicationStatement | medicationReference.reference | - | - | - | Top Level |
stopreason | end of course | The reason why this medication was stopped. | String | 0..1 | MedicationStatement | statusReason[1].coding[1].display | - | - | - | Top Level |
structuredsig | - | Components of the structured sig. | Object | 0..1 | MedicationStatement | dosage[1] | - | - | - | Top Level |
structuredsig.dosageaction | Chew | How the medication is taken. Examples are Chew, Take, Inhale, etc. | String | 0..1 | MedicationStatement | dosage[1].method.coding[1].display | - | - | - | Top Level |
structuredsig.dosageadditionalinstructions | with meals | Additional instructions. Example: with meals | String | 0..1 | MedicationStatement | dosage[1].additionalInstruction | - | - | - | Top Level |
structuredsig.dosagedurationunit | days | The unit of the duration. Example: days. So take this for days. | String | 0..1 | MedicationStatement | dosage[1].timing.repeat.durationUnit | - | - | - | Top Level |
structuredsig.dosagedurationvalue | 1 | How many duration time units this medication should be taken for. | Integer | 0..1 | MedicationStatement | dosage[1].timing.repeat.duration | - | - | - | Top Level |
structuredsig.dosagefrequencyunit | per day | The unit of the frequency. Example: per day, per week. | String | 0..1 | MedicationStatement | dosage[1].doseAndRate[1].rateQuantity.unit | - | - | - | Top Level |
structuredsig.dosagefrequencyvalue | 1 | How many times (in the given time unit) this should be taken. | Number | 0..1 | MedicationStatement | dosage[1].doseAndRate[1].rateQuantity.value | - | - | - | Top Level |
structuredsig.dosagequantityunit | tablets | The unit of the quantity. Example: tablets, sprays, etc. | String | 0..1 | MedicationStatement | dosage[1].doseAndRate[1].doseQuantity.unit | - | - | - | Top Level |
structuredsig.dosagequantityvalue | 1 | How many of this med is taken. | Number | 0..1 | MedicationStatement | dosage[1].doseAndRate[1].doseQuantity.value | - | - | - | Top Level |
structuredsig.dosageroute | oral | How this medication is taken. Example: oral, inhalation, intranasal, etc. | String | 0..1 | MedicationStatement | dosage[1].route.coding[1].display | - | - | - | Top Level |
approvedby | sample-name | For clinical prescriptions, the athenaNet username of the person who approved this prescription. | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | approved-by | Top Level |
billingndc | 1 | The billing NDC code for this medication. | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | billing-ndc | Top Level |
createdby | lucy | The athenaNet username of the person who entered or ordered the medication. Downloaded medications have INTERFACE for this field. | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | created-by | Top Level |
earliestfilldate | 01/01/2001 | The earliest date a prescription may be filled, in the format mm/dd/yyyy. | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | earliest-fill-date | Top Level |
futuresubmitdate | 01/01/2001 | The date a medication will be submitted. Included if the medication is in PEND status and attached to a approved future order. | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | future-submit-date | Top Level |
isdiscontinued | TRUE | Whether or not the given medication is discontinued and cannot be ordered anymore | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | is-discontinued | Top Level |
issafetorenew | TRUE | - | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | is-safe-to-renew | Top Level |
isstructuredsig | TRUE | Whether the sig for this entry is structured. | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | is-structured-sig | Top Level |
ndcoptions | sample-options | The list of NDC numbers that correspond to this medication. | String | 0..1 | MedicationStatement | extension[*].valueString | - | NDC | ndc-options | Top Level |
orderingmode | PRESCRIBE | The ordering mode for prescriptions. Can be PRESCRIBE, DISPENSE, or ADMINISTER. | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | ordering-mode | Top Level |
organclass | head | The organ class for this medication. This is equivalent to a medication class. | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | organ-class | Top Level |
patientnote | note | Patient-facing note for this prescription. Labeled 'note' in the UI. | String | 0..1 | MedicationStatement | note[*].text | authorString="patient" | - | - | Top Level |
pharmacy | sample-pharmacy | The name of the pharmacy where this medication was filled. | String | 0..1 | MedicationStatement | informationSource.display | - | - | - | Top Level |
pharmacyncpdpid | 2 | The NCPDP ID of the pharmacy for this medication.. See http://www.ncpdp.org/ for details. | String | 0..1 | MedicationStatement | informationSource.identifier.value | - | - | - | Top Level |
prescribedby | sample-name | The user who prescribed this medication. | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | prescribed-by | Top Level |
providernote | internal note | Non-patient facing note for ths prescription. Labeled 'internal note' in the UI. | String | 0..1 | MedicationStatement | note[*].text | authorString="practitioner" | - | Top Level | |
quantity | 1 | The total quantity prescribed, dispensed, administered. This is not currently available for historical (downloaded) medications. | Number | 0..1 | MedicationStatement | extension[*].valueInteger | - | - | quantity | Top Level |
quantityunit | tablets | The unit of the quantity. Example: tablets, sprays, etc. | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | quantity-unit | Top Level |
refillsallowed | 1 | The number of refills allowed when this medication was ordered. | Integer | 0..1 | MedicationStatement | extension[*].valueInteger | - | - | refills-allowed | Top Level |
route | sample-route | The route for the prescription. | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | route | Top Level |
source | medco | How this medication was entered. This can be the ordering provider, a medication history download (express scripts, medco, etc), ATHENA (which means it was entered manually), etc. | String | 0..1 | MedicationStatement | informationSource.reference | - | - | - | Top Level |
status | PEND | The status of this medication. Medications in PEND status are associated with approved future orders and have not yet been submitted. | String | 0..1 | MedicationStatement | status | - | - | - | Top Level |
therapeuticclass | sample-class | The therapeutic class for this medication. This is equivalent to a medication subclass. | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | therapeutic-class | Top Level |
unstructuredsig | - | Components of the structured sig. | Object | 0..1 | MedicationStatement | extension[*].valueString | - | - | unstructured-sig | Top Level |
structuredsig.dosagefrequencydescription | 6 per day | A standardized patient-friendly frequency. Example: 6 per day becomes 'every 4 hours'. | String | 0..1 | MedicationStatement | dosage[1].timing.extension[*].valueString | - | - | dosage-frequency-description | Top Level |
hidden | FALSE | Set whether the medication is hidden in the UI. | Boolean | 0..1 | MedicationStatement | extension[*].valueBoolean | - | - | hidden | Top Level |
startdate | 01/01/2001 | Start date for this medication | String | 0..1 | MedicationStatement | effectivePeriod.start | - | - | - | Top Level |
stopdate | 03/03/2002 | Stop date for this medication | String | 0..1 | MedicationStatement | effectivePeriod.end | - | - | - | Top Level |
PATIENTFACINGCALL | FALSE | When 'true' is passed we will collect relevant data and store in our database. | Boolean | 0..1 | MedicationStatement | extension[*].valueBoolean | - | - | patient-facing-call | Top Level |
THIRDPARTYUSERNAME | sample-name | User name of the patient in the third party application. | String | 0..1 | MedicationStatement | extension[*].valueString | - | - | third-party-user-name | Top Level |