Natural Health Product Properties¶
The terminology service returns three properties on concepts of the Natural Product Number code
system (http://terminology.hl7.org/CodeSystem/v3-hc-npn) when a consumer calls $lookup: the
product's dose-form group, and its strength as a value and a unit. They let a consumer label a
licensed natural health product by strength and form ("25 mcg capsule") without parsing Health
Canada's free-text dosage forms.
This guide does not define the Natural Product Number code system -- HL7 Terminology does -- and it ships no code system definition or supplement for it. The terminology service adds these properties to the concepts it serves; this page is where the guide describes them.
The three properties¶
| Code | Property URI | Type | Meaning |
|---|---|---|---|
dose-form-group |
https://fhir.apps.health/CodeSystem/nexus-hc-properties#dose-form-group |
Coding | "The group of the licence's first dosage form, where it is one of the eleven a clinician does not tell apart by spelling (softgel, capsule, tablet, ...): a Coding in https://fhir.apps.health/CodeSystem/nexus-nhp-dose-form-group. Absent for a form in no group." |
strength-value |
https://fhir.apps.health/CodeSystem/nexus-hc-properties#strength-value |
decimal | "Single-ingredient licences only: the medicinal ingredient's QUANTITY per dosage unit (not its potency), as the licence states it, on the mass scale most licences of that ingredient use; IU is never converted, and a power of ten in the unit (billion cfu) is never folded into the value. Absent only where the quantity or the unit is missing, the quantity is a range, or the licence states it two different ways; never for an unusual unit." |
strength-unit |
https://fhir.apps.health/CodeSystem/nexus-hc-properties#strength-unit |
Coding | "The unit of strength-value: a Coding in UCUM (http://unitsofmeasure.org) wherever UCUM has the unit (homeopathic potencies as [hp_X], [hp_C], [hp_Q], [kp_C], and the M potencies as 1000.[hp_C]; 10*9.[CFU] for billion cfu), otherwise in https://fhir.apps.health/CodeSystem/nexus-nhp-strength-unit. The display is the licence's own unit text ("CH", "M", "billion cfu", "mg AT"), so strength-value followed by the display reads as the licence does ("6 CH", "10 billion cfu"). Present exactly when strength-value is." |
The quoted meanings are the property descriptions exactly as the terminology service declares them.
dose-form-groupis a Coding in the NHP Dose Form Group CodeSystem, a curated, editorial set of eleven groups. Its displays are lower case because the label follows a strength.strength-unitis a Coding in UCUM (http://unitsofmeasure.org) wherever UCUM has the unit, including the homeopathic potencies and annotated units such asug{RAE}. A unit UCUM has no code for is coded in the NHP Strength Unit CodeSystem instead, whose concepts carry English and Canadian French displays. In either system thedisplayis the licence's own unit text ("mcg", "M", "FCC ALU"), while thecodeis the system's code ("ug", "1000.[hp_C]", "fcc-alu"): read the code, show the display.- The property URIs sit under
https://fhir.apps.health/CodeSystem/nexus-hc-properties, a name this guide reserves as a stem for property URIs. It is not a code system this guide defines, and it does not resolve to a page.
When each property is present¶
dose-form-groupis present only when the licence's first recorded dosage form is one of the forms a group gathers. Every other form has no group, and there is no catch-all: present the product's own dosage form instead.strength-valueandstrength-unitappear together or not at all, and only for single-ingredient licences. They are absent only where the quantity or its unit is missing, the quantity is a range, or the licence states it two different ways -- never because a unit is unusual: a unit UCUM lacks is coded in the NHP Strength Unit CodeSystem rather than dropped.
The declarations themselves (code, URI, type, description) are not returned by reading the code
system from the terminology service; a consumer meets the properties per concept, in $lookup output.
Examples¶
Each response below is verbatim from the terminology service, trimmed to the name, version, display, code and the properties this page describes (the service returns further properties that are not part of this contract).
A capsule with a strength, "Vita-D" (NPN 80111984):
{
"resourceType": "Parameters",
"parameter": [
{
"name": "system",
"valueUri": "http://terminology.hl7.org/CodeSystem/v3-hc-npn"
},
{
"name": "version",
"valueString": "20260918"
},
{
"name": "display",
"valueString": "Vita-D"
},
{
"name": "code",
"valueCode": "80111984"
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "dose-form-group"
},
{
"name": "value",
"valueCoding": {
"system": "https://fhir.apps.health/CodeSystem/nexus-nhp-dose-form-group",
"code": "capsule",
"display": "capsule"
}
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "strength-value"
},
{
"name": "value",
"valueDecimal": 25
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "nhp-dosage-form"
},
{
"name": "value",
"valueCode": "Capsule"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "strength-unit"
},
{
"name": "value",
"valueCoding": {
"system": "http://unitsofmeasure.org",
"code": "ug",
"display": "mcg"
}
}
]
}
]
}
A strength with no group, "Melatonin" (NPN 80000829): its dosage form, a strip, is not in any group.
{
"resourceType": "Parameters",
"parameter": [
{
"name": "system",
"valueUri": "http://terminology.hl7.org/CodeSystem/v3-hc-npn"
},
{
"name": "version",
"valueString": "20260918"
},
{
"name": "display",
"valueString": "Melatonin"
},
{
"name": "code",
"valueCode": "80000829"
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "strength-value"
},
{
"name": "value",
"valueDecimal": 3
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "nhp-dosage-form"
},
{
"name": "value",
"valueCode": "Strip"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "strength-unit"
},
{
"name": "value",
"valueCoding": {
"system": "http://unitsofmeasure.org",
"code": "mg",
"display": "mg"
}
}
]
}
]
}
A group with no strength, "BIO 88" (NPN 80002513): a homeopathic product with five medicinal ingredients, so it carries no strength -- strength is given for single-ingredient licences only.
{
"resourceType": "Parameters",
"parameter": [
{
"name": "system",
"valueUri": "http://terminology.hl7.org/CodeSystem/v3-hc-npn"
},
{
"name": "version",
"valueString": "20260918"
},
{
"name": "display",
"valueString": "BIO 88"
},
{
"name": "code",
"valueCode": "80002513"
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "dose-form-group"
},
{
"name": "value",
"valueCoding": {
"system": "https://fhir.apps.health/CodeSystem/nexus-nhp-dose-form-group",
"code": "oral-drops",
"display": "oral drops"
}
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "nhp-dosage-form"
},
{
"name": "value",
"valueCode": "Drops"
}
]
}
]
}
Notices¶
This page reproduces Health Canada open data (product names and dosage forms from the Licensed Natural Health Products Database) and UCUM unit codes.
Contains information licensed under the Open Government Licence – Canada. Contient de l'information visée par la Licence du gouvernement ouvert – Canada.
The UCUM table and UCUM codes are copyright © 1995-2024, Regenstrief Institute, Inc. and the Unified Codes for Units of Measures (UCUM) Organization. All rights reserved.
Related¶
- pan-Canadian LOINC Properties -- the properties and designations a
$lookupreturns for pan-Canadian LOINC Observation Code Database concepts, as Infoway publishes them. - Translated Codes -- how a coding added by translation says how faithful it is.
- Medications Value Set -- where Natural Product Number concepts enter this guide.
A UCUM annotated unit, "Kripps Vitamin A" (NPN 00360341): the unit is UCUM ug{RAE} (micrograms of
retinol activity equivalents), displayed as the licence writes it, "mcg RAE".
{
"resourceType": "Parameters",
"parameter": [
{
"name": "system",
"valueUri": "http://terminology.hl7.org/CodeSystem/v3-hc-npn"
},
{
"name": "version",
"valueString": "20260918"
},
{
"name": "display",
"valueString": "Kripps Vitamin A"
},
{
"name": "code",
"valueCode": "00360341"
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "dose-form-group"
},
{
"name": "value",
"valueCoding": {
"system": "https://fhir.apps.health/CodeSystem/nexus-nhp-dose-form-group",
"code": "capsule",
"display": "capsule"
}
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "strength-value"
},
{
"name": "value",
"valueDecimal": 3000
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "nhp-dosage-form"
},
{
"name": "value",
"valueCode": "Capsule"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "strength-unit"
},
{
"name": "value",
"valueCoding": {
"system": "http://unitsofmeasure.org",
"code": "ug{RAE}",
"display": "mcg RAE"
}
}
]
}
]
}
A unit UCUM has no code for, "Lactase Enzyme" (NPN 02243674): the unit is coded in the NHP Strength Unit
CodeSystem, displayed "FCC ALU". A $lookup of fcc-alu in that code system with
displayLanguage=fr-CA returns the Canadian French display, "unité de lactase acide (FCC ALU)".
{
"resourceType": "Parameters",
"parameter": [
{
"name": "system",
"valueUri": "http://terminology.hl7.org/CodeSystem/v3-hc-npn"
},
{
"name": "version",
"valueString": "20260918"
},
{
"name": "display",
"valueString": "Lactase Enzyme"
},
{
"name": "code",
"valueCode": "02243674"
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "dose-form-group"
},
{
"name": "value",
"valueCoding": {
"system": "https://fhir.apps.health/CodeSystem/nexus-nhp-dose-form-group",
"code": "capsule",
"display": "capsule"
}
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "strength-value"
},
{
"name": "value",
"valueDecimal": 9000
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "nhp-dosage-form"
},
{
"name": "value",
"valueCode": "Capsule"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "strength-unit"
},
{
"name": "value",
"valueCoding": {
"system": "https://fhir.apps.health/CodeSystem/nexus-nhp-strength-unit",
"code": "fcc-alu",
"display": "FCC ALU"
}
}
]
}
]
}
A homeopathic M potency, "Agnus Castus" (NPN 80135970): the unit is UCUM 1000.[hp_C] (1000C), and the
display keeps the licence's notation, "M", so the strength reads "1 M" as the licence does.
{
"resourceType": "Parameters",
"parameter": [
{
"name": "system",
"valueUri": "http://terminology.hl7.org/CodeSystem/v3-hc-npn"
},
{
"name": "version",
"valueString": "20260918"
},
{
"name": "display",
"valueString": "Agnus Castus"
},
{
"name": "code",
"valueCode": "80135970"
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "dose-form-group"
},
{
"name": "value",
"valueCoding": {
"system": "https://fhir.apps.health/CodeSystem/nexus-nhp-dose-form-group",
"code": "oral-drops",
"display": "oral drops"
}
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "strength-value"
},
{
"name": "value",
"valueDecimal": 1
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "nhp-dosage-form"
},
{
"name": "value",
"valueCode": "Oral drops"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueCode": "strength-unit"
},
{
"name": "value",
"valueCoding": {
"system": "http://unitsofmeasure.org",
"code": "1000.[hp_C]",
"display": "M"
}
}
]
}
]
}