NameFlagsCard.TypeDescription & Constraintsdoco
.. SubstanceDefinition TUDomainResourceThe detailed description of a substance, typically at a level beyond what is used for prescribing

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ0..*IdentifierIdentifier by which this substance is known

... version Σ0..1stringA business level version identifier of the substance
... status Σ0..1CodeableConceptStatus of substance within the catalogue e.g. active, retired
Binding: PublicationStatus (Preferred)
... classification Σ0..*CodeableConceptA categorization, high level e.g. polymer or nucleic acid, or food, chemical, biological, or lower e.g. polymer linear or branch chain, or type of impurity

... domain Σ0..1CodeableConceptIf the substance applies to human or veterinary use
Binding: Medicinal Product Domain (Example)
... grade Σ0..*CodeableConceptThe quality standard, established benchmark, to which substance complies (e.g. USP/NF, BP)
Binding: Substance Grade (Example)

... description Σ0..1markdownTextual description of the substance
... informationSource Σ0..*Reference(Citation)Supporting literature

... note Σ0..*AnnotationTextual comment about the substance's catalogue or registry record

... manufacturer Σ0..*Reference(Organization)The entity that creates, makes, produces or fabricates the substance

... supplier Σ0..*Reference(Organization)An entity that is the source for the substance. It may be different from the manufacturer

... moiety Σ0..*BackboneElementMoiety, for structural modifications

.... role Σ0..1CodeableConceptRole that the moiety is playing
.... identifier Σ0..1IdentifierIdentifier by which this moiety substance is known
.... name Σ0..1stringTextual name for this moiety substance
.... stereochemistry Σ0..1CodeableConceptStereochemistry type
Binding: Stereochemistry (Example)
.... opticalActivity Σ0..1CodeableConceptOptical activity type
Binding: Optical Activity (Example)
.... molecularFormula Σ0..1stringMolecular formula for this moiety (e.g. with the Hill system)
.... amount[x] Σ0..1Quantitative value for this moiety
..... amountQuantityQuantity
..... amountStringstring
.... measurementType Σ0..1CodeableConceptThe measurement type of the quantitative value
Binding: Substance Amount Type (Example)
... characterization Σ0..*BackboneElementGeneral specifications for this substance

.... technique Σ0..1CodeableConceptThe method used to find the characterization e.g. HPLC
Binding: Structure Technique (Example)
.... form Σ0..1CodeableConceptDescribes the nature of the chemical entity and explains, for instance, whether this is a base or a salt form
Binding: Substance Form (Example)
.... description Σ0..1markdownThe description or justification in support of the interpretation of the data file
.... file Σ0..*AttachmentThe data produced by the analytical instrument or a pictorial representation of that data. Examples: a JCAMP, JDX, or ADX file, or a chromatogram or spectrum analysis

... property Σ0..*BackboneElementGeneral specifications for this substance

.... type Σ1..1CodeableConceptA code expressing the type of property
Binding: Product Characteristic (Example)
.... value[x] Σ0..1A value for the property
..... valueCodeableConceptCodeableConcept
..... valueQuantityQuantity
..... valueDatedate
..... valueBooleanboolean
..... valueAttachmentAttachment
... referenceInformation Σ0..1Reference(SubstanceReferenceInformation)General information detailing this substance
... molecularWeight Σ0..*BackboneElementThe average mass of a molecule of a compound

.... method Σ0..1CodeableConceptThe method by which the weight was determined
Binding: Weight Method (Example)
.... type Σ0..1CodeableConceptType of molecular weight e.g. exact, average, weight average
Binding: Weight Type (Example)
.... amount Σ1..1QuantityUsed to capture quantitative values for a variety of elements
... structure Σ0..1BackboneElementStructural information
.... stereochemistry Σ0..1CodeableConceptStereochemistry type
Binding: Stereochemistry (Example)
.... opticalActivity Σ0..1CodeableConceptOptical activity type
Binding: Optical Activity (Example)
.... molecularFormula Σ0..1stringAn expression which states the number and type of atoms present in a molecule of a substance
.... molecularFormulaByMoiety Σ0..1stringSpecified per moiety according to the Hill system
.... molecularWeight Σ0..1see molecularWeightThe molecular weight or weight range
.... technique Σ0..*CodeableConceptThe method used to find the structure e.g. X-ray, NMR
Binding: Structure Technique (Example)

.... sourceDocument Σ0..*Reference(DocumentReference)Source of information for the structure

.... representation Σ0..*BackboneElementA depiction of the structure of the substance

