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.

FSH

The authored source of truth: extensions/AttestationFunction.fsh (edit on GitHub). One FSH file may define several related artifacts.

// AttestationFunction.fsh
// What kind of attestation a Composition.attester is. R4 binds attester.mode to four required
// codes (personal | professional | legal | official), so a supervisor's sign-off and a peer's
// co-signature would both be `professional` and could not be told apart. This carries the
// distinction, with codes HL7 already publishes (v3 ParticipationType); no code system is minted.
// R5 made attester.mode a CodeableConcept with a preferred binding, where these codes can move into
// `mode` itself.

Extension: NexusAttestationFunction
Id: nexus-attestation-function
Title: "Attestation Function"
Description: """
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`.

**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`](StructureDefinition-nexus-attested-version.md).
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 `authenticator`s, 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`](StructureDefinition-nexus-emr-reviewed.md), and is not an attester. See
[Review and attestation](../guide/patterns/review-and-attestation.md).
"""
* ^url = "https://fhir.apps.health/StructureDefinition/nexus-attestation-function"
* ^status = #draft
* ^experimental = false
* ^publisher = "WELLSTAR Technologies Corp."
* ^context[0].type = #element
* ^context[0].expression = "Composition.attester"
* . ^short = "What kind of attestation this is: LA | VRF | AUTHEN"
* value[x] 1..1
* value[x] only Coding
* valueCoding from NexusAttestationFunctionVS (extensible)

ValueSet: NexusAttestationFunctionVS
Id: nexus-attestation-function
Title: "Attestation Function"
Description: "The kinds of attestation a Composition.attester can be, from HL7 v3 ParticipationType: the author's legal signature, a supervisor's sign-off (verifier), and a peer's co-signature (authenticator)."
* ^url = "https://fhir.apps.health/ValueSet/nexus-attestation-function"
* ^status = #draft
* ^experimental = false
* http://terminology.hl7.org/CodeSystem/v3-ParticipationType#LA "legal authenticator"
* http://terminology.hl7.org/CodeSystem/v3-ParticipationType#VRF "verifier"
* http://terminology.hl7.org/CodeSystem/v3-ParticipationType#AUTHEN "authenticator"