Seiteninhalt:
Diese Seite beschreibt den Einstieg in die Consent-Query-Schnittstelle.
Die Nachricht zur Interaktion mit Einwilligungen als FHIR-Ressource Consent wird über die folgenden HTTP-Methoden ermöglicht:
| HTTP-Methode | Ergebnis der Anfrage |
|---|---|
| GET | Einwilligungen einsehen |
| POST | Einwilligung erteilen |
| DELETE | Einwilligung widerrufen |
Als Versicherter möchte ich eine Einwilligung zur elektronischen Speicherung meiner Abrechnungsinformationen erstellen und dem Fachdienst übermitteln. Die Einwilligung wird über die FHIR-Ressource “Consent” abgebildet.
Der Aufruf erfolgt als http-POST-Operation auf die Ressource /Consent. Im Aufruf muss das während der Authentisierung erhaltene ACCESS_TOKEN im http-Request-Header Authorization übergeben werden.
{"resourceType":"CapabilityStatement","id":"ti-flow-fachdienst-server-erpeu","meta":{"profile":["https://gematik.de/fhir/ti/StructureDefinition/ti-capability-statement"]},"text":{"status":"extensions","div":"<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\">Generated Narrative: CapabilityStatement ti-flow-fachdienst-server-erpeu</p><a name=\"ti-flow-fachdienst-server-erpeu\"> </a><a name=\"hcti-flow-fachdienst-server-erpeu\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"https://simplifier.net/resolve?scope=de.gematik.tiflow@2.0.0-ballot.1&canonical=https://gematik.de/fhir/ti/StructureDefinition/ti-capability-statement\">Capability Statement Profil für TI FHIR Data Service</a></p></div><h2 id=\"title\">ERPEU CapabilityStatement fuer den E-Rezept-Fachdienst</h2>application/fhir+json, application/fhir+xmlNote to Implementers: FHIR Capabilities
Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.
</blockquote><h2 id=\"rest\">FHIR RESTful Capabilities</h2><div class=\"panel panel-default\"><div class=\"panel-heading\"><h3 id=\"mode1\" class=\"panel-title\">Mode:server</h3></div><div class=\"panel-body\"><div class=\"row\"><div class=\"col-12\"><span class=\"lead\">Summary of System-wide Operations</span><table class=\"table table-condensed table-hover\">Registers access code and country for EU prescription access
\nReads the currently registered EU access code
\nRevokes the currently registered EU access code
\nReturns prescription information for EU ePrescription workflows
\nThe summary table lists the resources that are part of this configuration, and for each resource it lists:
_include_revinclude_include_revincludehttps://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task$eu-closesearch-type, read, patch.https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task
tokenTask.id - Unterstützt die Suche nach der Task-ID
\ntokenTask.identifier - Unterstützt die Suche nach der E-Rezept-ID
\ntokenTask.identifier - Unterstützt die Suche nach dem Zugriffscode
\ntokenTask.status - Unterstützt die Suche nach dem Status einer Task
\ndateTask.authoredOn - Unterstützt die Suche nach dem Erstellungsdatum
\ndateTask.extension:acceptDate.valueDate - Unterstützt die Suche nach dem Akzeptanzdatum
\ndateTask.extension:expiryDate.valueDate - Unterstützt die Suche nach dem Verfallsdatum
\ndateTask.lastModified - Unterstützt die Suche nach dem zuletzt modifizierten Datum
\nstringUnterstützt das Sortieren nach unterstützten Task-Suchkriterien
\nnumberMaximale Anzahl zurückgegebener Einträge pro Seite; maximum value is 50
\nnumberNullbasierter Offset des ersten zurückgegebenen Eintrags; default is 0
\nFinishes the EU ePrescription workflow and creates a signed receipt bundle
\nsearch-type, create, delete.tokenConsent.category - Unterstützt die Suche nach der Art der Einwilligung
\nError processing command: Unable to find fragment resource Consent/ExampleEUConsent pointed to in file /Users/gematik/dev/FHIR/fhir-igs-workflow/igs/erp-eu/input/pagecontent/query-api-consent </div>
Error processing command: Unable to find fragment resource Consent/ExampleEUConsent pointed to in file /Users/gematik/dev/FHIR/fhir-igs-workflow/igs/erp-eu/input/pagecontent/query-api-consent </div> </div> </div> #### Abfragen von Einwilligungen Als Versicherter möchte ich meine erteilte Einwilligung zur elektronischen Speicherung meiner Abrechnungsinformationen einsehen. Der Aufruf erfolgt als http-GET-Operation auf die Ressource /Consent. Im Aufruf muss das während der Authentisierung erhaltene ACCESS_TOKEN im http-Request-Header Authorization übergeben werden. Der Fachdienst filtert die Consent-Einträge nach der in der Nutzerinformation (zeta-user-info) enthaltenen KVNR des Versicherten.
{"resourceType":"CapabilityStatement","id":"ti-flow-fachdienst-server-erpeu","meta":{"profile":["https://gematik.de/fhir/ti/StructureDefinition/ti-capability-statement"]},"text":{"status":"extensions","div":"<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\">Generated Narrative: CapabilityStatement ti-flow-fachdienst-server-erpeu</p><a name=\"ti-flow-fachdienst-server-erpeu\"> </a><a name=\"hcti-flow-fachdienst-server-erpeu\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"https://simplifier.net/resolve?scope=de.gematik.tiflow@2.0.0-ballot.1&canonical=https://gematik.de/fhir/ti/StructureDefinition/ti-capability-statement\">Capability Statement Profil für TI FHIR Data Service</a></p></div><h2 id=\"title\">ERPEU CapabilityStatement fuer den E-Rezept-Fachdienst</h2>application/fhir+json, application/fhir+xmlNote to Implementers: FHIR Capabilities
Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.
</blockquote><h2 id=\"rest\">FHIR RESTful Capabilities</h2><div class=\"panel panel-default\"><div class=\"panel-heading\"><h3 id=\"mode1\" class=\"panel-title\">Mode:server</h3></div><div class=\"panel-body\"><div class=\"row\"><div class=\"col-12\"><span class=\"lead\">Summary of System-wide Operations</span><table class=\"table table-condensed table-hover\">Registers access code and country for EU prescription access
\nReads the currently registered EU access code
\nRevokes the currently registered EU access code
\nReturns prescription information for EU ePrescription workflows
\nThe summary table lists the resources that are part of this configuration, and for each resource it lists:
_include_revinclude_include_revincludehttps://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task$eu-closesearch-type, read, patch.https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task
tokenTask.id - Unterstützt die Suche nach der Task-ID
\ntokenTask.identifier - Unterstützt die Suche nach der E-Rezept-ID
\ntokenTask.identifier - Unterstützt die Suche nach dem Zugriffscode
\ntokenTask.status - Unterstützt die Suche nach dem Status einer Task
\ndateTask.authoredOn - Unterstützt die Suche nach dem Erstellungsdatum
\ndateTask.extension:acceptDate.valueDate - Unterstützt die Suche nach dem Akzeptanzdatum
\ndateTask.extension:expiryDate.valueDate - Unterstützt die Suche nach dem Verfallsdatum
\ndateTask.lastModified - Unterstützt die Suche nach dem zuletzt modifizierten Datum
\nstringUnterstützt das Sortieren nach unterstützten Task-Suchkriterien
\nnumberMaximale Anzahl zurückgegebener Einträge pro Seite; maximum value is 50
\nnumberNullbasierter Offset des ersten zurückgegebenen Eintrags; default is 0
\nFinishes the EU ePrescription workflow and creates a signed receipt bundle
\nsearch-type, create, delete.tokenConsent.category - Unterstützt die Suche nach der Art der Einwilligung
\n{
"resourceType" : "Bundle",
"id" : "ExampleGetConsent",
"type" : "searchset",
"timestamp" : "2025-10-01T12:03:23Z",
"total" : 1,
"entry" : [
{
"fullUrl" : "https://erp-dev.zentral.erp.splitdns.ti-dienste.de/Consent/f97a0772-c99f-4159-90c6-2a41c7d96779",
"resource" : {
"resourceType" : "Consent",
"id" : "f97a0772-c99f-4159-90c6-2a41c7d96779",
"meta" : {
"profile" : [
🔗 "https://gematik.de/fhir/tiflow-xborder/StructureDefinition/GEM-ERPEU-PR-Consent"
]
},
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><a name=\"Consent_f97a0772-c99f-4159-90c6-2a41c7d96779\"> </a><p class=\"res-header-id\"><b>Generated Narrative: Consent f97a0772-c99f-4159-90c6-2a41c7d96779</b></p><a name=\"f97a0772-c99f-4159-90c6-2a41c7d96779\"> </a><a name=\"hcf97a0772-c99f-4159-90c6-2a41c7d96779\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-GEM-ERPEU-PR-Consent.html\">Consent for ePrescriptions</a></p></div><h2>Participants</h2><table class=\"grid\"><tr><td><b>Role</b></td><td><b>Details</b></td></tr><tr><td title=\"Who the consent applies to\">Patient</td><td>Identifier: NamingSystemKVID/X123456789</td></tr></table><p>This consent is made under the regulation <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/v3-ActCode OPTIN}\">opt-in</span> .</p><p>The subject has given their consent.</p></div>"
},
"status" : "active",
"scope" : {
"coding" : [
{
"system" : "http://terminology.hl7.org/CodeSystem/consentscope",
"code" : "patient-privacy",
"display" : "Privacy Consent"
}
]
},
"category" : [
{
"coding" : [
{
"system" : "https://gematik.de/fhir/erp-eu/CodeSystem/GEM_ERPEU_CS_ConsentType",
"code" : "EUDISPCONS",
"display" : "Consent for redeeming e-prescriptions in EU countries"
}
]
}
],
"patient" : {
"identifier" : {
"system" : "http://fhir.de/sid/gkv/kvid-10",
"value" : "X123456789",
"assigner" : {
"identifier" : {
"system" : "http://fhir.de/sid/arge-ik/iknr",
"value" : "98765543"
}
}
}
},
"dateTime" : "2025-10-01T12:03:23Z",
"policyRule" : {
"coding" : [
{
"system" : "http://terminology.hl7.org/CodeSystem/v3-ActCode",
"code" : "OPTIN"
}
]
}
}
}
]
}
<Bundle xmlns="http://hl7.org/fhir">
<id value="ExampleGetConsent"/>
<type value="searchset"/>
<timestamp value="2025-10-01T12:03:23Z"/>
<total value="1"/>
<entry>
<fullUrl
value="https://erp-dev.zentral.erp.splitdns.ti-dienste.de/Consent/f97a0772-c99f-4159-90c6-2a41c7d96779"/>
<resource>
<Consent>
<id value="f97a0772-c99f-4159-90c6-2a41c7d96779"/>
<meta>
<profile
value="https://gematik.de/fhir/tiflow-xborder/StructureDefinition/GEM-ERPEU-PR-Consent"/>
</meta>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><a name="Consent_f97a0772-c99f-4159-90c6-2a41c7d96779"> </a><p class="res-header-id"><b>Generated Narrative: Consent f97a0772-c99f-4159-90c6-2a41c7d96779</b></p><a name="f97a0772-c99f-4159-90c6-2a41c7d96779"> </a><a name="hcf97a0772-c99f-4159-90c6-2a41c7d96779"> </a><div style="display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%"><p style="margin-bottom: 0px"/><p style="margin-bottom: 0px">Profile: <a href="StructureDefinition-GEM-ERPEU-PR-Consent.html">Consent for ePrescriptions</a></p></div><h2>Participants</h2><table class="grid"><tr><td><b>Role</b></td><td><b>Details</b></td></tr><tr><td title="Who the consent applies to">Patient</td><td>Identifier: NamingSystemKVID/X123456789</td></tr></table><p>This consent is made under the regulation <span title="Codes:{http://terminology.hl7.org/CodeSystem/v3-ActCode OPTIN}">opt-in</span> .</p><p>The subject has given their consent.</p></div>
</text>
<status value="active"/>
<scope>
<coding>
<system
value="http://terminology.hl7.org/CodeSystem/consentscope"/>
<code value="patient-privacy"/>
<display value="Privacy Consent"/>
</coding>
</scope>
<category>
<coding>
<system
value="https://gematik.de/fhir/erp-eu/CodeSystem/GEM_ERPEU_CS_ConsentType"/>
<code value="EUDISPCONS"/>
<display
value="Consent for redeeming e-prescriptions in EU countries"/>
</coding>
</category>
<patient>
<identifier>
<system value="http://fhir.de/sid/gkv/kvid-10"/>
<value value="X123456789"/>
<assigner>
<identifier>
<system value="http://fhir.de/sid/arge-ik/iknr"/>
<value value="98765543"/>
</identifier>
</assigner>
</identifier>
</patient>
<dateTime value="2025-10-01T12:03:23Z"/>
<policyRule>
<coding>
<system value="http://terminology.hl7.org/CodeSystem/v3-ActCode"/>
<code value="OPTIN"/>
</coding>
</policyRule>
</Consent>
</resource>
</entry>
</Bundle>
{"resourceType":"CapabilityStatement","id":"ti-flow-fachdienst-server-erpeu","meta":{"profile":["https://gematik.de/fhir/ti/StructureDefinition/ti-capability-statement"]},"text":{"status":"extensions","div":"<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\">Generated Narrative: CapabilityStatement ti-flow-fachdienst-server-erpeu</p><a name=\"ti-flow-fachdienst-server-erpeu\"> </a><a name=\"hcti-flow-fachdienst-server-erpeu\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"https://simplifier.net/resolve?scope=de.gematik.tiflow@2.0.0-ballot.1&canonical=https://gematik.de/fhir/ti/StructureDefinition/ti-capability-statement\">Capability Statement Profil für TI FHIR Data Service</a></p></div><h2 id=\"title\">ERPEU CapabilityStatement fuer den E-Rezept-Fachdienst</h2>application/fhir+json, application/fhir+xmlNote to Implementers: FHIR Capabilities
Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.
</blockquote><h2 id=\"rest\">FHIR RESTful Capabilities</h2><div class=\"panel panel-default\"><div class=\"panel-heading\"><h3 id=\"mode1\" class=\"panel-title\">Mode:server</h3></div><div class=\"panel-body\"><div class=\"row\"><div class=\"col-12\"><span class=\"lead\">Summary of System-wide Operations</span><table class=\"table table-condensed table-hover\">Registers access code and country for EU prescription access
\nReads the currently registered EU access code
\nRevokes the currently registered EU access code
\nReturns prescription information for EU ePrescription workflows
\nThe summary table lists the resources that are part of this configuration, and for each resource it lists:
_include_revinclude_include_revincludehttps://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task$eu-closesearch-type, read, patch.https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task
tokenTask.id - Unterstützt die Suche nach der Task-ID
\ntokenTask.identifier - Unterstützt die Suche nach der E-Rezept-ID
\ntokenTask.identifier - Unterstützt die Suche nach dem Zugriffscode
\ntokenTask.status - Unterstützt die Suche nach dem Status einer Task
\ndateTask.authoredOn - Unterstützt die Suche nach dem Erstellungsdatum
\ndateTask.extension:acceptDate.valueDate - Unterstützt die Suche nach dem Akzeptanzdatum
\ndateTask.extension:expiryDate.valueDate - Unterstützt die Suche nach dem Verfallsdatum
\ndateTask.lastModified - Unterstützt die Suche nach dem zuletzt modifizierten Datum
\nstringUnterstützt das Sortieren nach unterstützten Task-Suchkriterien
\nnumberMaximale Anzahl zurückgegebener Einträge pro Seite; maximum value is 50
\nnumberNullbasierter Offset des ersten zurückgegebenen Eintrags; default is 0
\nFinishes the EU ePrescription workflow and creates a signed receipt bundle
\nsearch-type, create, delete.tokenConsent.category - Unterstützt die Suche nach der Art der Einwilligung
\n