New Zealand NHI IG
1.5.4 - Release
New Zealand NHI IG
1.5.4 - Release
New Zealand NHI IG - Local Development build (v1.5.4) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft as of 2023-06-12 |
{
"resourceType" : "OperationDefinition",
"id" : "Patient-set-unvalidated-address",
"text" : {
"status" : "extensions",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p>URL: [base]/Patient/[id]/$set-unvalidated-address</p><p>Parameters</p><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>nhi</td><td/><td>1..1</td><td><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td/><td><div><p>The Patient's nhi number</p>\n</div></td></tr><tr><td>IN</td><td>version-id</td><td/><td>1..1</td><td><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td/><td><div><p>The current value of the patient resources meta.versionId</p>\n</div></td></tr><tr><td>IN</td><td>not-validated-address-reason</td><td/><td>1..1</td><td><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td/><td><div><p>The reason the address could not be validated</p>\n</div></td></tr><tr><td>IN</td><td>address-type</td><td/><td>1..1</td><td><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td/><td><div><p>Must be physical or postal</p>\n</div></td></tr><tr><td>IN</td><td>address-line-1</td><td/><td>1..1</td><td><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td/><td><div><p>The first line of the address</p>\n</div></td></tr><tr><td>IN</td><td>address-line-2</td><td/><td>0..1</td><td><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td/><td><div><p>The first line of the address</p>\n</div></td></tr><tr><td>IN</td><td>address-building-name</td><td/><td>0..1</td><td><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td/><td><div><p>Building name if required as additional address information, not returned by eSAM</p>\n</div></td></tr><tr><td>IN</td><td>address-suburb</td><td/><td>0..1</td><td><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td/><td/></tr><tr><td>IN</td><td>address-city</td><td/><td>0..1</td><td><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td/><td/></tr><tr><td>IN</td><td>address-postal-code</td><td/><td>0..1</td><td><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td/><td/></tr><tr><td>IN</td><td>address-country-code</td><td/><td>0..1</td><td><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td/><td><div><p>Must be supplied when not-validated-address-reason = OSEA and must not be ‘NZ’. When not-validated-address-reason not = OSEA and country-code is supplied it must be ‘NZ’</p>\n</div></td></tr><tr><td>IN</td><td>address-domicile-code</td><td/><td>0..1</td><td><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td/><td><div><p>When supplied it must be a valid code in domicile-code valueset. When not supplied, the suburb and city are used to derive a domicile code from the streets file. If a suburb/city combination is not found in the streets file an error is returned (note the client end-user can then enter a domicile code or client system can supply a default district domicile code)</p>\n</div></td></tr><tr><td>OUT</td><td>return</td><td/><td>0..1</td><td><a href=\"http://hl7.org/fhir/R4/patient.html\">Patient</a></td><td/><td><div><p>The updated patient resource</p>\n</div></td></tr><tr><td>OUT</td><td>failure</td><td/><td>0..1</td><td><a href=\"http://hl7.org/fhir/R4/operationoutcome.html\">OperationOutcome</a></td><td/><td><div><p>Error response</p>\n</div></td></tr></table><div><p>The patient address is updated with an unvalidated address.</p>\n</div></div>"
},
"url" : "https://nhi-ig.hip.digital.health.nz/OperationDefinition/set-unvalidated-address",
"version" : "1.5.4",
"name" : "Set Unvalidated Address",
"title" : "Update a patient address using an unvalidated address.",
"status" : "draft",
"kind" : "operation",
"experimental" : false,
"date" : "2023-06-12T12:47:40+10:00",
"publisher" : "Te Whatu Ora",
"contact" : [
{
"name" : "Te Whatu Ora",
"telecom" : [
{
"system" : "email",
"value" : "mailto:integration@health.govt.nz"
}
]
}
],
"description" : "Update a patient address using an unvalidated address.",
"affectsState" : true,
"code" : "set-unvalidated-address",
"comment" : "The patient address is updated with an unvalidated address.",
"resource" : [
"Patient"
],
"system" : false,
"type" : false,
"instance" : true,
"parameter" : [
{
"name" : "nhi",
"use" : "in",
"min" : 1,
"max" : "1",
"documentation" : "The Patient's nhi number",
"type" : "string"
},
{
"name" : "version-id",
"use" : "in",
"min" : 1,
"max" : "1",
"documentation" : "The current value of the patient resources meta.versionId",
"type" : "string"
},
{
"name" : "not-validated-address-reason",
"use" : "in",
"min" : 1,
"max" : "1",
"documentation" : "The reason the address could not be validated",
"type" : "string"
},
{
"name" : "address-type",
"use" : "in",
"min" : 1,
"max" : "1",
"documentation" : "Must be physical or postal",
"type" : "string"
},
{
"name" : "address-line-1",
"use" : "in",
"min" : 1,
"max" : "1",
"documentation" : "The first line of the address",
"type" : "string"
},
{
"name" : "address-line-2",
"use" : "in",
"min" : 0,
"max" : "1",
"documentation" : "The first line of the address",
"type" : "string"
},
{
"name" : "address-building-name",
"use" : "in",
"min" : 0,
"max" : "1",
"documentation" : "Building name if required as additional address information, not returned by eSAM",
"type" : "string"
},
{
"name" : "address-suburb",
"use" : "in",
"min" : 0,
"max" : "1",
"type" : "string"
},
{
"name" : "address-city",
"use" : "in",
"min" : 0,
"max" : "1",
"type" : "string"
},
{
"name" : "address-postal-code",
"use" : "in",
"min" : 0,
"max" : "1",
"type" : "string"
},
{
"name" : "address-country-code",
"use" : "in",
"min" : 0,
"max" : "1",
"documentation" : "Must be supplied when not-validated-address-reason = OSEA and must not be ‘NZ’. When not-validated-address-reason not = OSEA and country-code is supplied it must be ‘NZ’ ",
"type" : "string"
},
{
"name" : "address-domicile-code",
"use" : "in",
"min" : 0,
"max" : "1",
"documentation" : "When supplied it must be a valid code in domicile-code valueset. When not supplied, the suburb and city are used to derive a domicile code from the streets file. If a suburb/city combination is not found in the streets file an error is returned (note the client end-user can then enter a domicile code or client system can supply a default district domicile code)",
"type" : "string"
},
{
"name" : "return",
"use" : "out",
"min" : 0,
"max" : "1",
"documentation" : "The updated patient resource",
"type" : "Patient"
},
{
"name" : "failure",
"use" : "out",
"min" : 0,
"max" : "1",
"documentation" : "Error response",
"type" : "OperationOutcome"
}
]
}