HL7 FHIR Implementation Guide - New Zealand Formulary/NZULM IG
0.1.0 - ci-build

HL7 FHIR Implementation Guide - New Zealand Formulary/NZULM IG, published by New Zealand Medicines Formulary LP. This is not an authorized publication; it is the continuous build for version 0.1.0). This version is based on the current content of https://github.com/HL7NZ/nzf/ and changes regularly. See the Directory of published versions

Home

Official URL: http://hl7.org.nz/fhir/ig/formulary/ImplementationGuide/hl7.org.nz.fhir.ig.formulary Version: 0.1.0
Draft as of 2023-03-16 Computable Name: NZFormularyIG

This IG is to support retrieving formulary and medication information in New Zealand. This is part of a project by the NZULM/NZ Formulary to provide the information we produce and collate in a standards-based form. As an organisation we want to make it as easy as possible to retrieve the medication information that you require in a timely manner.

The key resource for this implementation is the Medication resource. For those that are familiar with the New Zealand Medicines Terminology (NZMT) we will provide a medication resource for the key types of medications in the NZMT. These are:

  • Medicinal Product (MP) e.g. paracetamol
  • Trade Product (TP) e.g. panadol
  • Medicinal Product Unit of Use (MPUU) e.g. paracetamol 500 mg tablet
  • Trade Product Unit of Use (TPUU) e.g. Panadol (paracetamol 500 mg) tablet: film-coated, 1 tablet
  • Containered Trade Product Pack (CTPP) e.g. Panadol 500 mg tablet: film-coated, 1000 tablets, blister pack
  • Medicinal Product Pack (MPP) e.g. paracetamol 120 mg/5 mL oral liquid, 200 mL
  • Trade Product Pack (TPP) e.g. Panadol 500 mg tablet: film-coated, 12 tablets

The standard Medication resource provides the key information needed for integration however we have defined several extensions to allow for the addition of specific NZULM/Formulary information. The following table describes these extensions and shows which extensions apply to which medication type.

Extension Description MP TP MPUU TPUU MPP TPP CTPP
Type Type of NZMT reference (e.g. CTPP, MPUU) etc. Yes Yes Yes Yes Yes Yes
Cautionary and Advisory Labels (CALs) List of all Cautionary and Advisory labels associated with the medication Yes Yes Yes Yes Yes
ATC The Anatomical Therapeutic Chemical Classification code(s) Yes Yes Yes Yes Yes Yes
Unapproved True if the medication has not been approved by Medsafe and can be prescribed under section 29 Yes
Legal Classification Medsafe legal classification Yes Yes Yes
Medsafe Status Medsafe product status Yes
Prescribe by Brand Whether the medication should be prescribed by brand or not Yes
Funding NZ specific funding information provided by PHARMAC Yes
Funding rules The rules and constraints around funding for the given medicine provided by PHARMAC Yes
PHARMAC Supply Information PHARMAC provided information detailing medication supply issues Yes Yes Yes Yes Yes Yes Yes
Links Links to associated resources, such as monographs, datasheets and patient information leaflets Yes Yes Yes Yes Yes Yes Yes

The medication resources will also link to several documents (using the link extension). To facilitate this, we use DocumentReference resources.

We provide document references for the following data:

Data Description
Adult monographs A reference to all adult monographs - this allows for integrating systems to determine which monograph(s) to link to for a given medication
Child monographs A reference to all children monographs - this allows for integrating systems to determine which monograph(s) to link to for a given medication
Patient information leaflets A link to all patient information leaflets - these contain a number of extensions to provide extra information about the PIL (see mapping tab)
Medsafe Datasheets A reference to all medsafe datasheet URLs
Medsafe CMIs A reference to all medsafe CMI URLs

Medication code

All medications will have a nzmt code. Where applicable one or more Pharmacodes® will be added to a CTPP. Where applicable one or more GTIN codes will added to a CTPP or a TPUU

Subsidy information

Subsidy information is added to Containered Trade Product Packs where applicable. The funding information is derived from both the PHARMAC community schedule as well as the HML.

There are two extensions added that store this information. The first is nzf-funding. This stores the general information around funding for a specific product, including some of the community schedule details (price etc.) - see extension details To cater for the existence of multiple schedules this extension can be added to a product multiple times, once per schedule. This allows vendors to see both the current schedule information as well as an upcoming schedule. To determine which set of information to use the 'scheduleDate' field can be used. The second extension is nzf-funding-rule. This extension once again has a schedule date so vendors can determine which schedule they would like to look at. The purpose of this extension is to provide the PHARMAC funding rules that apply to the given product. Most of the data here comes from the ps_rule table (in the NZMT releases) however a number of attribute rules are also added. These are:

Name Condition Rule Type Rule value Rule text
Sole Subsidised Supply When a CTPP associated with a ps_brand entry has the sole_supply flag set SoleSupply Sole Subsidised Supply
Principal Sole Supply When a CTPP associated with a ps_brand entry has the pss flag set PrincipalSoleSupply Principal Sole Supply
Cost Brand Source When a CTPP associated with ps_pack entry has cost brand source = 1 CostBrandSource CBS
Original Pack When a CTPP associated with ps_pack entry has originalPack = 1 OriginalPack Original Pack
Hospital Supply Status When a CTPP associated with a ps_brand entry has the hss set HospitalSupplyStatus Hospital Supply Status
Safety: Uncompounded ps_formulary.safety = Uncompounded Safety Uncompounded Safety cap required
Safety: Compounded ps_formulary.safety = compounded Safety Compounded Safety cap required for extemporaneously compounded oral liquid preparations
Statim ps_formulary.statim = Must Statim Must Statim: Three months or six months, as applicable, dispensed all-at-once.
Statim ps_formulary.statim = Must Statim Must Statim: Three months or six months, as applicable, dispensed all-at-once.

See extension details

As we stated we want this to be as useful as possible so please get in touch if you have any feedback.

Related medications

Each medication can have one or more optional related medication extensions. These allow navigation through the NZMT concept hierarchy.

See extension details

The following table shows the related medications for each concept

Concept Related medications
CTPP MP
TPP
MPP MP
MPUU (1 or more)
MPUU MP
MPP (1 or more)
TPP MP
TP
TPUU (1 or more)
MPP
TPUU MP
TP
TPP (1 or more)
MPUU