Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Herkunft medizinischer Daten erklärt

Was bei jedem Schreibvorgang in eine FHIR R4 Akte aufgezeichnet wird – Autorentyp, Person, Organisation, Quellsystem, Versionen – wie man es mit Headern einstellt, wie man es liest und wie es an KI-Modelle übergebene Daten kennzeichnet.

Herkunft ist die Aufzeichnung, woher ein medizinisches Datenelement stammt: wer es geschrieben hat, im Auftrag welcher Organisation, aus welchem System, wann und was sich bei jeder Version geändert hat. In einem Datensatz, der Daten von Patienten, Geräten, Kliniken, Laboren und KI sammelt, ist die Herkunft das, was einen Wert vertrauenswürdig macht: Eine zu Hause eingegebene Blutdruckmessung und eine in einer Klinik gemessene sehen ohne sie identisch aus. In Anpheros erzeugt jeder Schreibvorgang auf einen HL7 FHIR R4-Datensatz automatisch eine FHIR Provenance-Ressource. Diese Seite erklärt, was sie enthält, wie man sie korrekt befüllt und wie man sie liest.

Warum Provenienz wichtig ist

Klinisches Vertrauen. Ein Arzt gewichtet ein Laborergebnis anders als einen Wert, den der Patient selbst eingegeben hat, oder eine Zahl, die eine KI aus einem Foto extrahiert hat.
KI-Sicherheit. Ein Modell, dem ein Datensatz übergeben wird, muss wissen, welche Einträge Fakten und welche Notizen sind, die ein anderes Modell verfasst hat. Ohne Kennzeichnungen behandelt es diese gleich.
Korrekturen und Streitigkeiten. Wenn sich ein Wert ändert, muss jeder wissen, wie er vorher war, wer ihn geändert hat und warum.
Rechenschaftspflicht. Gemäß DSGVO und dem European Health Data Space muss eine Organisation nachweisen können, was sie mit den Gesundheitsdaten einer Person getan hat.
Weitergabe. Wenn ein Patient einer zweiten Klinik erlaubt, seine Daten zu lesen, muss diese Klinik wissen, welche Daten die erste Klinik eingetragen hat.

Was Anpheros bei jedem Schreibvorgang aufzeichnet

Frage	Wo es aufgezeichnet wird	Wie Sie es festlegen
Welche Art von Autor?	`agent.who.identifier` (author type)	`author_type` in `/v1`, oder `X-Anpheros-Author-Type` Header: `patient`, `practitioner`, `device`, `import`, `ai`
Welche Person?	`agent.who.reference`	`X-Anpheros-Author-Ref: Practitioner/<id>`, oder `X-Anpheros-Acting-As`
Für welche Organisation?	`agent.onBehalfOf`	die Organisation des `PractitionerRole`, oder `X-Anpheros-On-Behalf-Of: Organization/<id>`
Aus welchem System?	`entity` mit Rolle `source`	`X-Anpheros-Source-System: <name>`
Welcher Datensatz in diesem System?	origin id	`X-Anpheros-Origin-Id: <id>`
Wann und was ist passiert?	`recorded`, `activity` (CREATE, UPDATE, DELETE)	automatisch
Welche Version?	`target` verweist auf `<Resource>/<id>/_history/<version>`	automatisch

Wenn Sie nicht angeben, wer der Autor ist, zeichnet die Plattform import auf. Sie nimmt niemals an, patient, da ein Wert, der fälschlicherweise dem Patienten zugeordnet wird, schlimmer ist als ein ehrlich als importiert gekennzeichneter Wert.

Ein Schreibvorgang mit vollständiger Provenienz

Ein Kardiologe in einer Klinik erfasst während eines Besuchs die Herzfrequenz über die Software der Klinik:

curl -X POST https://platform.anpheros.com/fhir/R4/Observation -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/fhir+json" \
     -H "X-Anpheros-Author-Type: practitioner" \
     -H "X-Anpheros-Acting-As: PractitionerRole/$ROLE" \
     -H "X-Anpheros-Source-System: ccn-emr" \
     -d '{ "resourceType": "Observation", "status": "final", "code": {"coding": [{"system": "http://loinc.org", "code": "8867-4"}]}, … }'

Die Provenienz, die die Plattform schreibt:

{"resourceType": "Provenance",
 "target": [{"reference": "Observation/8660eb7c-…/_history/1"}],
 "recorded": "2026-10-12T20:41:47.469000Z",
 "activity": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/v3-DataOperation", "code": "CREATE"}]},
 "agent": [{"type": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type", "code": "author"}]},
            "who": {"reference": "PractitionerRole/e6d8c227-…",
                    "identifier": {"system": "https://anpheros.com/fhir/CodeSystem/author-type", "value": "practitioner"}},
            "onBehalfOf": {"reference": "Organization/c3a56a4b-…", "display": "Clinica Cardio Nord"}}],
 "entity": [{"role": "source", "what": {"identifier": {"system": "ccn-emr"}}}]}

Die Rolle des Arztes, seine Klinik, die Art des Autors und das Quellsystem sind alle vorhanden, in Standard-FHIR. Die PractitionerRole muss im Verzeichnis Ihres Projekts vorhanden und aktiv sein. Eine Anfrage, die den Practitioner einer anderen Person benennt, wird abgelehnt:

