Release 5 Ballot
Medication DefinitionThis page is part of the FHIR Specification (v5.0.0-ballot: R5 Ballot - see ballot notes). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions 
. Page versions: R5 R4B
| Biomedical Research and Regulation Work Group | Maturity Level: 2 | Trial Use | Security Category: Anonymous | Compartments: Not linked to any defined compartments |
The definition and characteristics of a medicinal manufactured item, such as a tablet or capsule, as contained in a packaged medicinal product.
For an overview of this resource and others in the Medication Definition domain, also see the module page
ManufacturedItemDefinition is to be used when you need to describe an actual physical medication item such as a tablet or capsule. This is typically for regulatory or manufacturing use cases, rather than day to day prescribing or dispensing.
This resource represents (for example) a single physical tablet. It can also represent physical liquids, powders, capsules etc. When prescribing, it is not usually necessary to represent the physical properties of the tablet that the patient will eventually receive and consume. Prescriptions make statements about types of products or substances, in general terms or more specific, which may be fulfilled by tablets (in some cases) but usually without directly talking about the details of those tablets. It is not usual to prescribe a red tablet with an "X" on it, so it is clear that this resource is not needed for the prescribing workflow itself. However it may be useful during a patient consultation (or perhaps in response to an adverse event), to look up which tablet is the red triangle with an "X" imprint. These definitional facts can be captured with this resource. They would likely never be on a prescription, but this resource supports the prescribing process as well as other downstream events. The weights, sizes, chemical properties and so on are naturally important to manufacturers, distributors, and regulators - who need every property detailing.
A defining aspect of this resource is that the item described is in the state as it comes from being manufactured, and has had no other preparatory steps - such as crushing or mixing. It is in the state ready for packaging and distribution to consumers, and not necessarily in the state ready for administration (for which see AdministrableProductDefinition). This is the state where medication items are commonly encountered, within packaging, before actually being used. It is a medication item "as manufactured", recognizing that other non-medication items are also manufactured, and that even the administrable form of a drug, and the packaging that an item is placed into, have been manufactured at some stage.
The manufactured item describes the physical characteristics of the item, as opposed to its pharmaceutical aspects (which may only apply after mixing with other items - to become an AdministrableProductDefinition), or its packaging, or legal aspects (which apply only to the whole group of packing and manufactured items). There are typically multiple instances of the item in the packaging (a PackagedProductDefinition resource) and this is indicated by the quantity within the containing package (e.g. 12 tablets), referencing a single copy of the manufactured item.
This is the only resource that treats the "tablet" (or whatever it may be) as a physical object. It is still definitional however - it describes all instances of this tablet. The resource aims to capture the definition of a single medication item type, such as a tablet of aspirin with a certain form, shape, manufacturer. It is not intended to describe and be instantiated for each medication item, i.e. it is not an actual real instance of a tablet, but rather represents (e.g.) all tablets of the same medication item type, that are described by the ManufacturedItemDefinition.
To define several package variations, e.g. pack of 10 tablets and of 50 tablets, you would need only one ManufacturedItemDefinition, referenced from both (and associated with a numeric quantity of 10 or 50 in the respective PackagedProductDefintions). To prescribe or dispense 100 tablets, you would not generally need this resource at all, because usually the code of the medication product as a whole is sufficient, plus a quantity, e.g. 100 of "ABC123" (meaning e.g. aspirin 75 mg).
This resource excludes devices and other items found in medication packaging such as scissors, applicators and so on (which would use DeviceDefinition), and components of packaging that are not considered devices, such bottle stoppers (use PackagedProductDefintion.package.package).
Structure
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
  ManufacturedItemDefinition | TU | DomainResource | The definition and characteristics of a medicinal manufactured item, such as a tablet or capsule, as contained in a packaged medicinal product Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension | |
  identifier | Σ | 0..* | Identifier | Unique identifier |
 status | ?!Σ | 1..1 | code | draft | active | retired | unknown PublicationStatus (Required) |
