Release 4

This page is part of the FHIR Specification (v4.0.1: R4 - Mixed Normative and STU) in it's permanent home (it will always be available at this URL). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions

Biomedical Research and Regulation Work GroupMaturity Level: 0 Trial UseSecurity Category: Anonymous Compartments: Not linked to any defined compartments

Detailed Descriptions for the elements in the SubstanceSpecification resource.

SubstanceSpecification
Element IdSubstanceSpecification
Definition

The detailed description of a substance, typically at a level beyond what is used for prescribing.

Cardinality0..*
TypeDomainResource
Summarytrue
SubstanceSpecification.identifier
Element IdSubstanceSpecification.identifier
Definition

Identifier by which this substance is known.

NoteThis is a business identifier, not a resource identifier (see discussion)
Cardinality0..1
TypeIdentifier
Summarytrue
SubstanceSpecification.type
Element IdSubstanceSpecification.type
Definition

High level categorization, e.g. polymer or nucleic acid.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.status
Element IdSubstanceSpecification.status
Definition

Status of substance within the catalogue e.g. approved.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.domain
Element IdSubstanceSpecification.domain
Definition

If the substance applies to only human or veterinary use.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.description
Element IdSubstanceSpecification.description
Definition

Textual description of the substance.

Cardinality0..1
Typestring
Summarytrue
SubstanceSpecification.source
Element IdSubstanceSpecification.source
Definition

Supporting literature.

Cardinality0..*
TypeReference(DocumentReference)
Summarytrue
SubstanceSpecification.comment
Element IdSubstanceSpecification.comment
Definition

Textual comment about this record of a substance.

Cardinality0..1
Typestring
Summarytrue
SubstanceSpecification.moiety
Element IdSubstanceSpecification.moiety
Definition

Moiety, for structural modifications.

Cardinality0..*
Summarytrue
SubstanceSpecification.moiety.role
Element IdSubstanceSpecification.moiety.role
Definition

Role that the moiety is playing.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.moiety.identifier
Element IdSubstanceSpecification.moiety.identifier
Definition

Identifier by which this moiety substance is known.

NoteThis is a business identifier, not a resource identifier (see discussion)
Cardinality0..1
TypeIdentifier
Summarytrue
SubstanceSpecification.moiety.name
Element IdSubstanceSpecification.moiety.name
Definition

Textual name for this moiety substance.

Cardinality0..1
Typestring
Summarytrue
SubstanceSpecification.moiety.stereochemistry
Element IdSubstanceSpecification.moiety.stereochemistry
Definition

Stereochemistry type.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.moiety.opticalActivity
Element IdSubstanceSpecification.moiety.opticalActivity
Definition

Optical activity type.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.moiety.molecularFormula
Element IdSubstanceSpecification.moiety.molecularFormula
Definition

Molecular formula.

Cardinality0..1
Typestring
Summarytrue
SubstanceSpecification.moiety.amount[x]
Element IdSubstanceSpecification.moiety.amount[x]
Definition

Quantitative value for this moiety.

Cardinality0..1
TypeQuantity|string
[x] NoteSee Choice of Data Types for further information about how to use [x]
Summarytrue
SubstanceSpecification.property
Element IdSubstanceSpecification.property
Definition

General specifications for this substance, including how it is related to other substances.

Cardinality0..*
Summarytrue
SubstanceSpecification.property.category
Element IdSubstanceSpecification.property.category
Definition

A category for this property, e.g. Physical, Chemical, Enzymatic.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.property.code
Element IdSubstanceSpecification.property.code
Definition

Property type e.g. viscosity, pH, isoelectric point.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.property.parameters
Element IdSubstanceSpecification.property.parameters
Definition

Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1).

Cardinality0..1
Typestring
Summarytrue
SubstanceSpecification.property.definingSubstance[x]
Element IdSubstanceSpecification.property.definingSubstance[x]
Definition

A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol).

Cardinality0..1
TypeReference(SubstanceSpecification | Substance)|CodeableConcept
[x] NoteSee Choice of Data Types for further information about how to use [x]
Summarytrue
SubstanceSpecification.property.amount[x]
Element IdSubstanceSpecification.property.amount[x]
Definition

Quantitative value for this property.

Cardinality0..1
TypeQuantity|string
[x] NoteSee Choice of Data Types for further information about how to use [x]
Summarytrue
SubstanceSpecification.referenceInformation
Element IdSubstanceSpecification.referenceInformation
Definition

General information detailing this substance.

Cardinality0..1
TypeReference(SubstanceReferenceInformation)
Summarytrue
SubstanceSpecification.structure
Element IdSubstanceSpecification.structure
Definition

Structural information.

Cardinality0..1
Summarytrue
SubstanceSpecification.structure.stereochemistry
Element IdSubstanceSpecification.structure.stereochemistry
Definition

Stereochemistry type.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.structure.opticalActivity
Element IdSubstanceSpecification.structure.opticalActivity
Definition

