Attestation Function Extension¶
| Canonical | https://fhir.apps.health/StructureDefinition/nexus-attestation-function |
|---|---|
| Status | draft · 1.33.0 |
| Base | Extension (constraint) |
| Context | Composition.attester (element) |
| Source | FSH · JSON |
What kind of attestation this Composition.attester is: the author's own signature, a supervisor's
sign-off on a learner's note, or a peer's co-signature. R4's attester.mode cannot say: both a
sign-off and a co-signature are professional.
Overview
Codes are HL7's. LA (legal authenticator) is the author signing their own note; VRF
(verifier) is a supervisor signing off a learner's note; AUTHEN (authenticator) is a peer
co-signing at the author's request. A display reads from the code, never from mode: VRF reads
"Signed off by", AUTHEN "Co-signed by".
Every attester other than the author's legal signature carries it, so a sign-off and a
co-signature can never be confused. Each sign-off is its own attester: party is the supervisor,
time is when they signed off, and a note can carry several over time. A sign-off also names the
version it approved, in nexus-attested-version.
Adding one changes nothing else on the note.
How these codes are used here, against their v3 definitions. In v3 ParticipationType, LA and
AUTHEN are both specializations of VRF, and v3 tells them apart by signing privilege: AUTHEN is a
signer without privileges to legally authenticate (v3's example is a resident signing their own
note) and LA is one with them. This guide uses the three as distinct functions instead: LA is the
author's own signature, VRF a supervisor's sign-off, AUTHEN a peer's co-signature, and a learner
who signs their own note is LA here. Two consequences for a reader: do not test for a sign-off by
subsumption under VRF, which would match every signature -- match the code exactly; and when mapping
to CDA, the LA attester is the legalAuthenticator and the others are authenticators, whatever
v3's examples suggest.
An attestation is not a review. An attester takes professional responsibility for the note under
their own name. A clinician who has only received and read something is a reviewer, recorded with
nexus-emr-reviewed, and is not an attester. See
Review and attestation.
Terminology bindings
| Path | Strength | Value set |
|---|---|---|
Extension.value[x] |
extensible | Attestation Function |