HIP FHIR Common Terminology Guide
1.8.7 - Release

HIP FHIR Common Terminology Guide - Local Development build (v1.8.7) 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.

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

Address Not Validated Reason

Reason why an address is not validated.

Address Purpose (Qualifier) for Facility

Facility address purpose

Address Purpose (Qualifier) for Organisation

Organisation address purpose

Address Type for Facility

Facility address type

Address Type for Organisation

Organisation address type

Address Type for Patient

Patient address type

Address Use for Location

Location address use

Address Use for Organisation

Organisation address use

Contact Type

Contact type

Contact Usage

Contact usage

Country of Birth Information Source

A coded type for the source of information for a birth country.

Coverage Type

New Zealand codes for Coverage Types

Date of Birth Information Source

A coded type for the source of information for a birth date.

Date of Death Information Source

A coded type for the source of information for a death date.

Facility Type

Facility type

Gender

A coded type for a person’s gender.

HPI 2 digit ethnicity codes

HPI 2 digit ethnicity codes as used in the provider person extract

HPI 3 digit ethnicity codes

HPI 3 digit ethnicity codes as used in the provider person extract

HPI 4 digit ethnicity codes

HPI 4 digit ethnicity codes as used in the provider person extract

HPI Alias Type (Location)

A coded type for an alias name for facilities.

HPI Alias Type (Organization)

A coded type for an alias name for organisation.

HPI Disestablishment Reason

Disestablishment Reason Code (Organisation and Facility)

HPI Disestablishment Reason

Disestablishment Reason Code (Organisation and Facility)

HPI Legacy Name Type

A coded type for name type based on NAMTYP 2.0

HPI Location Status

A coded type for status of facilities.

HPI Location Type

A coded type for types of facilities.

HPI Registration Status

A coded type for professional registration status.

HPI Registration Type

A coded type for professional registrations.

HPI Registration Type

A coded type for professional registrations.

ISO 3166-1:2013 (2-alpha country code)

2-alpha country codes

ISO 639-3:2007 (3-alpha language code)

3-alpha language codes

IdentifierUse

Use values for an Identifier

Legal Entity Type

Legal entity type

Legal Entity Type

Legal entity type

MWS Clinical status

MWS clinical status codes

MWS verification status

MWS verificationStatus codes

NES Enrolment Status

NES Enrolment Status

NES Enrolment Termination Reason

A code to describe the reason the enrolment has ended

NES Enrolment Type

Describes the type of health service which the enrolment is for

NES Entitlement System Identifiers

A list of the identifiers of entitlement issuers authorities.

NHI Address Type Codes

Types of address supported by the NHI

NHI Address Use Codes

Uses of the address supported by the NHI

NHI Identifier

NHI Identifier

NHI Name Use Extra

Additional name use codes for NHI names

NZ Citizenship Information Source

A coded type for the source of information for NZ citizenship.

NZ Residency Information Source

A coded type for the source of information for NZ residency.

NZSCC4N99 four digit country code

4-digit country codes

NZULM codes

Combined NZULM and SNOWMED valuesets for substances

Name Information Source

A coded type for the source of information for a name.

Name Prefix Codes

A coded type for a name prefix or title eg Mr, Mrs, Dr.

Name Prefix Codes

A coded type for name prefixes.

Name Suffix Codes

Types of name suffixes used by NHI

Name qualifier for Facility

Facility name qualifier

Name qualifier for Organisation

Organisation name qualifier

Old HPI two alpha language codes

2-alpha language codes

Organisation Type

Organisation type

Organisation Type

Organisation type

PractitionerRole code

The role a practitioner holds.

RaIdentifier

RA Identifier

Scope of practice

A coded type for professional scope of practice.

Use values for a ContactPoint

Use values for a ContactPoint

Use values for a ContactSystem

System values for a ContactPoint

Use values for a HumanName

Use values for a HumanName

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

ANZSCO - Australian and New Zealand Standard Classification of Occupations, 2013

Index of Principal Titles, Alternative Titles, Specialisations and Occupations in Not Elsewhere Classified (nec) Categories.

Address Not Validated Reason

Reason why an address is not validated.

Coverage type

New Zealand codes for Coverage Types

Ethnicity lvl 2

Ethnic Group Codes at Level 2

Ethnicity lvl 3

Ethnic Group Codes at Level 3

Ethnicity lvl 4. v2005 2.0

Ethnic Group Codes at Level 4.

Facility Type

A coded value for facility type.

Gender v1.0
A coded type for a person’s gender (M F I U). Deprecated. Used in NHI HL7v2 legacy messaging
Gender v1.1
A coded type for a person’s gender(M F U). Used in HPI and NHI HL7v2 legacy messaging & SOAP v3 webservice.
Gender v1.2
A coded type for a person’s gender (M F O U). Used in HPI and NHI HL7v2 legacy messaging & SOAP v3 webservice
HIP Error Code

HIP Error Codes

HPI Country Code

Supplementary country codes to extend ISO3166-1.

HPI Disestablishment Reason

Disestablishment Reason Code (Organisation and Facility)

HPI Disestablishment Reason

Disestablishment Reason Code (Organisation and Facility)

HPI Legacy Name Type

A code for practitioner name type.

HPI Registration Authority Identifiers

A list of the registration authority identifiers.

HPI Registration Status

The code list represents the current practicing status of the Provider Person as per their registration with an RA or a health worker source.

HPI Registration Type

A code to identify the type of professional registration the healthcare provider person has been assigned.

HPI Registration Type

A code to identify the type of professional registration the healthcare provider person has been assigned.

ISO 639-3:2007 (3-alpha language code)

ISO 639-3 is a set of codes that defines three-letter identifiers for all known human languages.