Optical activity type.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.structure.molecularFormula
Element IdSubstanceSpecification.structure.molecularFormula
Definition

Molecular formula.

Cardinality0..1
Typestring
Summarytrue
SubstanceSpecification.structure.molecularFormulaByMoiety
Element IdSubstanceSpecification.structure.molecularFormulaByMoiety
Definition

Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot.

Cardinality0..1
Typestring
Summarytrue
SubstanceSpecification.structure.isotope
Element IdSubstanceSpecification.structure.isotope
Definition

Applicable for single substances that contain a radionuclide or a non-natural isotopic ratio.

Cardinality0..*
Summarytrue
SubstanceSpecification.structure.isotope.identifier
Element IdSubstanceSpecification.structure.isotope.identifier
Definition

Substance identifier for each non-natural or radioisotope.

NoteThis is a business identifier, not a resource identifier (see discussion)
Cardinality0..1
TypeIdentifier
Summarytrue
SubstanceSpecification.structure.isotope.name
Element IdSubstanceSpecification.structure.isotope.name
Definition

Substance name for each non-natural or radioisotope.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.structure.isotope.substitution
Element IdSubstanceSpecification.structure.isotope.substitution
Definition

The type of isotopic substitution present in a single substance.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.structure.isotope.halfLife
Element IdSubstanceSpecification.structure.isotope.halfLife
Definition

Half life - for a non-natural nuclide.

Cardinality0..1
TypeQuantity
Summarytrue
SubstanceSpecification.structure.isotope.molecularWeight
Element IdSubstanceSpecification.structure.isotope.molecularWeight
Definition

The molecular weight or weight range (for proteins, polymers or nucleic acids).

Cardinality0..1
Summarytrue
SubstanceSpecification.structure.isotope.molecularWeight.method
Element IdSubstanceSpecification.structure.isotope.molecularWeight.method
Definition

The method by which the molecular weight was determined.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.structure.isotope.molecularWeight.type
Element IdSubstanceSpecification.structure.isotope.molecularWeight.type
Definition

Type of molecular weight such as exact, average (also known as. number average), weight average.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.structure.isotope.molecularWeight.amount
Element IdSubstanceSpecification.structure.isotope.molecularWeight.amount
Definition

Used to capture quantitative values for a variety of elements. If only limits are given, the arithmetic mean would be the average. If only a single definite value for a given element is given, it would be captured in this field.

Cardinality0..1
TypeQuantity
Summarytrue
SubstanceSpecification.structure.molecularWeight
Element IdSubstanceSpecification.structure.molecularWeight
Definition

The molecular weight or weight range (for proteins, polymers or nucleic acids).

Cardinality0..1
TypeSee SubstanceSpecification.structure.isotope.molecularWeight
Summarytrue
SubstanceSpecification.structure.source
Element IdSubstanceSpecification.structure.source
Definition

Supporting literature.

Cardinality0..*
TypeReference(DocumentReference)
Summarytrue
SubstanceSpecification.structure.representation
Element IdSubstanceSpecification.structure.representation
Definition

Molecular structural representation.

Cardinality0..*
Summarytrue
SubstanceSpecification.structure.representation.type
Element IdSubstanceSpecification.structure.representation.type
Definition

The type of structure (e.g. Full, Partial, Representative).

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.structure.representation.representation
Element IdSubstanceSpecification.structure.representation.representation
Definition

The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX.

Cardinality0..1
Typestring
Summarytrue
SubstanceSpecification.structure.representation.attachment
Element IdSubstanceSpecification.structure.representation.attachment
Definition

An attached file with the structural representation.

Cardinality0..1
TypeAttachment
Summarytrue
SubstanceSpecification.code
Element IdSubstanceSpecification.code
Definition

Codes associated with the substance.

Cardinality0..*
Summarytrue
SubstanceSpecification.code.code
Element IdSubstanceSpecification.code.code
Definition

The specific code.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.code.status
Element IdSubstanceSpecification.code.status
Definition

Status of the code assignment.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.code.statusDate
Element IdSubstanceSpecification.code.statusDate
Definition

The date at which the code status is changed as part of the terminology maintenance.

Cardinality0..1
TypedateTime
Summarytrue
SubstanceSpecification.code.comment
Element IdSubstanceSpecification.code.comment
Definition

Any comment can be provided in this field, if necessary.

Cardinality0..1
Typestring
Summarytrue
SubstanceSpecification.code.source
Element IdSubstanceSpecification.code.source
Definition

Supporting literature.

Cardinality0..*
TypeReference(DocumentReference)
Summarytrue
SubstanceSpecification.name
Element IdSubstanceSpecification.name
Definition

Names applicable to this substance.

Cardinality0..*
Summarytrue
SubstanceSpecification.name.name
Element IdSubstanceSpecification.name.name
Definition

The actual name.

Cardinality1..1
Typestring
Summarytrue
SubstanceSpecification.name.type
Element IdSubstanceSpecification.name.type
Definition

