currentConsentForPersonAndTemplate

Voraussetzung
  • Spezifizierte Domäne muss angelegt sein
  • Spezifiziertes Template muss angelegt sein
  • Es muss eine gültige Einwilligung mit dem gegebenen personIdentfier auf Basis des spezifizierten Templates existieren
Aufruf und Rückgabe

Invocations

URL: [base]/$currentConsentForPersonAndTemplate

This operation does NOT change content

Parameters (In)

NameCardinalityTypeDocumentation
personIdentifier1..*Identifier

Um den Bezug zwischen Person und Einwilligung herzustellen, ist die Angabe von mindestens einem eindeutigen Personenidentifikator erforderlich. Dies kann je nach Anforderungen die Fallnummer, ein Patienten-Identifikator, die Angabe eines Bevollmächtigten oder ein Studienpseudonym, o.ä. sein. Bei Angabe von mehreren Identifikatoren werden diese ODER-verknüpft.

domain1..1string

Angabe der Einwilligungsdomaene

ignore-version-number0..1boolean

Wenn TRUE, wird die Datumsbezogen jüngste Einwilligung der Person ermittelt und die Versionsangabe der spezifizierten Einwilligungsvorlage (TemplateFrame) ignoriert. Default=FALSE

template1..1string

Angabe der eindeutigen TemplateId in Form des TemplateFrame.Identifier.Value für das vorbelegte Template.Identifier.System "https://ths-greifswald.de/fhir/gics/"

_profile0..1canonical

Angabe um Ausgabeprofil festzulegen. Default ist die gics-Variante; alternativ das Profil aus dem IG Einwilligungsmanagement.

Liefert den aktuellen Consent einer Person bezogen auf eine spezifische Einwilligungsvorlage (unter Angabe des TemplateFrame-Identifiers) per POST-Request. Aktuell bedeutet "höchste Version der Einwilligungsvorlage" UND "jüngstes Datum". Die Rückgabe erfolgt als Bundle vom Typ "collection". Das Bundle enthält exakt einen Bundle-Entry, der alle für den spezifischen Consent relevanten Ressourcen (z.B. TemplateFrame, QuestionnaireComposed, QuestionnaireResponse, Provenance) enthält. Details zu den verwendeten Profilen unter https://simplifier.net/guide/einwilligungsmanagement/igeinwilligungsmanagement

Beispiel

Beispielhafter Request-Body:

<Parameters xmlns="http://hl7.org/fhir">
    <parameter>
        <name value="personIdentifier" />
        <valueIdentifier>
            <system value="https://ths-greifswald.de/fhir/gics/identifiers/Pseudonym" />
            <value value="dic_1H51T" />
        </valueIdentifier>
    </parameter>
    <parameter>
        <name value="domain" />
        <valueString value="MII" />
    </parameter>
    <parameter>
        <name value="template" />
        <valueString value="MII;Patienteneinwilligung MII;1.6.f" />
    </parameter>
    <parameter>
        <name value="ignore-version-number" />
        <valueBoolean value="false" />
    </parameter>
</Parameters>

Beispielhafte Rückmeldung:

