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/daniel-thomson/nzbase/ and changes regularly. See the Directory of published versions

## Resource Profile: NzPatient - Mappings

Active as of 2026-05-21

Mappings for the NzPatient resource profile.

#### Mappings to Structures in this Implementation Guide

No Mappings Found

#### Mappings to other Structures

No Mappings Found

#### Other Mappings

Name | RIM Mapping | CDA (R2) | FiveWs Pattern Mapping | HL7 v2 Mapping | LOINC code for the element
--- | --- | --- | --- | --- | ---
Patient | Patient[classCode=PAT] | ClinicalDocument.recordTarget.patientRole |  |  |
id |  |  |  |  |
meta |  |  |  |  |
implicitRules |  |  |  |  |
language |  |  |  |  |
text | Act.text? |  |  |  |
contained | N/A |  |  |  |
Slices for extension |  |  |  |  |
extension:ethnicity |  |  |  |  |
extension:nzCitizen |  |  |  |  |
extension:dhb |  |  |  |  |
extension:domicile-code |  |  |  |  |
extension:pho |  |  |  |  |
extension:sex-at-birth |  |  |  |  |
extension:iwi |  |  |  |  |
extension:acc-patient-occupation |  |  |  |  |
extension:messaging-address |  |  |  |  |
extension:nz-residency |  |  |  |  |
extension:interpreter-required |  |  |  |  |
modifierExtension | N/A |  |  |  |
Slices for identifier | id | .id | FiveWs.identifier | PID-3 |
identifier:NHI | id | .id | FiveWs.identifier | PID-3 |
id | n/a |  |  |  |
extension | n/a |  |  |  |
use | Role.code or implied by context |  |  | N/A |
type | Role.code or implied by context |  |  | CX.5 |
system | II.root or Role.id.root |  |  | CX.4 / EI-2-4 |
value | II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root) |  |  | CX.1 / EI.1 |
period | Role.effectiveTime or implied by context |  |  | CX.7 + CX.8 |
assigner | II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper |  |  | CX.4 / (CX.4 CX.9 CX.10) |
active | statusCode | n/a | FiveWs.status |  |
name | name | .patient.name |  | PID-5 PID-9 |
id | n/a |  |  |  |
Slices for extension | n/a |  |  |  |
extension:information-source |  |  |  |  |
use | unique(./use) |  |  | XPN.7 but often indicated by which field contains the name |
text | ./formatted |  |  | implied by XPN.11 |
family | ./part[partType = FAM] |  |  | XPN.1/FN.1 |
given | ./part[partType = GIV] |  |  | XPN.2 + XPN.3 |
prefix | ./part[partType = PFX] |  |  | XPN.5 |
suffix | ./part[partType = SFX] |  |  | XPN/4 |
period | ./usablePeriod[type="IVL<TS>"] |  |  | XPN.13 + XPN.14 |
telecom | telecom | .telecom |  | PID-13 PID-14 PID-40 |
gender | player[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender | .patient.administrativeGenderCode |  | PID-8 |
id |  |  |  |  |
Slices for extension |  |  |  |  |
extension:genderOriginalText |  |  |  |  |
value |  |  |  |  |
birthDate | player[classCode=PSN|ANM and determinerCode=INSTANCE]/birthTime | .patient.birthTime |  | PID-7 | 21112-8
id |  |  |  |  |
Slices for extension |  |  |  |  |
extension:information-source |  |  |  |  |
value |  |  |  |  |
Slices for deceased[x] | player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedInd player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedTime | n/a |  | PID-30 (bool) and PID-29 (datetime) |
deceased[x]:deceasedDateTime | player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedInd player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedTime | n/a |  | PID-30 (bool) and PID-29 (datetime) |
id |  |  |  |  |
Slices for extension |  |  |  |  |
extension:information-source |  |  |  |  |
value |  |  |  |  |
address | addr | .addr |  | PID-11 |
maritalStatus | player[classCode=PSN]/maritalStatusCode | .patient.maritalStatusCode |  | PID-16 |
multipleBirth[x] | player[classCode=PSN|ANM and determinerCode=INSTANCE]/multipleBirthInd player[classCode=PSN|ANM and determinerCode=INSTANCE]/multipleBirthOrderNumber | n/a |  | PID-24 (bool) PID-25 (integer) |
photo | player[classCode=PSN|ANM and determinerCode=INSTANCE]/desc | n/a |  | OBX-5 - needs a profile |
contact | player[classCode=PSN|ANM and determinerCode=INSTANCE]/scopedRole[classCode=CON] | n/a |  |  |
id | n/a |  |  |  |
extension | n/a |  |  |  |
modifierExtension | N/A |  |  |  |
relationship | code | n/a |  | NK1-7 NK1-3 |
name | name | n/a |  | NK1-2 |
telecom | telecom | n/a |  | NK1-5 NK1-6 NK1-40 |
address | addr | n/a |  | NK1-4 |
gender | player[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender | n/a |  | NK1-15 |
organization | scoper | n/a |  | NK1-13 NK1-30 NK1-31 NK1-32 NK1-41 |
period | effectiveTime | n/a |  |  |
communication | LanguageCommunication | patient.languageCommunication |  |  |
id | n/a |  |  |  |
extension | n/a |  |  |  |
modifierExtension | N/A |  |  |  |
language | player[classCode=PSN|ANM and determinerCode=INSTANCE]/languageCommunication/code | .languageCode |  | PID-15 LAN-2 |
preferred | preferenceInd | .preferenceInd |  | PID-15 |
generalPractitioner | subjectOf.CareEvent.performer.AssignedEntity | n/a |  | PD1-4 |
managingOrganization | scoper | .providerOrganization |  |  |
link | outboundLink | n/a |  |  |
id | n/a |  |  |  |
extension | n/a |  |  |  |
modifierExtension | N/A |  |  |  |
other | id | n/a |  | PID-3 MRG-1 |
type | typeCode | n/a |  |  |
Documentation for this format