New Zealand HPI Implementation Guide
1.5.0 - Release

New Zealand HPI Implementation Guide - Local Development build (v1.5.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: HPI Organization

Official URL: http://hl7.org.nz/fhir/StructureDefinition/HPIOrganization Version: 1.5.0
Active as of 2024-12-18 Computable Name: HpiOrganization

An entity that provides services of interest to, or is involved in, the business of health care service provision.

Describe the Organization that will be returned by the HPI

The Organisation resource represents any organisation that provides healthcare services.

HPI Organisations each have an identifier in the format GXXNNN-C where X is alphanumeric, N is numeric and C is a check character

Organisations are primarily legal entities e.g. Companies, Charitable trusts etc but can also be Sole traders or informal partnerships.

Organisations can also be parts of a legal entity that ‘trade’ as if they were a separate entity. These ‘sub-organisations’ will be related to their parent.

An example of an organisation with sub organisations would be a Company owning a number of discrete pharmacies . Each of the pharmacies would be set up as a separate organisation (sub-organisation) with each being related to the parent Organisation (organization.partOf)

Wherever possible Organisations are validated by the assignment of the NZBN.

Usage:

Formal Views of Profile Content

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

This structure is derived from NzOrganization

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization NzOrganization
... Slices for extension Content/Rules for all slices
.... extension:established 0..1 Established The period over which this Organization has been established
.... extension:funded-programme 0..0
... Slices for identifier 1..* Identifier Identifies this organization across multiple systems
Slice: Unordered, Open by value:use, value:system
.... identifier:All Slices Content/Rules for all slices
..... use 0..1 code official | old
Binding: IdentifierUse (required)
.... identifier:orgId S 1..1 Identifier The current HPI organization Id for this Organization
..... use 1..1 code fixed to official
Fixed Value: official
..... type 0..0
..... system 1..1 uri The namespace for the identifier value
Fixed Value: https://standards.digital.health.nz/ns/hpi-organisation-id
..... period 0..0
..... assigner 0..1 Reference(HPI Organization) Organization that issued id (may be just text)
.... identifier:legacyOrgId 0..1 Identifier The MOH (NZHIS) Legacy agency code)
..... use 1..1 code fixed to official
Fixed Value: official
..... type 0..0
..... system 1..1 uri The namespace for the identifier value
Fixed Value: https://standards.digital.health.nz/ns/nzhis-agency-id
..... period 0..0
..... assigner 0..1 Reference(HPI Organization) Organization that issued id (may be just text)
.... identifier:nzbn S 0..1 Identifier The New Zealand Business Number
..... use 1..1 code fixed to official
Fixed Value: official
..... type 0..0
..... system 1..1 uri The namespace for the identifier value
Fixed Value: https://standards.digital.health.nz/ns/hpi-nzbn
..... period 0..0
..... assigner 0..1 Reference(HPI Organization) Organization that issued id (may be just text)
.... identifier:dormant S 0..* Identifier Identifiers which have been deprecated
..... use 1..1 code fixed to old
Fixed Value: old
..... type 0..0
..... system 1..1 uri The namespace for the identifier value
Fixed Value: https://standards.digital.health.nz/ns/hpi-organisation-id
..... period 0..0
..... assigner 0..1 Reference(HPI Organization) Organization that issued id (may be just text)
... type 0..* CodeableConcept Kind of organization
Binding: Organisation Type (required)
.... Slices for extension Content/Rules for all slices
..... extension:alias-type 0..1 AliasType The type of alias for this Organization - eg its Maori name
...... Slices for value[x] Content/Rules for all slices
....... value[x]:valueCodeableConcept 0..1 CodeableConcept Value of extension
Binding: HPI Alias Type (Organization) (preferred)
... telecom
.... use 0..1 code home | work | temp | old | mobile - purpose of this contact point
Binding: Use values for a ContactPoint (required)
... address 0..0
... partOf 0..1 Reference(HPI Organization) The organization of which this organization forms a part
... contact 0..0
... endpoint 0..0

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSetURI
Organization.identifier.userequiredHpi_IdentfierUse
https://nzhts.digital.health.nz/fhir/ValueSet/hpi-identifier-use-code
Organization.typerequiredHpi_organisation_type
https://nzhts.digital.health.nz/fhir/ValueSet/organisation-type-code
Organization.alias.extension:alias-type.value[x]:valueCodeableConceptpreferredHpi_organization_alias_type
https://nzhts.digital.health.nz/fhir/ValueSet/organization-alias-type-code
Organization.telecom.userequiredHpi_ContactPointUse
https://nzhts.digital.health.nz/fhir/ValueSet/hpi-contact-point-use-code

 

Other representations of profile: CSV, Excel, Schematron