New Zealand NHI IG
1.4.1 - Release
New Zealand NHI IG - Local Development build (v1.4.1) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
Contents:
This page provides a list of the FHIR artifacts defined as part of this implementation guide.
The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.
| NhiCapabilityStatement |
A FHIR API in front of the New Zealand NHI |
These are custom operations that can be supported by and/or invoked by systems conforming to this implementation guide.
| Add a name to a patient's NHI record. |
A custom operation to add a name to a patient’s NHI record |
| An operation to inactivate a name that is currently active on a patients record. |
An operation to inactivate a name that is currently active on a patients record |
| An operation to update a patients citizenship information |
A custom operation to update a patient’s citizenship information. |
| Find patient matches using MPI based logic |
When an NHI number is not known, a match by demographics can be used to find the patient record. For the patient match service,
the name and birthdate are required at a minimum. Other demographics such as gender, birthplace and address can be used to improve
the match results. The NHI search uses a probabilistic search and returns results in order of their match score with the highest
scoring result returned as the first in the bundle. The more match criteria provided, in as complete a form as is known, the more
accurate the results returned will be. It is better to enter the complete name even if spelling is not accurate, than entering just
part of the name. |
| Patient-create |
A custom operation to create a patient in the NHI |
| Remove a patient's postal address. |
A custom operation to remove a patient’s postal address |
| Replace a name on a patient's NHI record. |
A custom operation to replace a name on a patient’s record. |
| Set patient's preferred name |
An operation to indicate which of the patient’s names is preferred |
| Update a patient address using an unvalidated address. |
A custom operation to Update a patient address using an unvalidated address. |
| Update a patient's address. |
A custom operation to update a patient’s address. |
| Update patient's birth details |
A custom operation to to update a patient’s birth details. |
| Update patient's death details |
A custom operation to to update a patient’s death details. |
| Update patient's self-identified demographic information |
A custom operation to update a patient’s self-identified demographic information. |
These define data models that represent the domain covered by this implementation guide in more business-friendly terms than the underlying FHIR resources.
| Patient |
Representing a person receiving healthcare |
These define constraints on FHIR resources for systems conforming to this implementation guide.
| Create NHI Patient |
The information to be supplied when requesting that a new Patient resource be created in the NHI. |
| NHI Patient |
The Patient resource exposed by the NHI. |
These define constraints on FHIR data types for systems conforming to this implementation guide.
| NHI Address |
Adds additional, NHI specific extensions |
These define constraints on FHIR data types for systems conforming to this implementation guide.
| BirthPlace |
The country where the person was born |
| NameUseExtra |
Additional name use codes for NHI names |
| NhiAddressDerived |
Address elements that are directly derived from the address validation service |
| NotValidatedAddressReason |
The reason why the address has not been validated |
| NzAddressId |
Uniquely identifies this address as a physical entity. Will remain constant over time even if address administrative data such as DPID change |
| OriginalText |
The uncoded original text that was provided by the patient as their Gender |
These define sets of codes used by systems conforming to this implementation guide.
| NHI ContactPoint System Codes |
System values for a ContactPoint supported by the NHI |
| NHI ContactPoint Use Codes |
Types of contact use supported by the NHI |
These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.
| Match |
Example $Match (Find NHI) Request |
| ZAA0792 |
Example Patient dormant identifier, two addresses |
| ZAT2348 |
Example Patient - deceased |
| ZAT2496 |
Example Patient - With linked ‘dormant’ identifier |
| ZJM9397 |
Example Patient - with validated residential and mailing addresses |
| ZKC4633 |
Example Patient - with enrolled GP and contact details |
| create1 |
example patient parameter for $create-patient request |
| create2-error- |
example patient parameter for $create-patient request - errors no-preferred-name, not address line |
| create3-errors |
example patient parameter for $create-patient request, errors:name must contain either a given or family name(EM02101),no primary address(EM02201), birthdate < 1900 (EM07212), deceasedDateTime < birthdate(EM07215), Baby of name source not NPRF (EM07225) |
| validate |
Example $Match (Validate) Request |
| validate-response |
Example $Match (Validate) Response |