HL7® FHIR® New Zealand Base Implementation Guide
3.1.0 - Draft

HL7® FHIR® New Zealand Base Implementation Guide, published by HL7 New Zealand. This guide is not an authorized publication; it is the continuous build for version 3.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7nz/nzbase/ and changes regularly. See the Directory of published versions

## Extensions

Id | Canonical url | Context of Use | Description | Purpose
--- | --- | --- | --- | ---
acc-patient-occupation | http://hl7.org.nz/fhir/StructureDefinition/acc-patient-occupation | Patient | Codes to describe a patient's occupation, using ACC's patient occupation codeset. Note that the current ValueSet binding contains codes from NZSC099. ACC are planning to update this ValueSet to base the codes on ANZSCO at the request of Stats NZ (Timing TBC), so the binding strength has been left as 'example'. |
additional-authorisation | http://hl7.org.nz/fhir/StructureDefinition/additional-authorisation | Practitioner.qualification | Additional authorisations that a practitioner is authorised to perform in addition to their registration and scope of practice. Examples include: Prescribing authorisation for a nurse practitioner Authorisation to administer immunisations |
alias-type | http://hl7.org.nz/fhir/StructureDefinition/alias-type | Location.alias Organization.alias | Used to indicate what sort of alias is being used in a Location or Organization - eg that it is a legal name. |
building-name | http://hl7.org.nz/fhir/StructureDefinition/building-name | Address | The name of a building cited in an address. |
condition-on-practice | http://hl7.org.nz/fhir/StructureDefinition/condition-on-practice | Practitioner.qualification | A full description of the conditions the health practitioner is subject to in relation to their scope of practice. |
contactpoint-purpose | http://hl7.org.nz/fhir/StructureDefinition/contactpoint-purpose | ContactPoint | A specific purpose for which this ContactPoint dataType would be used. An example would be to indicate that this ContactPoint is used for video conferencing. |
country-name | http://hl7.org.nz/fhir/StructureDefinition/country-name | Address | The display name for a country in an address. |
death-date | http://hl7.org.nz/fhir/StructureDefinition/death-date | Practitioner | The date of death of the individual, plus the source of that information |
dhb | http://hl7.org.nz/fhir/StructureDefinition/dhb | HealthcareService Location Patient | District Health Board relating to a NZ Healthcare Service, Location (Facility) or Patient (primary, physical home address). | Administrative - to allow NZ HealthcareService, Location (Facility) or Patient Resources to include the related District Health Board.
domicile-code | http://hl7.org.nz/fhir/StructureDefinition/domicile-code | Patient Address | NZ Domicile Code. Derived from a patient's primary physical, home address. |
edi-address | http://hl7.org.nz/fhir/StructureDefinition/edi-address | ContactPoint.system | Represents an Electronic Data Interchange (EDI) address. It is intended as an extension on ContactPoint.system, with the system value being 'other'. The value of the extension is the EDI supplier, the actual EDI address is the value element. Note that a new extension 'messaging address' is preferred. |
educational-qualification | http://hl7.org.nz/fhir/StructureDefinition/educational-qualification | Practitioner | Educational qualifications a practitioner has. These may or may not be related to registration information. |
established | http://hl7.org.nz/fhir/StructureDefinition/established | Location Organization | The period over which the location or Organization is open |
funded-programme | http://hl7.org.nz/fhir/StructureDefinition/funded-programme | Location Organization HealthcareService | Funded NZ Healthcare Programmes | Details of a NZ Healthcare Funded Programme relevant to its implementation status at an individual organisation, facility or service.
gender-original-text | http://hl7.org.nz/fhir/StructureDefinition/gender-original-text | Patient.gender | ​Text provided by the person with the choice of 'Another gender' (The FHIR AdministrativeGender CodeSystem codes this as 'other'). |
information-source | http://hl7.org.nz/fhir/StructureDefinition/information-source | Patient.name Patient.birthDate Patient.deceased.ofType(dateTime) | The official source of information held about a patient. |
long-term-condition | http://hl7.org.nz/fhir/StructureDefinition/long-term-condition | Condition | Long Term Condition Indicator. A long term condition can be defined as any ongoing, long term or recurring conditions that can have a significant impact on people’s lives. | For more info see https://www.tewhatuora.govt.nz/for-the-health-sector/health-sector-guidance/diseases-and-conditions/long-term-conditions.
maori-descent | http://hl7.org.nz/fhir/StructureDefinition/maori-descent | Patient | Code indicating whether the person is of Māori descent |
messaging-address | http://hl7.org.nz/fhir/StructureDefinition/messaging-address | Patient Location Organization HealthcareService PractitionerRole Practitioner | The address to where electronic communications might be sent. For historical reasons, there is an overlap with edi-address. |
nz-citizenship | http://hl7.org.nz/fhir/StructureDefinition/nz-citizenship | Patient | New Zealand citizenship |
nz-ethnicity | http://hl7.org.nz/fhir/StructureDefinition/nz-ethnicity | Patient Practitioner RelatedPerson | The ethnic group or groups that a person identifies with or feels they belong to. Ethnicity is a measure of cultural affiliation as opposed to race, ancestry, nationality or citizen. Ethnicity is self-perceived and a person can belong to more than one group. The Stats New Zealand standard can be found here. |
nz-geocode | http://hl7.org.nz/fhir/StructureDefinition/nz-geocode | Address | New Zealand Geocode. This uses a different datum from that defined in the HL7 FHIR specification for a Geocode. |
nz-iwi | http://hl7.org.nz/fhir/StructureDefinition/nz-iwi | Patient Practitioner RelatedPerson | Persons Iwi affiliation |
nz-residency | http://hl7.org.nz/fhir/StructureDefinition/nz-residency | Patient | NZ Residency status |
nzeps-long-term-medication | http://hl7.org.nz/fhir/StructureDefinition/nzeps-long-term-medication | MedicationRequest MedicationStatement | NZePS Long Term Medication Indicator | This has specific uses in NZ Pharmacy and GP systems for funding and clinical purposes. It is also part of the HISO 10041.1 standard for Medication Lists.
nzeps-supply-period-reason | http://hl7.org.nz/fhir/StructureDefinition/nzeps-supply-period-reason | MedicationRequest | The reason for a non-standard Supply Period. | The reason for a non-standard supply period, e.g. the patient going abroad.
nzeps-unusual-dose-quantity | http://hl7.org.nz/fhir/StructureDefinition/nzeps-unusual-dose-quantity | MedicationRequest | NZePS Unusual Dose Quantity Indicator | Indicates if an unusual dose quantity has been prescribed deliberately.
nzf-atc | http://hl7.org.nz/fhir/StructureDefinition/nzf-atc | Medication | Anatomical Therapeutic Chemical (ATC) Classification - see https://www.who.int/tools/atc-ddd-toolkit/atc-classification |
nzf-nzmt-type | http://hl7.org.nz/fhir/StructureDefinition/nzf-nzmt-type | Medication | The NZ Medicines Terminology (NZMT) Data Class – MP (Medicinal Product), MPUU (Medicinal Product Unit of Use), MPP (Medicinal Product Pack), TP (Trade Product), TPUU (Trade Product Unit of Use), TPP (Trade Product Pack) or CTPP (Containered Trade Product Pack) – that the Medication is a member of. |
pho | http://hl7.org.nz/fhir/StructureDefinition/pho | HealthcareService Location Patient | Primary Healthcare Organisation associated with a General Practice linked to a NZ Healthcare Service, Location (Facility) or Patient (GP). | Administrative - to allow NZ HealthcareService, Location (Facility) or Patient Resources to include the related Primary Healthcare Organisation.
practitionerRole-creator | http://hl7.org.nz/fhir/StructureDefinition/practitionerRole-creator | PractitionerRole | The organisation and person that created this role |
practitionerRole-status-reason | http://hl7.org.nz/fhir/StructureDefinition/practitionerRole-status-reason | PractitionerRole | The reason for the status. Generally only used for inactive resources. |
registration-initial-date | http://hl7.org.nz/fhir/StructureDefinition/registration-initial-date | Practitioner.qualification | The date the practitioner first became registered with the Responsible Authority or professional body |
registration-status-code | http://hl7.org.nz/fhir/StructureDefinition/registration-status-code | Practitioner.qualification | An indicator of the practicing status of the practitioner as supplied by their Responsible Authority or professional body. |
scope-of-practice | http://hl7.org.nz/fhir/StructureDefinition/scope-of-practice | Practitioner.qualification | The type or range of health services a practitioner is authorised to perform, as determined by the Responsible Authority or professional body. |
sex-at-birth | http://hl7.org.nz/fhir/StructureDefinition/sex-at-birth | Patient | A person’s sex at the time of their birth (considered to be immutable). |
suburb | http://hl7.org.nz/fhir/StructureDefinition/suburb | Address | Suburb element of a NZ Address. | Required as FHIR Base Address Type does not contain an element for Suburb (only District or State which, in population terms, are both broader than City - whereas Suburb is narrower).