NutritionOrder | Medplum

On this page

A request to supply a diet, formula feeding (enteral) or oral nutritional supplement to a patient/resident.

Elements

Name Required Type Description
identifier Identifier[] Identifiers assigned to this order
Details
Identifiers assigned to this order by the order sender or by the order receiver.
The Identifier.type element can be to indicate filler vs. placer if needed. This is explained in further detail here.
instantiatesCanonical canonical[] Instantiates FHIR protocol or definition
Details
The URL pointing to a FHIR-defined protocol, guideline, orderset or other definition that is adhered to in whole or in part by this NutritionOrder.
Note: This is a business identifier, not a resource identifier (see discussion). It is best practice for the identifier to only appear on a single resource instance, however business practices may occasionally dictate that multiple resource instances with the same identifier can exist - possibly even with different resource types. For example, multiple Patient and a Person resource instance might share the same social insurance number.
instantiatesUri uri[] Instantiates external protocol or definition
Details
The URL pointing to an externally maintained protocol, guideline, orderset or other definition that is adhered to in whole or in part by this NutritionOrder.
This might be an HTML page, PDF, etc. or could just be a non-resolvable URI identifier.
instantiates uri[] Instantiates protocol or definition
Details
The URL pointing to a protocol, guideline, orderset or other definition that is adhered to in whole or in part by this NutritionOrder.
status code draft | active | on-hold | revoked | completed | entered-in-error | unknown
Details
The workflow status of the nutrition order/request.
Typically the system placing the order sets the status to "requested". Thereafter, the order is maintained by the receiver that updates the status as the request is handled. This element is labeled as a modifier because the status contains codes that mark the resource as not currently valid.
intent code proposal | plan | directive | order | original-order | reflex-order | filler-order | instance-order | option
Details
Indicates the level of authority/intentionality associated with the NutritionOrder and where the request fits into the workflow chain.
When resources map to this element, they are free to define as many codes as necessary to cover their space and will map to "proposal, plan or order". Can have multiple codes that map to one of these. E.g. "original order", "encoded order", "reflex order" would all map to "order". Expectation is that the set of codes is mutually exclusive or a strict all-encompassing hierarchy.
patient Reference< Patient > The person who requires the diet, formula or nutritional supplement
Details
The person (patient) who needs the nutrition order for an oral diet, nutritional supplement and/or enteral or formula feeding.
encounter Reference< Encounter > The encounter associated with this nutrition order
Details
An encounter that provides additional information about the healthcare context in which this request is made.
dateTime dateTime Date and time the nutrition order was requested
Details
The date and time that this nutrition order was requested.
orderer Reference< Practitioner | PractitionerRole > Who ordered the diet, formula or nutritional supplement
Details
The practitioner that holds legal responsibility for ordering the diet, nutritional supplement, or formula feedings.
allergyIntolerance Reference< AllergyIntolerance >[] List of the patient's food and nutrition-related allergies and intolerances
Details
A link to a record of allergies or intolerances which should be included in the nutrition order.
Information on a patient's food allergies and intolerances to inform healthcare personnel about the type of foods that the patient shouldn't receive or consume.
foodPreferenceModifier CodeableConcept[] Order-specific modifier about the type of food that should be given
Details
This modifier is used to convey order-specific modifiers about the type of food that should be given. These can be derived from patient allergies, intolerances, or preferences such as Halal, Vegan or Kosher. This modifier applies to the entire nutrition order inclusive of the oral diet, nutritional supplements and enteral formula feedings.
Information on a patient's food preferences that inform healthcare personnel about the food that the patient should receive or consume.
excludeFoodModifier CodeableConcept[] Order-specific modifier about the type of food that should not be given
Details
This modifier is used to convey Order-specific modifier about the type of oral food or oral fluids that should not be given. These can be derived from patient allergies, intolerances, or preferences such as No Red Meat, No Soy or No Wheat or Gluten-Free. While it should not be necessary to repeat allergy or intolerance information captured in the referenced AllergyIntolerance resource in the excludeFoodModifier, this element may be used to convey additional specificity related to foods that should be eliminated from the patient’s diet for any reason. This modifier applies to the entire nutrition order inclusive of the oral diet, nutritional supplements and enteral formula feedings.
Information on a patient's food allergies, intolerances and preferences to inform healthcare personnel about the type of foods that the patient shouldn't receive or consume.
oralDiet NutritionOrderOralDiet Oral diet components
Details
Diet given orally in contrast to enteral (tube) feeding.
id string Unique id for inter-element referencing
Details
Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
extension Extension[] Additional content defined by implementations
Details
May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
modifierExtension Extension[] Extensions that cannot be ignored even if unrecognized
Details
May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.
Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
type CodeableConcept[] Type of oral diet or diet restrictions that describe what can be consumed orally
Details
The kind of diet or dietary restriction such as fiber restricted diet or diabetic diet.
schedule Timing[] Scheduled frequency of diet
Details
The time period and frequency at which the diet should be given. The diet should be given for the combination of all schedules if more than one schedule is present.
nutrient NutritionOrderOralDietNutrient[] Required nutrient modifications
Details
Class that defines the quantity and type of nutrient modifications (for example carbohydrate, fiber or sodium) required for the oral diet.
id string Unique id for inter-element referencing
Details
Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
extension Extension[] Additional content defined by implementations
Details
May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
modifierExtension Extension[] Extensions that cannot be ignored even if unrecognized
Details
May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.
Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
modifier CodeableConcept Type of nutrient that is being modified
Details
The nutrient that is being modified such as carbohydrate or sodium.
amount Quantity Quantity of the specified nutrient
Details
The quantity of the specified nutrient to include in diet.
texture NutritionOrderOralDietTexture[] Required texture modifications
Details
Class that describes any texture modifications required for the patient to safely consume various types of solid foods.
id string Unique id for inter-element referencing
Details
Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
extension Extension[] Additional content defined by implementations
Details
May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
modifierExtension Extension[] Extensions that cannot be ignored even if unrecognized
Details
May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.
Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
modifier CodeableConcept Code to indicate how to alter the texture of the foods, e.g. pureed
Details
Any texture modifications (for solid foods) that should be made, e.g. easy to chew, chopped, ground, and pureed.
Coupled with the foodType (Meat).
foodType CodeableConcept Concepts that are used to identify an entity that is ingested for nutritional purposes
Details
The food type(s) (e.g. meats, all foods) that the texture modification applies to. This could be all foods types.
Coupled with the texture.modifier; could be (All Foods).
fluidConsistencyType CodeableConcept[] The required consistency of fluids and liquids provided to the patient
Details
The required consistency (e.g. honey-thick, nectar-thick, thin, thickened.) of liquids or fluids served to the patient.
instruction string Instructions or additional information about the oral diet
Details
Free text or additional instructions or information pertaining to the oral diet.
Free text dosage instructions can be used for cases where the instructions are too complex to code.
supplement NutritionOrderSupplement[] Supplement components
Details
Oral nutritional products given in order to add further nutritional value to the patient's diet.
id string Unique id for inter-element referencing
Details
Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
extension Extension[] Additional content defined by implementations
Details
May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
modifierExtension Extension[] Extensions that cannot be ignored even if unrecognized
Details
May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.
Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
baseFormulaType CodeableConcept Type of enteral or infant formula
Details
The type of enteral or infant formula such as an adult standard formula with fiber or a soy-based infant formula.
baseFormulaProductName string Product or brand name of the enteral or infant formula
Details
The product or brand name of the enteral or infant formula product such as "ACME Adult Standard Formula".
additiveType CodeableConcept Type of modular component to add to the feeding
Details
Indicates the type of modular component such as protein, carbohydrate, fat or fiber to be provided in addition to or mixed with the base formula.
additiveProductName string Product or brand name of the modular additive
Details
The product or brand name of the type of modular component to be added to the formula.
caloricDensity Quantity Amount of energy per specified volume that is required
Details
The amount of energy (calories) that the formula should provide per specified volume, typically per mL or fluid oz. For example, an infant may require a formula that provides 24 calories per fluid ounce or an adult may require an enteral formula that provides 1.5 calorie/mL.
routeofAdministration CodeableConcept How the formula should enter the patient's gastrointestinal tract
Details
The route or physiological path of administration into the patient's gastrointestinal tract for purposes of providing the formula feeding, e.g. nasogastric tube.
administration NutritionOrderEnteralFormulaAdministration[] Formula feeding instruction as structured data
Details
Formula administration instructions as structured data. This repeating structure allows for changing the administration rate or volume over time for both bolus and continuous feeding. An example of this would be an instruction to increase the rate of continuous feeding every 2 hours.
See implementation notes below for further discussion on how to order continuous vs bolus enteral feeding using this resource.
id string Unique id for inter-element referencing
Details
Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
extension Extension[] Additional content defined by implementations
Details
May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
modifierExtension Extension[] Extensions that cannot be ignored even if unrecognized
Details
May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.
Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
schedule Timing Scheduled frequency of enteral feeding
Details
The time period and frequency at which the enteral formula should be delivered to the patient.
quantity Quantity The volume of formula to provide
Details
The volume of formula to provide to the patient per the specified administration schedule.
rate[x] Quantity, Ratio Speed with which the formula is provided per period of time
Details
The rate of administration of formula via a feeding pump, e.g. 60 mL per hour, according to the specified schedule.
Ratio is used when the quantity value in the denominator is not "1", otherwise use Quantity. For example, the Ratio datatype is used for "200 mL/4 hrs" versus the Quantity datatype for "50 mL/hr".
maxVolumeToDeliver Quantity Upper limit on formula volume per unit of time
Details
The maximum total quantity of formula that may be administered to a subject over the period of time, e.g. 1440 mL over 24 hours.
administrationInstruction string Formula feeding instructions expressed as text
Details
Free text formula administration, feeding instructions or additional instructions or information.
Free text dosage instructions can be used for cases where the instructions are too complex to code.
note Annotation[] Comments
Details
Comments made about the {{title}} by the requester, performer, subject or other participants.
This element SHALL NOT be used to supply free text instructions for the diet which are represented in the .oralDiet.instruction, supplement.instruction, or enteralFormula.administrationInstruction elements.

