# US Core Nutrition Order Profile - Health eData 1 Sandbox v0.1.0

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **US Core Nutrition Order Profile**

## Resource Profile: US Core Nutrition Order Profile 

| | | |
| :--- | :--- | :--- |
| *Official URL*:http://hl7.org/fhir/us/core/StructureDefinition/us-core-nutritionorder | *Version*:0.1.0 | |
| Active as of 2026-05-06 | [Maturity Level](http://hl7.org/fhir/versions.html#maturity): 2 | *Computable Name*:USCoreNutritionOrderProfile |
| *Other Identifiers:*OID:2.16.840.1.113883.4.642.40.2.42.76 | | |

 
The US Core Nutrition Order Profile inherits from the FHIR [NutritionOrder](https://hl7.org/fhir/R4/nutritionorder.html) resource; refer to it for scope and usage definitions. This profile meets the requirements of the U.S. Core Data for Interoperability (USCDI) **Nutrition Order Data Element of the Orders Data Class**. It sets minimum expectations for the NutriotionOrder resource to record, search, and fetch nutritional orders for a patient. It specifies which core elements, extensions, vocabularies, and value sets **SHALL** be present in the resource and constrains how the elements are used. Providing the floor for standards development for specific use cases promotes interoperability and adoption. 

**Example Usage Scenarios:**

The following are example usage scenarios for the US Core NutritionOrder profile:

* Query for NutritionOrder resources belonging to a Patient
* [Record or update] a Patient NutritionOrder

### Mandatory and Must Support Data Elements

The following data elements must always be present ([Mandatory] definition) or must be supported if the data is present in the sending system ([Must Support] definition). They are presented below in a simple human-readable explanation. Profile specific guidance and examples are provided as well. The [Formal Views] below provides the formal summary, definitions, and terminology requirements.

**Each NutritionOrder Must Have:**

1. a status
1. an intent
1. a patient
1. when requested

**Each NutritionOrder Must Support:**

1. the requester
1. what diet is being requested
1. patient instructions

### Profile Specific Implementation Guidance

This section provides detailed implementation guidance for the US Core Profile to support implementation and certification.

* **FOO**

### Liquid Script to Generate StructureDefinition All Nice N Pretty Like

{% include structure-table.md sd=sd source="differential" show_must_support=true show_uscdi=true %}

## USCoreNutritionOrderProfile — US Core Nutrition Order Profile

The US Core Nutrition Order Profile inherits from the FHIR [NutritionOrder](https://hl7.org/fhir/R4/nutritionorder.html) resource; refer to it for scope and usage definitions. This profile meets the requirements of the U.S. Core Data for Interoperability (USCDI) **Nutrition Order Data Element of the Orders Data Class**. It sets minimum expectations for the NutriotionOrder resource to record, search, and fetch nutritional orders for a patient. It specifies which core elements, extensions, vocabularies, and value sets **SHALL** be present in the resource and constrains how the elements are used. Providing the floor for standards development for specific use cases promotes interoperability and adoption.

* **URL:** `http://hl7.org/fhir/us/core/StructureDefinition/us-core-nutritionorder`
* **Version:** 0.1.0
* **Status:** active
* **Kind:** resource
* **Type:** `NutritionOrder`
* **Base Definition:** `http://hl7.org/fhir/StructureDefinition/NutritionOrder`
* **Derivation:** constraint

### Elements (differential)

| | | | | | |
| :--- | :--- | :--- | :--- | :--- | :--- |
| `NutritionOrder` |   |   | 0..* |   | **Diet, formula or nutritional supplement request**A request to supply a diet, formula feeding (enteral) or oral nutritional supplement to a patient/resident. |
| ↳`identifier` | ✅ |   | 0..* | `Identifier` | **Identifiers assigned to this order**Identifiers assigned to this order by the order sender or by the order receiver. |
| ↳`status` | ✅ |   | 1..1 | `code` | **draft | active | on-hold | revoked | completed | entered-in-error | unknown**The workflow status of the nutrition order/request.**Binding:** `http://hl7.org/fhir/ValueSet/request-status\|4.0.1` (required) — Codes identifying the lifecycle stage of the nutrition order. |
| ↳`intent` | ✅ |   | 1..1 | `code` | **proposal | plan | directive | order | original-order | reflex-order | filler-order | instance-order | option**Indicates the level of authority/intentionality associated with the NutrionOrder and where the request fits into the workflow chain.**Binding:** `http://hl7.org/fhir/ValueSet/request-intent\|4.0.1` (required) — Codes indicating the degree of authority/intentionality associated with a nutrition order. |
| ↳`patient` | ✅ |   | 1..1 | `Reference`target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | **The person who requires the diet, formula or nutritional supplement**The person (patient) who needs the nutrition order for an oral diet, nutritional supplement and/or enteral or formula feeding. |
| ↳`dateTime` | ✅ |   | 1..1 | `dateTime` | **Date and time the nutrition order was requested**The date and time that this nutrition order was requested. |
| ↳`orderer` | ✅ |   | 0..1 | `Reference`target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionertarget: http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | **Who ordered the diet, formula or nutritional supplement**The practitioner that holds legal responsibility for ordering the diet, nutritional supplement, or formula feedings. |
| ↳`oralDiet` | ✅ |   | 0..1 | `BackboneElement` | **Oral diet components**Diet given orally in contrast to enteral (tube) feeding. |
| ↳`type` | ✅ |   | 0..* | `CodeableConcept` | **Type of oral diet or diet restrictions that describe what can be consumed orally**The kind of diet or dietary restriction such as fiber restricted diet or diabetic diet.**Binding:** `http://hl7.org/fhir/ValueSet/diet-type\|4.0.1` (example) — Codes used to indicate the type of diet being ordered for a patient. |
| ↳`instruction` | ✅ |   | 0..1 | `string` | **Instructions or additional information about the oral diet**Free text or additional instructions or information pertaining to the oral diet. |

```


## USCoreNutritionOrderProfile — US Core Nutrition Order Profile

The US Core Nutrition Order Profile inherits from the FHIR [NutritionOrder](https://hl7.org/fhir/R4/nutritionorder.html) resource; refer to it for scope and usage definitions. This profile meets the requirements of the U.S. Core Data for Interoperability (USCDI) *Nutrition Order Data Element of the Orders Data Class*. It sets minimum expectations for the NutriotionOrder resource to record, search, and fetch nutritional orders for a patient. It specifies which core elements, extensions, vocabularies, and value sets **SHALL** be present in the resource and constrains how the elements are used. Providing the floor for standards development for specific use cases promotes interoperability and adoption.

- **URL:** `http://hl7.org/fhir/us/core/StructureDefinition/us-core-nutritionorder`
- **Version:** 0.1.0
- **Status:** active
- **Kind:** resource
- **Type:** `NutritionOrder`
- **Base Definition:** `http://hl7.org/fhir/StructureDefinition/NutritionOrder`
- **Derivation:** constraint


### Elements (differential)

| Element | Must Support | Add'l USCDI | Cardinality | Type | Description |
|---|:---:|:---:|---|---|---|
| `NutritionOrder` |  |  | 0..* |  | **Diet, formula or nutritional supplement request**<br/>A request to supply a diet, formula feeding (enteral) or oral nutritional supplement to a patient/resident. |
| <span style="padding-left: 1.5em;">↳</span> `identifier` | ✅ |  | 0..* | `Identifier` | **Identifiers assigned to this order**<br/>Identifiers assigned to this order by the order sender or by the order receiver. |
| <span style="padding-left: 1.5em;">↳</span> `status` | ✅ |  | 1..1 | `code` | **draft \| active \| on-hold \| revoked \| completed \| entered-in-error \| unknown**<br/>The workflow status of the nutrition order/request.<br/><span style="font-size: 0.85em;">**Binding:** `http://hl7.org/fhir/ValueSet/request-status\|4.0.1` (required) — Codes identifying the lifecycle stage of the nutrition order.</span> |
| <span style="padding-left: 1.5em;">↳</span> `intent` | ✅ |  | 1..1 | `code` | **proposal \| plan \| directive \| order \| original-order \| reflex-order \| filler-order \| instance-order \| option**<br/>Indicates the level of authority/intentionality associated with the NutrionOrder and where the request fits into the workflow chain.<br/><span style="font-size: 0.85em;">**Binding:** `http://hl7.org/fhir/ValueSet/request-intent\|4.0.1` (required) — Codes indicating the degree of authority/intentionality associated with a nutrition order.</span> |
| <span style="padding-left: 1.5em;">↳</span> `patient` | ✅ |  | 1..1 | `Reference`<br/><span style="font-size: 0.85em;">target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient</span> | **The person who requires the diet, formula or nutritional supplement**<br/>The person (patient) who needs the nutrition order for an oral diet, nutritional supplement and/or enteral or formula feeding. |
| <span style="padding-left: 1.5em;">↳</span> `dateTime` | ✅ |  | 1..1 | `dateTime` | **Date and time the nutrition order was requested**<br/>The date and time that this nutrition order was requested. |
| <span style="padding-left: 1.5em;">↳</span> `orderer` | ✅ |  | 0..1 | `Reference`<br/><span style="font-size: 0.85em;">target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner</span><br/><span style="font-size: 0.85em;">target: http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole</span> | **Who ordered the diet, formula or nutritional supplement**<br/>The practitioner that holds legal responsibility for ordering the diet, nutritional supplement, or formula feedings. |
| <span style="padding-left: 1.5em;">↳</span> `oralDiet` | ✅ |  | 0..1 | `BackboneElement` | **Oral diet components**<br/>Diet given orally in contrast to enteral (tube) feeding. |
| <span style="padding-left: 3.0em;">↳</span> `type` | ✅ |  | 0..* | `CodeableConcept` | **Type of oral diet or diet restrictions that describe what can be consumed orally**<br/>The kind of diet or dietary restriction such as fiber restricted diet or diabetic diet.<br/><span style="font-size: 0.85em;">**Binding:** `http://hl7.org/fhir/ValueSet/diet-type\|4.0.1` (example) — Codes used to indicate the type of diet being ordered for a patient.</span> |
| <span style="padding-left: 3.0em;">↳</span> `instruction` | ✅ |  | 0..1 | `string` | **Instructions or additional information about the oral diet**<br/>Free text or additional instructions or information pertaining to the oral diet. |





```

**Usages:**

* Examples for this Profile: [NutritionOrder/cardiac-diet](NutritionOrder-cardiac-diet.md), [NutritionOrder/clear-liquid-diet](NutritionOrder-clear-liquid-diet.md), [NutritionOrder/mediterranean-diet](NutritionOrder-mediterranean-diet.md) and [NutritionOrder/whole-food-diet](NutritionOrder-whole-food-diet.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/resource/hl7.fhir.us.healthedata1-sandbox|current/StructureDefinition/StructureDefinition-us-core-nutritionorder.json)

### Formal Views of Profile Content

 [Description of Profiles, Differentials, Snapshots and how the different presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-us-core-nutritionorder.csv), [Excel](StructureDefinition-us-core-nutritionorder.xlsx), [Schematron](StructureDefinition-us-core-nutritionorder.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "us-core-nutritionorder",
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 2
  }],
  "url" : "http://hl7.org/fhir/us/core/StructureDefinition/us-core-nutritionorder",
  "identifier" : [{
    "system" : "urn:ietf:rfc:3986",
    "value" : "urn:oid:2.16.840.1.113883.4.642.40.2.42.76"
  }],
  "version" : "0.1.0",
  "name" : "USCoreNutritionOrderProfile",
  "title" : "US Core Nutrition Order Profile",
  "status" : "active",
  "experimental" : false,
  "date" : "2026-05-06",
  "publisher" : "HL7 International / Cross-Group Projects",
  "contact" : [{
    "name" : "HL7 International / Cross-Group Projects",
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/cgp"
    },
    {
      "system" : "email",
      "value" : "cgp@lists.HL7.org"
    }]
  }],
  "description" : "The US Core Nutrition Order Profile inherits from the FHIR [NutritionOrder](https://hl7.org/fhir/R4/nutritionorder.html) resource; refer to it for scope and usage definitions. This profile meets the requirements of the U.S. Core Data for Interoperability (USCDI) *Nutrition Order Data Element of the Orders Data Class*. It sets minimum expectations for the NutriotionOrder resource to record, search, and fetch nutritional orders for a patient. It specifies which core elements, extensions, vocabularies, and value sets **SHALL** be present in the resource and constrains how the elements are used. Providing the floor for standards development for specific use cases promotes interoperability and adoption.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "US"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "workflow",
    "uri" : "http://hl7.org/fhir/workflow",
    "name" : "Workflow Pattern"
  },
  {
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 v2 Mapping"
  },
  {
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "NutritionOrder",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/NutritionOrder",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "NutritionOrder",
      "path" : "NutritionOrder"
    },
    {
      "id" : "NutritionOrder.identifier",
      "path" : "NutritionOrder.identifier",
      "mustSupport" : true
    },
    {
      "id" : "NutritionOrder.status",
      "path" : "NutritionOrder.status",
      "mustSupport" : true
    },
    {
      "id" : "NutritionOrder.intent",
      "path" : "NutritionOrder.intent",
      "mustSupport" : true
    },
    {
      "id" : "NutritionOrder.patient",
      "path" : "NutritionOrder.patient",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "NutritionOrder.dateTime",
      "path" : "NutritionOrder.dateTime",
      "mustSupport" : true
    },
    {
      "id" : "NutritionOrder.orderer",
      "path" : "NutritionOrder.orderer",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner",
        "http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole"],
        "_targetProfile" : [{
          "extension" : [{
            "url" : "http://hl7.org/fhir/StructureDefinition/elementdefinition-type-must-support",
            "valueBoolean" : true
          }]
        },
        {
          "extension" : [{
            "url" : "http://hl7.org/fhir/StructureDefinition/elementdefinition-type-must-support",
            "valueBoolean" : false
          }]
        }]
      }],
      "mustSupport" : true
    },
    {
      "id" : "NutritionOrder.oralDiet",
      "path" : "NutritionOrder.oralDiet",
      "mustSupport" : true
    },
    {
      "id" : "NutritionOrder.oralDiet.type",
      "path" : "NutritionOrder.oralDiet.type",
      "mustSupport" : true
    },
    {
      "id" : "NutritionOrder.oralDiet.instruction",
      "path" : "NutritionOrder.oralDiet.instruction",
      "mustSupport" : true
    }]
  }
}

```