{"resourceType": "OperationOutcome", "issue": [{"severity": "error", "code": "invalid",
  "diagnostics": "Unknown or inactive Practitioner in X-Anpheros-Acting-As."}]}

Die Einrichtung des Verzeichnisses wird in Integration von Kliniksystemen mit einem FHIR-Backend behandelt.

Versionen: Nichts wird stillschweigend überschrieben

Jedes Update erstellt eine neue Version der Ressource und eine neue Provenance dafür. Nachdem die Herzfrequenz von 92 auf 88 korrigiert wurde:

curl https://platform.anpheros.com/fhir/R4/Observation/$OBS/_history -H "Authorization: Bearer $KEY"

gibt Version 2 (88) und Version 1 (92) zurück. Die REST-Ansicht fasst die Provenance jeder Version zusammen:

curl https://platform.anpheros.com/v1/patients/$PID/provenance/Observation/$OBS -H "Authorization: Bearer $KEY"

{"data": [
  {"version": 1, "activity": "CREATE", "recorded": "2026-10-12T20:41:47.469000Z", "author_type": "practitioner", "author": "PractitionerRole/e6d8c227-…", "source_system": "ccn-emr", "fhir": "Provenance/6ed91529-…"},
  {"version": 2, "activity": "UPDATE", "recorded": "2026-10-12T20:41:47.500000Z", "author_type": "practitioner", "fhir": "Provenance/3fbf270f-…"}],
 "total": 2}

Löschungen sind "soft": Eine gelöschte Ressource verschwindet aus Suchen, aber ihre Historie und Provenance bleiben erhalten.

Provenienz lesen

# who wrote this resource (all versions)
GET /fhir/R4/Provenance?target=Observation/{id}
# everything a practitioner recorded
GET /fhir/R4/Provenance?agent=PractitionerRole/{id}
# the same, summarised, per resource
GET /v1/patients/{pid}/provenance/Observation/{id}

Provenienz in KI-Kontexten

Die Kontext-API überträgt die Provenienz in jedes Element, das sie einem Modell übergibt, als author_type und source. In Textform:

- Type 2 diabetes mellitus (E11), active, onset 2024-10-15 [import/anpheros-sandbox]
- Metformin 1000 mg 1 tablet twice daily with meals, active [patient/anpheros-sandbox]
- Glucose [Mass/volume] in Blood: 2026-09-16: 140.0 mg/dL [device/anpheros-sandbox]

Messungen, die mit author_type: ai geschrieben wurden, erscheinen niemals unter diesen Fakten. Sie werden separat unter ai_notes aufgeführt und als nicht verifiziert markiert, sodass ein Modell die Vermutung eines früheren Modells nicht mit einer Messung verwechseln kann. Teilen Sie dem Modell mit, was die Labels bedeuten, und bitten Sie es, diese zu zitieren. How to build an AI healthcare app with a FHIR backend zeigt eine entsprechende Aufforderung.

Was der Patient sieht

Provenienz ist auch das, was der Patient sieht. Seine Akte zeigt an, wer jeden Eintrag hinzugefügt hat, und seine Verbindungsliste zeigt für jede Anwendung an, wer was zugegriffen hat, namentlich wenn ein Praktiker handelte ("Dr. Ana Popescu · Clinica Cardio Nord hat Ihre Laborergebnisse gelesen"). Siehe Einwilligungs- und Zugriffsmodell.

Regeln, die Provenienz nützlich machen

Setzen Sie immer den Autorentyp. Dies kostet ein Feld und ist die wichtigste Kennzeichnung in einem Datensatz.
Nennen Sie die Person, wenn eine Person etwas geschrieben hat. Verwenden Sie X-Anpheros-Acting-As für klinisches Personal.
Nennen Sie das Quellsystem und übergeben Sie die eigene ID der Quelle als Origin-ID, falls vorhanden.
Korrigieren Sie durch Aktualisierung, niemals durch Löschen und Neuerstellen. Eine Aktualisierung behält die Verknüpfung zwischen dem alten und dem neuen Wert bei.
Kennzeichnen Sie KI-Ausgaben als ai, einschließlich Werte, die ein Modell aus einem Dokument extrahiert hat. Werte, die aus einem Dokument abgeleitet wurden, können auch mit derived_from darauf zurückverweisen.

Häufig gestellte Fragen

Was ist Datenherkunft (Data Provenance) im Gesundheitswesen?

Der dokumentierte Ursprung und die Historie eines Gesundheitsdatums: wer es erstellt oder geändert hat, in wessen Auftrag, aus welchem System und wann. In HL7 FHIR wird dies durch die Provenance Ressource dargestellt, die auf die exakte Version der Ressource verweist, die sie beschreibt.

Ist Provenance dasselbe wie ein Audit-Log?

Nein. Provenance beschreibt die Daten: wer jede Version geschrieben hat. Ein Audit-Log beschreibt den Zugriff: wer was wann unter welcher Zustimmung gelesen oder geschrieben hat. Anpheros behält beides; der Patient sieht das Zugriffslog für jede Anwendung, die mit seiner Akte verbunden ist.

Kann ich meine eigenen Provenance-Ressourcen schreiben?

Anpheros schreibt eine für jedes Create, Update und Delete, sodass Sie dies normalerweise nicht tun müssen. Verwenden Sie die oben genannten Header, um es präzise zu gestalten. Eine vom Client bereitgestellte Provenance muss auf Ressourcen eines einzelnen Patienten abzielen.