Patsiendi üldandmete teenus / Master Patient Index - Downloaded Version 1.5.0 See the Directory of published versions
| Page standards status: Trial-use | Maturity Level: 1 |
{
"resourceType" : "OperationDefinition",
"id" : "patient-resolve-reference",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: OperationDefinition patient-resolve-reference</b></p><a name=\"patient-resolve-reference\"> </a><a name=\"hcpatient-resolve-reference\"> </a><p>URL: [base]/Patient/$resolve-reference</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>identifier</td><td/><td>1..*</td><td><a href=\"http://hl7.org/fhir/R5/datatypes.html#Identifier\">Identifier</a></td><td/><td><div><p>Patient identifier to resolve. At least one is required, and system and value are mandatory. identifier.system must be a code of the https://fhir.ee/ValueSet/patsiendi-identifikaatorite-domeen value set, or the value of that code's oid property. At most 100 identifiers per request.</p>\n</div></td></tr><tr><td>OUT</td><td>match</td><td/><td>1..*</td><td></td><td/><td><div><p>Result for each submitted identifier. Contains either <code>patient</code> or <code>issue</code>. Clients should pair results with the request by <code>match.identifier</code>.</p>\n</div></td></tr><tr><td>OUT</td><td>match.identifier</td><td/><td>1..1</td><td><a href=\"http://hl7.org/fhir/R5/datatypes.html#Identifier\">Identifier</a></td><td/><td><div><p>Identifier as submitted in the request.</p>\n</div></td></tr><tr><td>OUT</td><td>match.patient</td><td/><td>0..1</td><td><a href=\"http://hl7.org/fhir/R5/references.html#Reference\">Reference</a> (<a href=\"StructureDefinition-ee-mpi-patient.html\" title=\"https://fhir.ee/mpi/StructureDefinition/ee-mpi-patient\">EE MPI Patient</a>)</td><td/><td><div><p>Reference to the found patient.</p>\n</div></td></tr><tr><td>OUT</td><td>match.issue</td><td/><td>0..1</td><td><a href=\"http://hl7.org/fhir/R5/operationoutcome.html\">OperationOutcome</a></td><td/><td><div><p>OperationOutcome for this identifier: warning if patient not found, error if identifier.system is not allowed.</p>\n</div></td></tr></table><div><p>Only POST is supported. identifier.system must be a code of the patsiendi-identifikaatorite-domeen value set, or the value of that code's oid property. An identifier without system or value fails the whole request. If the total number of identifiers exceeds 100, the whole request fails. An invalid system is returned in match.issue. Per-identifier issues do not fail the request: the response is HTTP 200 with a Parameters resource, even if every identifier has an issue.</p>\n</div></div>"
},
"extension" : [
{
"url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
"valueInteger" : 1
},
{
"url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
"valueCode" : "trial-use"
}
],
"url" : "https://fhir.ee/mpi/OperationDefinition/patient-resolve-reference",
"version" : "1.5.0",
"name" : "EEMPIPatientResolveReference",
"title" : "Resolve Patient Reference",
"status" : "active",
"kind" : "operation",
"experimental" : false,
"date" : "2026-09-30T10:44:40+00:00",
"publisher" : "TEHIK",
"contact" : [
{
"name" : "TEHIK",
"telecom" : [
{
"system" : "url",
"value" : "https://tehik.ee"
}
]
}
],
"description" : "Resolves patient identifiers to MPI Patient references.",
"jurisdiction" : [
{
"coding" : [
{
"system" : "urn:iso:std:iso:3166",
"code" : "EE",
"display" : "Estonia"
}
]
}
],
"affectsState" : false,
"code" : "resolve-reference",
"comment" : "Only POST is supported. identifier.system must be a code of the patsiendi-identifikaatorite-domeen value set, or the value of that code's oid property. An identifier without system or value fails the whole request. If the total number of identifiers exceeds 100, the whole request fails. An invalid system is returned in match.issue. Per-identifier issues do not fail the request: the response is HTTP 200 with a Parameters resource, even if every identifier has an issue.",
"resource" : [
"Patient"
],
"system" : false,
"type" : true,
"instance" : false,
"parameter" : [
{
"name" : "identifier",
"use" : "in",
"min" : 1,
"max" : "*",
"documentation" : "Patient identifier to resolve. At least one is required, and system and value are mandatory. identifier.system must be a code of the https://fhir.ee/ValueSet/patsiendi-identifikaatorite-domeen value set, or the value of that code's oid property. At most 100 identifiers per request.",
"type" : "Identifier"
},
{
"name" : "match",
"use" : "out",
"min" : 1,
"max" : "*",
"documentation" : "Result for each submitted identifier. Contains either `patient` or `issue`. Clients should pair results with the request by `match.identifier`.",
"part" : [
{
"name" : "identifier",
"use" : "out",
"min" : 1,
"max" : "1",
"documentation" : "Identifier as submitted in the request.",
"type" : "Identifier"
},
{
"name" : "patient",
"use" : "out",
"min" : 0,
"max" : "1",
"documentation" : "Reference to the found patient.",
"type" : "Reference",
"targetProfile" : [
🔗 "https://fhir.ee/mpi/StructureDefinition/ee-mpi-patient"
]
},
{
"name" : "issue",
"use" : "out",
"min" : 0,
"max" : "1",
"documentation" : "OperationOutcome for this identifier: warning if patient not found, error if identifier.system is not allowed.",
"type" : "OperationOutcome"
}
]
}
]
}