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

## Data Type Profile: Common NZ ContactPoint datatype

Official URL: http://hl7.org.nz/fhir/StructureDefinition/NzContactpoint | Version: 1.0.0
Active as of 2026-05-21 | Computable Name: NzContactPoint

This profile adds the Contact Point Purpose and EDI address extensions to the standard data type

Usages:

- Use this DataType Profile: NZ Patient

You can also check for usages in the FHIR IG Statistics

### Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

- Key Elements Table
- Differential Table
- Snapshot Table
- Statistics/References
- All

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
ContactPoint | C | 0..* | ContactPoint | Details of a Technology mediated contact point (phone, fax, email, etc.) Constraints: cpt-2
Slices for extension |  |  |  | Content/Rules for all slices
extension:cp-purpose |  | 0..1 | CodeableConcept | The business reason this ContactPoint is being used URL: http://hl7.org.nz/fhir/StructureDefinition/contactpoint-purpose Binding: ContactPoint purpose (preferred)
use | ?!Σ | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required): Use of contact point.
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
ContactPoint.use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
cpt-2 | error | ContactPoint | A system is required if a value is provided. | `value.empty() or system.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`

This structure is derived from ContactPoint

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
ContactPoint |  | 0..* | ContactPoint | Details of a Technology mediated contact point (phone, fax, email, etc.)
Slices for extension |  |  |  | Content/Rules for all slices
extension:cp-purpose |  | 0..1 | CodeableConcept | The business reason this ContactPoint is being used URL: http://hl7.org.nz/fhir/StructureDefinition/contactpoint-purpose Binding: ContactPoint purpose (preferred)
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
ContactPoint | C | 0..* | ContactPoint | Details of a Technology mediated contact point (phone, fax, email, etc.) Constraints: cpt-2
id |  | 0..1 | string | Unique id for inter-element referencing
Slices for extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
extension:cp-purpose |  | 0..1 | CodeableConcept | The business reason this ContactPoint is being used URL: http://hl7.org.nz/fhir/StructureDefinition/contactpoint-purpose Binding: ContactPoint purpose (preferred)
system | Σ C | 0..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point.
value | Σ | 0..1 | string | The actual contact point details
use | ?!Σ | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required): Use of contact point.
rank | Σ | 0..1 | positiveInt | Specify preferred order of use (1 = highest)
period | Σ | 0..1 | Period | Time period when the contact point was/is in use
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
ContactPoint.system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std.
ContactPoint.use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
cpt-2 | error | ContactPoint | A system is required if a value is provided. | `value.empty() or system.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`

This structure is derived from ContactPoint

Summary

Extensions

This structure refers to these extensions:

- http://hl7.org.nz/fhir/StructureDefinition/contactpoint-purpose

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
ContactPoint | C | 0..* | ContactPoint | Details of a Technology mediated contact point (phone, fax, email, etc.) Constraints: cpt-2
Slices for extension |  |  |  | Content/Rules for all slices
extension:cp-purpose |  | 0..1 | CodeableConcept | The business reason this ContactPoint is being used URL: http://hl7.org.nz/fhir/StructureDefinition/contactpoint-purpose Binding: ContactPoint purpose (preferred)
use | ?!Σ | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required): Use of contact point.
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
ContactPoint.use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
cpt-2 | error | ContactPoint | A system is required if a value is provided. | `value.empty() or system.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`

Differential View

This structure is derived from ContactPoint

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
ContactPoint |  | 0..* | ContactPoint | Details of a Technology mediated contact point (phone, fax, email, etc.)
Slices for extension |  |  |  | Content/Rules for all slices
extension:cp-purpose |  | 0..1 | CodeableConcept | The business reason this ContactPoint is being used URL: http://hl7.org.nz/fhir/StructureDefinition/contactpoint-purpose Binding: ContactPoint purpose (preferred)
Documentation for this format

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
ContactPoint | C | 0..* | ContactPoint | Details of a Technology mediated contact point (phone, fax, email, etc.) Constraints: cpt-2
id |  | 0..1 | string | Unique id for inter-element referencing
Slices for extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
extension:cp-purpose |  | 0..1 | CodeableConcept | The business reason this ContactPoint is being used URL: http://hl7.org.nz/fhir/StructureDefinition/contactpoint-purpose Binding: ContactPoint purpose (preferred)
system | Σ C | 0..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point.
value | Σ | 0..1 | string | The actual contact point details
use | ?!Σ | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required): Use of contact point.
rank | Σ | 0..1 | positiveInt | Specify preferred order of use (1 = highest)
period | Σ | 0..1 | Period | Time period when the contact point was/is in use
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
ContactPoint.system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std.
ContactPoint.use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
cpt-2 | error | ContactPoint | A system is required if a value is provided. | `value.empty() or system.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`

This structure is derived from ContactPoint

Summary

Extensions

This structure refers to these extensions:

- http://hl7.org.nz/fhir/StructureDefinition/contactpoint-purpose

Other representations of profile: CSV, Excel, Schematron