Skip to content

Health Data Interoperability

Developers and vendors implementing health data exchange should also consult the Health New Zealand API Standards for protocol-specific design and implementation guidance.

FHIR & Implementation Guides

Summary

Health data exchange uses FHIR, builds on documented existing Implementation Guides, and supports published FHIR API versions through defined notice periods.

Standards

  1. std-arch-fhir-implementation-guides-01 Health data exchange SHOULD use HL7's Fast Healthcare Interoperability Resources (FHIR) standard where an appropriate FHIR resource exists.
  2. std-arch-fhir-implementation-guides-02 An existing HL7 Version 2 messaging integration MAY continue to operate; FHIR SHOULD be used for new development.
  3. std-arch-fhir-implementation-guides-03 A new Implementation Guide SHOULD extend or build on an existing published Implementation Guide while preserving the work it already covers.
  4. std-arch-fhir-implementation-guides-04 A new Implementation Guide MUST include documentation sufficient for a prospective consumer to understand its purpose, scope, and the resource types and operations it supports, without needing to seek guidance from the team that published it.
  5. std-arch-fhir-implementation-guides-05 A published FHIR API version MUST remain supported for at least three years from the introduction of a replacement version, with at least one year's notice before it is withdrawn from support.

Implements These Principles

Clinical Terminology

Summary

Clinical data uses recognised terminology sourced from NZHTS, served locally for production, and represents departures through standard profiles or extensions.

Standards

  1. std-arch-clinical-terminology-01 Clinical data SHOULD be represented using a recognised clinical terminology or coding system so its meaning is consistent and machine-interpretable across consuming systems.
  2. std-arch-clinical-terminology-02 Clinical terminology and code sets SHOULD be sourced from the NZ Health Terminology Service (NZHTS).
  3. std-arch-clinical-terminology-03 A production implementation SHOULD use a local or cached terminology server instance so it can meet its own availability and performance requirements.
  4. std-arch-clinical-terminology-04 Where a data representation departs from an existing accepted standard, the departure MUST be made explicit through the standard's own profiling or extension mechanism.

Implements These Principles

Cross-Boundary Interoperability

Summary

Health data crossing an organisational or sector boundary meets the conformance requirements that apply within an organisation.

Standards

  1. std-arch-cross-boundary-interoperability-01 Health data exchanged across an organisational or sector boundary MUST meet the same conformance expectations as data exchanged within a single organisation.
  2. std-arch-cross-boundary-interoperability-02 Crossing a boundary MUST NOT justify a proprietary or lower-conformance alternative.
  3. std-arch-cross-boundary-interoperability-03 An interface crossing an organisational or sector boundary SHOULD be designed for multiple prospective consuming organisations.
  4. std-arch-cross-boundary-interoperability-04 Health data exchanged across an organisational or sector boundary remains subject to any applicable data residency or sovereignty requirement, and MUST NOT be used to circumvent one.

Implements These Principles

Conformance Testing

Summary

An implementation is tested for conformance against its Implementation Guide before it exchanges data in production.

Standards

  1. std-arch-conformance-testing-01 An implementation MUST be tested for conformance against the relevant Implementation Guide before it is used to exchange data in production.
  2. std-arch-conformance-testing-02 Conformance testing SHOULD be automated, so it can be repeated whenever the implementation changes or the Implementation Guide it conforms to is updated.
  3. std-arch-conformance-testing-03 A confirmed conformance failure MUST be resolved before the implementation is used to exchange data in production.

Implements These Principles