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: Primary Healthcare Organisation

Official URL: http://hl7.org.nz/fhir/StructureDefinition/pho | Version: 1.0
Active as of 2020-11-06 | Maturity Level: 1 | Computable Name: Pho
Copyright/Legal: HL7 New Zealand© 2020+; Licensed Under Creative Commons No Rights Reserved.

Primary Healthcare Organisation associated with a General Practice linked to a NZ Healthcare Service, Location (Facility) or Patient (GP).

Administrative - to allow NZ HealthcareService, Location (Facility) or Patient Resources to include the related Primary Healthcare Organisation.

Context of Use

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

- Element ID: `HealthcareService`
- Element ID: `Location`
- Element ID: `Patient`

Example of extension

    <extension url="http://hl7.org.nz/fhir/StructureDefinition/pho">
        <valueCodeableConcept>
            <coding>
                <system value="https://standards.digital.health.nz/ns/pho-code"/>
                <version value="1.0"/>
                <code value="G05533-K"/>
                <display value="Procare Networks Ltd"/>
            </coding>
        </valueCodeableConcept>
    </extension>

Example instances

Patient with PHO

Usage info

Usages:

- Use this Extension: HealthcareService resource for use in NZ, Location resource for use in NZ and NZ Patient
- Examples for this Extension: Patient/patient-pho

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 | Primary Healthcare Organisation
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://hl7.org.nz/fhir/StructureDefinition/pho"
value[x] |  | 0..1 | CodeableConcept | NZ Primary Healthcare Organisations Binding: PHO (extensible): NZ HPI-ORG Values for PHOs Example Procare Networks Ltd: {"coding":[{"system":"https://standards.digital.health.nz/ns/pho-code","version":"1.0","code":"G05533-K","display":"Procare Networks Limited"}]}
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Primary Healthcare Organisation
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "http://hl7.org.nz/fhir/StructureDefinition/pho"
value[x] |  | 0..1 | CodeableConcept | NZ Primary Healthcare Organisations Binding: PHO (extensible): NZ HPI-ORG Values for PHOs Example Procare Networks Ltd: {"coding":[{"system":"https://standards.digital.health.nz/ns/pho-code","version":"1.0","code":"G05533-K","display":"Procare Networks Limited"}]}
Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type CodeableConcept: Primary Healthcare Organisation associated with a General Practice linked to a NZ Healthcare Service, Location (Facility) or Patient (GP).

Maturity: 1

Differential View

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Primary Healthcare Organisation
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://hl7.org.nz/fhir/StructureDefinition/pho"
value[x] |  | 0..1 | CodeableConcept | NZ Primary Healthcare Organisations Binding: PHO (extensible): NZ HPI-ORG Values for PHOs Example Procare Networks Ltd: {"coding":[{"system":"https://standards.digital.health.nz/ns/pho-code","version":"1.0","code":"G05533-K","display":"Procare Networks Limited"}]}
Documentation for this format

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Primary Healthcare Organisation
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "http://hl7.org.nz/fhir/StructureDefinition/pho"
value[x] |  | 0..1 | CodeableConcept | NZ Primary Healthcare Organisations Binding: PHO (extensible): NZ HPI-ORG Values for PHOs Example Procare Networks Ltd: {"coding":[{"system":"https://standards.digital.health.nz/ns/pho-code","version":"1.0","code":"G05533-K","display":"Procare Networks Limited"}]}
Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type CodeableConcept: Primary Healthcare Organisation associated with a General Practice linked to a NZ Healthcare Service, Location (Facility) or Patient (GP).

Maturity: 1

Other representations of profile: CSV, Excel, Schematron

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x] | Base | extensible | PHO | 📦1.0.0 | This IG

#### 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()`