diff --git a/content/millennium/r4/clinical/medications/medication-administration.md b/content/millennium/r4/clinical/medications/medication-administration.md index 79546b5f7..baf2b69dd 100644 --- a/content/millennium/r4/clinical/medications/medication-administration.md +++ b/content/millennium/r4/clinical/medications/medication-administration.md @@ -9,10 +9,9 @@ title: MedicationAdministration | R4 API ## Overview -The MedicationAdministration resource provides information about medications administered to a patient or consumed by a patient including injections, intravenous solutions, and self administered oral medications. -When using this resource, full administration details for vaccinations administered by the current healthcare system can be searched. For historically administered vaccines, or vaccines administered by other healthcare disciplines, care settings, or regions, the [`Immunization`] resource must be used for creating or retrieving data. +The MedicationAdministration resource provides information about medications administered to a patient or consumed by a patient including injections, intravenous solutions, and self-administered oral medications. You can use this resource to search for full administration details for vaccinations administered by the current healthcare system. For historically administered vaccines, or vaccines administered by other healthcare disciplines, care settings, or regions, you must use the [`Immunization`] resource to create or retrieve information. -* **IMPORTANT NOTE**: Infuse or Bolus administration results for continuous infusion orders may require additional calculations to determine the actual amount of medication administered per ingredient. An additional calculation is required when the dosage dose does not equal the [contained] Medication ingredient strength denominator. In this case, calculate the ratio between the ingredient’s numerator divided by the denominator and multiply by dosage dose. This will be the actual amount of medication administered. +* **Important!**: Infuse or bolus administration results for continuous infusion orders may require additional calculations to determine the actual amount of medication administered per ingredient. An additional calculation is required when the dosage dose does not equal the [contained] medication ingredient strength denominator. In this case, calculate the ratio between the ingredient’s numerator divided by the denominator and multiply by dosage dose. This result is the actual amount of medication administered. The following fields are returned if valued: @@ -33,7 +32,7 @@ The following fields are returned if valued: * [Dose](https://hl7.org/fhir/r4/medicationadministration-definitions.html#MedicationAdministration.dosage.dose){:target="_blank"} * [Rate](https://hl7.org/fhir/r4/medicationadministration-definitions.html#MedicationAdministration.dosage.rate){:target="_blank"} -* MedicationAdministration.medication may be a reference to a [contained] Medication when the Medication cannot be represented by a [CodeableConcept] because it contains a unique combination of ingredients. Medications in the system always exist within the context of a MedicationAdministration and cannot be referenced independently. +* MedicationAdministration.medication may be a reference to a [contained] medication when the medication cannot be represented by a [CodeableConcept] because it contains a unique combination of ingredients. Medications in the system always exist in the context of a medication administration and cannot be referenced independently. <%= disclaimer %> @@ -64,7 +63,7 @@ All URLs for custom extensions are defined as `https://fhir-ehr.cerner.com/r4/St ## Search -Search for MedicationAdministrations that meet supplied query parameters: +Search for medication administrations that meet supplied query parameters. GET /MedicationAdministration?:parameters @@ -81,15 +80,15 @@ Search for MedicationAdministrations that meet supplied query parameters: `status` | No | [`token`] | The status of the medication administration event. It may be a list separated by commas. Example: `status=completed,not-done` `performer` | No | [`reference`] | The logical resource ID of the practitioner who administered the medication. It may be a list separated by commas. Example: `performer=1245,7659` `effective-time` | No | [`dateTime`] | A date range for when the administration happened. Example: `effective-time=ge2014-05-19T20:54:02.000Z` - [`_count`] | No | [`number`] | The maximum number of results to include in a page. Example: `50` + [`_count`] | No | [`number`] | The maximum number of results to include on a page. Example: `50` -_Implementation Notes_ +_Notes_ - When searching with the `_id` parameter - It must not be provided with any other parameters. - When searching with the `effective-time` parameter: - For a single `effective-time` occurrence: - - It must be provided with a `ge`, `gt`, `le`, or `lt` prefix to imply the date range to search for administrations within. + - It must be provided with a `ge`, `gt`, `le`, or `lt` prefix to imply the date range for an administrations search. - The time component is required. - Example: `effective-time=ge2014-05-19T20:54:02.000Z` - For two `effective-time` occurences: @@ -114,7 +113,7 @@ _Implementation Notes_ ## Retrieve by ID -List an individual MedicationAdministration by its ID: +List an individual medication administration by its ID. GET /MedicationAdministration/:id