CH EPR FHIR (R4)
4.0.1-ballot - ballot Switzerland flag

This page is part of the CH EPR FHIR (R4) (v4.0.1-ballot: DSTU 4 Ballot 2) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version. For a full list of available versions, see the Directory of published versions

Find Document Lists [ITI-66]

This section describes the additional requirements for the Swiss EPR of the Find Document Lists [ITI-66] transaction defined in the MHD Profile published in the IHE ITI Trial Implementation “Mobile Access to Health Documents”. The SubmissionSet.Author.AuthorRole mapping to DocumentManifest has to be supported.

Scope

The Find Document Lists [ITI-66] transaction is used to find List Resources that satisfy a set of parameters. It is equivalent to the FindSubmissionSets query in the Registry Stored Query ITI-18 transaction, as documented in ITI TF-2: 3.18.4.1.2.3.7.2. The result of the query is a Bundle containing List Resources that match the query parameters.

Actor Roles

Actor: Document Consumer
Role: Requests List Resources, matching the supplied set of criteria, from the Document Responder
Actor: Document Responder
Role: Returns List Resources that match the search criteria provided by the Document Consumer

Referenced Standards

  1. Mobile access to Health Documents (MHD), Rev. 4.2.1 – Trial-Implementation, August 2, 2023
  2. This MHD Profile is based on Release 4 of the HL7® FHIR® standard.

Messages

Interaction Diagram for [ITI-66]Document ConsumerDocument ResponderFind Document Lists RequestFind Document Lists Response

Find Document Lists Request Message

The Document Consumer SHALL include the search parameter patient.identifier with the oid of the EPR-SPID.

Find Document List example request:

GET [base]/List?patient.identifier=urn:oid:2.16.756.5.30.1.127.3.10.3|761337610411353650&&status=current HTTP/1.1
Accept: application/fhir+json
traceparent: 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-00

Find Document Lists Response Message

The response Bundle SHALL follow the CH MHD SubmissionSet Comprehensive Bundle Profile (example: MHD Find DocumentSubmissionSet (List)).

The Document Responder does not need to support the FindFolders Query from the XDS on FHIR Option.

CapabilityStatement Resource

The CapabilityStatement resource for the Document Consumer is MHD Document Consumer.

The CapabilityStatement resource for the Document Responder is MHD Document Responder.

Security Consideration

TLS SHALL be used. This national extension enforces authentication and authorization of access to the Document Responder using the IUA profile with extended access token. Consequently the Find Document Lists [ITI-66] request must authorize using the [ITI-72] transaction of the IUA profile.

For the traceparent header handling refer to Trace Context header.

Security Audit Considerations

Document Consumer Audit

The Document Consumer shall record a Find Document Lists Consumer Audit Event Log. Audit Example for a Find Document Lists Transaction from Consumer perspective.

Document Responder Audit

The Document Responder shall record a Find Document Lists Responder Audit Event Log. Audit Example for a Find Document Lists Transaction from Responder perspective.