Name type.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.name.status
Element IdSubstanceSpecification.name.status
Definition

The status of the name.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.name.preferred
Element IdSubstanceSpecification.name.preferred
Definition

If this is the preferred name for this substance.

Cardinality0..1
Typeboolean
Summarytrue
SubstanceSpecification.name.language
Element IdSubstanceSpecification.name.language
Definition

Language of the name.

Cardinality0..*
TypeCodeableConcept
Summarytrue
SubstanceSpecification.name.domain
Element IdSubstanceSpecification.name.domain
Definition

The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive.

Cardinality0..*
TypeCodeableConcept
Summarytrue
SubstanceSpecification.name.jurisdiction
Element IdSubstanceSpecification.name.jurisdiction
Definition

The jurisdiction where this name applies.

Cardinality0..*
TypeCodeableConcept
Summarytrue
SubstanceSpecification.name.synonym
Element IdSubstanceSpecification.name.synonym
Definition

A synonym of this name.

Cardinality0..*
TypeSee SubstanceSpecification.name
Summarytrue
SubstanceSpecification.name.translation
Element IdSubstanceSpecification.name.translation
Definition

A translation for this name.

Cardinality0..*
TypeSee SubstanceSpecification.name
Summarytrue
SubstanceSpecification.name.official
Element IdSubstanceSpecification.name.official
Definition

Details of the official nature of this name.

Cardinality0..*
Summarytrue
SubstanceSpecification.name.official.authority
Element IdSubstanceSpecification.name.official.authority
Definition

Which authority uses this official name.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.name.official.status
Element IdSubstanceSpecification.name.official.status
Definition

The status of the official name.

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.name.official.date
Element IdSubstanceSpecification.name.official.date
Definition

Date of official name change.

Cardinality0..1
TypedateTime
Summarytrue
SubstanceSpecification.name.source
Element IdSubstanceSpecification.name.source
Definition

Supporting literature.

Cardinality0..*
TypeReference(DocumentReference)
Summarytrue
SubstanceSpecification.molecularWeight
Element IdSubstanceSpecification.molecularWeight
Definition

The molecular weight or weight range (for proteins, polymers or nucleic acids).

Cardinality0..*
TypeSee SubstanceSpecification.structure.isotope.molecularWeight
Summarytrue
SubstanceSpecification.relationship
Element IdSubstanceSpecification.relationship
Definition

A link between this substance and another, with details of the relationship.

Cardinality0..*
Summarytrue
SubstanceSpecification.relationship.substance[x]
Element IdSubstanceSpecification.relationship.substance[x]
Definition

A pointer to another substance, as a resource or just a representational code.

Cardinality0..1
TypeReference(SubstanceSpecification)|CodeableConcept
[x] NoteSee Choice of Data Types for further information about how to use [x]
Summarytrue
SubstanceSpecification.relationship.relationship
Element IdSubstanceSpecification.relationship.relationship
Definition

For example "salt to parent", "active moiety", "starting material".

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.relationship.isDefining
Element IdSubstanceSpecification.relationship.isDefining
Definition

For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships.

Cardinality0..1
Typeboolean
Summarytrue
SubstanceSpecification.relationship.amount[x]
Element IdSubstanceSpecification.relationship.amount[x]
Definition

A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other.

Cardinality0..1
TypeQuantity|Range|Ratio|string
[x] NoteSee Choice of Data Types for further information about how to use [x]
Summarytrue
SubstanceSpecification.relationship.amountRatioLowLimit
Element IdSubstanceSpecification.relationship.amountRatioLowLimit
Definition

For use when the numeric.

Cardinality0..1
TypeRatio
Summarytrue
SubstanceSpecification.relationship.amountType
Element IdSubstanceSpecification.relationship.amountType
Definition

An operator for the amount, for example "average", "approximately", "less than".

Cardinality0..1
TypeCodeableConcept
Summarytrue
SubstanceSpecification.relationship.source
Element IdSubstanceSpecification.relationship.source
Definition

Supporting literature.

Cardinality0..*
TypeReference(DocumentReference)
Summarytrue
SubstanceSpecification.nucleicAcid
Element IdSubstanceSpecification.nucleicAcid
Definition

Data items specific to nucleic acids.

Cardinality0..1
TypeReference(SubstanceNucleicAcid)
Summarytrue
SubstanceSpecification.polymer
Element IdSubstanceSpecification.polymer
Definition

Data items specific to polymers.

Cardinality0..1
TypeReference(SubstancePolymer)
Summarytrue
SubstanceSpecification.protein
Element IdSubstanceSpecification.protein
Definition

Data items specific to proteins.

Cardinality0..1
TypeReference(SubstanceProtein)
Summarytrue
SubstanceSpecification.sourceMaterial
Element IdSubstanceSpecification.sourceMaterial
Definition

Material or taxonomic/anatomical source for the substance.

Cardinality0..1
TypeReference(SubstanceSourceMaterial)
Summarytrue