HL7 FHIR Implementation Guide - New Zealand Formulary/NZULM IG
1.0.0 - ci-build
HL7 FHIR Implementation Guide - New Zealand Formulary/NZULM IG, published by New Zealand Medicines Formulary LP. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7NZ/nzf/ and changes regularly. See the Directory of published versions
The New Zealand Medicines Terminology (NZMT) database has been designed from the SNOMED data model, and is intended to provide a single, consistent database of names for medicines and trade products containing these medicines.
This is a simplified view of the structure of the NZ Medicines Terminology. It uses an example medicine to show how information is linked together.
It does not show all of the information available and the multitude of relationships that can exist. For example a medicine may be available in more than one dose form, strength and brand.
*Panadol is a registered trademark of the Haleon group of companies.
Concept | Examples |
Medicinal Product (MP) | ibuprofen |
Medicinal Product Pack (MPP) | ibuprofen 10 mg/2 mL injection, 4 x 2 mL ampoules ibuprofen 200 mg capsule, 96 |
Medicinal Product Unit of Use (MPUU) | ibuprofen 800 mg tablet: modified release ibuprofen 200 mg/5 mL oral liquid |
Trade Product (TP) | Fenpaed Caldolor Nurofen |
Trade Product Pack (TPP) | ACT-3 200 mg capsule: soft, 48 capsules ACT-3 200 mg capsule: soft, 20 capsules ACT-3 (ibuprofen 200 mg) capsule: soft, 12 |
Trade Product Unit of Use (TPUU) | Nurofen Solutabs (ibuprofen 200 mg) tablet: dispersible, 1 tablet Nurofen Duralast (ibuprofen 200 mg/24 hours) patch Nurofen Caplet (ibuprofen 200 mg) tablet: sugar-coated, 1 tablet |
Container Trade Product Pack (CTPP) | Medreich Ibuprofen 200 mg tablet: film-coated, 96 tablets, blister pack Nurofen 200 mg tablet: sugar-coated, 6 tablets, blister pack Nurofen 400 Double Strength 400 mg tablet: sugar-coated, 48 tablets, blister pack |
The SNOMED spec dictates that all records are identified by a globally unique 18-digit number. This means that you can create a single lookup table inside your database that contains all the id numbers of all the NZMT records in your database and you won’t get a single duplicate.
The primary purpose of this globally unique key is to allow records from any of the Medicines Terminologies operated by SNOMED member nations to co-exist in a single database if required, and also to conform to the very flexible but rather challenging to use “three-table” structure of the standard SNOMED data structure (which is not covered in this document – please ask if you need additional information).
id numbers that are 18 digits wide are just slightly too large to fit within the largest integers supported by most databases. So all record IDs are stored as 18 character strings.
The 18-digit key contains (in order):
E.g.: 50004811000117106 breaks down as: 5000481 – 1000117 – 10 – 6
Note 1: The Australian national namespace code is: 1000036. You can use this to identify data imported from the AMT.
Note 2: We currently only use 7 of the available 8 digits in the initial sequence number, so as in our example above almost all of our SCTIDs are actually 17-character strings.
Note 3: The SNOMED ‘partition code’ has three values: 10 for Concept IDs, 11 for Description IDs and 12 for Relationship IDs. The example above is therefore a Concept ID and is actually the SCTID for a CTPP record. All of the seven primary tables and of the lookup tables are considered to have Concept IDs. The descriptions table has Description IDs, while relationship tables such as MHM and THT have Relationship IDs.