New Zealand HPI Implementation Guide
1.4.10 - Release
New Zealand HPI Implementation Guide - Local Development build (v1.4.10) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
Official URL: http://hl7.org.nz/fhir/StructureDefinition/HPIPractitioner | Version: 1.4.10 | |||
Active as of 2025-04-06 | Computable Name: HpiPractitioner |
The practitioner exposed by the HPI. This is the person who delivers healthcare or healthcare related services.
Describe the Practitioner that will be returned by the HPI
The Practitioner resource represents any provider of healthcare - not restricted to those with formal qualifications.
The current HPI contains practitioners covered by the Health Practitioners Competence Assurance Amendment Act 2019. This includes all:
It is intended with the upgraded capabilities that other professional groups may supply their members eg Social Workers, Acupuncturists, Audiologists, Counsellors, Cardiac Physiologists, Nutritionist.
Other groups of health workers will need a CPN to be identified in digital records eg Allied Health assistants, Aged care, Personal Care and support workers, administrative staff, practice managers, students working in healthcare setting.
Consideration is being given to ‘self-asserted’ data.
A registration authority is an organization that asserts the information about a practitioner’s competence to perform a particular health role. This includes the Responsible Authorities named under the Act and Professional bodies who require a level of education and professional development to be registered as a member and be issued a certificate to practice. - Information supplied by the Registration Authority can only be changed by the Registration Authority. Health provider organisations may add their workers to the HPI with personal identity details ie name, date of birth, gender, ethnicity and the languages they speak in order to get a CPN. At a later stage a Responsible Authority or a Professional body may add information about their registration with that body ie Annual Practicing Certificate dates, scopes of practice etc.
There are 2 levels of identifier in the practitioner resource.
Practitioner.identifier is the top level identifier assigned by the HPI (and the source of the resource id as described in the background section). There can be multiple identifiers for any given resource as part of managing the Practitioner (for example removal of duplicate identifiers). The current identifier will have a use value of ‘official’, others will have a use value of ‘old’. The HPI identifier will always have a system value of '\https://standards.digital.health.nz/ns/hpi-person-id' It is the client's responsibility to check the value of the use element.
Practitioner.qualification.identifier is the identifier assigned by the Registration authority - for example the Medical Council Number, or Nursing Council number. This will also be found under the Practitioner.identifier but with a system value related to the Registration authority who issued it, for nursing council this will be 'https://standards.digital.health.nz/ns/nursing-council-id'.
To practice in NZ, practitioners must gain registration with a Responsible Authority (RA). The RA ensures practitioners are competent and fit to practice. Practitioners may provide evidence of educational qualifications attained that are considered by the RA when granting registrations, however the educational qualifications alone do not give a practitioner the right to practice in NZ.
In order to clearly distinguish a person’s licence to practice and their educational qualifications the HpiPractitioner profile uses the Practitioner.qualification element to represent the practitioner’s registration and the extension Practitioner.educational.qualification element to represent a person’s educational qualifications.
Other health providers (not considered Practitioners in NZ) are recorded in the HPI. They may not have a registration but will supply educational qualifications as part of their profile. In the HPI educational qualifications are an element of practitioner not a sub element of practitioner.qualification (ie registration).
Element | Description | Profile element |
---|---|---|
Type | the type of registration – nurse, physiotherapist, doctor etc. | Practitioner.qualification.code |
Identifier | an identifier issued by the responsible authority eg medical council number | Practitioner.qualification.identifier |
Status | indicates whether the registration is current | Practitioner.qualification.extension:registration-status-code |
Initial registration date | date the practitioner was first registered with the responsible authority | Practitioner.qualification.extension:registration-initial-date |
Annual practicing certificate | the period of the most recently issued APC | Practitioner.qualification.period |
Issuer | HPI Identifier of the responsible authority | Practitioner.qualification.issuer |
Scope of practice | range of health services a practitioner is authorised to perform | Practitioner.qualification.extension:scope-of-practice |
Condition on practice | conditions the health practitioner is subject to in relation to their scope of practice | Practitioner.qualification.extension:condition-on-practice |
Additional Authorisation | additional services that a practitioner is authorised to perform | Practitioner.qualification.extension:additional-authorisation |
Element | Profile element |
---|---|
Fullname | Practitioner.extension:educational-qualification.extension:fullname |
Shortname | Practitioner.extension:educational-qualification.extension:shortname |
Year | Practitioner.extension:educational-qualification.extension:year |
Institution | Practitioner.extension:educational-qualification.extension:institution |
City | Practitioner.extension:educational-qualification.extension:city |
Country | Practitioner.extension:educational-qualification.extension:country |
A person can make a request to their council to make their record confidential. When this is the case the person’s name and other personal details will not be returned in any search or get response. Identifiers and registration details are returned. See Confidentiality.
A practitioner’s Date of birth, Gender and Ethnicity are supplied when a practitioner is added and maintained by their Responsible Authority, but they are withheld on a Get Practitioner response. Admin permissions are required to get all the practitioner details in a response.
The Practitioner resources will contain a security element of "REDACTED" in the meta data when data items within the practitioner resource have been withheld.
Confidentiality level | Code | HPI Use | Information that is redacted with a read scope |
---|---|---|---|
Low | L | All Registered Practitioner records with no confidentiality flag set | Gender, birthDate and ethnicity |
Moderate | M | All Non-registered Practitioner records with no confidentiality flag set | Gender, birthDate and ethnicity |
Restricted and, Redacted |
R, and REDACTED |
All Practitioner records with confidentiality set (Registered and Non-registered Practitioners) | Name Official Name Usual Name(s) Old Gender Date of Birth Date of death Language(s) Ethnicity ConditionOnPractice (Applies to Registered Practitioner only) |
{
"resourceType": "Practitioner",
"id": "90ZZLP",
"meta": {
"versionId": "9971",
"lastUpdated": "2022-04-07T09:12:26.000+12:00",
"profile": [
"http://hl7.org.nz/fhir/StructureDefinition/HPIPractitioner"
],
"security": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-ObservationValue",
"code": "REDACTED"
},
{
"system": "http://terminology.hl7.org/CodeSystem/v3-Confidentiality",
"code": "R"
}
]
…
}
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
Other representations of profile: CSV, Excel, Schematron