..... type Σ0..1CodeableConceptThe kind of structural representation (e.g. full, partial)
Binding: Substance Representation Type (Example)
..... representation Σ0..1stringThe structural representation as a text string in a standard format
..... format Σ0..1CodeableConceptThe format of the representation e.g. InChI, SMILES, MOLFILE (note: not the physical file format)
Binding: Substance Representation Format (Example)
..... document Σ0..1Reference(DocumentReference)An attachment with the structural representation e.g. a structure graphic or AnIML file
... code Σ0..*BackboneElementCodes associated with the substance

.... code Σ0..1CodeableConceptThe specific code
.... status Σ0..1CodeableConceptStatus of the code assignment, for example 'provisional', 'approved'
Binding: PublicationStatus (Preferred)
.... statusDate Σ0..1dateTimeThe date at which the code status was changed
.... note Σ0..*AnnotationAny comment can be provided in this field

.... source Σ0..*Reference(DocumentReference)Supporting literature

... name Σ0..*BackboneElementNames applicable to this substance

.... name Σ1..1stringThe actual name
.... type Σ0..1CodeableConceptName type e.g. 'systematic', 'scientific, 'brand'
Binding: Substance Name Type (Example)
.... status Σ0..1CodeableConceptThe status of the name e.g. 'current', 'proposed'
Binding: PublicationStatus (Preferred)
.... preferred Σ0..1booleanIf this is the preferred name for this substance
.... language Σ0..*CodeableConceptHuman language that the name is written in
Binding: All Languages (Required)
Additional BindingsPurpose
Common LanguagesStarter Set


.... domain Σ0..*CodeableConceptThe use context of this name e.g. as an active ingredient or as a food colour additive
Binding: Substance Name Domain (Example)

.... jurisdiction Σ0..*CodeableConceptThe jurisdiction where this name applies
Binding: Jurisdiction ValueSet (Example)

.... synonym Σ0..*see nameA synonym of this particular name, by which the substance is also known

.... translation Σ0..*see nameA translation for this name into another human language

.... official Σ0..*BackboneElementDetails of the official nature of this name

..... authority Σ0..1CodeableConceptWhich authority uses this official name
Binding: Substance Name Authority (Preferred)
..... status Σ0..1CodeableConceptThe status of the official name, for example 'draft', 'active'
Binding: PublicationStatus (Preferred)
..... date Σ0..1dateTimeDate of official name change
.... source Σ0..*Reference(DocumentReference)Supporting literature

... relationship Σ0..*BackboneElementA link between this substance and another

.... substanceDefinition[x] Σ0..1A pointer to another substance, as a resource or a representational code
..... substanceDefinitionReferenceReference(SubstanceDefinition)
..... substanceDefinitionCodeableConceptCodeableConcept
.... type Σ1..1CodeableConceptFor example "salt to parent", "active moiety"
Binding: Substance Relationship Type (Example)
.... isDefining Σ0..1booleanFor example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible relationships
.... amount[x] Σ0..1A numeric factor for the relationship, e.g. that a substance salt has some percentage of active substance in relation to some other
..... amountQuantityQuantity
..... amountRatioRatio
..... amountStringstring
.... ratioHighLimitAmount Σ0..1RatioFor use when the numeric has an uncertain range
.... comparator Σ0..1CodeableConceptAn operator for the amount, for example "average", "approximately", "less than"
Binding: Substance Amount Type (Example)
.... source Σ0..*Reference(DocumentReference)Supporting literature

... nucleicAcid Σ0..1Reference(SubstanceNucleicAcid)Data items specific to nucleic acids
... polymer Σ0..1Reference(SubstancePolymer)Data items specific to polymers
... protein Σ0..1Reference(SubstanceProtein)Data items specific to proteins
... sourceMaterial Σ0..1BackboneElementMaterial or taxonomic/anatomical source
.... type Σ0..1CodeableConceptClassification of the origin of the raw material. e.g. cat hair is an Animal source type
Binding: Source Material Type (Example)
.... genus Σ0..1CodeableConceptThe genus of an organism e.g. the Latin epithet of the plant/animal scientific name
Binding: Source Material Genus (Example)
.... species Σ0..1CodeableConceptThe species of an organism e.g. the Latin epithet of the species of the plant/animal
Binding: Source Material Species (Example)
.... part Σ0..1CodeableConceptAn anatomical origin of the source material within an organism
Binding: Source Material Part (Example)
.... countryOfOrigin Σ0..*CodeableConceptThe country or countries where the material is harvested
Binding: Country ValueSet (Required)


doco Documentation for this format