| name | Σ | 0..1 | string | A descriptive name applied to this item |
| manufacturedDoseForm | Σ | 1..1 | CodeableConcept | Dose form as manufactured (before any necessary transformation) ManufacturedDoseForm (Example) |
| unitOfPresentation | Σ | 0..1 | CodeableConcept | The “real world” units in which the quantity of the item is described UnitOfPresentation (Example) |
 manufacturer | Σ | 0..* | Reference(Organization) | Manufacturer of the item, one of several possible |
| marketingStatus | Σ | 0..* | MarketingStatus | Allows specifying that an item is on the market for sale, or that it is not available, and the dates and locations associated |
| ingredient | Σ | 0..* | CodeableConcept | The ingredients of this manufactured item. Only needed if these are not specified by incoming references from the Ingredient resource SNOMED CT Substance Codes (Example) |
  property | Σ | 0..* | BackboneElement | General characteristics of this item |
 type | Σ | 1..1 | CodeableConcept | A code expressing the type of characteristic ProductCharacteristic (Example) |
  value[x] | Σ | 0..1 | A value for the characteristic | |
 valueCodeableConcept | CodeableConcept | |||
| valueQuantity | Quantity | |||
| valueDate | date | |||
| valueBoolean | boolean | |||
 valueAttachment | Attachment | |||
| component | Σ | 0..* | BackboneElement | Physical parts of the manufactured item, that it is intrisically made from. This is distinct from the ingredients that are part of its chemical makeup |
| type | Σ | 1..1 | CodeableConcept | Defining type of the component e.g. shell, layer, ink |
| function | Σ | 0..* | CodeableConcept | The function of this component within the item e.g. delivers active ingredient, masks taste |
| amount | Σ | 0..* | Quantity | The measurable amount of substance in this component, expressable in different ways (e.g. by mass or volume) |
| constituent | Σ | 0..* | BackboneElement | A reference to an constituent of the manufactured item as a whole, linked here so that its component location within the item can be indicated. This not where the item's ingredient are primarily stated (for which see Ingredient.for or ManufacturedItemDefinition.ingredient) |
| amount | Σ | 0..* | Quantity | The measurable amount of this constituent in this component, expressable in different ways (e.g. by mass or volume) |
| location | Σ | 0..* | CodeableConcept | The type of location of the constituent within this component e.g. intragranular, blend |
| function | Σ | 0..* | CodeableConcept | The function of this constituent within the component e.g. binder |
| locationForIngredient | Σ | 0..* | CodeableReference(Ingredient) | An ingredient that this component is the location of in this manufactured item. The component is physically made of this ingredient (and possibly others), rather than just being a container for it |
 property | Σ | 0..* | see property | General characteristics of this component |
