{
"description": "CapabilityStatement für den ePA MHD Service (Document Source - Client)",
"_filename": "CapabilityStatement-epa-mhd-document-source.json",
"package_name": "de.gematik.epa.mhd",
"format": [ "application/fhir+json", "application/fhir+xml" ],
"_imports": [ {
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
} ]
} ],
"date": "2026-12-08",
"meta": {
"profile": [ "https://gematik.de/fhir/ti/StructureDefinition/ti-capability-statement" ]
},
"publisher": "gematik GmbH",
"fhirVersion": "4.0.1",
"jurisdiction": [ {
"coding": [ {
"code": "DE",
"system": "urn:iso:std:iso:3166"
} ]
} ],
"instantiates": [ "https://gematik.de/fhir/epa/CapabilityStatement/epa-basic-client", "https://profiles.ihe.net/ITI/MHD/CapabilityStatement/IHE.MHD.DocumentSource.Generate", "https://profiles.ihe.net/ITI/MHD/CapabilityStatement/IHE.MHD.DocumentSource.Simplified", "http://hl7.eu/fhir/health-data-api/CapabilityStatement/EEHRxF-DocumentPublisher" ],
"name": "EPAMHDDocumentSource",
"type": null,
"experimental": null,
"resourceType": "CapabilityStatement",
"imports": [ "https://gematik.de/fhir/epa/CapabilityStatement/epa-basic-client" ],
"title": "ePA MHD Service (Document Source - Client)",
"package_version": "1.2.0-ballot.1",
"extension": [ {
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-base-url",
"valueString": "http://epa4all/epa/mhd/api/v1/fhir/"
} ],
"status": "active",
"id": "667f718d-0760-41dd-8a5c-bf5fe8ebb0ea",
"kind": "requirements",
"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" ],
"url": "https://gematik.de/fhir/epa-mhd/CapabilityStatement/epa-mhd-document-source",
"version": "1.2.0",
"contact": [ {
"telecom": [ {
"value": "https://www.gematik.de",
"system": "url"
} ]
} ],
"rest": [ {
"mode": "client",
"resource": [ {
"type": "DocumentReference",
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
} ],
"operation": [ {
"name": "generate-metadata",
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
}, {
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info",
"extension": [ {
"url": "statusCode",
"valueString": "200"
}, {
"url": "description",
"valueString": "Successful operation"
}, {
"url": "responseType",
"valueString": "DocumentReference"
} ]
}, {
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-header",
"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-response-info",
"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"
} ]
} ],
"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."
} ],
"interaction": [ {
"code": "create",
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
}, {
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info",
"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-header",
"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-response-info",
"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"
} ]
} ]
} ],
"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"
} ]
} ]
} ]
} ]
}