TIFlow - Grenzüberschreitender Datenaustausch
Version 2.0.0-ballot.1 - ci-build

Operation API: Zugriffsberechtigung erstellen

Seiteninhalt:

Die FHIR-Operation führt zum Schreiben einer neuen Zugriffsberechtigung. Diese Operation steht Versicherten zur Verfügung.

Nachricht

Die Nachricht wird als HTTP POST an /$grant-eu-access-permission gesendet.

Anforderungen an Schnittstelle

API Beschreibung

			{"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>
  • Implementation Guide Version: 2.0.0-ballot.1 
  • FHIR Version: 4.0.1 
  • Supported Formats: application/fhir+json, application/fhir+xml
  • Published on: 2026-01-08 
  • Published by: gematik GmbH 
<blockquote class=\"impl-note\">
Note 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\">ConformanceOperationDocumentationSHALL<a href=\"OperationDefinition-Grant-EU-Access-Permission.html\">$grant-eu-access-permission</a>
Registers access code and country for EU prescription access
\n
SHALL<a href=\"OperationDefinition-Read-EU-Access-Permission.html\">$read-eu-access-permission</a>
Reads the currently registered EU access code
\n
SHALL<a href=\"OperationDefinition-Revoke-EU-Access-Permission.html\">$revoke-eu-access-permission</a>
Revokes the currently registered EU access code
\n
SHALL<a href=\"OperationDefinition-GET-Prescription-EU.html\">$get-eu-prescriptions</a>
Returns prescription information for EU ePrescription workflows
\n
</table></div></div></div></div><h3 id=\"resourcesCap1\">Capabilities by Resource/Profile</h3><h4 id=\"resourcesSummary1\">Summary</h4>
The summary table lists the resources that are part of this configuration, and for each resource it lists:
  • The relevant profiles (if any)
  • The interactions supported by each resource (<span class=\"bg-info\">R</span>ead, <span class=\"bg-info\">S</span>earch, <span class=\"bg-info\">U</span>pdate, and <span class=\"bg-info\">C</span>reate, are always shown, while <span class=\"bg-info\">VR</span>ead, <span class=\"bg-info\">P</span>atch, <span class=\"bg-info\">D</span>elete, <span class=\"bg-info\">H</span>istory on <span class=\"bg-info\">I</span>nstance, or <span class=\"bg-info\">H</span>istory on <span class=\"bg-info\">T</span>ype are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any). 
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
<div class=\"table-responsive\"><table class=\"table table-condensed table-hover\">Resource TypeProfile<th class=\"text-center\"><b title=\"GET a resource (read interaction)\">R</b></th><th class=\"text-center\"><b title=\"GET all set of resources of the type (search interaction)\">S</b></th><th class=\"text-center\"><b title=\"PUT a new resource version (update interaction)\">U</b></th><th class=\"text-center\"><b title=\"PATCH a new resource version (patch interaction)\">P</b></th><th class=\"text-center\"><b title=\"POST a new resource (create interaction)\">C</b></th><th class=\"text-center\"><b title=\"DELETE a resource (delete interaction)\">D</b></th><b title=\"Required and recommended search parameters\">Searches</b>_include_revincludeOperations<a href=\"#Task1-1\">Task</a>Supported Profiles
\u00a0\u00a0https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task<td class=\"text-center\"><span title=\"SHALL\">Y</span></td><td class=\"text-center\"><span title=\"SHALL\">Y</span></td><td class=\"text-center\"/><td class=\"text-center\"><span title=\"SHALL\">Y</span></td><td class=\"text-center\"/><td class=\"text-center\"/>_id, prescription-id, access-code, status, authored-on, accept-date, expiry-date, modified, _sort, _count, __offset$eu-close<a href=\"#Consent1-2\">Consent</a>\u00a0<td class=\"text-center\"/><td class=\"text-center\"><span title=\"SHALL\">Y</span></td><td class=\"text-center\"/><td class=\"text-center\"/><td class=\"text-center\"><span title=\"SHALL\">Y</span></td><td class=\"text-center\"><span title=\"SHALL\">Y</span></td>category</table></div>
<div class=\"panel panel-default\"><div class=\"panel-heading\"><h4 id=\"Task1-1\" class=\"panel-title\"><span style=\"float: right;\">Resource Conformance: SHALL </span>Task</h4></div><div class=\"panel-body\"><div class=\"container\"><div class=\"row\"><div class=\"col-lg-4\"><span class=\"lead\">Core FHIR Resource</span>
<a href=\"http://hl7.org/fhir/R4/task.html\">Task</a></div><div class=\"col-lg-4\"><span class=\"lead\">Reference Policy</span>
</div><div class=\"col-lg-4\"><span class=\"lead\">Interaction summary</span>
  • SHALL support search-type, read, patch.
</div></div>
<div class=\"row\"><div class=\"col-6\"><span class=\"lead\">Supported Profiles</span>
https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task
</div></div>
<div class=\"row\"><div class=\"col-lg-7\"><span class=\"lead\">Search Parameters</span><table class=\"table table-condensed table-hover\">ConformanceParameterTypeDocumentationSHALL<a href=\"http://hl7.org/fhir/R4/resource.html#search\">_id</a>token
Task.id - Unterstützt die Suche nach der Task-ID
\n
SHALLprescription-idtoken
Task.identifier - Unterstützt die Suche nach der E-Rezept-ID
\n
SHALLaccess-codetoken
Task.identifier - Unterstützt die Suche nach dem Zugriffscode
\n
SHALL<a href=\"http://hl7.org/fhir/R4/task.html#search\">status</a>token
Task.status - Unterstützt die Suche nach dem Status einer Task
\n
SHALLauthored-ondate
Task.authoredOn - Unterstützt die Suche nach dem Erstellungsdatum
\n
SHALLaccept-datedate
Task.extension:acceptDate.valueDate - Unterstützt die Suche nach dem Akzeptanzdatum
\n
SHALLexpiry-datedate
Task.extension:expiryDate.valueDate - Unterstützt die Suche nach dem Verfallsdatum
\n
SHALL<a href=\"http://hl7.org/fhir/R4/task.html#search\">modified</a>date
Task.lastModified - Unterstützt die Suche nach dem zuletzt modifizierten Datum
\n
SHALL_sortstring
Unterstützt das Sortieren nach unterstützten Task-Suchkriterien
\n
SHALL_countnumber
Maximale Anzahl zurückgegebener Einträge pro Seite; maximum value is 50
\n
SHALL__offsetnumber
Nullbasierter Offset des ersten zurückgegebenen Eintrags; default is 0
\n
</table></div><div class=\"col-lg-5\">\u00a0</div></div><div class=\"row\"><div class=\"col-12\"><span class=\"lead\">Extended Operations</span><table class=\"table table-condensed table-hover\">ConformanceOperationDocumentationSHALL<a href=\"OperationDefinition-EUCloseOperation.html\">$eu-close</a>
Finishes the EU ePrescription workflow and creates a signed receipt bundle
\n
</table></div></div></div></div></div><div class=\"panel panel-default\"><div class=\"panel-heading\"><h4 id=\"Consent1-2\" class=\"panel-title\"><span style=\"float: right;\">Resource Conformance: SHALL </span>Consent</h4></div><div class=\"panel-body\"><div class=\"container\"><div class=\"row\"><div class=\"col-lg-4\"><span class=\"lead\">Core FHIR Resource</span>
<a href=\"http://hl7.org/fhir/R4/consent.html\">Consent</a></div><div class=\"col-lg-4\"><span class=\"lead\">Reference Policy</span>
</div><div class=\"col-lg-4\"><span class=\"lead\">Interaction summary</span>
  • SHALL support search-type, create, delete.
</div></div>
<div class=\"row\"><div class=\"col-lg-7\"><span class=\"lead\">Search Parameters</span><table class=\"table table-condensed table-hover\">ConformanceParameterTypeDocumentationSHALL<a href=\"http://hl7.org/fhir/R4/consent.html#search\">category</a>token
Consent.category - Unterstützt die Suche nach der Art der Einwilligung
\n
</table></div><div class=\"col-lg-5\">\u00a0</div></div></div></div></div></div>"},"extension":[{"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-base-url","valueString":"https://tiflow.de"}],"url":"https://gematik.de/fhir/tiflow-xborder/CapabilityStatement/ti-flow-fachdienst-server-erpeu","version":"2.0.0-ballot.1","title":"ERPEU CapabilityStatement fuer den E-Rezept-Fachdienst","status":"active","date":"2026-01-08","publisher":"gematik GmbH","contact":[{"name":"gematik GmbH","telecom":[{"system":"url","value":"https://gematik.de"},{"system":"email","value":"erp-umsetzung@gematik.de"}]}],"description":"CapabilityStatement fuer den E-Rezept-Fachdienst (EU-Zugriff)","jurisdiction":[{"coding":[{"system":"urn:iso:std:iso:3166","code":"DE","display":"Germany"}]}],"kind":"requirements","fhirVersion":"4.0.1","format":["application/fhir+json","application/fhir+xml"],"rest":[{"mode":"server","resource":[{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}],"type":"Task","supportedProfile":["https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task"],"_supportedProfile":[{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}]}],"interaction":[{"extension":[{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Invalid request"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_BAD_FORMAT"}],"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"},{"extension":[{"url":"statusCode","valueString":"408"},{"url":"description","valueString":"Request timeout"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_TIMEOUT"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"500"},{"url":"description","valueString":"Internal server error"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_INTERNAL_ERROR"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"200"},{"url":"description","valueString":"Successful operation"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Unknown search parameter"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_PARAM_UNKNOWN"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Invalid query parameter(s)"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_BAD_SYNTAX"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"404"},{"url":"description","valueString":"Unknown resource type"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_UNKNOWN_TYPE"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"}],"code":"search-type"},{"extension":[{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Invalid request"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_BAD_FORMAT"}],"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"},{"extension":[{"url":"statusCode","valueString":"408"},{"url":"description","valueString":"Request timeout"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_TIMEOUT"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"500"},{"url":"description","valueString":"Internal server error"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_INTERNAL_ERROR"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"200"},{"url":"description","valueString":"Successful operation"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"404"},{"url":"description","valueString":"Unknown resource type"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_UNKNOWN_TYPE"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"404"},{"url":"description","valueString":"Resource is not known"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_RESOURCE_ID_FAIL"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"410"},{"url":"description","valueString":"Resource was deleted"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_DELETED"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"}],"code":"read"},{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}],"code":"patch"}],"versioning":"versioned-update","readHistory":true,"searchParam":[{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}],"name":"_id","definition":"http://hl7.org/fhir/SearchParameter/Resource-id","type":"token","documentation":"Task.id - Unterstützt die Suche nach der Task-ID"},{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}],"name":"prescription-id","type":"token","documentation":"Task.identifier - Unterstützt die Suche nach der E-Rezept-ID"},{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}],"name":"access-code","type":"token","documentation":"Task.identifier - Unterstützt die Suche nach dem Zugriffscode"},{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}],"name":"status","definition":"http://hl7.org/fhir/SearchParameter/Task-status","type":"token","documentation":"Task.status - Unterstützt die Suche nach dem Status einer Task"},{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}],"name":"authored-on","type":"date","documentation":"Task.authoredOn - Unterstützt die Suche nach dem Erstellungsdatum"},{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}],"name":"accept-date","type":"date","documentation":"Task.extension:acceptDate.valueDate - Unterstützt die Suche nach dem Akzeptanzdatum"},{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}],"name":"expiry-date","type":"date","documentation":"Task.extension:expiryDate.valueDate - Unterstützt die Suche nach dem Verfallsdatum"},{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}],"name":"modified","definition":"http://hl7.org/fhir/SearchParameter/Task-modified","type":"date","documentation":"Task.lastModified - Unterstützt die Suche nach dem zuletzt modifizierten Datum"},{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}],"name":"_sort","type":"string","documentation":"Unterstützt das Sortieren nach unterstützten Task-Suchkriterien"},{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}],"name":"_count","type":"number","documentation":"Maximale Anzahl zurückgegebener Einträge pro Seite; maximum value is 50"},{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}],"name":"__offset","type":"number","documentation":"Nullbasierter Offset des ersten zurückgegebenen Eintrags; default is 0"}],"operation":[{"extension":[{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"FHIR Profile Validation Failed"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"SVC_VALIDATION_FAILED"}],"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"},{"extension":[{"url":"statusCode","valueString":"403"},{"url":"description","valueString":"Access permission invalid"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"TIFLOW_ACCESS_PERMISSION_INVALID"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"403"},{"url":"description","valueString":"Access role not allowed"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"TIFLOW_AUTH_ROLE_NOT_ALLOWED"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"403"},{"url":"description","valueString":"Consent missing"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"TIFLOW_CONSENT_MISSING"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Task status mismatch"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"TIFLOW_TASK_STATUS_MISMATCH"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"404"},{"url":"description","valueString":"Resource is not known"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_RESOURCE_ID_FAIL"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"410"},{"url":"description","valueString":"Resource was deleted"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_DELETED"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Invalid request"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_BAD_FORMAT"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"408"},{"url":"description","valueString":"Request timeout"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_TIMEOUT"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"500"},{"url":"description","valueString":"Internal server error"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_INTERNAL_ERROR"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"}],"name":"eu-close","definition":"https://gematik.de/fhir/erp-eu/OperationDefinition/EUCloseOperationDefinition","documentation":"Finishes the EU ePrescription workflow and creates a signed receipt bundle"}]},{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}],"type":"Consent","interaction":[{"extension":[{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Invalid request"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_BAD_FORMAT"}],"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"},{"extension":[{"url":"statusCode","valueString":"408"},{"url":"description","valueString":"Request timeout"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_TIMEOUT"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"500"},{"url":"description","valueString":"Internal server error"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_INTERNAL_ERROR"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"200"},{"url":"description","valueString":"Successful operation"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Unknown search parameter"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_PARAM_UNKNOWN"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Invalid query parameter(s)"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_BAD_SYNTAX"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"404"},{"url":"description","valueString":"Unknown resource type"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_UNKNOWN_TYPE"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"}],"code":"search-type"},{"extension":[{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Invalid request"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_BAD_FORMAT"}],"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"},{"extension":[{"url":"statusCode","valueString":"408"},{"url":"description","valueString":"Request timeout"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_TIMEOUT"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"500"},{"url":"description","valueString":"Internal server error"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_INTERNAL_ERROR"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"201"},{"url":"description","valueString":"Resource created"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"404"},{"url":"description","valueString":"Unknown resource type"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_UNKNOWN_TYPE"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"}],"code":"create"},{"extension":[{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Invalid request"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_BAD_FORMAT"}],"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"},{"extension":[{"url":"statusCode","valueString":"408"},{"url":"description","valueString":"Request timeout"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_TIMEOUT"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"500"},{"url":"description","valueString":"Internal server error"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_INTERNAL_ERROR"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"204"},{"url":"description","valueString":"Successful operation without response body"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"404"},{"url":"description","valueString":"Unknown resource type"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_UNKNOWN_TYPE"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"404"},{"url":"description","valueString":"Resource is not known"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_RESOURCE_ID_FAIL"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"410"},{"url":"description","valueString":"Resource was deleted"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_DELETED"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"}],"code":"delete"}],"versioning":"versioned-update","readHistory":true,"searchParam":[{"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"}],"name":"category","definition":"http://hl7.org/fhir/SearchParameter/Consent-category","type":"token","documentation":"Consent.category - Unterstützt die Suche nach der Art der Einwilligung"}]}],"operation":[{"extension":[{"extension":[{"url":"statusCode","valueString":"200"},{"url":"description","valueString":"Successful operation"},{"url":"responseType","valueString":"Parameters"}],"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"},{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Invalid request"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_BAD_FORMAT"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"408"},{"url":"description","valueString":"Request timeout"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_TIMEOUT"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"500"},{"url":"description","valueString":"Internal server error"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_INTERNAL_ERROR"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Access code invalid"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"TIFLOW_ACCESS_CODE_INVALID"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"403"},{"url":"description","valueString":"Consent required"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"TIFLOW_CONSENT_REQUIRED"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"409"},{"url":"description","valueString":"Country code invalid"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"TIFLOW_XBORDER_COUNTRY_CODE_INVALID"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"403"},{"url":"description","valueString":"Access role not allowed"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"TIFLOW_AUTH_ROLE_NOT_ALLOWED"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"}],"name":"grant-eu-access-permission","definition":"https://gematik.de/fhir/erp-eu/OperationDefinition/Grant_Access_PermissionOperationDefinition","documentation":"Registers access code and country for EU prescription access"},{"extension":[{"extension":[{"url":"statusCode","valueString":"200"},{"url":"description","valueString":"Successful operation"},{"url":"responseType","valueString":"Parameters"}],"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"},{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Invalid request"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_BAD_FORMAT"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"408"},{"url":"description","valueString":"Request timeout"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_TIMEOUT"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"500"},{"url":"description","valueString":"Internal server error"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_INTERNAL_ERROR"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"403"},{"url":"description","valueString":"Access role not allowed"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"TIFLOW_AUTH_ROLE_NOT_ALLOWED"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"}],"name":"read-eu-access-permission","definition":"https://gematik.de/fhir/erp-eu/OperationDefinition/Read_Access_PermissionOperationDefinition","documentation":"Reads the currently registered EU access code"},{"extension":[{"extension":[{"url":"statusCode","valueString":"200"},{"url":"description","valueString":"Successful operation"}],"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"},{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Invalid request"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_BAD_FORMAT"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"408"},{"url":"description","valueString":"Request timeout"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_TIMEOUT"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"500"},{"url":"description","valueString":"Internal server error"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_INTERNAL_ERROR"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"403"},{"url":"description","valueString":"Access role not allowed"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"TIFLOW_AUTH_ROLE_NOT_ALLOWED"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"}],"name":"revoke-eu-access-permission","definition":"https://gematik.de/fhir/erp-eu/OperationDefinition/Revoke_Access_PermissionOperationDefinition","documentation":"Revokes the currently registered EU access code"},{"extension":[{"extension":[{"url":"statusCode","valueString":"200"},{"url":"description","valueString":"Successful operation"},{"url":"responseType","valueString":"Parameters"}],"url":"http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation","valueCode":"SHALL"},{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"Invalid request"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_BAD_FORMAT"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"408"},{"url":"description","valueString":"Request timeout"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_TIMEOUT"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"500"},{"url":"description","valueString":"Internal server error"},{"url":"responseType","valueString":"EPAMSOperationOutcome"},{"url":"errorCode","valueString":"MSG_INTERNAL_ERROR"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"400"},{"url":"description","valueString":"FHIR Profile Validation Failed"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"SVC_VALIDATION_FAILED"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"403"},{"url":"description","valueString":"Access permission invalid"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"TIFLOW_ACCESS_PERMISSION_INVALID"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"403"},{"url":"description","valueString":"Access role not allowed"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"TIFLOW_AUTH_ROLE_NOT_ALLOWED"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"403"},{"url":"description","valueString":"Consent required"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"TIFLOW_CONSENT_REQUIRED"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"},{"extension":[{"url":"statusCode","valueString":"404"},{"url":"description","valueString":"No prescriptions found"},{"url":"responseType","valueString":"TIFlowOperationOutcome"},{"url":"errorCode","valueString":"TIFLOW_XBORDER_NO_PRESCRIPTIONS_FOUND"}],"url":"https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"}],"name":"get-eu-prescriptions","definition":"https://gematik.de/fhir/erp-eu/OperationDefinition/GET-Prescription-EUOperationDefinition","documentation":"Returns prescription information for EU ePrescription workflows"}]}]}
		
			{"resourceType":"OperationDefinition","id":"Grant-EU-Access-Permission","text":{"status":"generated","div":"<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\">Generated Narrative: OperationDefinition Grant-EU-Access-Permission</p><a name=\"Grant-EU-Access-Permission\"> </a><a name=\"hcGrant-EU-Access-Permission\"> </a>
URL: [base]/$grant-eu-access-permission
Input parameters Profile:<a href=\"StructureDefinition-GEM-ERPEU-PR-PAR-AccessAuthorization-Request.html\">GEM ERPEU PR PAR Access Authorization Request</a>
Output parameters Profile:<a href=\"StructureDefinition-GEM-ERPEU-PR-PAR-AccessAuthorization-Response.html\">GEM ERPEU PR PAR Access Authorization Response</a>
Parameters
<table class=\"grid\">UseNameScopeCardinalityTypeBindingDocumentationINcountryCode1..1<a href=\"http://hl7.org/fhir/R4/datatypes.html#Coding\">Coding</a>
The country for which the patient wants to grant access.
\n
INaccessCode1..1<a href=\"http://hl7.org/fhir/R4/datatypes.html#Identifier\">Identifier</a>
The access code for that country.
\n
OUTcountryCode1..1<a href=\"http://hl7.org/fhir/R4/datatypes.html#Coding\">Coding</a>
The country for which the patient wants to grant access.
\n
OUTaccessCode1..1<a href=\"http://hl7.org/fhir/R4/datatypes.html#Identifier\">Identifier</a>
The access code for that country.
\n
OUTvalidUntil1..1<a href=\"http://hl7.org/fhir/R4/datatypes.html#instant\">instant</a>
The instant until the access code is valid.
\n
OUTcreatedAt1..1<a href=\"http://hl7.org/fhir/R4/datatypes.html#instant\">instant</a>
The instant when the record was created in the E-Rezept-Fachdienst.
\n
</table></div>"},"url":"https://gematik.de/fhir/erp-eu/OperationDefinition/Grant_Access_PermissionOperationDefinition","version":"2.0.0-ballot.1","name":"Grant_Access_Permission","status":"draft","kind":"operation","date":"2026-05-26","publisher":"gematik GmbH","contact":[{"name":"gematik GmbH","telecom":[{"system":"url","value":"https://gematik.de"},{"system":"email","value":"erp-umsetzung@gematik.de"}]}],"description":"This operation receives the access code and the country that the patient wants to grant access to. The operation validates the country and creates registeres the Access Code.","jurisdiction":[{"coding":[{"system":"urn:iso:std:iso:3166","code":"DE","display":"Germany"}]}],"affectsState":true,"code":"grant-eu-access-permission","system":true,"type":false,"instance":false,"inputProfile":"https://gematik.de/fhir/tiflow-xborder/StructureDefinition/GEM-ERPEU-PR-PAR-AccessAuthorization-Request","outputProfile":"https://gematik.de/fhir/tiflow-xborder/StructureDefinition/GEM-ERPEU-PR-PAR-AccessAuthorization-Response","parameter":[{"name":"countryCode","use":"in","min":1,"max":"1","documentation":"The country for which the patient wants to grant access.","type":"Coding"},{"name":"accessCode","use":"in","min":1,"max":"1","documentation":"The access code for that country.","type":"Identifier"},{"name":"countryCode","use":"out","min":1,"max":"1","documentation":"The country for which the patient wants to grant access.","type":"Coding"},{"name":"accessCode","use":"out","min":1,"max":"1","documentation":"The access code for that country.","type":"Identifier"},{"name":"validUntil","use":"out","min":1,"max":"1","documentation":"The instant until the access code is valid.","type":"instant"},{"name":"createdAt","use":"out","min":1,"max":"1","documentation":"The instant when the record was created in the E-Rezept-Fachdienst.","type":"instant"}]}
		

<Parameters xmlns="http://hl7.org/fhir">
  <id value="Example-EU-PermissionRequest"/>
  <meta>
    <profile
             value="https://gematik.de/fhir/tiflow-xborder/StructureDefinition/GEM-ERPEU-PR-PAR-AccessAuthorization-Request"/>
  </meta>
  <parameter>
    <name value="countryCode"/>
    <valueCoding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="BE"/>
    </valueCoding>
  </parameter>
  <parameter>
    <name value="accessCode"/>
    <valueIdentifier>
      <system
              value="https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_EU_AccessCode"/>
      <value value="ABC123"/>
    </valueIdentifier>
  </parameter>
</Parameters>

<Parameters xmlns="http://hl7.org/fhir">
  <id value="Example-EU-PermissionResponse"/>
  <meta>
    <profile
             value="https://gematik.de/fhir/tiflow-xborder/StructureDefinition/GEM-ERPEU-PR-PAR-AccessAuthorization-Response"/>
  </meta>
  <parameter>
    <name value="countryCode"/>
    <valueCoding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="BE"/>
    </valueCoding>
  </parameter>
  <parameter>
    <name value="accessCode"/>
    <valueIdentifier>
      <system
              value="https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_EU_AccessCode"/>
      <value value="ABC123"/>
    </valueIdentifier>
  </parameter>
  <parameter>
    <name value="validUntil"/>
    <valueInstant value="2025-10-01T13:12:32+02:00"/>
  </parameter>
  <parameter>
    <name value="createdAt"/>
    <valueInstant value="2025-10-01T12:12:32+02:00"/>
  </parameter>
</Parameters>

<OperationOutcome xmlns="http://hl7.org/fhir">
  <id value="ExampleERPEUOperationOutcomeError"/>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: OperationOutcome ExampleERPEUOperationOutcomeError</b></p><a name="ExampleERPEUOperationOutcomeError"> </a><a name="hcExampleERPEUOperationOutcomeError"> </a><h3>Issues</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Severity</b></td><td><b>Code</b></td><td><b>Details</b></td><td><b>Diagnostics</b></td></tr><tr><td style="display: none">*</td><td>Error</td><td>Invalid Content</td><td><span title="Codes:">countryCode is not supported</span></td><td>Expected one of approved EU country codes in requestData.countryCode</td></tr></table></div>
  </text>
  <issue>
    <severity value="error"/>
    <code value="invalid"/>
    <details>
      <text value="countryCode is not supported"/>
    </details>
    <diagnostics
                 value="Expected one of approved EU country codes in requestData.countryCode"/>
  </issue>
</OperationOutcome>