New Zealand HPI Implementation Guide
1.5.0 - Release
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
| Draft as of 2020-04-01 |
<CapabilityStatement xmlns="http://hl7.org/fhir">
<id value="HpiCapabilityStatement"/>
<meta>
<profile
value="https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/hnz-capability-statement"/>
</meta>
<text>
<status value="additional"/>
<div xmlns="http://www.w3.org/1999/xhtml">HPI capabilities</div>
</text>
<extension
url="https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/resource-metadata-extension">
<extension url="licenseURL">
<valueUri
value="https://www.tewhatuora.govt.nz/assets/Our-health-system/Digital-health/Digital-Service-Hub/API-Access-and-Use-Agreement.docx"/>
</extension>
<extension url="externalDocs">
<valueUri value="https://fhir-ig.digital.health.nz/hpi"/>
</extension>
<extension url="licenseName">
<valueString
value="Health New Zealand Digital Services Hub API Access and Use Agreement"/>
</extension>
<extension url="globalHeaders">
<extension
url="https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/custom-headers-extension">
<extension url="key">
<valueString value="Correlation-Id"/>
</extension>
<extension url="value">
<valueUri
value="https://raw.githubusercontent.com/tewhatuora/schemas/main/shared-care/Correlation-Id.json"/>
</extension>
<extension url="required">
<valueBoolean value="false"/>
</extension>
</extension>
<extension
url="https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/custom-headers-extension">
<extension url="key">
<valueString value="Request-Context"/>
</extension>
<extension url="value">
<valueUri
value="https://raw.githubusercontent.com/tewhatuora/schemas/main/openapi-definitions/Request-Context.json"/>
</extension>
<extension url="required">
<valueBoolean value="true"/>
</extension>
<extension url="documentation">
<valueString
value="A base64-encoded JSON object that defines the context of the current request.
See https://github.com/tewhatuora/schemas/blob/main/json-schema/Request-Context-v2.json for the schema this object must conform to."/>
</extension>
</extension>
</extension>
</extension>
<url
value="https://fhir-ig.digital.health.nz/CapabilityStatement/HpiCapabilityStatement"/>
<version value="1.5.0"/>
<name value="HPI_CapabilityStatement"/>
<title value="Capability Statement describing HPI FHIR APIs"/>
<status value="draft"/>
<date value="2020-04-01"/>
<publisher value="Te Whatu Ora"/>
<contact>
<name value="Te Whatu Ora"/>
<telecom>
<system value="email"/>
<value value="mailto:integration@health.govt.nz"/>
</telecom>
</contact>
<description
value="This is the computable resource that describes the RESTful endpoint"/>
<kind value="instance"/>
<implementation>
<description value="The HPI endpoint"/>
<url value="https://api.hip.digital.health.nz/fhir/hpi/v1/"/>
</implementation>
<fhirVersion value="4.0.1"/>
<format value="json"/>
<rest>
<mode value="server"/>
<security>
<extension
url="http://fhir-registry.smarthealthit.org/StructureDefinition/oauth-uris">
<extension url="token">
<valueUri
value="https://auth.services.health.nz/realms/hnz-integration/protocol/openid-connect/token"/>
</extension>
</extension>
<extension
url="http://fhir-registry.smarthealthit.org/StructureDefinition/capabilities">
<valueCode value="client-confidential-symmetric"/>
</extension>
<cors value="true"/>
<service>
<coding>
<code value="SMART-on-FHIR"/>
</coding>
</service>
</security>
<resource>
<type value="Practitioner"/>
<supportedProfile
value="http://hl7.org.nz/fhir/StructureDefinition/HPIPractitioner"/>
<documentation value="Practitioner query
"/>
<interaction>
<code value="read"/>
<documentation
value="GET, [base]/Practitioner[cpn], Retrieves a Practitioner resource by Id, system/Practitioner.r"/>
</interaction>
<interaction>
<code value="search-type"/>
<documentation
value="GET,[base]/Practitioner, Queries against the Practitioner using name and other search parameters. Will return a Bundle (even if there are no matching resources),system/Practitioner.s "/>
</interaction>
<interaction>
<code value="create"/>
<documentation
value="POST',[base]/Practitioner, Creates a new Practitioner record , system/Practitioner.c"/>
</interaction>
<searchParam>
<name value="identifier"/>
<type value="token"/>
<documentation
value="For searching a Practitioner resource using their council/board registration number"/>
</searchParam>
<searchParam>
<name value="name"/>
<type value="string"/>
<documentation
value="Should contain the person’s full name, include all given names and family name."/>
</searchParam>
<searchParam>
<name value="gender"/>
<type value="token"/>
<documentation
value="Use with name and birthdate. Search by gender alone is not allowed."/>
</searchParam>
<searchParam>
<name value="birthdate"/>
<type value="date"/>
<documentation
value="Use with name and gender. Search by birthdate alone is not allowed."/>
</searchParam>
<operation>
<name value="update-core"/>
<definition
value="https://hpi-ig.hip.digital.health.nz/OperationDefinition/practitioner-update-core"/>
<documentation
value="POST, [base]/Practitioner[cpn],An operation that updates a health providers demographic details, system/Practitioner.u"/>
</operation>
</resource>
<resource>
<type value="PractitionerRole"/>
<supportedProfile
value="http://hl7.org.nz/fhir/StructureDefinition/HPIPractitionerRole"/>
<documentation value="PractitionerRole query
"/>
<interaction>
<code value="read"/>
<documentation
value="GET, [base]/PractitionerRole[id], Used to retrieve a PractitionerRole resource by Id, system/PractitionerRole.r"/>
</interaction>
<interaction>
<code value="search-type"/>
<documentation
value="GET, [base]/PractitionerRole, Queries against PractitionerRole using hpi-person-id and other parameters. Will return a Bundle (even if there are no matching resources), system/PractitionerRole.s"/>
</interaction>
<interaction>
<code value="create"/>
<documentation
value="POST, [base]/PractitionerRole, Create a new PractitionerRole, system/PractitionerRole.c"/>
</interaction>
<interaction>
<code value="update"/>
<documentation
value="PUT, [base]/PractitionerRole[id], Update contact details and end date on an existing PractitionerRole record, system/PractitionerRole.u"/>
</interaction>
<searchInclude value="practitioner"/>
<searchInclude value="organization"/>
<searchInclude value="location"/>
<searchParam>
<name value="practitioner"/>
<type value="reference"/>
<documentation
value="Given an hpi-person-id, returns the PractitionerRole records associated with that id"/>
</searchParam>
<searchParam>
<name value="organization"/>
<type value="reference"/>
<documentation
value="Not yet enabled. Given an hpi-organization-id, returns the PractitionerRole records associated with that id"/>
</searchParam>
<searchParam>
<name value="location"/>
<type value="token"/>
<documentation
value="Given an hpi-facility-id, returns the PractitionerRole records associated with that id"/>
</searchParam>
<searchParam>
<name value="role"/>
<type value="token"/>
<documentation
value="Returns PractitionerRole records based on role code"/>
</searchParam>
<searchParam>
<name value="active"/>
<type value="token"/>
<documentation
value="To enable exclusion of inactive PractitionerRole records"/>
</searchParam>
</resource>
<resource>
<type value="Organization"/>
<supportedProfile
value="http://hl7.org.nz/fhir/StructureDefinition/HPIOrganization"/>
<documentation value="Organization query
"/>
<interaction>
<code value="read"/>
<documentation
value="GET, [base]/Organization/[hpi-org-id], Used to retrieve an Organization resource by Id, system/Organization.r"/>
</interaction>
<interaction>
<code value="search-type"/>
<documentation
value="GET, [base]/Organization, Queries against the Organization using name or other parameters. Will return a Bundle (even if there are no matching resources), system/Organization.s"/>
</interaction>
<searchParam>
<name value="active"/>
<type value="token"/>
<documentation value="To enable exclusion of inactive organizations"/>
</searchParam>
<searchParam>
<name value="name"/>
<type value="string"/>
<documentation
value="For searching using the organisation’s name or an alias name"/>
</searchParam>
<searchParam>
<name value="identifier"/>
<type value="token"/>
<documentation
value="For searching using an organisation’s New Zealand Business Number (NZBN) or their legacy NZHIS agency code."/>
</searchParam>
<searchParam>
<name value="type"/>
<type value="token"/>
<documentation
value="For searching using an organisation's type E.g. DHB, RA, Educational institution"/>
</searchParam>
<searchParam>
<name value="partOf"/>
<type value="reference"/>
<documentation
value="For retrieving organizations that are 'part of' another."/>
</searchParam>
</resource>
<resource>
<type value="Location"/>
<supportedProfile
value="http://hl7.org.nz/fhir/StructureDefinition/HPILocation"/>
<documentation value="Location query"/>
<interaction>
<code value="read"/>
<documentation
value="GET, [base]/Location/[hpi-facid], Used to retrieve an Location resource by Id, system/Location.r"/>
</interaction>
<interaction>
<code value="search-type"/>
<documentation
value="GET, [base]/Location, Queries against the Location using name or other parameters. Will return a Bundle (even if there are no matching resources), system/Location.s"/>
</interaction>
<searchParam>
<name value="identifier"/>
<type value="token"/>
<documentation
value="For searching using an organization’s legacy NZHIS facility code."/>
</searchParam>
<searchParam>
<name value="name"/>
<type value="string"/>
<documentation
value="For searching using the Locations name or alias name"/>
</searchParam>
<searchParam>
<name value="type"/>
<type value="token"/>
<documentation value="Retrieve Locations of the given type"/>
</searchParam>
<searchParam>
<name value="address"/>
<type value="string"/>
<documentation value="Retrieve the Locations by address"/>
</searchParam>
<searchParam>
<name value="organization"/>
<type value="reference"/>
<documentation
value="Retrieve Locations with the given ManagingOrganization"/>
</searchParam>
<searchParam>
<name value="dhb"/>
<type value="token"/>
<documentation
value="Searching for Locations that are in a DHBs catchment area."/>
</searchParam>
<searchParam>
<name value="status"/>
<type value="token"/>
<documentation
value="Not yet enabled. To enable exclusion of inactive locations"/>
</searchParam>
<searchParam>
<name value="messaging-address"/>
<type value="string"/>
<documentation value="Search by EDI address"/>
</searchParam>
</resource>
</rest>
</CapabilityStatement>