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

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Behavior: Capability Statements

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

Behavior: Operation Definitions

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.
To ask an MPI to match a patient, clients use the "$match" operation, which accepts a patient resource. The patient resource submitted to the operation does not have to be complete, nor does it need to pass validation (i.e. mandatory fields don't need to be populated), but it does have to be a valid instance, as it is used as the reference data to match against.

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.

Structures: Logical Models

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

Structures: Resource Profiles

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.

Structures: Data Type Profiles

These define constraints on FHIR data types for systems conforming to this implementation guide.

NHI Address

Adds additional, NHI specific extensions

Structures: Extension Definitions

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

Terminology: Value Sets

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

Example: Example Instances

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