New Zealand HPI Implementation Guide, published by Te Whatu Ora. This guide is not an authorized publication; it is the continuous build for version 1.5.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7NZ/hpi/ and changes regularly. See the Directory of published versions
A Practitioner read request returns a Practitioner record with the following attributes (if populated):
The ‘last updated single instance’ from all the HPI sources of Practitioner information:
deathdate,
official and usual names,
set of languages (Practitioner.communication, and
All:
educational qualifications,
‘old’ names, and
registraion details (Practitioner.qualification)
A user with administration permissions will also see the ‘last updated single instance’ from across all sources:
set of ethnicities,
gender, and
birthdate.
Get Practitioner using an hpi-person-id (HPI-CPN)
Get Practitioner processing steps:
The user supplies an hpi-person-id number for the Practitioner to be looked up.
The integrating application sends an HTTP GET request for the Practitioner resource using the hpi-person-id to identify the Practitioner whose information is being requested. E.g. GET<Endpoint>/Practitioner/99ZZRT
The request is validated - ALT: Validation failure. OperationOutcome resource returned
The Practitioner resource is retrieved from the HPI - ALT: Practitioner not found. OperationOutcome resource returned
The response containing the Practitioner resource is returned
A Practitioner read request must include a valid hpi-person-id
EM07240
Resource not found
Practitioner.identifier:HPI
404 Not found
Query Practitioner using the registration authority identifier
To query a Practitioner with a registration authority identifier (E.g. nursing-council-id) the integrating application sends an HTTP GET request for the Practitioner resource using the registration authority identifier and identifiying the required register.
The user supplies the system (https://standards.digital.health.nz/ns/nursing-council-id) and identifier (nursing-council-id) for the Practitioner.
The integrating application sends an HTTP GET request for the Practitioner resource using the nursing council identifier to identify the Practitioner whose information is being requested. E.g. GET<Endpoint>/Practitioner?identifier=https://standards.digital.health.nz/ns/nursing-council-id|961049
The request is validated - ALT: Validation failure. OperationOutcome resource returned
The Practitioner resource is retrieved from the HPI - ALT: Practitioner not found. OperationOutcome resource returned
The response containing a bundle with a single Practitioner record is returned
The integrating application displays the practitioner details to the user