Skip to content

Attestation Function Extension

Canonicalhttps://fhir.apps.health/StructureDefinition/nexus-attestation-function
Statusdraft · 1.33.0
BaseExtension (constraint)
ContextComposition.attester (element)
SourceFSH · 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