FHIR IG analytics
| Package | de.gematik.epa.mhd |
| Resource Type | CapabilityStatement |
| Id | CapabilityStatement-epa-mhd-document-recipient.json |
| FHIR Version | R4 |
| Source | https://gematik.de/fhir/epa-mhd/1.2.0-ballot.1/CapabilityStatement-epa-mhd-document-recipient.html |
| URL | https://gematik.de/fhir/epa-mhd/CapabilityStatement/epa-mhd-document-recipient |
| Version | 1.2.0 |
| Status | active |
| Date | 2026-12-08 |
| Name | EPAMHDDocumentRecipient |
| Title | ePA MHD Service (Document Recipient - Server) |
| Realm | de |
| Description | CapabilityStatement für den ePA MHD Service (Document Recipient - Server) |
| Copyright | gematik GmbH / Dieser Implementation Guide ist lizenziert unter [Apache License](./license.html), Version 2.0. |
| Kind | requirements |
Resources that use this resource
No resources found
Resources that this resource uses
Narrative
No narrative content found in resource
Source1
{
"resourceType": "CapabilityStatement",
"id": "epa-mhd-document-recipient",
"meta": {
"profile": [
"https://gematik.de/fhir/ti/StructureDefinition/ti-capability-statement"
]
},
"extension": [
{
"extension": [
{
"url": "name",
"valueString": "X-Request-ID"
},
{
"url": "type",
"valueString": "string"
},
{
"url": "description",
"valueString": "UUID of the request message"
},
{
"url": "format",
"valueString": "uuid"
},
{
"url": "required",
"valueBoolean": true
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-header"
},
{
"extension": [
{
"url": "name",
"valueString": "x-insurantid"
},
{
"url": "type",
"valueString": "string"
},
{
"url": "description",
"valueString": "Health Record Identifier"
},
{
"url": "pattern",
"valueString": "^[A-Z]{1}\\d{9}$"
},
{
"url": "required",
"valueBoolean": true
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-header"
},
{
"extension": [
{
"url": "name",
"valueString": "x-useragent"
},
{
"url": "type",
"valueString": "string"
},
{
"url": "description",
"valueString": "user agent information"
},
{
"url": "pattern",
"valueString": "^[a-zA-Z0-9]{20}\\/[a-zA-Z0-9\\-\\.]{1,15}$"
},
{
"url": "required",
"valueBoolean": true
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-header"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "403"
},
{
"url": "description",
"valueString": "Requestor not authorized (no user session with valid ID-Token available)"
},
{
"url": "responseType",
"valueString": "application/json"
},
{
"url": "errorCode",
"valueString": "invalAuth"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "403"
},
{
"url": "description",
"valueString": "Requestor has no valid entitlement"
},
{
"url": "responseType",
"valueString": "application/json"
},
{
"url": "errorCode",
"valueString": "notEntitled"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "403"
},
{
"url": "description",
"valueString": "Requestor role is not in the list of allowed user groups"
},
{
"url": "responseType",
"valueString": "application/json"
},
{
"url": "errorCode",
"valueString": "invalidOid"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "403"
},
{
"url": "description",
"valueString": "Device registration does not exist (if requestor role is oid_versicherter only)"
},
{
"url": "responseType",
"valueString": "application/json"
},
{
"url": "errorCode",
"valueString": "unregisteredDevice"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "404"
},
{
"url": "description",
"valueString": "Health record is in state UNKNOWN or INITIALIZED"
},
{
"url": "responseType",
"valueString": "application/json"
},
{
"url": "errorCode",
"valueString": "noHealthRecord"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "409"
},
{
"url": "description",
"valueString": "Request conflicts with the current state of the health record"
},
{
"url": "responseType",
"valueString": "application/json"
},
{
"url": "errorCode",
"valueString": "statusMismatch"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "500"
},
{
"url": "description",
"valueString": "Any other error"
},
{
"url": "responseType",
"valueString": "application/json"
},
{
"url": "errorCode",
"valueString": "internalError"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-base-url",
"valueString": "http://epa4all/epa/mhd/api/v1/fhir/"
}
],
"url": "https://gematik.de/fhir/epa-mhd/CapabilityStatement/epa-mhd-document-recipient",
"version": "1.2.0",
"name": "EPAMHDDocumentRecipient",
"title": "ePA MHD Service (Document Recipient - Server)",
"status": "active",
"date": "2026-12-08",
"publisher": "gematik GmbH",
"contact": [
{
"telecom": [
{
"system": "url",
"value": "https://www.gematik.de"
}
]
}
],
"description": "CapabilityStatement für den ePA MHD Service (Document Recipient - Server)",
"jurisdiction": [
{
"coding": [
{
"system": "urn:iso:std:iso:3166",
"code": "DE"
}
]
}
],
"copyright": "gematik GmbH / Dieser Implementation Guide ist lizenziert unter [Apache License](./license.html), Version 2.0.",
"kind": "requirements",
"instantiates": [
"https://gematik.de/fhir/epa/CapabilityStatement/epa-basic-server",
"https://profiles.ihe.net/ITI/MHD/CapabilityStatement/IHE.MHD.DocumentRecipient.Generate",
"https://profiles.ihe.net/ITI/MHD/CapabilityStatement/IHE.MHD.DocumentRecipient.Simplified",
"http://hl7.eu/fhir/health-data-api/CapabilityStatement/EEHRxF-DocumentAccessProvider-SubmissionOption"
],
"imports": [
"https://gematik.de/fhir/epa/CapabilityStatement/epa-basic-server"
],
"_imports": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
}
]
}
],
"fhirVersion": "4.0.1",
"format": [
"application/fhir+json",
"application/fhir+xml"
],
"implementationGuide": [
"https://gematik.de/fhir/ti/ImplementationGuide/de.gematik.ti",
"https://gematik.de/fhir/terminology/ImplementationGuide/de.gematik.terminology",
"https://gematik.de/fhir/epa/ImplementationGuide/de.gematik.epa",
"https://gematik.de/fhir/epa-mhd/ImplementationGuide/de.gematik.epa.mhd",
"https://gematik.de/fhir/epa-laboratory/ImplementationGuide/de.gematik.epa.laboratory"
],
"rest": [
{
"mode": "server",
"resource": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
}
],
"type": "DocumentReference",
"supportedProfile": [
"https://gematik.de/fhir/epa-mhd/StructureDefinition/epa-mhd-simplified-publish-document-reference"
],
"_supportedProfile": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
}
]
}
],
"interaction": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "201"
},
{
"url": "description",
"valueString": "Created - Location header with logical id and version id, created DocumentReference in the response body"
},
{
"url": "responseType",
"valueString": "DocumentReference"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "name",
"valueString": "X-Requesting-Organization"
},
{
"url": "type",
"valueString": "string"
},
{
"url": "description",
"valueString": "Base64 encoded FHIR Organization resource in JSON format used to identify the originator of the request"
},
{
"url": "format",
"valueString": "base64(fhir+json:Organization)"
},
{
"url": "required",
"valueBoolean": true
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-header"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "431"
},
{
"url": "description",
"valueString": "Requesting Organization Header exceeds maximum size"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "SVC_ORG_HEADER_TOO_LARGE"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "422"
},
{
"url": "description",
"valueString": "Profile mismatch in header Organization"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "SVC_ORG_HEADER_PROFILE_MISMATCH"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "403"
},
{
"url": "description",
"valueString": "ID-Token or Insurant-ID mismatch"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "SVC_IDENTITY_MISMATCH"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "404"
},
{
"url": "description",
"valueString": "Resource is not found - resource type not supported, or not a FHIR end-point"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "MSG_RESOURCE_TYPE_MISMATCH"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "400"
},
{
"url": "description",
"valueString": "Bad Request - resource could not be parsed or failed basic FHIR validation rules"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "MSG_BAD_SYNTAX"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "422"
},
{
"url": "description",
"valueString": "Unprocessable Entity - the proposed resource violated applicable FHIR profiles or server business rules"
},
{
"url": "responseType",
"valueString": "EPAMHDOperationOutcome"
},
{
"url": "errorCode",
"valueString": "[proper code from EPAMHDOperationOutcomeDetailsCS]"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "413"
},
{
"url": "description",
"valueString": "Payload too large"
},
{
"url": "responseType",
"valueString": "application/json"
},
{
"url": "errorCode",
"valueString": "'MaxDocSizeExceeded' or 'MaxPkgSizeExceeded'"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "403"
},
{
"url": "description",
"valueString": "Action inconsistent with legal policy"
},
{
"url": "responseType",
"valueString": "application/json"
},
{
"url": "errorCode",
"valueString": "legalPolicyViolation"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
}
],
"code": "create"
}
],
"operation": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "200"
},
{
"url": "description",
"valueString": "Successful operation"
},
{
"url": "responseType",
"valueString": "DocumentReference"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "name",
"valueString": "X-Requesting-Organization"
},
{
"url": "type",
"valueString": "string"
},
{
"url": "description",
"valueString": "Base64 encoded FHIR Organization resource in JSON format used to identify the originator of the request"
},
{
"url": "format",
"valueString": "base64(fhir+json:Organization)"
},
{
"url": "required",
"valueBoolean": true
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-header"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "431"
},
{
"url": "description",
"valueString": "Requesting Organization Header exceeds maximum size"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "SVC_ORG_HEADER_TOO_LARGE"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "422"
},
{
"url": "description",
"valueString": "Profile mismatch in header Organization"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "SVC_ORG_HEADER_PROFILE_MISMATCH"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "403"
},
{
"url": "description",
"valueString": "ID-Token or Insurant-ID mismatch"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "SVC_IDENTITY_MISMATCH"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "400"
},
{
"url": "description",
"valueString": "Bad Request - resource could not be parsed or failed basic FHIR validation rules"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "MSG_BAD_SYNTAX"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "422"
},
{
"url": "description",
"valueString": "Unprocessable Entity - the proposed resource violated applicable FHIR profiles or server business rules"
},
{
"url": "responseType",
"valueString": "EPAMHDOperationOutcome"
},
{
"url": "errorCode",
"valueString": "[proper code from EPAMHDOperationOutcomeDetailsCS]"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "403"
},
{
"url": "description",
"valueString": "Action inconsistent with legal policy"
},
{
"url": "responseType",
"valueString": "application/json"
},
{
"url": "errorCode",
"valueString": "legalPolicyViolation"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
}
],
"name": "generate-metadata",
"definition": "https://gematik.de/fhir/epa-mhd/OperationDefinition/generate-metadata-op",
"documentation": "Die Generate-Metadata-Operation ermöglicht das Einstellen eines FHIR-Dokuments in die ePA mit automatisch generierten Metadaten und Ressourceninstanzen."
}
]
}
]
}
]
}