Vital Records Death Reporting (VRDR) FHIR Implementation Guide
3.0.0 - STU3

Vital Records Death Reporting (VRDR) FHIR Implementation Guide, published by HL7 International / Public Health. This guide is not an authorized publication; it is the continuous build for version 3.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/IHE/QRPH.VRDR/ and changes regularly. See the Directory of published versions

## Resource Profile: DeathCertificate - Mappings

Active as of 2024-10-23

Mappings for the vrdr-death-certificate resource profile.

### Mappings for Workflow Pattern (http://hl7.org/fhir/workflow)

DeathCertificate
Composition | Event
identifier | Event.identifier
status | Event.status
type | Event.code
category | Event.subject
encounter | Event.context
date | Event.occurrence[x]
author | Event.performer

### Mappings for RIM Mapping (http://hl7.org/v3)

DeathCertificate
Composition | Entity. Role, or Act, Document[classCode="DOC" and moodCode="EVN" and isNormalAct()]
text | Act.text?
contained | N/A
modifierExtension | N/A
identifier | Document.id / Document.setId
status | interim: .completionCode="IN" & ./statusCode[isNormalDatatype()]="active"; final: .completionCode="AU" && ./statusCode[isNormalDatatype()]="complete" and not(./inboundRelationship[typeCode="SUBJ" and isNormalActRelationship()]/source[subsumesCode("ActClass#CACT") and moodCode="EVN" and domainMember("ReviseComposition", code) and isNormalAct()]); amended: .completionCode="AU" && ./statusCode[isNormalDatatype()]="complete" and ./inboundRelationship[typeCode="SUBJ" and isNormalActRelationship()]/source[subsumesCode("ActClass#CACT") and moodCode="EVN" and domainMember("ReviseComposition", code) and isNormalAct() and statusCode="completed"]; withdrawn : .completionCode=NI && ./statusCode[isNormalDatatype()]="obsolete"
type | ./code
category | .outboundRelationship[typeCode="COMP].target[classCode="LIST", moodCode="EVN"].code
subject | .participation[typeCode="SBJ"].role[typeCode="PAT"]
encounter | unique(highest(./outboundRelationship[typeCode="SUBJ" and isNormalActRelationship()], priorityNumber)/target[moodCode="EVN" and classCode=("ENC", "PCPR") and isNormalAct])
date | .effectiveTime[type="TS"]
author | .participation[typeCode="AUT"].role[classCode="ASSIGNED"]
title | ./title
confidentiality | .confidentialityCode
attester | .participation[typeCode="AUTHEN"].role[classCode="ASSIGNED"]
id | n/a
extension | n/a
modifierExtension | N/A
mode | unique(./modeCode)
time | ./time[type="TS" and isNormalDatatype()]
party | ./role[classCode="ASSIGNED" and isNormalRole]/player[determinerCode="INST" and classCode=("DEV", "PSN") and isNormalEntity()] or ./role[classCode="ASSIGNED" and isNormalRole and not(player)]/scoper[determinerCode="INST" and classCode="ORG" and isNormalEntity()]
custodian | .participation[typeCode="RCV"].role[classCode="CUST"].scoper[classCode="ORG" and determinerCode="INST"]
relatesTo | .outboundRelationship
id | n/a
extension | n/a
modifierExtension | N/A
code | .outboundRelationship.typeCode
target[x] | .target[classCode="DOC", moodCode="EVN"].id
event | outboundRelationship[typeCode="SUBJ"].target[classCode<'ACT']
id | n/a
extension | n/a
modifierExtension | N/A
code | .code
period | .effectiveTime
detail | .outboundRelationship[typeCode="SUBJ"].target
section | ./outboundRelationship[typeCode="COMP" and isNormalActRelationship()]/target[moodCode="EVN" and classCode="DOCSECT" and isNormalAct]
id | n/a
extension | n/a
modifierExtension | N/A
title | ./title
code | ./code
author | .participation[typeCode="AUT"].role[classCode="ASSIGNED"]
text | .text
mode | .outBoundRelationship[typeCode=COMP].target[classCode=OBS"].value
orderedBy | .outboundRelationship[typeCode=COMP].sequenceNumber > 1
entry | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
emptyReason | .inboundRelationship[typeCode=SUBJ,code<ListEmptyReason].value[type=CD]
section | ./outboundRelationship[typeCode="COMP" and isNormalActRelationship()]/target[moodCode="EVN" and classCode="DOCSECT" and isNormalAct]
section (DecedentDemographics) | ./outboundRelationship[typeCode="COMP" and isNormalActRelationship()]/target[moodCode="EVN" and classCode="DOCSECT" and isNormalAct]
id | n/a
extension | n/a
modifierExtension | N/A
title | ./title
code | ./code
author | .participation[typeCode="AUT"].role[classCode="ASSIGNED"]
text | .text
mode | .outBoundRelationship[typeCode=COMP].target[classCode=OBS"].value
orderedBy | .outboundRelationship[typeCode=COMP].sequenceNumber > 1
entry | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (Decedent) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (Father) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (Mother) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (Spouse) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (Age) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (BirthRecordID) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (FetalDeathRecordID) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (BirthRecordIDChild) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (EducationLevel) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (MilitaryService) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (UsualWork) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (EmergingIssues) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (InputRaceAndEthnicity) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
emptyReason | .inboundRelationship[typeCode=SUBJ,code<ListEmptyReason].value[type=CD]
section | ./outboundRelationship[typeCode="COMP" and isNormalActRelationship()]/target[moodCode="EVN" and classCode="DOCSECT" and isNormalAct]
section (DeathInvestigation) | ./outboundRelationship[typeCode="COMP" and isNormalActRelationship()]/target[moodCode="EVN" and classCode="DOCSECT" and isNormalAct]
id | n/a
extension | n/a
modifierExtension | N/A
title | ./title
code | ./code
author | .participation[typeCode="AUT"].role[classCode="ASSIGNED"]
text | .text
mode | .outBoundRelationship[typeCode=COMP].target[classCode=OBS"].value
orderedBy | .outboundRelationship[typeCode=COMP].sequenceNumber > 1
entry | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (ExaminerContacted) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (PregnancyStatus) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (TobaccoUse) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (DeathLocation) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (InjuryLocation) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (InjuryIncident) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (Autopsy) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (DeathDate) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (SurgeryDate) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
emptyReason | .inboundRelationship[typeCode=SUBJ,code<ListEmptyReason].value[type=CD]
section | ./outboundRelationship[typeCode="COMP" and isNormalActRelationship()]/target[moodCode="EVN" and classCode="DOCSECT" and isNormalAct]
section (DeathCertification) | ./outboundRelationship[typeCode="COMP" and isNormalActRelationship()]/target[moodCode="EVN" and classCode="DOCSECT" and isNormalAct]
id | n/a
extension | n/a
modifierExtension | N/A
title | ./title
code | ./code
author | .participation[typeCode="AUT"].role[classCode="ASSIGNED"]
text | .text
mode | .outBoundRelationship[typeCode=COMP].target[classCode=OBS"].value
orderedBy | .outboundRelationship[typeCode=COMP].sequenceNumber > 1
entry | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (Certifier) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (DeathCertification) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (MannerOfDeath) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (CauseOfDeathPart1) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (CauseOfDeathPart2) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
emptyReason | .inboundRelationship[typeCode=SUBJ,code<ListEmptyReason].value[type=CD]
section | ./outboundRelationship[typeCode="COMP" and isNormalActRelationship()]/target[moodCode="EVN" and classCode="DOCSECT" and isNormalAct]
section (DecedentDisposition) | ./outboundRelationship[typeCode="COMP" and isNormalActRelationship()]/target[moodCode="EVN" and classCode="DOCSECT" and isNormalAct]
id | n/a
extension | n/a
modifierExtension | N/A
title | ./title
code | ./code
author | .participation[typeCode="AUT"].role[classCode="ASSIGNED"]
text | .text
mode | .outBoundRelationship[typeCode=COMP].target[classCode=OBS"].value
orderedBy | .outboundRelationship[typeCode=COMP].sequenceNumber > 1
entry | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (DispositionLocation) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (FuneralHome) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (DispositionMethod) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (Mortician) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
emptyReason | .inboundRelationship[typeCode=SUBJ,code<ListEmptyReason].value[type=CD]
section | ./outboundRelationship[typeCode="COMP" and isNormalActRelationship()]/target[moodCode="EVN" and classCode="DOCSECT" and isNormalAct]
section (CodedContent) | ./outboundRelationship[typeCode="COMP" and isNormalActRelationship()]/target[moodCode="EVN" and classCode="DOCSECT" and isNormalAct]
id | n/a
extension | n/a
modifierExtension | N/A
title | ./title
code | ./code
author | .participation[typeCode="AUT"].role[classCode="ASSIGNED"]
text | .text
mode | .outBoundRelationship[typeCode=COMP].target[classCode=OBS"].value
orderedBy | .outboundRelationship[typeCode=COMP].sequenceNumber > 1
entry | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (ActivityAtTimeOfDeath) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (AutomatedUnderlyingCauseOfDeath) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (ManualUnderlyingCauseOfDeath) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (CodedRaceAndEthnicity) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (EntityAxisCauseOfDeath) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (RecordAxisCauseOfDeath) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (PlaceOfInjury) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
entry (CodingStatusValues) | .outboundRelationship[typeCode=COMP] or .participation[typeCode=SBJ]
emptyReason | .inboundRelationship[typeCode=SUBJ,code<ListEmptyReason].value[type=CD]
section | ./outboundRelationship[typeCode="COMP" and isNormalActRelationship()]/target[moodCode="EVN" and classCode="DOCSECT" and isNormalAct]

### Mappings for CDA (R2) (http://hl7.org/v3/cda)

DeathCertificate
Composition | ClinicalDocument
identifier | .setId
status | n/a
type | .code
category | n/a
subject | .recordTarget
encounter | .componentOf.encompassingEncounter
date | .effectiveTime
author | .author.assignedAuthor
title | .title
confidentiality | .confidentialityCode
attester | .authenticator/.legalAuthenticator
mode | implied by .authenticator/.legalAuthenticator
time | .authenticator.time
party | .authenticator.assignedEnttty
custodian | .custodian.assignedCustodian
relatesTo | .relatedDocument
code | .relatedDocument.typeCode
target[x] | .relatedDocument.id
event | .documentationOf.serviceEvent
code | .code
period | .effectiveTime
detail | n/a
section | .component.structuredBody.component.section
title | .title
code | .code
author | .author.assignedAuthor
focus | .subject? (CDA did not differentiate between subject and focus)
text | .text
mode | n/a
orderedBy | n/a
entry | .entry
emptyReason | n/a
section | .component.section
section (DecedentDemographics) | .component.structuredBody.component.section
title | .title
code | .code
author | .author.assignedAuthor
focus | .subject? (CDA did not differentiate between subject and focus)
text | .text
mode | n/a
orderedBy | n/a
entry | .entry
entry (Decedent) | .entry
entry (Father) | .entry
entry (Mother) | .entry
entry (Spouse) | .entry
entry (Age) | .entry
entry (BirthRecordID) | .entry
entry (FetalDeathRecordID) | .entry
entry (BirthRecordIDChild) | .entry
entry (EducationLevel) | .entry
entry (MilitaryService) | .entry
entry (UsualWork) | .entry
entry (EmergingIssues) | .entry
entry (InputRaceAndEthnicity) | .entry
emptyReason | n/a
section | .component.section
section (DeathInvestigation) | .component.structuredBody.component.section
title | .title
code | .code
author | .author.assignedAuthor
focus | .subject? (CDA did not differentiate between subject and focus)
text | .text
mode | n/a
orderedBy | n/a
entry | .entry
entry (ExaminerContacted) | .entry
entry (PregnancyStatus) | .entry
entry (TobaccoUse) | .entry
entry (DeathLocation) | .entry
entry (InjuryLocation) | .entry
entry (InjuryIncident) | .entry
entry (Autopsy) | .entry
entry (DeathDate) | .entry
entry (SurgeryDate) | .entry
emptyReason | n/a
section | .component.section
section (DeathCertification) | .component.structuredBody.component.section
title | .title
code | .code
author | .author.assignedAuthor
focus | .subject? (CDA did not differentiate between subject and focus)
text | .text
mode | n/a
orderedBy | n/a
entry | .entry
entry (Certifier) | .entry
entry (DeathCertification) | .entry
entry (MannerOfDeath) | .entry
entry (CauseOfDeathPart1) | .entry
entry (CauseOfDeathPart2) | .entry
emptyReason | n/a
section | .component.section
section (DecedentDisposition) | .component.structuredBody.component.section
title | .title
code | .code
author | .author.assignedAuthor
focus | .subject? (CDA did not differentiate between subject and focus)
text | .text
mode | n/a
orderedBy | n/a
entry | .entry
entry (DispositionLocation) | .entry
entry (FuneralHome) | .entry
entry (DispositionMethod) | .entry
entry (Mortician) | .entry
emptyReason | n/a
section | .component.section
section (CodedContent) | .component.structuredBody.component.section
title | .title
code | .code
author | .author.assignedAuthor
focus | .subject? (CDA did not differentiate between subject and focus)
text | .text
mode | n/a
orderedBy | n/a
entry | .entry
entry (ActivityAtTimeOfDeath) | .entry
entry (AutomatedUnderlyingCauseOfDeath) | .entry
entry (ManualUnderlyingCauseOfDeath) | .entry
entry (CodedRaceAndEthnicity) | .entry
entry (EntityAxisCauseOfDeath) | .entry
entry (RecordAxisCauseOfDeath) | .entry
entry (PlaceOfInjury) | .entry
entry (CodingStatusValues) | .entry
emptyReason | n/a
section | .component.section

### Mappings for FHIR DocumentReference (http://hl7.org/fhir/documentreference)

DeathCertificate
Composition | when described by DocumentReference
identifier | DocumentReference.masterIdentifier
status | DocumentReference.status
type | DocumentReference.type
category | DocumenttReference.category
subject | DocumentReference.subject
encounter | DocumentReference.context.encounter
date | DocumentReference.content.attachment.date, DocumentReference.created
author | DocumentReference.agent
title | DocumentReference.description, DocumentReference.content.attachment.title
confidentiality | DocumentReference.securityLabel
attester | DocumentReference.authenticator
custodian | DocumentReference.custodian
relatesTo | DocumentReference.relatesTo
code | DocumentReference.relatesTo.code
target[x] | DocumentReference.relatesTo.target
event | DocumentReference.event
code | DocumentReference.event.code
period | DocumentReference.event.period

### Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

DeathCertificate
Composition |
identifier | FiveWs.identifier
status | FiveWs.status
type | FiveWs.class
category | FiveWs.class
subject | FiveWs.subject[x], FiveWs.subject
encounter | FiveWs.context
date | FiveWs.done[x]
author | FiveWs.author
attester |
party | FiveWs.witness
section |
author | FiveWs.author
mode | FiveWs.class
section (DecedentDemographics) |
author | FiveWs.author
mode | FiveWs.class
section (DeathInvestigation) |
author | FiveWs.author
mode | FiveWs.class
section (DeathCertification) |
author | FiveWs.author
mode | FiveWs.class
section (DecedentDisposition) |
author | FiveWs.author
mode | FiveWs.class
section (CodedContent) |
author | FiveWs.author
mode | FiveWs.class