New Zealand NHI IG
1.6.1 - Release
New Zealand NHI IG
1.6.1 - Release
New Zealand NHI IG - Local Development build (v1.6.1) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
No, the NHI FHIR service currently supports $match but not Patient search.
The purpose of using $Match versus a regular search is that $Match is intended to target and find a specific single patient for recording information about, reducing errors through incorrectly selecting the wrong patient. This aligns better with the NHI probabilistic search algorithm. The $Match operation won't return any data if there is insufficient search parameter data, such as a partial surname. This compares to a regular search which can be used for finding lists of patients, such as to locate a group of patients that share an attribute.
The NHI $match operation processes a parameters resource containing a complete or fragment of a patient resource, along with some other control parameters. This means that an application cannot search the NHI using the Patient Search Parameters.
The standard FHIR $Match on patient does not allow an age range parameter. A year and month or year only can be used if the exact birthdate is not known An extension to allow an age-range parameter is being considered. Please contact the integration team if this is something that would benefit you.
No, eSAM addresses do not include any details about apartment names or retirement village names. Building name is entered by a user and provided to the NHI in addition to the eSAM address ID.
The enrolled general practice and contact details are not held in the NHI but are retrieved from the National Enrolment Service and returned along with the NHI details in the NHI Patient profile. The Patient Version-id only reflects when details held on the NHI change.
There is no ordering of ethnicities on the NHI – they are returned as supplied to the NHI. If a prioritised ethnicity is required on output for analysis/reporting/kpi etc then follow the rules described in the Ethnicity data Protocol section 5.5.2 Prioritised Output
The information source attribute is used to provide provenance to the attribute it corresponds to. It is required when a patient record is created or when an update is made.
The information source attribute is required on the following attributes:
Information sources are classified as unverified, verified or registered.
Unverified sources are added when no documentation has been sighted to verify the information. Verified sources are added when a specific document has been sighted to verify the information. Registered sources are only added by Te Whatu Ora when the information has been verified with the official source e.g. Department of Internal Affairs.
The service will return an error if a request attempts to update:
For more information of the list of information sources see the glossary definitions
The information source is only required to be displayed to an end user if the business requirement is to provide evidence of the quality of information held.
The information source is not required to be stored in the local system.
The NHI provides update access to all users with the correct permissions.
If an attribute is not present it can be added using the update-eligibility operation.
If present then an unverified source can be updated to a verified source, a verified source can then be updated to another verified source (if required) or by an authorised user to a registered source.
Local role based access should limit the updating of NZ Citizenship to users with a good knowledge of the NZ Citizenship determination.
NZ Citizenship is an attribute that was introduced with the NHI SOAP services in 2016 (It is not available in HL7 legacy). It is mostly populated from a DIA share of historic births since approximately 1930. Where data could be successfully matched to an NHI, the NZ Citizenship status was updated to Yes and the NZ Citizenship status Information Source to DIA. The absence of NZ Citizenship status does not mean a person is not a Citizen, only that we have not received or processed information to update the Citizenship status value.
Providers can update the NZ Citizenship status if there is no data on the NHI for their patient and the source is not DIA. Evidence of citizenship should be sighted before updating the NHI. Organisations may want to limit update capability of these fields to users who have a good understanding of the eligibility rules.
| Status of the record | Percentage of records | Breakdown of source for yes reponses |
|---|---|---|
| NHIs with no citizenship details | 67% | |
| Unknown | 6% | |
| No | 2% | |
| Yes | 25% | BREG 84% BRCT 7% NPRF 7% PPRT 1% NZCT <1% |
The New Zealand resident status attribute was introduced in the NHI Legacy service to capture resident status:
Organiations with legacy update access had the ability to update the New Zealand resident status for a person. The process for updating varied between integrators which resulted in inconsistent data quailty.
With the release of the NHI SOAP service the attribute was discontinued, however is still maintained today by some integrators using the NHI Legacy service.
A new attribute NZ Residency was designed to capture a person with a resident class visa. For the NHI, there is currently no data sharing agreement with Immigration New Zealand or mechanism to populate this data from an authorised source.
We have removed this attribute from the NHI Patient profile. There is no current timeframe for when this might be returned.
Gender is a self-identified attribute and refers to a person’s social and personal identity as male, female, or another gender.
A person’s current gender may differ from the sex recorded at their birth, may change over time and some people may not identify with any gender.
While multiple responses to the gender question are valid, only a single gender code can be updated in the NHI.
See the source standard for more information about how to collect gender information from the person.
For More information see:
The standard ethnicity question for the health and disability sector mirrors the Statistics New Zealand 2018 Census ethnicity question. The ethnicity question has been rigorously tested by Stats NZ to establish the most effective wording, layout and font, and is re analysed after every census.
Consumer facing applications that allow a person to update their NHI ethnicity must present the standard question in an unanswered format when a request to change is made. Do not present their previous responses for amendment.
For More information see:
For a description on dormant identifier see Linking resources and Dormant identifiers