Vital Records Death Reporting (VRDR) FHIR Implementation Guide
2.1.0 - STU 2 United States of America flag

This page is part of the Vital Records Death Reporting FHIR Implementation Guide (v2.1.0: STU 2) based on FHIR (HL7® FHIR® Standard) R4. The current version which supersedes this version is 3.0.0. For a full list of available versions, see the Directory of published versions

Resource Profile: DeathCertificate - Mappings

Active as of 2023-03-24

Mappings for the vrdr-death-certificate resource profile.

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

DeathCertificate
CompositionEvent
   identifierEvent.identifier
   statusEvent.status
   typeEvent.code
   categoryEvent.subject
   encounterEvent.context
   dateEvent.occurrence[x]
   authorEvent.performer

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

DeathCertificate
CompositionEntity. Role, or Act, Document[classCode="DOC" and moodCode="EVN" and isNormalAct()]
   textAct.text?
   containedN/A
   extension (filingFormat)n/a, N/A
   extension (replaceStatus)n/a, N/A
   extension (stateSpecificField)n/a, N/A
   modifierExtensionN/A
   identifierDocument.id / Document.setId
   statusinterim: .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"]
   encounterunique(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"]
      idn/a
      extensionn/a
      modifierExtensionN/A
      modeunique(./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
      idn/a
      extensionn/a
      modifierExtensionN/A
      code.outboundRelationship.typeCode
      target[x].target[classCode="DOC", moodCode="EVN"].id
   eventoutboundRelationship[typeCode="SUBJ"].target[classCode<'ACT']
      idn/a
      extensionn/a
      modifierExtensionN/A
      code.code
      period.effectiveTime
      detail.outboundRelationship[typeCode="SUBJ"].target
   section./outboundRelationship[typeCode="COMP" and isNormalActRelationship()]/target[moodCode="EVN" and classCode="DOCSECT" and isNormalAct]
      idn/a
      extensionn/a
      modifierExtensionN/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]
      idn/a
      extensionn/a
      modifierExtensionN/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 (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]
      idn/a
      extensionn/a
      modifierExtensionN/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 (PlaceOfInjury).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]
      idn/a
      extensionn/a
      modifierExtensionN/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]
      idn/a
      extensionn/a
      modifierExtensionN/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]
      idn/a
      extensionn/a
      modifierExtensionN/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
CompositionClinicalDocument
   identifier.setId
   statusn/a
   type.code
   categoryn/a
   subject.recordTarget
   encounter.componentOf.encompassingEncounter
   date.effectiveTime
   author.author.assignedAuthor
   title.title
   confidentiality.confidentialityCode
   attester.authenticator/.legalAuthenticator
      modeimplied 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
      detailn/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
      moden/a
      orderedByn/a
      entry.entry
      emptyReasonn/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
      moden/a
      orderedByn/a
      entry.entry
      entry (Decedent).entry
      entry (Father).entry
      entry (Mother).entry
      entry (Spouse).entry
      entry (Age).entry
      entry (BirthRecordID).entry
      entry (EducationLevel).entry
      entry (MilitaryService).entry
      entry (UsualWork).entry
      entry (EmergingIssues).entry
      entry (InputRaceAndEthnicity).entry
      emptyReasonn/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
      moden/a
      orderedByn/a
      entry.entry
      entry (ExaminerContacted).entry
      entry (PregnancyStatus).entry
      entry (TobaccoUse).entry
      entry (DeathLocation).entry
      entry (InjuryLocation).entry
      entry (PlaceOfInjury).entry
      entry (InjuryIncident).entry
      entry (Autopsy).entry
      entry (DeathDate).entry
      entry (SurgeryDate).entry
      emptyReasonn/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
      moden/a
      orderedByn/a
      entry.entry
      entry (Certifier).entry
      entry (DeathCertification).entry
      entry (MannerOfDeath).entry
      entry (CauseOfDeathPart1).entry
      entry (CauseOfDeathPart2).entry
      emptyReasonn/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
      moden/a
      orderedByn/a
      entry.entry
      entry (DispositionLocation).entry
      entry (FuneralHome).entry
      entry (DispositionMethod).entry
      entry (Mortician).entry
      emptyReasonn/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
      moden/a
      orderedByn/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
      emptyReasonn/a
      section.component.section

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

DeathCertificate
Compositionwhen described by DocumentReference
   identifierDocumentReference.masterIdentifier
   statusDocumentReference.status
   typeDocumentReference.type
   categoryDocumenttReference.category
   subjectDocumentReference.subject
   encounterDocumentReference.context.encounter
   dateDocumentReference.content.attachment.date, DocumentReference.created
   authorDocumentReference.agent
   titleDocumentReference.description, DocumentReference.content.attachment.title
   confidentialityDocumentReference.securityLabel
   attesterDocumentReference.authenticator
   custodianDocumentReference.custodian
   relatesToDocumentReference.relatesTo
      codeDocumentReference.relatesTo.code
      target[x]DocumentReference.relatesTo.target
   eventDocumentReference.event
      codeDocumentReference.event.code
      periodDocumentReference.event.period

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

DeathCertificate
Composition
   identifierFiveWs.identifier
   statusFiveWs.status
   typeFiveWs.class
   categoryFiveWs.class
   subjectFiveWs.subject[x], FiveWs.subject
   encounterFiveWs.context
   dateFiveWs.done[x]
   authorFiveWs.author
   attester
      partyFiveWs.witness
   section
      authorFiveWs.author
      modeFiveWs.class
   section (DecedentDemographics)
      authorFiveWs.author
      modeFiveWs.class
   section (DeathInvestigation)
      authorFiveWs.author
      modeFiveWs.class
   section (DeathCertification)
      authorFiveWs.author
      modeFiveWs.class
   section (DecedentDisposition)
      authorFiveWs.author
      modeFiveWs.class
   section (CodedContent)
      authorFiveWs.author
      modeFiveWs.class