NZ Shared Digital Health Record API
0.6.0 - ballot

NZ Shared Digital Health Record API - Local Development build (v0.6.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: SDHRHNZParticipateOperation - TTL Representation

Active as of 2025-08-07

Raw ttl | Download


@prefix fhir: <http://hl7.org/fhir/> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

# - resource -------------------------------------------------------------------

 a fhir:OperationDefinition ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:id [ fhir:v "SDHRHNZParticipateOperation"] ; # 
  fhir:text [
fhir:status [ fhir:v "generated" ] ;
fhir:div "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: OperationDefinition SDHRHNZParticipateOperation</b></p><a name=\"SDHRHNZParticipateOperation\"> </a><a name=\"hcSDHRHNZParticipateOperation\"> </a><p>URL: [base]/$$hnz-participate</p><h3>Parameters</h3><table class=\"grid\"><tr><td><b>Use</b></td><td><b>Name</b></td><td><b>Scope</b></td><td><b>Cardinality</b></td><td><b>Type</b></td><td><b>Binding</b></td><td><b>Documentation</b></td></tr><tr><td>IN</td><td>patient</td><td/><td>1..1</td><td><a href=\"http://hl7.org/fhir/R4/references.html#Reference\">Reference</a></td><td/><td><div><p>Reference must be an NHI Patient URL with format https://api.hip.digital.health.nz/fhir/nhi/v1/Patient/ZZZ1111 or ZZZ11AA</p>\n</div></td></tr><tr><td>IN</td><td>hnzParticipationIndicator</td><td/><td>1..1</td><td><a href=\"http://hl7.org/fhir/R4/datatypes.html#boolean\">boolean</a></td><td/><td><div><p>Indicates global participation in the Shared Digital Health Record service (true/false)\nIf false, the patient does not wish to participate in the service and their resources will not be shared.</p>\n</div></td></tr><tr><td>IN</td><td>facilityId</td><td/><td>1..1</td><td><a href=\"http://hl7.org/fhir/R4/references.html#Reference\">Reference</a></td><td/><td><div><p>The HPI Facility ID of the healthcare provider that is withholding the resource.\nThis parameter is mandatory and must be provided to indicate the healthcare provider that is withholding the resource from the Shared Digital Health Record service.\nThe HPI Facility ID must be a valid HPI Facility ID in the format <code>https://api.hip.digital.health.nz/fhir/hpi/v1/{Location}or{Organization}/{hpi-facility-id}or{hpi-org-id}</code>.</p>\n</div></td></tr><tr><td>IN</td><td>reasonCode</td><td/><td>0..1</td><td><a href=\"http://hl7.org/fhir/R4/datatypes.html#Coding\">Coding</a></td><td><a href=\"ValueSet-sdhr-participation-reason-valueset.html\">ValueSet for SDHR Participation Reason</a> (Required)</td><td><div><p>The reason code for participation.\nValid codes include:</p>\n<ul>\n<li><code>sdhr-hnz-opt-out</code>: Patient has opted out of participation entirely with Health NZ. This means that no records will be shared from any facility.</li>\n<li><code>sdhr-hnz-opt-in</code>: Patient has opted in to participation with Health NZ.</li>\n</ul>\n</div></td></tr><tr><td>OUT</td><td>return</td><td/><td>1..1</td><td><a href=\"http://hl7.org/fhir/R4/operationoutcome.html\">OperationOutcome</a></td><td/><td><div><p>The result of the operation.\nThis parameter will contain an OperationOutcome resource indicating the success or failure of the operation.\nIf the operation is successful, the OperationOutcome will contain a success message.\nIf the operation fails, the OperationOutcome will contain an error message indicating the reason for the failure.\nThe OperationOutcome resource will be returned in the response body of the operation request.\nSee the following examples for possible OperationOutcome responses:\n- <a href=\"./OperationOutcome-OperationOutcomeParticipateInvalidPatient.html\">OperationOutcome for invalid patient reference</a>\n- <a href=\"./OperationOutcome-OperationOutcomeParticipateMissingReason.html\">OperationOutcome for missing reason code</a>\n- <a href=\"./OperationOutcome-OperationOutcomeParticipateSuccess.html\">OperationOutcome for successful participation</a></p>\n</div></td></tr></table></div>"^^rdf:XMLLiteral
  ] ; # 
  fhir:url [ fhir:v "https://fhir-ig.digital.health.nz/sdhr/OperationDefinition/SDHRHNZParticipateOperation"^^xsd:anyURI] ; # 
  fhir:version [ fhir:v "0.6.0"] ; # 
  fhir:name [ fhir:v "HNZParticipate"] ; # 
  fhir:status [ fhir:v "active"] ; # 
  fhir:kind [ fhir:v "operation"] ; # 
  fhir:date [ fhir:v "2025-08-07T03:04:43+00:00"^^xsd:dateTime] ; # 
  fhir:publisher [ fhir:v "Health New Zealand"] ; # 
  fhir:contact ( [
fhir:name [ fhir:v "Health New Zealand" ] ;
    ( fhir:telecom [
fhir:system [ fhir:v "url" ] ;
fhir:value [ fhir:v "https://github.com/tewhatuora" ]     ] )
  ] [
fhir:name [ fhir:v "HNZ Integration Team" ] ;
    ( fhir:telecom [
fhir:system [ fhir:v "email" ] ;
fhir:value [ fhir:v "integration@tewhatuora.govt.nz" ] ;
fhir:use [ fhir:v "work" ]     ] )
  ] ) ; # 
  fhir:description [ fhir:v "This operation allows a patient to choose to participate in the Shared Digital Health Record service via HNZ assisted channels.\nThis operation should only be used by HNZ channels.\n\nScenarios where this operation might be used include:\n- A patient has opted in to the Shared Digital Health Record service by contacting Health NZ via appropriate digital or assisted channels.\n- A patient chooses not to participate in the Shared Digital Health Record service and informs Health NZ of this choice via appropriate digital or assisted channels.\n\nFor example payloads that might be used with this operation see:\n- [Parameters resource for total non-participation](./Parameters-ParametersHNZParticipateOptOut.html) : This example shows how to indicate that a patient does not wish to participate in the Shared Digital Health Record service (has opted out).\n- [Parameters resource for participation](./Parameters-ParametersHNZParticipateOptIn.html) : This example shows how to indicate that a patient wishes to participate in the Shared Digital Health Record service.\n\nTo make a request to this operation the API Consumer must POST a `Parameters` payload to the operation URL (e.g. `POST https://api.sdhr.digital.health.nz/s2s/$hnz-participate`).\n\nThe operation is idempotent, meaning that multiple requests with the same parameters will have the same effect as a single request.\nThe operation is expected to be called by a Health NZ channel system on behalf of the patient, and the patient must be identified by their NHI.\nThe operation will return an OperationOutcome resource indicating the result of the operation."] ; # 
  fhir:code [ fhir:v "hnz-participate"] ; # 
  fhir:system [ fhir:v true] ; # 
  fhir:type [ fhir:v false] ; # 
  fhir:instance [ fhir:v false] ; # 
  fhir:parameter ( [
fhir:name [ fhir:v "patient" ] ;
fhir:use [ fhir:v "in" ] ;
fhir:min [ fhir:v 1 ] ;
fhir:max [ fhir:v "1" ] ;
fhir:documentation [ fhir:v "Reference must be an NHI Patient URL with format https://api.hip.digital.health.nz/fhir/nhi/v1/Patient/ZZZ1111 or ZZZ11AA" ] ;
fhir:type [ fhir:v "Reference" ]
  ] [
fhir:name [ fhir:v "hnzParticipationIndicator" ] ;
fhir:use [ fhir:v "in" ] ;
fhir:min [ fhir:v 1 ] ;
fhir:max [ fhir:v "1" ] ;
fhir:documentation [ fhir:v "Indicates global participation in the Shared Digital Health Record service (true/false)\nIf false, the patient does not wish to participate in the service and their resources will not be shared." ] ;
fhir:type [ fhir:v "boolean" ]
  ] [
fhir:name [ fhir:v "facilityId" ] ;
fhir:use [ fhir:v "in" ] ;
fhir:min [ fhir:v 1 ] ;
fhir:max [ fhir:v "1" ] ;
fhir:documentation [ fhir:v "The HPI Facility ID of the healthcare provider that is withholding the resource.\n    This parameter is mandatory and must be provided to indicate the healthcare provider that is withholding the resource from the Shared Digital Health Record service.\n    The HPI Facility ID must be a valid HPI Facility ID in the format `https://api.hip.digital.health.nz/fhir/hpi/v1/{Location}or{Organization}/{hpi-facility-id}or{hpi-org-id}`." ] ;
fhir:type [ fhir:v "Reference" ]
  ] [
fhir:name [ fhir:v "reasonCode" ] ;
fhir:use [ fhir:v "in" ] ;
fhir:min [ fhir:v 0 ] ;
fhir:max [ fhir:v "1" ] ;
fhir:documentation [ fhir:v "The reason code for participation.\nValid codes include:\n- `sdhr-hnz-opt-out`: Patient has opted out of participation entirely with Health NZ. This means that no records will be shared from any facility.\n- `sdhr-hnz-opt-in`: Patient has opted in to participation with Health NZ." ] ;
fhir:type [ fhir:v "Coding" ] ;
fhir:binding [
fhir:strength [ fhir:v "required" ] ;
fhir:valueSet [
fhir:v "https://fhir-ig.digital.health.nz/sdhr/ValueSet/sdhr-participation-reason-valueset"^^xsd:anyURI ;
fhir:link <https://fhir-ig.digital.health.nz/sdhr/ValueSet/sdhr-participation-reason-valueset>       ]     ]
  ] [
fhir:name [ fhir:v "return" ] ;
fhir:use [ fhir:v "out" ] ;
fhir:min [ fhir:v 1 ] ;
fhir:max [ fhir:v "1" ] ;
fhir:documentation [ fhir:v "The result of the operation.\n    This parameter will contain an OperationOutcome resource indicating the success or failure of the operation.\n    If the operation is successful, the OperationOutcome will contain a success message.\n    If the operation fails, the OperationOutcome will contain an error message indicating the reason for the failure.\n    The OperationOutcome resource will be returned in the response body of the operation request.\n    See the following examples for possible OperationOutcome responses:\n    - [OperationOutcome for invalid patient reference](./OperationOutcome-OperationOutcomeParticipateInvalidPatient.html)\n    - [OperationOutcome for missing reason code](./OperationOutcome-OperationOutcomeParticipateMissingReason.html)\n    - [OperationOutcome for successful participation](./OperationOutcome-OperationOutcomeParticipateSuccess.html)" ] ;
fhir:type [ fhir:v "OperationOutcome" ]
  ] ) . #