| component | Σ | 0..* | see component | A component that this component contains or is made from |
| Documentation for this format | ||||
See the Extensions for this resource
UML Diagram (Legend)
XML Template
<ManufacturedItemDefinition xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Unique identifier --></identifier> <status value="[code]"/><!-- 1..1 draft | active | retired | unknown --> <name value="[string]"/><!-- 0..1 A descriptive name applied to this item --> <manufacturedDoseForm><!-- 1..1 CodeableConcept Dose form as manufactured (before any necessary transformation) --></manufacturedDoseForm> <unitOfPresentation><!-- 0..1 CodeableConcept The “real world” units in which the quantity of the item is described --></unitOfPresentation> <manufacturer><!-- 0..* Reference(Organization) Manufacturer of the item, one of several possible --></manufacturer> <marketingStatus><!-- 0..* MarketingStatus Allows specifying that an item is on the market for sale, or that it is not available, and the dates and locations associated --></marketingStatus> <ingredient><!-- 0..* CodeableConcept The ingredients of this manufactured item. Only needed if these are not specified by incoming references from the Ingredient resource --></ingredient> <property> <!-- 0..* General characteristics of this item --> <type><!-- 1..1 CodeableConcept A code expressing the type of characteristic --></type> <value[x]><!-- 0..1 CodeableConcept|Quantity|date|boolean|Attachment A value for the characteristic --></value[x]> </property> <component> <!-- 0..* Physical parts of the manufactured item, that it is intrisically made from. This is distinct from the ingredients that are part of its chemical makeup --> <type><!-- 1..1 CodeableConcept Defining type of the component e.g. shell, layer, ink --></type> <function><!-- 0..* CodeableConcept The function of this component within the item e.g. delivers active ingredient, masks taste --></function> <amount><!-- 0..* Quantity The measurable amount of substance in this component, expressable in different ways (e.g. by mass or volume) --></amount> <constituent> <!-- 0..* A reference to an constituent of the manufactured item as a whole, linked here so that its component location within the item can be indicated. This not where the item's ingredient are primarily stated (for which see Ingredient.for or ManufacturedItemDefinition.ingredient) --> <amount><!-- 0..* Quantity The measurable amount of this constituent in this component, expressable in different ways (e.g. by mass or volume) --></amount> <location><!-- 0..* CodeableConcept The type of location of the constituent within this component e.g. intragranular, blend --></location> <function><!-- 0..* CodeableConcept The function of this constituent within the component e.g. binder --></function> <locationForIngredient><!-- 0..* CodeableReference(Ingredient) An ingredient that this component is the location of in this manufactured item. The component is physically made of this ingredient (and possibly others), rather than just being a container for it --></locationForIngredient> </constituent> <property><!-- 0..* Content as for ManufacturedItemDefinition.property General characteristics of this component --></property> <component><!-- 0..* Content as for ManufacturedItemDefinition.component A component that this component contains or is made from --></component> </component> </ManufacturedItemDefinition>
JSON Template
{
"resourceType" : "ManufacturedItemDefinition",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // Unique identifier
"status" : "<code>", // R! draft | active | retired | unknown
"name" : "<string>", // A descriptive name applied to this item
"manufacturedDoseForm" : { CodeableConcept }, // R! Dose form as manufactured (before any necessary transformation)
"unitOfPresentation" : { CodeableConcept }, // The “real world” units in which the quantity of the item is described
"manufacturer" : [{ Reference(Organization) }], // Manufacturer of the item, one of several possible
"marketingStatus" : [{ MarketingStatus }], // Allows specifying that an item is on the market for sale, or that it is not available, and the dates and locations associated
"ingredient" : [{ CodeableConcept }], // The ingredients of this manufactured item. Only needed if these are not specified by incoming references from the Ingredient resource
"property" : [{ // General characteristics of this item
"type" : { CodeableConcept }, // R! A code expressing the type of characteristic
// value[x]: A value for the characteristic. One of these 5:
"valueCodeableConcept" : { CodeableConcept },
"valueQuantity" : { Quantity },
"valueDate" : "<date>",
"valueBoolean" : <boolean>,
"valueAttachment" : { Attachment }
}],
"component" : [{ // Physical parts of the manufactured item, that it is intrisically made from. This is distinct from the ingredients that are part of its chemical makeup
"type" : { CodeableConcept }, // R! Defining type of the component e.g. shell, layer, ink
"function" : [{ CodeableConcept }], // The function of this component within the item e.g. delivers active ingredient, masks taste
"amount" : [{ Quantity }], // The measurable amount of substance in this component, expressable in different ways (e.g. by mass or volume)
"constituent" : [{ // A reference to an constituent of the manufactured item as a whole, linked here so that its component location within the item can be indicated. This not where the item's ingredient are primarily stated (for which see Ingredient.for or ManufacturedItemDefinition.ingredient)
"amount" : [{ Quantity }], // The measurable amount of this constituent in this component, expressable in different ways (e.g. by mass or volume)
"location" : [{ CodeableConcept }], // The type of location of the constituent within this component e.g. intragranular, blend
"function" : [{ CodeableConcept }], // The function of this constituent within the component e.g. binder
"locationForIngredient" : [{ CodeableReference(Ingredient) }] // An ingredient that this component is the location of in this manufactured item. The component is physically made of this ingredient (and possibly others), rather than just being a container for it
}],
"property" : [{ Content as for ManufacturedItemDefinition.property }], // General characteristics of this component
"component" : [{ Content as for ManufacturedItemDefinition.component }] // A component that this component contains or is made from
}]
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .
Structure
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
| ManufacturedItemDefinition | TU | DomainResource | The definition and characteristics of a medicinal manufactured item, such as a tablet or capsule, as contained in a packaged medicinal product Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension | |
| identifier | Σ | 0..* | Identifier | Unique identifier |
| status | ?!Σ | 1..1 | code | draft | active | retired | unknown PublicationStatus (Required) |
| name | Σ | 0..1 | string | A descriptive name applied to this item |
| manufacturedDoseForm | Σ | 1..1 | CodeableConcept | Dose form as manufactured (before any necessary transformation) ManufacturedDoseForm (Example) |
| unitOfPresentation | Σ | 0..1 | CodeableConcept | The “real world” units in which the quantity of the item is described UnitOfPresentation (Example) |
| manufacturer | Σ | 0..* | Reference(Organization) | Manufacturer of the item, one of several possible |
| marketingStatus | Σ | 0..* | MarketingStatus | Allows specifying that an item is on the market for sale, or that it is not available, and the dates and locations associated |
| ingredient | Σ | 0..* | CodeableConcept | The ingredients of this manufactured item. Only needed if these are not specified by incoming references from the Ingredient resource SNOMED CT Substance Codes (Example) |
| property | Σ | 0..* | BackboneElement | General characteristics of this item |
| type | Σ | 1..1 | CodeableConcept | A code expressing the type of characteristic ProductCharacteristic (Example) |
| value[x] | Σ | 0..1 | A value for the characteristic | |
| valueCodeableConcept | CodeableConcept | |||
| valueQuantity | Quantity | |||
| valueDate | date | |||
| valueBoolean | boolean | |||
| valueAttachment | Attachment | |||
| component | Σ | 0..* | BackboneElement | Physical parts of the manufactured item, that it is intrisically made from. This is distinct from the ingredients that are part of its chemical makeup |
| type | Σ | 1..1 | CodeableConcept | Defining type of the component e.g. shell, layer, ink |
| function | Σ | 0..* | CodeableConcept | The function of this component within the item e.g. delivers active ingredient, masks taste |
| amount | Σ | 0..* | Quantity | The measurable amount of substance in this component, expressable in different ways (e.g. by mass or volume) |
| constituent | Σ | 0..* | BackboneElement | A reference to an constituent of the manufactured item as a whole, linked here so that its component location within the item can be indicated. This not where the item's ingredient are primarily stated (for which see Ingredient.for or ManufacturedItemDefinition.ingredient) |
| amount | Σ | 0..* | Quantity | The measurable amount of this constituent in this component, expressable in different ways (e.g. by mass or volume) |
| location | Σ | 0..* | CodeableConcept | The type of location of the constituent within this component e.g. intragranular, blend |
| function | Σ | 0..* | CodeableConcept | The function of this constituent within the component e.g. binder |
| locationForIngredient | Σ | 0..* | CodeableReference(Ingredient) | An ingredient that this component is the location of in this manufactured item. The component is physically made of this ingredient (and possibly others), rather than just being a container for it |
| property | Σ | 0..* | see property | General characteristics of this component |
| component | Σ | 0..* | see component | A component that this component contains or is made from |
| Documentation for this format | ||||
See the Extensions for this resource
XML Template
<ManufacturedItemDefinition xmlns="http://hl7.org/fhir">
JSON Template
{
"resourceType" : "ManufacturedItemDefinition",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // Unique identifier
"status" : "<code>", // R! draft | active | retired | unknown
"name" : "<string>", // A descriptive name applied to this item
"manufacturedDoseForm" : { CodeableConcept }, // R! Dose form as manufactured (before any necessary transformation)
"unitOfPresentation" : { CodeableConcept }, // The “real world” units in which the quantity of the item is described
"manufacturer" : [{ Reference(Organization) }], // Manufacturer of the item, one of several possible
"marketingStatus" : [{ MarketingStatus }], // Allows specifying that an item is on the market for sale, or that it is not available, and the dates and locations associated
"ingredient" : [{ CodeableConcept }], // The ingredients of this manufactured item. Only needed if these are not specified by incoming references from the Ingredient resource
"property" : [{ // General characteristics of this item
"type" : { CodeableConcept }, // R! A code expressing the type of characteristic
// value[x]: A value for the characteristic. One of these 5:
"valueCodeableConcept" : { CodeableConcept },
"valueQuantity" : { Quantity },
"valueDate" : "<date>",
"valueBoolean" : <boolean>,
"valueAttachment" : { Attachment }
}],
"component" : [{ // Physical parts of the manufactured item, that it is intrisically made from. This is distinct from the ingredients that are part of its chemical makeup
"type" : { CodeableConcept }, // R! Defining type of the component e.g. shell, layer, ink
"function" : [{ CodeableConcept }], // The function of this component within the item e.g. delivers active ingredient, masks taste
"amount" : [{ Quantity }], // The measurable amount of substance in this component, expressable in different ways (e.g. by mass or volume)
"constituent" : [{ // A reference to an constituent of the manufactured item as a whole, linked here so that its component location within the item can be indicated. This not where the item's ingredient are primarily stated (for which see Ingredient.for or ManufacturedItemDefinition.ingredient)
"amount" : [{ Quantity }], // The measurable amount of this constituent in this component, expressable in different ways (e.g. by mass or volume)
"location" : [{ CodeableConcept }], // The type of location of the constituent within this component e.g. intragranular, blend
"function" : [{ CodeableConcept }], // The function of this constituent within the component e.g. binder
"locationForIngredient" : [{ CodeableReference(Ingredient) }] // An ingredient that this component is the location of in this manufactured item. The component is physically made of this ingredient (and possibly others), rather than just being a container for it
}],
"property" : [{ Content as for ManufacturedItemDefinition.property }], // General characteristics of this component
"component" : [{ Content as for ManufacturedItemDefinition.component }] // A component that this component contains or is made from
}]
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .
Additional definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions, the spreadsheet version & the dependency analysis
| Path | Definition | Type | Reference |
|---|---|---|---|
| ManufacturedItemDefinition.status | The lifecycle status of an artifact. | Required | PublicationStatus |
| ManufacturedItemDefinition.manufacturedDoseForm | Dose form for a medication, as manufactured (and before any mixing etc.), not necessarily ready for administration to the patient. | Example | ManufacturedDoseForm |
| ManufacturedItemDefinition.unitOfPresentation | The presentation type in which an administrable medicinal product is given to a patient. | Example | UnitOfPresentation |
| ManufacturedItemDefinition.ingredient | This value set includes all substance codes from SNOMED CT - provided as an exemplar value set. | Example | SNOMEDCTSubstanceCodes |
| ManufacturedItemDefinition.property.type | This value set includes all observable entity codes from SNOMED CT - provided as an exemplar value set. | Example | ProductCharacteristic |
Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
| Name | Type | Description | Expression | In Common |
| dose-form | token | Dose form as manufactured and before any transformation into the pharmaceutical product | ManufacturedItemDefinition.manufacturedDoseForm | |
| identifier | token | Unique identifier | ManufacturedItemDefinition.identifier | |
| ingredient D | token | An ingredient of this item | ManufacturedItemDefinition.ingredient | |
| name D | token | A descriptive name applied to this item | ManufacturedItemDefinition.name | |
| status | token | The status of this item. Enables tracking the life-cycle of the content. | ManufacturedItemDefinition.status |
FHIR ®© HL7.org 2011+. FHIR R5 Ballot hl7.fhir.core#5.0.0-ballot generated on Sat, Sep 10, 2022 05:04+1000.
Links: Search |
Version History |
Contents |
Glossary |
QA |
Compare to R4B |
Compare to R5 Draft |
|
Propose a change