CH EPR FHIR (R4), published by eHealth Suisse. This guide is not an authorized publication; it is the continuous build for version 4.0.0-ci-build built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/ehealthsuisse/ch-epr-mhealth/ and changes regularly. See the Directory of published versions
Sequence Diagrams
Sample sequence diagrams to illustrate the usage of the generic EPR API and SMART on FHIR options for reading
documents as a patient or healthcare professional:
Patient: get document – generic EPR API option
Patient Portal Community Components IdP Patient Patient App GUI App GUI Document Consumer (MHD) Document Consumer (MHD) Patient Identifier Cross-reference Consumer Patient Identifier Cross-reference Consumer Authorization Client (IUA) Authorization Client (IUA) Patient Identifier Cross-reference Manger Patient Identifier Cross-reference Manger Authorization Server (IUA) Authorization Server (IUA) Document Responder (MHD) Document Responder (MHD) User Authentication Provider User Authentication Provider [01] read doc [02] GET /.well-known/smart-configuration [03] Conformance statement incl. OAuth 2.1 endpoints [04] Get Access Token [05] [ITI-71] Get Access Token Request [Basic access token] [06] Authenticate User [07] [08] Authorize App Access [09] [ITI-71] Get Access Token Response [Basic access token] [10] [11] query MPI-PID and EPR-SPID from MPI using local ID and access token [12] [ITI-83] Mobile Patient Identifier Cross-reference Query [local ID] together with access token [13] [ITI-83] Mobile Patient Identifier Cross-reference Query Response [MPI-PID, EPR-SPID] [14] [15] Get Access Token [16] [ITI-71] Get Access Token [Extended access token] [17] [ITI-71] Get Access Token Response [Extended access token] [18] [19] query documents [20] query documents [ITI-67] [21] [22] [23] retrieve documents [24] retrieve document [ITI-68] [25] [26] [27] Healthcare professional: get document – generic EPR API option
Healthcare Professional Portal or Primary System Community Components IdP Healthcare Professional Healthcare Professional App GUI App GUI Document Consumer (MHD) Document Consumer (MHD) Patient Identifier Cross-reference Consumer Patient Identifier Cross-reference Consumer Authorization Client (IUA) Authorization Client (IUA) Patient Identifier Cross-reference Manger Patient Identifier Cross-reference Manger Authorization Server (IUA) Authorization Server (IUA) Document Responder (MHD) Document Responder (MHD) User Authentication Provider User Authentication Provider [01] read doc [02] GET /.well-known/smart-configuration [03] Conformance statement incl. OAuth 2.1 endpoints [04] Get Access Token [05] [ITI-71] Get Access Token Request [Basic access token] [06] Authenticate User [07] [08] Authorize App Access [09] [ITI-71] Get Access Token Response [Basic access token] [10] [11] query MPI-PID and EPR-SPID from MPI using local ID and access token [12] [ITI-83] Mobile Patient Identifier Cross-reference Query [local ID] together with access token [13] [ITI-83] Mobile Patient Identifier Cross-reference Query Response [MPI-PID, EPR-SPID] [14] [15] Get Access Token [16] [ITI-71] Get Access Token [Extended access token] [17] [ITI-71] Get Access Token Response [Extended access token] [18] [19] query documents [20] query documents [ITI-67] [21] [22] [23] retrieve documents [24] retrieve document [ITI-68] [25] [26] [27] Patient: get document – SMART on FHIR option (EHR Launch)
Patient Portal SMART on FHIR App Community Components IdP Patient Patient App GUI IUA Authorization Client App GUI IUA Authorization Client Authorization Client (IUA) Authorization Client (IUA) Patient Identifier Cross-reference Consumer Patient Identifier Cross-reference Consumer App GUI IUA Authorization Client App GUI IUA Authorization Client Document Consumer (MHD) Document Consumer (MHD) Authorization Server (IUA) Authorization Server (IUA) Patient Identifier Cross-reference Mange Patient Identifier Cross-reference Mange Document Responder (MHD) Document Responder (MHD) User Authentication Provider User Authentication Provider [01] read doc [02] GET /.well-known/smart-configuration [03] Conformance statement incl. OAuth 2.1 endpoints [04] Get Access Token [05] [ITI-71] Get Access Token Request [Basic access token] [06] Authenticate User [07] [08] Authorize App Access [09] [ITI-71] Get Access Token Response [Basic access token] [10] [11] query MPI-PID and EPR-SPID from MPI using local ID and access token [12] [ITI-83] Mobile Patient Identifier Cross-reference Query [local ID] together with access token [13] [ITI-83] Mobile Patient Identifier Cross-reference Query Response [MPI-PID, EPR-SPID] [14] [15] launch app [16] GET /.well-known/smart-configuration [17] Conformance statement incl. OAuth 2.1 endpoints [18] [ITI-71] Get Access Token [Extended access token] [19] [ITI-71] Get Access Token Response [Extended access token] [20] query documents [21] query documents [ITI-67] [22] [23] [24] retrieve document [25] retrieve document [ITI-68] [26] [27] [28] [29] Healthcare professional: get document – SMART on FHIR option (EHR Launch)
Healthcare Professional Portal or Primary System SMART on FHIR App Community Components IdP Healthcare Professional Healthcare Professional App GUI IUA Authorization Client App GUI IUA Authorization Client Authorization Client (IUA) Authorization Client (IUA) Patient Identifier Cross-reference Consumer Patient Identifier Cross-reference Consumer App GUI IUA Authorization Client App GUI IUA Authorization Client Document Consumer (MHD) Document Consumer (MHD) Authorization Server (IUA) Authorization Server (IUA) Patient Identifier Cross-reference Mange Patient Identifier Cross-reference Mange Document Responder (MHD) Document Responder (MHD) User Authentication Provider User Authentication Provider [01] read doc [02] GET /.well-known/smart-configuration [03] Conformance statement incl. OAuth 2.1 endpoints [04] Get Access Token [05] [ITI-71] Get Access Token Request [Basic access token] [06] Authenticate User [07] [08] Authorize App Access [09] [ITI-71] Get Access Token Response [Basic access token] [10] [11] query MPI-PID and EPR-SPID from MPI using local ID and access token [12] [ITI-83] Mobile Patient Identifier Cross-reference Query [local ID] together with access token [13] [ITI-83] Mobile Patient Identifier Cross-reference Query Response [MPI-PID, EPR-SPID] [14] [15] launch app [16] GET /.well-known/smart-configuration [17] Conformance statement incl. OAuth 2.1 endpoints [18] [ITI-71] Get Access Token [Extended access token] [19] [ITI-71] Get Access Token Response [Extended access token] [20] query documents [21] query documents [ITI-67] [22] [23] [24] retrieve document [25] retrieve document [ITI-68] [26] [27] [28] [29]
