--- type: "resource" title: "Substance" resource: "Substance" --- # Substance ## Introduction ## Scope and Usage This is a base resource that represents raw materials used to represent a packaged or measured amount of a known substance (e.g. bottle, jar, packet, drum) that is not in a consumable form nor associated directly with a patient. For example, the materials used for a medication that are not yet in an administrable form. This resource is used for "instances" of substances. The resource is not used to represent a kind of a substance - e.g. a formulation commonly used for treating patients (a "definitional" use). For that use see SubstanceDefinition resource. A Substance may be identifiable as precise as the specific container it is stored in, while more commonly it would be based on a combination of lot number, quantity, and package type. ## Boundaries and Relationships A medication is a substance that is packaged and used as an administered medication. The [medication resource](medication) uses the substance resource to represent the actual ingredients of a medication. This resource represents an instance of a substance. For definitions (type, kind) see the [SubstanceDefinition](substancedefinition) resource, which is purely definitional. A SubstanceDefinition describes the common characteristics of the substance, including those needed for regulatory agencies. A [NutritionProduct](nutritionproduct) distinguishes from a Substance in that a nutrition product is primary consumable purpose is for its nutritional effect. A [BiologicallyDerivedProduct](biologicallyderivedproduct) distinguishes from a Substance in that a BiologicallyDerivedProduct has its origins in a biological entity and needs to carry the source’s characteristics to enable matching and compatibility with the biological target to which it will be transfused or implanted, as well as traceability to the source. ## StructureDefinition ### Elements (Simplified) - **[Substance](/substance-definitions#Substance)** [0..*]: - A homogeneous material with a definite composition - **[Substance.identifier](/substance-definitions#Substance.identifier)** [0..*]: [Identifier](/Identifier) Unique identifier - **[Substance.status](/substance-definitions#Substance.status)** [0..1]: [code](/code) required:[substance-status](/valueset-substance-status) active | inactive | entered-in-error - **[Substance.category](/substance-definitions#Substance.category)** [0..*]: [CodeableConcept](/CodeableConcept) extensible:[substance-category](/valueset-substance-category) What class/type of substance this is - **[Substance.code](/substance-definitions#Substance.code)** [1..1]: [CodeableReference](/CodeableReference) example:[substance-code](/valueset-substance-code) What substance this is - **[Substance.description](/substance-definitions#Substance.description)** [0..1]: [markdown](/markdown) Textual description of the substance, comments - **[Substance.expiry](/substance-definitions#Substance.expiry)** [0..1]: [dateTime](/dateTime) When no longer valid to use - **[Substance.quantity](/substance-definitions#Substance.quantity)** [0..1]: [Quantity](/Quantity)([SimpleQuantity](/SimpleQuantity)) Amount of substance in the package ## Mappings - [Substance Mappings](/substance-mappings) — 15 mapping entries ## Resource Packs ### list-Substance-packs.xml ```xml ``` ## Search Parameters - [category](/substance-search#category) — **token** — The category of the substance — `Substance.category` - [code](/substance-search#code) — **token** — The code of the substance — `Substance.code.concept` - [code-reference](/substance-search#code-reference) — **reference** — A reference to the defining substance — `Substance.code.reference` - [expiry](/substance-search#expiry) — **date** — Expiry date of package or container of substance — `Substance.expiry` - [identifier](/substance-search#identifier) — **token** — Unique identifier for the substance — `Substance.identifier` - [quantity](/substance-search#quantity) — **quantity** — Amount of substance in the package — `Substance.quantity` - [status](/substance-search#status) — **token** — active | inactive | entered-in-error — `Substance.status` [Full Search Parameters](/substance-search) ## Examples - [example](/substance-example-example) — substance-example — General Example - [f201](/substance-example-f201) — substance-example-f201-dust — Dust Mite Example - [f202](/substance-example-f202) — substance-example-f202-staphylococcus — Staphylococcus Example - [f203](/substance-example-f203) — substance-example-f203-potassium — Potassium Example - [f204](/substance-example-f204) — substance-example-silver-nitrate-product — Silver Nitrate Product Example - [f205](/substance-example-f205) — substance-example-amoxicillin-clavulanate — Amoxicillin-Clavulanate Example - [substance-example](/substance-example-substance-example) — substance-example - [substance-example-amoxicillin-clavulanate](/substance-example-substance-example-amoxicillin-clavulanate) — substance-example-amoxicillin-clavulanate - [substance-example-f201-dust](/substance-example-substance-example-f201-dust) — substance-example-f201-dust - [substance-example-f202-staphylococcus](/substance-example-substance-example-f202-staphylococcus) — substance-example-f202-staphylococcus - [substance-example-f203-potassium](/substance-example-substance-example-f203-potassium) — substance-example-f203-potassium - [substance-example-silver-nitrate-product](/substance-example-substance-example-silver-nitrate-product) — substance-example-silver-nitrate-product - [substance-examples-header](/substance-example-substance-examples-header) — substance-examples-header [Full Examples](/substance-examples) ## Mapping Exceptions ### substance-fivews-mapping-exceptions.xml ### Unmapped Elements - **FiveWs.recorded** — Unknown - **FiveWs.author** — Unknown - **FiveWs.actor** — Unknown - **FiveWs.cause** — Unknown - **FiveWs.version** — Unknown - **FiveWs.witness** — Unknown - **FiveWs.where** — Unknown - **FiveWs.context** — Unknown - **FiveWs.init** — Unknown - **FiveWs.why** — Unknown - **FiveWs.source** — Unknown - **FiveWs.who** — Unknown - **FiveWs.grade** — Unknown - **FiveWs.planned** — Unknown - **FiveWs.done** — Unknown - **FiveWs.subject** — Unknown