New Zealand HPI Implementation Guide
1.5.0 - Release

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

Get Prac Role

Read PractitionerRole with Identifier (hpi-practitionerrole-id)

Get PractitionerRole sequence diagramIntegrating application userIntegrating application userIntegrating applicationIntegrating application<FHIR API> HPI<FHIR API> HPIHPI Practitioner Role databaseHPI Practitioner Role databaseLook up PractitionerRolewith hpi-practitionerrole-idGET<Endpoint>/PractitionerRole/[hpi-practitionerrole-id]Validate[]RequestReturn PractitionerRolerecordReturn PractitionerRoledetails

Read PractitionerRole processing steps:

  1. The user supplies an hpi-practitionerrole-id for the PractitionerRole to be looked up.
  2. The integrating application sends an HTTP GET request for the PractitionerRole resource using the hpi-practitionerrole-id to identify the PractitionerRole whose information is being requested E.g. GET<Endpoint>/PractitionerRole/R00000009-H.
  3. The request is validated - ALT: Validation failure. OperationOutcome resource returned
  4. The PractitionerRole resource is retrieved from the HPI - ALT: PractitionerRole not found. OperationOutcome resource returned
  5. The response containing the PractitionerRole resource is returned

Query PractitionerRole with another identifier (hpi-person-id)

To query a PractitionerRole with ‘another identifier' the integrating application sends an HTTP GET request for the PractitionerRole resource using the ‘other identifier’ to identify the Practitioner whose information is being requested.

To review searching by other identifiers click here

For more information on read vs query click here

Get PractitionerRole Rules and errors

For Request rules and errors click here

  • Get PractitionerRole rules
    • A PractitionerRole read request must include a valid hpi-practitionerrole-id
  • Get PractitionerRole errors
    • “Invalid id: ” (HTTP 404 Not found, Error, Processing)