<Bundle xmlns="http://hl7.org/fhir">
    <type value="collection" />
    <entry>
        <resource>
            <QuestionnaireResponse>
                <id value="dfd5edc6-3a8a-4796-a9bb-f9572cf15c96" />
                <meta>
                    <lastUpdated value="2021-05-19T17:50:23.000+02:00" />
                    <profile value="http://fhir.de/ConsentManagement/StructureDefinition/QuestionnaireResponse" />
                </meta>
                <language value="DE" />
                <questionnaire value="https://ths-greifswald.de/fhir/gics/QuestionnaireComposed/MII/Patienteneinwilligung+MII|1.6.f" />
                <status value="completed" />
                <subject>
                    <reference value="Patient/d4c9a2fe-0eea-4a84-899d-3dbd9dc5c7f1" />
                    <display value="Pseudonym dic_1H51T" />
                </subject>
                <authored value="2021-05-19T00:00:00+02:00" />
                <author>
                    <reference value="Patient/d4c9a2fe-0eea-4a84-899d-3dbd9dc5c7f1" />
                    <display value="Pseudonym dic_1H51T" />
                </author>
                <source>
                    <reference value="Patient/d4c9a2fe-0eea-4a84-899d-3dbd9dc5c7f1" />
                    <display value="Pseudonym dic_1H51T" />
                </source>
                <item>
                    <linkId value="PATDAT_erheben_speichern_nutzen|1.6" />
                    <answer>
                        <valueCoding>
                            <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
                            <code value="2.16.840.1.113883.3.1937.777.24.5.2.1" />
                            <display value="g&#252;ltig" />
                        </valueCoding>
                    </answer>
                </item>
                <item>
                    <linkId value="KKDAT_retrospektiv_uebertragen_speichern_nutzen|1.6" />
                    <answer>
                        <valueCoding>
                            <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
                            <code value="2.16.840.1.113883.3.1937.777.24.5.2.2" />
                            <display value="ung&#252;ltig" />
                        </valueCoding>
                    </answer>
                </item>
                <item>
                    <linkId value="KKDAT_prospektiv_uebertragen_speichern_nutzen|1.6" />
                    <answer>
                        <valueCoding>
                            <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
                            <code value="2.16.840.1.113883.3.1937.777.24.5.2.2" />
                            <display value="ung&#252;ltig" />
                        </valueCoding>
                    </answer>
                </item>
                <item>
                    <linkId value="BIOMAT_erheben_lagern_nutzen|1.6" />
                    <answer>
                        <valueCoding>
                            <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
                            <code value="2.16.840.1.113883.3.1937.777.24.5.2.2" />
                            <display value="ung&#252;ltig" />
                        </valueCoding>
                    </answer>
                </item>
                <item>
                    <linkId value="BIOMAT_Zusatzentnahme|1.6" />
                    <answer>
                        <valueCoding>
                            <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
                            <code value="2.16.840.1.113883.3.1937.777.24.5.2.2" />
                            <display value="ung&#252;ltig" />
                        </valueCoding>
                    </answer>
                </item>
                <item>
                    <linkId value="Rekontaktierung_Ergaenzungen|1.6" />
                    <answer>
                        <valueCoding>
                            <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
                            <code value="2.16.840.1.113883.3.1937.777.24.5.2.1" />
                            <display value="g&#252;ltig" />
                        </valueCoding>
                    </answer>
                </item>
                <item>
                    <linkId value="Rekontaktierung_Zusatzbefund|1.6" />
                    <answer>
                        <valueCoding>
                            <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
                            <code value="2.16.840.1.113883.3.1937.777.24.5.2.1" />
                            <display value="g&#252;ltig" />
                        </valueCoding>
                    </answer>
                </item>
                <item>
                    <linkId value="Z1_GECCO83_Nutzung_NUM_CODEX|1.0" />
                    <answer>
                        <valueCoding>
                            <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
                            <code value="2.16.840.1.113883.3.1937.777.24.5.2.1" />
                            <display value="g&#252;ltig" />
                        </valueCoding>
                    </answer>
                </item>
                <item>
                    <linkId value="Z1_GECCO83_Weitergabe_NUM_CODEX_EU_DSGVO_nonkonform|1.0" />
                    <answer>
                        <valueCoding>
                            <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
                            <code value="2.16.840.1.113883.3.1937.777.24.5.2.2" />
                            <display value="ung&#252;ltig" />
                        </valueCoding>
                    </answer>
                </item>
            </QuestionnaireResponse>
        </resource>
    </entry>
    <entry>
        <resource>
            <Consent>
                <id value="dfd5edc6-3a8a-4796-a9bb-f9572cf15c96" />
                <meta>
                    <lastUpdated value="2021-05-19T17:50:23.000+02:00" />
                    <profile value="http://fhir.de/ConsentManagement/StructureDefinition/Consent" />
                </meta>
                <extension url="http://fhir.de/ConsentManagement/StructureDefinition/DomainReference">
                    <extension url="domain">
                        <valueReference>
                            <reference value="ResearchStudy/593d66f3-3654-4e8a-9524-3bcd78a363bb" />
                        </valueReference>
                    </extension>
                    <extension url="status">
                        <valueCoding>
                            <system value="http://hl7.org/fhir/publication-status" />
                            <code value="active" />
                        </valueCoding>
                    </extension>
                </extension>
                <status value="active" />
                <scope>
                    <coding>
                        <system value="http://terminology.hl7.org/CodeSystem/consentscope" />
                        <code value="research" />
                    </coding>
                </scope>
                <category>
                    <coding>
                        <system value="http://loinc.org" />
                        <code value="57016-8" />
                    </coding>
                </category>
                <patient>
                    <reference value="Patient/d4c9a2fe-0eea-4a84-899d-3dbd9dc5c7f1" />
                    <display value="Pseudonym dic_1H51T" />
                </patient>
                <dateTime value="2021-05-19T00:00:00+02:00" />
                <organization>
                    <display value="MII" />
                </organization>
                <sourceReference>
                    <reference value="QuestionnaireResponse/dfd5edc6-3a8a-4796-a9bb-f9572cf15c96" />
                </sourceReference>
                <provision>
                    <type value="deny" />
                    <period>
                        <start value="2021-05-19T17:50:22+02:00" />
                        <end value="2051-05-19T17:50:23+02:00" />
                    </period>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                                <code value="IDAT_bereitstellen_EU_DSGVO_konform" />
                                <display value="Herausgabe identifizierender Daten (IDAT)[...]" />
                            </coding>
                        </code>
                        <code>
                            <coding>
                                <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" />
                                <code value="2.16.840.1.113883.3.1937.777.24.5.3.5" />
                            </coding>
                        </code>
                    </provision>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                                <code value="IDAT_erheben" />
                                <display value="Erfassung neuer identifizierender Daten (IDAT)" />
                            </coding>
                        </code>
                        <code>
                            <coding>
                                <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" />
                                <code value="2.16.840.1.113883.3.1937.777.24.5.3.2" />
                            </coding>
                        </code>
                    </provision>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                                <code value="IDAT_speichern_verarbeiten" />
                                <display value="Speicherung und Verarbeitung identifizierender Daten (IDAT)[...]" />
                            </coding>
                        </code>
                        <code>
                            <coding>
                                <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" />
                                <code value="2.16.840.1.113883.3.1937.777.24.5.3.3" />
                            </coding>
                        </code>
                    </provision>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                                <code value="IDAT_zusammenfuehren_Dritte" />
                                <display value="Zusammenf&#252;hrung identifizierender Daten (IDAT)[...]" />
                            </coding>
                        </code>
                        <code>
                            <coding>
                                <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" />
                                <code value="2.16.840.1.113883.3.1937.777.24.5.3.4" />
                            </coding>
                        </code>
                    </provision>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                                <code value="MDAT_erheben" />
                                <display value="Erfassung medizinischer Daten" />
                            </coding>
                        </code>
                        <code>
                            <coding>
                                <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" />
                                <code value="2.16.840.1.113883.3.1937.777.24.5.3.6" />
                            </coding>
                        </code>
                    </provision>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                                <code value="MDAT_speichern_verarbeiten" />
                                <display value="Speicherung_Verarbeitung von medizinischen Daten[...]" />
                            </coding>
                        </code>
                        <code>
                            <coding>
                                <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" />
                                <code value="2.16.840.1.113883.3.1937.777.24.5.3.7" />
                            </coding>
                        </code>
                    </provision>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                                <code value="MDAT_wissenschaftlich_nutzen_EU_DSGVO_konform" />
                                <display value="Bereitstellung medizinischer Daten (MDAT)[...]" />
                            </coding>
                        </code>
                        <code>
                            <coding>
                                <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" />
                                <code value="2.16.840.1.113883.3.1937.777.24.5.3.8" />
                            </coding>
                        </code>
                    </provision>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                                <code value="MDAT_zusammenfuehren_Dritte" />
                                <display value="Zusammenf&#252;hrung medizinischer Daten (MDAT)[...]" />
                            </coding>
                        </code>
                        <code>
                            <coding>
                                <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" />
                                <code value="2.16.840.1.113883.3.1937.777.24.5.3.9" />
                            </coding>
                        </code>
                    </provision>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                                <code value="Rekontaktierung_Verknuepfung_Datenbanken" />
                                <display value="Rekontaktierung zur Verkn&#252;pfung[...]" />
                            </coding>
                        </code>
                        <code>
                            <coding>
                                <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" />
                                <code value="2.16.840.1.113883.3.1937.777.24.5.3.27" />
                            </coding>
                        </code>
                    </provision>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                                <code value="Rekontaktierung_weitere_Erhebung" />
                                <display value="Rekontaktierung bez&#252;glich Erhebung zus&#228;tzlicher Daten" />
                            </coding>
                        </code>
                        <code>
                            <coding>
                                <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" />
                                <code value="2.16.840.1.113883.3.1937.777.24.5.3.28" />
                            </coding>
                        </code>
                    </provision>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                                <code value="Rekontaktierung_weitere_Studien" />
                                <display value="Rekontaktierung bez&#252;glich Information[...]" />
                            </coding>
                        </code>
                        <code>
                            <coding>
                                <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" />
                                <code value="2.16.840.1.113883.3.1937.777.24.5.3.29" />
                            </coding>
                        </code>
                    </provision>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                                <code value="MDAT_GECCO83_bereitstellen_NUM_CODEX" />
                                <display value="Medizinische Daten des GECCO83 Datensatz[...]" />
                            </coding>
                        </code>
                        <code>
                            <coding>
                                <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" />
                                <code value="2.16.840.1.113883.3.1937.777.24.5.3.33" />
                            </coding>
                        </code>
                    </provision>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                                <code value="MDAT_GECCO83_speichern_verarbeiten_NUM_CODEX" />
                                <display value="Medizinische Daten des GECCO83 Datensatz[...]" />
                            </coding>
                        </code>
                        <code>
                            <coding>
                                <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" />
                                <code value="2.16.840.1.113883.3.1937.777.24.5.3.34" />
                            </coding>
                        </code>
                    </provision>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy/MII" />
                                <code value="MDAT_GECCO83_wissenschaftlich_nutzen_COVID_19_Forschung_EU_DSGVO_konform" />
                                <display value="Nutzung des Covid-19-Datensatzes[...]" />
                            </coding>
                        </code>
                    </provision>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy/MII" />
                                <code value="MDAT_GECCO83_wissenschaftlich_nutzen_Pandemie_Forschung_EU_DSGVO_konform" />
                                <display value="Nutzung des Covid-19-Datensatzes[...]" />
                            </coding>
                        </code>
                    </provision>
                    <provision>
                        <type value="permit" />
                        <period>
                            <start value="2021-05-19T17:50:22+02:00" />
                            <end value="2051-05-19T17:50:23+02:00" />
                        </period>
                        <code>
                            <coding>
                                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy/MII" />
                                <code value="Rekontaktierung_Zusatzbefund" />
                                <display value="Rekontaktierung bez&#252;glich Zusatzbefund" />
                            </coding>
                        </code>
                        <code>
                            <coding>
                                <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" />
                                <code value="2.16.840.1.113883.3.1937.777.24.5.3.31" />
                            </coding>
                        </code>
                    </provision>
                </provision>
            </Consent>
        </resource>
    </entry>
    <entry>
        <resource>
            <Provenance>
                <id value="dfd5edc6-3a8a-4796-a9bb-f9572cf15c96" />
                <meta>
                    <lastUpdated value="2021-05-19T17:50:23.000+02:00" />
                    <profile value="http://fhir.de/ConsentManagement/StructureDefinition/Provenance" />
                </meta>
                <target>
                    <reference value="QuestionnaireResponse/dfd5edc6-3a8a-4796-a9bb-f9572cf15c96" />
                </target>
                <recorded value="2021-05-19T17:50:23.000+02:00" />
                <agent>
                    <who>
                        <display value="https://ths-greifswald.de/gics" />
                    </who>
                </agent>
                <signature>
                    <type>
                        <system value="urn:iso-astm:E1762-95:2013" />
                        <code value="1.2.840.10065.1.12.1.7" />
                        <display value="Consent Signature" />
                    </type>
                    <when value="2021-05-19T00:00:00.000+02:00" />
                    <who>
                        <reference value="Patient/d4c9a2fe-0eea-4a84-899d-3dbd9dc5c7f1" />
                        <display value="Pseudonym dic_1H51T" />
                    </who>
                    <onBehalfOf>
                        <display value="Erlangen" />
                    </onBehalfOf>
                    <data value="ZHVtbXky" />
                </signature>
                <signature>
                    <type>
                        <system value="urn:iso-astm:E1762-95:2013" />
                        <code value="1.2.840.10065.1.12.1.5" />
                        <display value="Verification Signature" />
                    </type>
                    <when value="2021-05-19T00:00:00.000+02:00" />
                    <who>
                        <display value="arzt_12345" />
                    </who>
                    <onBehalfOf>
                        <display value="Erlangen" />
                    </onBehalfOf>
                    <data value="ZHVtbXk=" />
                </signature>
            </Provenance>
        </resource>
    </entry>
    <entry>
        <resource>
            <Patient>
                <id value="d4c9a2fe-0eea-4a84-899d-3dbd9dc5c7f1" />
                <meta>
                    <lastUpdated value="2021-05-19T17:50:23.000+02:00" />
                    <profile value="http://fhir.de/ConsentManagement/StructureDefinition/Patient" />
                </meta>
                <identifier>
                    <type>
                        <coding>
                            <system value="http://hl7.org/fhir/v2/0203/" />
                            <code value="ANON" />
                            <display value="Anonymous identifier" />
                        </coding>
                    </type>
                    <system value="https://ths-greifswald.de/fhir/gics/identifiers/Pseudonym" />
                    <value value="dic_1H51T" />
                </identifier>
            </Patient>
        </resource>
    </entry>
</Bundle>

Error Codes
Beschreibung HTTP Error Code
Fehlende Parameter 400 Bad Request
Parameter mit unbekanntem Inhalt 404 Not found
Leere Ergebnismenge trotz gültiger Parameter 200 Ok