CH EPR FHIR (R4)
4.0.1-ballot-2 - ballot
CH EPR FHIR (R4)
4.0.1-ballot-2 - ballot
CH EPR FHIR (R4), published by eHealth Suisse. This guide is not an authorized publication; it is the continuous build for version 4.0.1-ballot-2 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/ehealthsuisse/ch-epr-fhir/ and changes regularly. See the Directory of published versions
This section describes the national extension for the Swiss EPR to the Mobile Patient Identifier Cross-reference Query [ITI-83] transaction defined in the IUA profile published in the IHE IT Infrastructure Technical Framework Trial Implementation “Patient Identifier Cross-referencing for mobile”.
The Mobile Patient Identifier Cross-reference Query is used by an app in the Swiss EPR to query with the local identifier the MPI and get the corresponding MPI-PID and the EPR-SPID identifier for the patient.
Actor: Patient Identifier Cross-reference Consumer
Role: Queries the Patient Identifier Cross-reference Manager for the MPI-PID and EPR-SPID.
Actor: Patient Identifier Cross-reference Manager
Role: Resolves the local ID sent with the request to the MPI-PID and EPR-SPID.
The message semantics is the same as defined in 2:3.83.4.1.2 with a restriction on the targetSystem query Parameter:
GET [base]/Patient/$ihe-pix?sourceIdentifier=[token]&targetSystem=[uri]{&_format=[token]}
| Query parameter Name | Cardinality | Search Type | Description | Swiss National Extension |
|---|---|---|---|---|
| Input Parameters | ||||
| sourceIdentifier | 1..1 | token | The Patient identifier search parameter that will be used by the Patient Identifier Cross-reference Manager to find cross matching identifiers associated with the Patient Resource. See Section 2:3.83.4.1.2.1. | No further refinement. |
| targetSystem | 1..2 | uri | The Assigning Authorities for the Patient Identity Domains from which the returned identifiers shall be selected. See Section 2:3.83.4.1.2.2. | SHALL be the Assigning authority of the EPR-SPID and MAY be the Assigning authority of the community. |
| _format | 0..1 | token | The requested format of the response from the mime-type value set. See ITI TF-2: Appendix Z.6. | No further refinement. |
See the PIXm Find patient matches OperationDefinition and the CH PIXm IN Parameters Profile (with its example: PIXm Parameters Query Input).
Query for a patient with a local id of 123 by AssigningAuthority oid 1.2.3 which resides in a community where the Assigning Authority is oid 5.6.7 and the MPI-PID and EPR-SPID are requested:
GET [base]/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.999.1.2.3|123&targetSystem=urn:oid:2.999.5.6.7&targetSystem=urn:oid:2.16.756.5.30.1.127.3.10.3 HTTP/1.1
Accept: application/fhir+json
traceparent: 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-00
| Parameter | Cardinality | Data Type | Description |
|---|---|---|---|
| FHIR Parameters Resource | |||
| targetIdentifier | 0..2 | Identifier | The identifier found. Constraints to include the assigning authority as specified in ITI TF-2: Appendix E.3. |
| targetId | 0..1 | Reference(Patient) | The URL of the Patient Resource |
See Output Parameters example (and the corresponding profile) as response to the Mobile Patient Identifier Cross-reference Query.
If the targetSystem is not restricted to the Assigning authority of the community and the EPR-SPID, then the following
failure shall be returned:
HTTP 403 (Forbidden) is returned as the HTTP status code.
An OperationOutcome Resource is returned indicating that the Patient
Identifier Domain is not recognized in an issue having:
| Attribute | Value |
|---|---|
| severity | error |
| code | code-invalid |
| diagnostics | “targetSystem not found” |
See Input Parameters example (and the corresponding profile) for the Mobile Patient Identifier Cross-reference Query.
The CapabilityStatement resource for the Patient Identifier Cross-reference Consumer is PIXm Patient Identifier Cross-Reference Consumer.
The CapabilityStatement resource for the Patient Identifier Cross-reference Manager is PIXm Patient Identifier Cross-reference Manager.
The transaction SHALL be secured by Transport Layer Security (TLS) encryption and server authentication with server certificates.
The transaction SHALL use client authentication and authorization using basic authorization token as defined in the IUA profile. The authorization token SHALL be conveyed as defined in the Incorporate Access Token [ITI-72] transaction.
The actors SHALL support the traceparent header handling, as defined in Appendix: Trace Context.
The Patient Identifier Cross-reference Consumer shall record a CH Audit Event for [ITI-83] Patient Identifier Cross-reference Consumer (example).
The Patient Identifier Cross-reference Manager shall record a CH Audit Event for [ITI-83] Patient Identifier Cross-reference Manager (example).