NZ FHIR Extension Registry (Beta)

This contents is historical. For the current NZ FHIR Extension Registry, please visit the URL below:

http://build.fhir.org/ig/HL7NZ/nzbase/branches/master/extensions.html

Introduction

These are NZ-specific extensions to the HL7® FHIR® Specification that are considered to have a scope of use beyond individual projects or products. The Base Address for these extensions is http://hl7.org.nz/fhir/StructureDefinition and the IDs in the table below all point to a resolvable Uniform Resource Location (URL) containing the related Structure Definition Resource. The FHIR Maturity Model (FMM) is used to indicate the level of stability and implementation readiness of each extension, as determined by the HL7NZ FHIR Implementation Work Group (it is likely to reflect the number of known implementations).

Resource / Data TypeIDDescription & Usage ExampleFMM
Addressbuilding-name The name of a building cited in an address.
Addressnz-geocode New Zealand Geocode. This uses a different datum from that defined in the HL7 FHIR specification for a Geocode.
Addresssuburb Suburb element of a New Zealand Address.  

<extension url="http://hl7.org.nz/fhir/StructureDefinition/suburb">
   <valueString value="Rototuna North" />
</extension>
Conditionlong-term-condition Long term condition indicator. 

<extension url="http://hl7.org.nz/fhir/StructureDefinition/long-term-condition">
       <valueBoolean value="true" />  
</extension>
1
Location
Organization
HealthcareService
edi-address  Represents an Electronic Data Interchange (EDI) address used by a Healthcare Facility, Organisation or Service. 
Location
Organization
HealthcareService
funded-programmeDetails of a NZ Healthcare Funded Programme relevant to its implementation status at an individual organisation, facility or service. 

<extension url ="http://hl7.co.nz/fhir/StructureDefinition/funded-programme">
    <extension url= "programmeType">
        <valueCode value = "dental">
    </extension>
    <extension url= "currentAvailability">
        <valueString value = "Children up to age 13">
    </extension> 
   <extension url="notes">
        <valueString value = "Dental care is only free on referral. Your child’s care will normally be managed by the Auckland Regional Dental Services (ARDs).”>
    </extension>
</extension>
 
1
Location
HealthcareService
Patient
dhb  District Health Board relating to a NZ Healthcare Service, Location (Healthcare Facility) or Patient (primary, physical home address)  

<extension url="http://hl7.org.nz/fhir/StructureDefinition/dhb">
   <valueCodeableConcept>
     <coding>
        <system value="https://standards.digital.health.nz/ns/dhb-code" />
        <code value="G00027-C" />
        <display value="Waikato District Health Board" />
      </coding>
   </valueCodeableConcept>
</extension>
3
Location
HealthcareService
Patient
pho  Primary Healthcare Organisation associated with a General Practice linked to a NZ Healthcare Service, Location (Facility) or Patient.

<extension url="http://hl7.org.nz/fhir/StructureDefinition/pho">
   <valueCodeableConcept>
     <coding>
        <system value="https://standards.digital.health.nz/ns/pho-code" />
        <code value="G05533-K" />
        <display value="Procare Networks Limited" />
      </coding>
   </valueCodeableConcept>
</extension>
1
MedicationRequestnzeps-long-term-medication Long term medication indicator. 

<extension url="http://hl7.org.nz/fhir/StructureDefinition/nzeps-long-term-medication">
       <valueBoolean value="true" />
</extension>
2
MedicationRequestnzeps-supply-period-reason The reason for a non-standard supply period, e.g. the patient going abroad.  

<extension url="http://hl7.org.nz/fhir/StructureDefinition/nzeps-supply-period-reason">
       <valueString value="Patient going overseas for 3 months" />    
</extension>
MedicationRequestnzeps-unusual-dose-quantityIndicates if an unusual dose quantity has been prescribed deliberately. 

<extension url="http://hl7.org.nz/fhir/StructureDefinition/nzeps-unusual-dose-quantity">
       <valueBoolean value="true" />  
</extension>
Patientbirth-place  The country where the person was born. 
Patientdomicile-code NZ Domicile Code. Derived from a patient’s primary, physical home address. 
Patientinformation-source  The official source of information held about a patient.  
Patientnz-citizenship NZ Citizenship Status.
Patient
Practitioner
nz-ethnicity  The ethnicity of the patient. Uses level 4 codes (most detailed). 
Patientnz-residency-statusNZ Residency Status.
Patientpatient-iwi Social Units in  Aotearoa (New Zealand) Māori society
Patientsex-at-birth A person’s sex at the time of their birth (considered to be immutable). 

Requests for additions to this list should be sent to HL7 New Zealand. In determining whether to add an Extension to this Registry the following will be considered by the HL7 New Zealand FHIR Implementation Work Group…

  1. Whether the extension has been published elsewhere, notably the FHIR Registry
  2. Feedback from the FHIR Implementer Community – principally, but not limited to, New Zealand
  3. The potential scope of use (NB at the request of a member, HL7 New Zealand may also host a valid NZ Extension that is considered outside the scope this Registry)
  4. The extension URL must consist of the Base Address of  http://hl7.org.nz/fhir/StructureDefinition/ followed by the extension ID
  5. The extension definition must be created and/or validated by this Work Group and include the following attributes…
<publisher value="HL7 New Zealand" />

  <contact>

   <telecom>
    <system value="email" />
    <value value="admin@hl7.org.nz" />
    <use value="work" />
   </telecom>
  </contact>

  <jurisdiction>
   <coding>
    <system value="urn:iso:std:iso:3166"/>
    <code value="NZ"/>
   </coding>
  </jurisdiction>

  <copyright value="HL7 New Zealand© 2020+; Licensed Under Creative Commons No Rights Reserved."/>