Skip to content

Provenance Profile

Canonicalhttps://fhir.apps.health/StructureDefinition/nexus-emr-core-provenance
Statusdraft · 1.33.0
BaseProvenance (constraint)
SourceFSH · JSON

Attribution for AI-mediated writes, cross-boundary writes and record-lifecycle events such as linking an arriving result to a chart or entering a resource into the record: what was produced, when, by which agent (human or non-human), from what inputs, and -- for generated text -- which verbatim source passage each statement rests on. Used standalone against a produced resource, and contained in an AI-suggestion review Task against the suggestion contained alongside it.

Examples

AI-Drafted Note Accepted by a Clinician · AI-Generated Summary With Per-Fact Citations · Import Provenance for a Migration File · Prov lab link automatic inr 20250402 · Prov lab link confirmed cbc 20250408 · Prov lab link manual us 20260312 · Prov lab unlink manual cbc 20250409

Prov lab link automatic inr 20250402

Provenance/prov-lab-link-automatic-inr-20250402 — claims conformance to Provenance Profile

{
  "resourceType": "Provenance",
  "id": "prov-lab-link-automatic-inr-20250402",
  "meta": {
    "profile": [
      "https://fhir.apps.health/StructureDefinition/nexus-emr-core-provenance"
    ]
  },
  "text": {
    "status": "generated",
    "div": "<div xmlns='http://www.w3.org/1999/xhtml'><p>Provenance for a lab result linked to a chart automatically: the lab inbound matcher attached an uploaded INR result to Avery Linwood's chart on health card number, with no human decision.</p><p>The activity carries two codings: the ISO 21089 event <code>link</code> (what happened) and the link method <code>automatic</code> (how). The matcher is named as the author under NamingSystem/nexus-automation, and the person who uploaded the file is named as the enterer. meta.source carries the matcher version, so every link a given version made can be found.</p></div>"
  },
  "target": [
    {
      "reference": "DiagnosticReport/inr-diagnosticreport-20250402/_history/1",
      "display": "INR, 2025-04-02"
    }
  ],
  "occurredDateTime": "2025-04-02T10:07:00-06:00",
  "recorded": "2025-04-02T10:07:03-06:00",
  "activity": {
    "extension": [
      {
        "url": "https://fhir.apps.health/StructureDefinition/nexus-link-method",
        "valueCoding": {
          "system": "https://fhir.apps.health/CodeSystem/nexus-link-method",
          "code": "automatic",
          "display": "Linked automatically"
        }
      }
    ],
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/iso-21089-lifecycle",
        "code": "link",
        "display": "Link Record Lifecycle Event"
      }
    ],
    "text": "Matched to the chart on health card number"
  },
  "agent": [
    {
      "type": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
            "code": "author",
            "display": "Author"
          }
        ],
        "text": "Matching service"
      },
      "who": {
        "type": "Device",
        "identifier": {
          "system": "https://fhir.apps.health/NamingSystem/nexus-automation",
          "value": "lab-inbound-matcher"
        },
        "display": "Lab inbound matcher"
      }
    },
    {
      "type": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
            "code": "enterer",
            "display": "Enterer"
          }
        ],
        "text": "Uploaded the lab file"
      },
      "who": {
        "reference": "Practitioner/adaeze-okonkwo-rn",
        "display": "Adaeze Okonkwo, RN"
      }
    }
  ],
  "entity": [
    {
      "role": "source",
      "what": {
        "reference": "DocumentReference/lab-upload-inr-20250402",
        "display": "Uploaded lab file"
      }
    }
  ]
}