Search Parameters

Name Type Description Expression
identifier token Return nutrition orders with this external identifier NutritionOrder.identifier
patient reference The identity of the person who requires the diet, formula or nutritional supplement NutritionOrder.patient
encounter reference Return nutrition orders with this encounter identifier NutritionOrder.encounter
additive token Type of module component to add to the feeding NutritionOrder.enteralFormula.additiveType
datetime date Return nutrition orders requested on this date NutritionOrder.dateTime
formula token Type of enteral or infant formula NutritionOrder.enteralFormula.baseFormulaType
instantiates-canonical reference Instantiates FHIR protocol or definition NutritionOrder.instantiatesCanonical
instantiates-uri uri Instantiates external protocol or definition NutritionOrder.instantiatesUri
oraldiet token Type of diet that can be consumed orally (i.e., take via the mouth). NutritionOrder.oralDiet.type
provider reference The identity of the provider who placed the nutrition order NutritionOrder.orderer
status token Status of the nutrition order. NutritionOrder.status
supplement token Type of supplement product requested NutritionOrder.supplement.type

Inherited Elements

Name Required Type Description
id string Logical id of this artifact
Details
The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.
The only time that a resource does not have an id is when it is being submitted to the server using a create operation.
meta Meta Metadata about the resource
Details
The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource.
implicitRules uri A set of rules under which this content was created
Details
A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.
Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.
language code Language of the resource content
Details
The base language in which the resource is written.
Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute).
text Narrative Text summary of the resource, for human interpretation
Details
A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety.
Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied).
contained Resource[] Contained, inline Resources
Details
These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope.
This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels.
extension Extension[] Additional content defined by implementations
Details
May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
modifierExtension Extension[] Extensions that cannot be ignored
Details
May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.
Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.