Resource type: substance

Description

A homogeneous material with a definite composition.

Elements

PathShortDefinitionComments
A homogeneous material with a definite compositionA homogeneous material with a definite composition.
identifierUnique identifierUnique identifier for the substance.This identifier is associated with the kind of substance in contrast to the Substance.instance.identifier which is associated with the package/container.
statusactive | inactive | entered-in-errorA code to indicate if the substance is actively used.
categoryWhat class/type of substance this isA code that classifies the general type of substance. This is used for searching, sorting and display purposes.The level of granularity is defined by the category concepts in the value set. More fine-grained filtering can be performed using the metadata and/or terminology hierarchy in Substance.code.
codeWhat substance this isA code (or set of codes) that identify this substance.This could be a reference to an externally defined code. It could also be a locally assigned code (e.g. a formulary), optionally with translations to the standard drug codes.
descriptionTextual description of the substance, commentsA description of the substance - its appearance, handling requirements, and other usage notes.
instanceIf this describes a specific package/container of the substanceSubstance may be used to describe a kind of substance, or a specific package/container of the substance: an instance.
instance.idUnique id for inter-element referencingUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
instance.extensionAdditional content defined by implementationsMay 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.
instance.modifierExtensionExtensions that cannot be ignored even if unrecognizedMay 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.
instance.identifierIdentifier of the package/containerIdentifier associated with the package/container (usually a label affixed directly).
instance.expiryWhen no longer valid to useWhen the substance is no longer valid to use. For some substances, a single arbitrary date is used for expiry.
instance.quantityAmount of substance in the packageThe amount of the substance.
ingredientComposition information about the substanceA substance can be composed of other substances.
ingredient.idUnique id for inter-element referencingUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
ingredient.extensionAdditional content defined by implementationsMay 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.
ingredient.modifierExtensionExtensions that cannot be ignored even if unrecognizedMay 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.
ingredient.quantityOptional amount (concentration)The amount of the ingredient in the substance - a concentration ratio.
ingredient.substance[x]A component of the substanceAnother substance that is a component of this substance.

Scope and Usage

This resource allows for a material to be represented. The resource can be used to represent either a kind of a substance - e.g. a formulation commonly used for treating patients, or it can be used to describe a particular package of a known substance (e.g. bottle, jar, packet).

The composition of the material can be specified in terms of a mix of other materials, including with precise amounts if required.

Boundaries and Relationships

A medication is a substance that is packaged and used as an administered medication. The medication resource uses the substance resource to represent the actual ingredients of a medication.

Search Parameters

categoryThe category of the substanceSubstance.category
codeThe code of the substance or ingredientSubstance.code | (Substance.ingredient.substance as CodeableConcept)
container-identifierIdentifier of the package/containerSubstance.instance.identifier
expiryExpiry date of package or container of substanceSubstance.instance.expiry
identifierUnique identifier for the substanceSubstance.identifier
quantityAmount of substance in the packageSubstance.instance.quantity
statusactive | inactive | entered-in-errorSubstance.status
substance-referenceA component of the substance(Substance.ingredient.substance as Reference)

Extension Definitions

These are extension definitions for this resource defined by the spec