DocumentBundle

Befunde, OP-Berichte und ähnliche Unterlagen gehen über denselben Endpunkt wie die Anfragen. Erkannt werden sie am Profil DocumentBundle.

POST /api/v2/fhir/Bundle
Authorization: Bearer <Access-Token>
Content-Type: application/fhir+json

Beispiel

Ein DocumentBundle mit einer DocumentReference, der eigentlichen Binary und den empfangsberechtigten Kliniken:

{
  "resourceType": "Bundle",
  "type": "collection",
  "meta": {
    "profile": ["https://belegung-api.median-kliniken.de/fhir/StructureDefinition/DocumentBundle"]
  },
  "entry": [
    {
      "resource": {
        "resourceType": "DocumentReference",
        "masterIdentifier": {
          "system": "urn:ietf:rfc:3986",
          "value": "https://zuweiser.example.org/documents/DOC-2025-123456"
        },
        "status": "current",
        "type": {
          "coding": [{
            "system": "http://dvmd.de/fhir/CodeSystem/kdl",
            "code": "AD010109",
            "display": "Ärztlicher Befundbericht"
          }]
        },
        "content": [{
          "attachment": { "contentType": "application/pdf", "url": "Binary/binary-001" }
        }],
        "context": {
          "related": [{
            "type": "ServiceRequest",
            "identifier": {
              "system": "urn:ietf:rfc:3986",
              "value": "https://zuweiser.example.org/fhir/ServiceRequest/SR-2025-123456"
            }
          }]
        }
      }
    },
    {
      "resource": {
        "resourceType": "Binary",
        "id": "binary-001",
        "contentType": "application/pdf",
        "data": "JVBERi0xLjQK..."
      }
    },
    {
      "resource": {
        "resourceType": "Organization",
        "identifier": [{ "system": "http://fhir.de/sid/arge-ik/iknr", "value": "260950455" }]
      }
    }
  ]
}

Das vollständige Beispiel steht unter Beispiele.

Inhalt eines DocumentBundle

Ressource	Anzahl	Zweck
DocumentReference	1	Metadaten des Dokuments
Binary	1	Der Inhalt, etwa ein PDF
Organization	0..n	Die Kliniken, die das Dokument erhalten dürfen, siehe FHIR-Ressourcen

Anforderungen an die DocumentReference

Element	Zweck
masterIdentifier	Eindeutige Kennung des Dokuments. Wird zur Erkennung von Wiederholungen genutzt.
type.coding	Dokumentart als KDL-Code, System http://dvmd.de/fhir/CodeSystem/kdl.
context.related	Verweis auf den ServiceRequest über dessen Identifier. Stellt die Zuordnung zur Anfrage her.
content.attachment.contentType	MIME-Typ des Inhalts, etwa application/pdf.
content.attachment.url	Verweis auf die Binary im selben Bundle.

Zuordnung zur Anfrage

Das Dokument wird über den ServiceRequest-Identifier in context.related mit der Anfrage verknüpft. Es ist dabei zulässig, ein Dokument zu senden, bevor die zugehörige Anfrage eingetroffen ist: Das Portal puffert es und ordnet es zu, sobald die Anfrage vorliegt.

Wiederholte Übermittlung

Dokumente werden anhand des masterIdentifier erkannt. Wird dasselbe Dokument erneut gesendet, verarbeitet das Portal es kein zweites Mal. Eine Übertragung lässt sich daher gefahrlos wiederholen.

Empfängerkreis

Die im Bundle enthaltenen Organization-Ressourcen legen aus Datenschutzgründen fest, welche Kliniken das Dokument erhalten dürfen. Ging die ursprüngliche Anfrage an mehrere Kliniken, erhält das Dokument trotzdem nur, wer hier als Organization steht.

Antworten

Status	Bedeutung
202 Accepted	Das Dokument ist angenommen.
400 Bad Request	Das Bundle ist unvollständig, etwa ohne DocumentReference. Body ist ein OperationOutcome.
401 Unauthorized	Token fehlt oder ist abgelaufen.

Ein vollständiges Beispiel steht unter Beispiele.