ISO3166-1 two character country code

The purpose of ISO 3166 is to define internationally recognized codes of letters and/or numbers that we can use when we refer to countries and their subdivisions. However, it does not define the names of countries – this information comes from United Nations sources (Terminology Bulletin Country Names and the Country and Region Codes for Statistical Use maintained by the United Nations Statistics Divisions).

Legacy HPI 2 alpha language codes

Legacy HPI two alpha language codes

Legal Entity Type

A coded value for organisation legal entity type.

Legal Entity Type

A coded value for organisation legal entity type.

Location Type

A coded value for location type.

NES Enrolment Termination Reason Code

A code to describe the reason the enrolment has ended

NES Enrolment Type

Describes the type of health service which the enrolment is for

NES Entitlement System Identifiers

A list of the identifiers of entitlement issuers authorities.

NES Event Type

Identifies NES events.

NHI Name Use Extra

Additional name use codes for NHI names

NZSCC4N99 four digit country code

NZSCC4N99 four digit numeric country codes (Statistics New Zealand Country Code List - NZSC 1999).

Name Prefix

A coded type for name prefixes.

Name Prefix

A coded type for name prefixes.

Name Suffix

Types of name suffixes used by HIP

OrgFac Address Purpose

A coded type for organisation/facility address purpose (qualifier).

OrgFac Address Type

A coded type for organisation/facility address.

OrgFac Address Use

A coded type for organisation/facility address purpose (qualifier).

OrgFac Contact Type

A coded type for organisation/facility contact.

OrgFac Contact Usage

A coded type for organisation/facility contact usage.

OrgFac Name Qualifier

A code for organisation/facility name type/qualifier.

Organisation Type

A coded value for organisation type.

Organisation Type

A coded value for organisation type.

Patient Address Type

A coded type for patient address.

SNOMED Health occupation subset (New Zealand Ministry of Health)

Health occupation subset. Refset Id 451000210100. Module Id 21000210109.

Scope of practice

A classification of the type or range of health services that a practitioner is authorised to provide, as determined by the Responsible Authority or other statutory authority (e.g. PHARMAC), that is, what the practitioner can or cannot do. It includes Scope of Practice as defined by the Health Practitioners Competence Assurance Act 2003, any special authorisations granted, and any conditions or limitations imposed by the Responsible Authority.

Terminology: Concept Maps

These define transformations to convert between codes by systems conforming with this implementation guide.

Disestablishment reason legacy translation

Translated disestablishment reason to legacy disestablishment reason

Disestablishment reason mapping

Translated legacy disestablishment reason to disestablishment reason

Gender Mapping (from R4)

Translation from FHIR Administrative Gender to HPI/NHI Gender Code

Gender Mapping (to R4)

Translation from HPI/NHI Gender Code to FHIR Administrative Gender

HPI Contact Type Mapping

Translation from HPI Contact Type to FHIR Contact Point System

HPI Contact Type Mapping

Translation from FHIR Contact Point System to HPI Contact Type

HPI Contact Usage Mapping

Translation from HPI Contact Usage to FHIR Contact Point Use

HPI Contact Usage Mapping

Translation from FHIR Contact Point Use to HPI Contact Usage

HPI Facility Address Purpose Mapping

Translation from HPI Address Purpose to FHIR Address Use

HPI Facility Address Purpose Mapping

Translation from FHIR Address Use to HPI Address Purpose

HPI Facility Address Type Mapping

Translation from HPI Address Type to FHIR Address Type

HPI Facility Address Type Mapping

Translation from FHIR Address Type to HPI Address Type

HPI Facility Name Qualifier Mapping

Translation from HPI Name Qualifier to FHIR Location Alias Type

HPI Facility Name Qualifier Mapping Down

Translation from FHIR Location Alias Type to HPI Name Qualifier

HPI Facility Type Mapping

Translation from HPI Facility Type to FHIR Location Type

HPI Facility Type Mapping

Translation from FHIR Location Type to legacy HPI Facility Type

HPI Name Use to Name Type Mapping

Translation from FHIR Name use to HPI Name Type

HPI Name type to Name Use Mapping

Translation from HPI Name Type to FHIR Name Use

HPI Organisation Address Purpose Mapping

Translation from HPI Address Purpose to FHIR Address Use

HPI Organisation Address Purpose Mapping

Translation from FHIR Address Use to HPI Address Purpose

HPI Organisation Address Type Mapping

Translation from HPI Address Type to FHIR Address Type

HPI Organisation Address Type Mapping

Translation from FHIR Address Type to HPI Address Type

HPI Organisation Name Qualifier Mapping

Translation from HPI Name Qualifier to FHIR Organization Alias Type

HPI Organisation Name Qualifier Mapping Down

Translation from FHIR Organization Alias Type to HPI Name Qualifier

HPI Organisation Type Mapping

Translation from HPI Organisation Type to FHIR Organisation Type

HPI Registration Type Mapping

Translation from legacy HPI to FHIR

HPI Registration Type Mapping

Translation between HPI Registration Type versions

HPI Registration Type Mapping Down Conversion

Translation from FHIR to Legacy HPI values

HPI provider person extract ethnicity cm

Translate from lvl 4 ethnicity codes down to level 3 ethnicity codes

Language mapping from legacy to iso639-3-2007

Translation from legacy HPI aa language codes to iso639 aaa codes

NHI Patient Address Type Mapping

Translation from NHI Address Type to FHIR Address Type

NZSCC4N99_to_ISO3166-1.csv

ConceptMap imported from NZSCC4N99_to_ISO3166-1.csv

Name Prefix legacy translation

Translated FHIR name prefix to legacy name prefix

country-code-down

Convert country-codes down from new fhir to old