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

## Extension: EducationalQualification

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

Educational qualifications a practitioner has. These may or may not be related to registration information.

Context of Use

This extension may be used on the following element(s)

- Element ID: `Practitioner`
- Element ID: `Practitioner.qualification`

Example of extension

      ...
      <qualification>
        <extension url="http://hl7.org.nz/fhir/StructureDefinition/educational-qualification">
          <extension url="fullname">
            <valueString value="Fellow of the Royal Australian and New Zealand College of Psychiatrists qualification"/>
          </extension>
          <extension url="shortname">
            <valueString value="Psychiatrist fellow"/>
          </extension>
          <extension url="year">
            <valueDate value="1995"/>
          </extension>
          <extension url="institution">
            <valueString value="Royal Australian and New Zealand College of Psychiatrists"/>
          </extension>
          <extension url="city">
            <valueString value="Wellington"/>
          </extension>
          <extension url="country">
            <valueString value="NZ"/>
          </extension>
          <extension url="country-name">
            <valueString value="New Zealand"/>
          </extension>
        </extension>
        ...
      </qualification>
      ...

Example instances

Practitioner with educational qualification

Usage info

Usages:

- Use this Extension: Practitioner resource for use in NZ
- Examples for this Extension: Practitioner/practitioner-educational-qualification

You can also check for usages in the FHIR IG Statistics

### Formal Views of Extension Content

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

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

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Extension
Slices for extension |  |  |  | Content/Rules for all slices
extension:fullname |  | 0..1 | Extension | The full name of the educational qualification
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "fullname"
value[x] |  | 0..1 | string | Value of extension
extension:shortname |  | 0..1 | Extension | A short name of the educational qualification for when space is limited
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "shortname"
value[x] |  | 0..1 | string | Value of extension
extension:year |  | 0..1 | Extension | The year in which the qualification was granted
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "year"
value[x] |  | 0..1 | date | Value of extension
extension:institution |  | 0..1 | Extension | The institution that granted the qualification
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "institution"
value[x] |  | 0..1 | string | Value of extension
extension:city |  | 0..1 | Extension | The city where the institution is located
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "city"
value[x] |  | 0..1 | string | Value of extension
extension:country |  | 0..1 | Extension | The country (as iso country code) where the institution is located
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "country"
value[x] |  | 0..1 | string | Value of extension
extension:country-name |  | 0..1 | Extension | The country name (as text) where the institution is located
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "country-name"
value[x] |  | 0..1 | string | Value of extension
url |  | 1..1 | uri | "http://hl7.org.nz/fhir/StructureDefinition/educational-qualification"
value[x] |  | 0..0 |  | Value of extension
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Extension
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:fullname |  | 0..1 | Extension | The full name of the educational qualification
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "fullname"
value[x] |  | 0..1 | string | Value of extension
extension:shortname |  | 0..1 | Extension | A short name of the educational qualification for when space is limited
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "shortname"
value[x] |  | 0..1 | string | Value of extension
extension:year |  | 0..1 | Extension | The year in which the qualification was granted
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "year"
value[x] |  | 0..1 | date | Value of extension
extension:institution |  | 0..1 | Extension | The institution that granted the qualification
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "institution"
value[x] |  | 0..1 | string | Value of extension
extension:city |  | 0..1 | Extension | The city where the institution is located
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "city"
value[x] |  | 0..1 | string | Value of extension
extension:country |  | 0..1 | Extension | The country (as iso country code) where the institution is located
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "country"
value[x] |  | 0..1 | string | Value of extension
extension:country-name |  | 0..1 | Extension | The country name (as text) where the institution is located
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "country-name"
value[x] |  | 0..1 | string | Value of extension
url |  | 1..1 | uri | "http://hl7.org.nz/fhir/StructureDefinition/educational-qualification"
Documentation for this format

This structure is derived from Extension

Summary

Complex Extension: Educational qualifications a practitioner has. These may or may not be related to registration information.

- fullname: string: The full name of the educational qualification
- shortname: string: A short name of the educational qualification for when space is limited
- year: date: The year in which the qualification was granted
- institution: string: The institution that granted the qualification
- city: string: The city where the institution is located
- country: string: The country (as iso country code) where the institution is located
- country-name: string: The country name (as text) where the institution is located

Differential View

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Extension
Slices for extension |  |  |  | Content/Rules for all slices
extension:fullname |  | 0..1 | Extension | The full name of the educational qualification
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "fullname"
value[x] |  | 0..1 | string | Value of extension
extension:shortname |  | 0..1 | Extension | A short name of the educational qualification for when space is limited
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "shortname"
value[x] |  | 0..1 | string | Value of extension
extension:year |  | 0..1 | Extension | The year in which the qualification was granted
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "year"
value[x] |  | 0..1 | date | Value of extension
extension:institution |  | 0..1 | Extension | The institution that granted the qualification
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "institution"
value[x] |  | 0..1 | string | Value of extension
extension:city |  | 0..1 | Extension | The city where the institution is located
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "city"
value[x] |  | 0..1 | string | Value of extension
extension:country |  | 0..1 | Extension | The country (as iso country code) where the institution is located
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "country"
value[x] |  | 0..1 | string | Value of extension
extension:country-name |  | 0..1 | Extension | The country name (as text) where the institution is located
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "country-name"
value[x] |  | 0..1 | string | Value of extension
url |  | 1..1 | uri | "http://hl7.org.nz/fhir/StructureDefinition/educational-qualification"
value[x] |  | 0..0 |  | Value of extension
Documentation for this format

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Extension
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:fullname |  | 0..1 | Extension | The full name of the educational qualification
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "fullname"
value[x] |  | 0..1 | string | Value of extension
extension:shortname |  | 0..1 | Extension | A short name of the educational qualification for when space is limited
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "shortname"
value[x] |  | 0..1 | string | Value of extension
extension:year |  | 0..1 | Extension | The year in which the qualification was granted
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "year"
value[x] |  | 0..1 | date | Value of extension
extension:institution |  | 0..1 | Extension | The institution that granted the qualification
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "institution"
value[x] |  | 0..1 | string | Value of extension
extension:city |  | 0..1 | Extension | The city where the institution is located
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "city"
value[x] |  | 0..1 | string | Value of extension
extension:country |  | 0..1 | Extension | The country (as iso country code) where the institution is located
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "country"
value[x] |  | 0..1 | string | Value of extension
extension:country-name |  | 0..1 | Extension | The country name (as text) where the institution is located
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "country-name"
value[x] |  | 0..1 | string | Value of extension
url |  | 1..1 | uri | "http://hl7.org.nz/fhir/StructureDefinition/educational-qualification"
Documentation for this format

This structure is derived from Extension

Summary

Complex Extension: Educational qualifications a practitioner has. These may or may not be related to registration information.

- fullname: string: The full name of the educational qualification
- shortname: string: A short name of the educational qualification for when space is limited
- year: date: The year in which the qualification was granted
- institution: string: The institution that granted the qualification
- city: string: The city where the institution is located
- country: string: The country (as iso country code) where the institution is located
- country-name: string: The country name (as text) where the institution is located

Other representations of profile: CSV, Excel, Schematron

#### Constraints

Id | Grade | Path(s) | Description | Expression
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()`