This page is part of the Vital Records Mortality and Morbidity Reporting FHIR IG (v0.1.0: STU 1 Ballot 1) based on FHIR R3. The current version which supercedes this version is 2.0.0. For a full list of available versions, see the Directory of published versions

Decedent

Decedent is a profile of the US-Core patient resource profile. It is used to convey the demographic information used to establish the identity of the decedent. The profile includes three US Core extensions to the base FHIR STU3 Patient resource ΓÇô birth sex, ethnicity, and race. The VRDR defined Within-City-Limits-Indicator extension to the address datatype is used to convey whether the decedentΓÇÖs home address is within the limits of the city component of home postal address.

A decedent may include a residential address and a birth address. The Within-City-Limits-Indicator extension is intended for use in the residential address only but can be used for either or both. A decedent may have multiple names, an official name and a nickname. A decedent may have any number of identifiers. Each identifier shall include the OID of the identifier assigning authority. This oid is the namespace in which the identifier value is unique. An identifier type code may also be included.

Patient.contact is a backbone element of the decendent profile. It conveys the name, address, and relationship of the informant, the individual functioning as the source of the demographic information about the decedent.


UML Expression


Structure Definition

id 0..1
meta 0..1
race 1..1
race 1..*
valueCode
ethnicity 1..1
ethnicity 1..1
valueCode
birthsex 1..1
birthsex 1..1
valueCode
birthPlace 1..1
birthPlace 0..1
valueAddress
type 1..1 Fixed Value
system 0..1
value 1..1
name1 1..1
name1 0..1
name1 0..*
name2 1..1
name2 0..1
name2 0..*
gender 1..1 codeBinding
birthDate 0..1
address1 1..1
address1 1..1
valueBoolean
address1 0..1 Fixed Value
address1 0..1
address1 1..*
address1 0..1
address1 0..1
address1 0..1
maritalStatus 1..1 CodeableConceptBinding

Element Bindings

Element Name Binding Type Binding Value Fixed Value Code System
birthSex Value Set US-Core-birthsex
contact.Informant.relationship Value Set v2 Contact Role
ethnicity Value Set v3-Ethnicity
gender Value Set Administrative-gender
maritalStatus Value Set Marital-status
race Value Set v3-Race

Element Table

Patient ..
Patient.id 0..1
Patient.meta 0..1
Patient.extension ..
Patient.extension:race 0..1
Patient.extension:race.url:race 1..1
Patient.extension:race.value[x]:race 1..*
Patient.extension:race.valueCode:valueCode ..
Patient.extension:ethnicity 0..1
Patient.extension:ethnicity.url:ethnicity 1..1
Patient.extension:ethnicity.value[x]:ethnicity 1..1
Patient.extension:ethnicity.valueCode:valueCode ..
Patient.extension:birthsex 0..1
Patient.extension:birthsex.url:birthsex 1..1
Patient.extension:birthsex.value[x]:birthsex 1..1
Patient.extension:birthsex.valueCode:valueCode ..
Patient.extension:birthPlace 0..1
Patient.extension:birthPlace.url:birthPlace 1..1
Patient.extension:birthPlace.value[x]:birthPlace 0..1
Patient.extension:birthPlace.valueAddress:valueAddress ..
Patient.identifier 0..1
Patient.identifier.type 1..1
Patient.identifier.system 0..1
Patient.identifier.value 1..1
Patient.name ..
Patient.name:name1 1..1
Patient.name:name1.use:name1 1..1
Patient.name:name1.family:name1 0..1
Patient.name:name1.given:name1 0..*
Patient.name:name2 1..1
Patient.name:name2.use:name2 1..1
Patient.name:name2.family:name2 0..1
Patient.name:name2.given:name2 0..*
Patient.gender code 1..1
Patient.birthDate 0..1
Patient.address ..
Patient.address:address1 0..1
Patient.address:address1.extension:address1 1..1
Patient.address:address1.extension:address1.url:address1 1..1
Patient.address:address1.extension:address1.value[x]:address1 1..1
Patient.address:address1.extension:address1.valueBoolean:valueBoolean ..
Patient.address:address1.use:address1 0..1
Patient.address:address1.type:address1 0..1
Patient.address:address1.line:address1 1..*
Patient.address:address1.city:address1 0..1
Patient.address:address1.state:address1 0..1
Patient.address:address1.postalCode:address1 0..1
Patient.maritalStatus CodeableConcept 1..1


Requirements Traceability Mappings

Element Path Reference Location Data Item
address Vital Records DAM 2.04 Responsible Party address
address Vital Records DAM 3.02 Decedent birthAddress
address Vital Records DAM 3.02 Decedent residentialAddress
address Death Certificate Item 13c Mailing Address [Informant]
address Death Certificate Item 6 Birthplace
address Death Certificate Item 7 Residence Address
address Standard Death Record IG SDR Decedent Profile Patient.address:shr-core-PostalAddress
address Standard Death Record IG SDR Decedent Profile Patient.contact:sdr-decedent-Informant.address
address Standard Death Record IG SDR Decedent Profile Patient.extension:birthplace
birthdate Vital Records DAM 3.02 Decedent birthDate
birthdate Death Certificate Item 5 Date of Birth
birthdate Standard Death Record IG SDR Decedent Profile Patient.birthDate
birthsex Vital Records DAM 3.02 Decedent sex
birthsex Death Certificate Item 2 Sex
birthsex Standard Death Record IG SDR Decedent Profile Patient.extension:sex
ethnicity Vital Records DAM 3.02 Decedent ethnicity
ethnicity Death Certificate Item 52 [is]Decedent of Hispanic Origin?
ethnicity Standard Death Record IG SDR Decedent Profile Patient.extension:ethnicity
gender Vital Records DAM 3.02 Decedent sex
gender Death Certificate Item 2 Sex
gender Standard Death Record IG SDR Decedent Profile Patient.extension:sex
identifier Vital Records DAM 3.02 Decedent socialSecurityNumber
identifier Death Certificate Item 3 Social Security Number
identifier Standard Death Record IG SDR SocialSecurityNumber Profile Patient.identifier:sdr-decedent-DecedentID[Identifier.value]
maritalStatus Vital Records DAM 3.02 Decedent maritalStatus
maritalStatus Death Certificate Item 9 Marital Status at Time of Death
maritalStatus Standard Death Record IG SDR Decedent Profile Patient.extension:maritalstatusatdeath
name Vital Records DAM 2.04 Responsible Party name
name Vital Records DAM 3.02 Decedent name
name Death Certificate Item 1 Decedent's Legal Name
name Death Certificate Item 13a Informant's Name
name Standard Death Record IG SDR Decedent Profile Patient.contact:sdr-decedent-Informant.name
name Standard Death Record IG SDR Decedent Profile Patient.name
race Vital Records DAM 3.02 Decedent raceCode
race Death Certificate Item 53 Decedent's Race
race Standard Death Record IG SDR Decedent Profile Patient.extension:race
relationship Vital Records DAM 2.04 Responsible Party relationshipToSubject
relationship Death Certificate Item 13b Relationship to Decedent
relationship Standard Death Record IG SDR Decedent Profile Patient.contact:sdr-decedent-Informant.relationship

Instance Example

<Patient>
  <id value="example-decedent" />
  <extension url="http://www.hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity">
    <extension url="text">
      <valueString value="Hispanic or Latino" />
    </extension>
    <extension url="ombCategory">
      <valueCoding>
        <system value="urn:oid:2.16.840.1.113883.6.238" />
        <code value="2135-2" />
        <display value="Hispanic or Latino" />
      </valueCoding>
    </extension>
    <extension url="text">
      <valueString value="Puerto Rican" />
    </extension>
    <extension url="detailed">
      <valueCoding>
        <system value="urn:oid:2.16.840.1.113883.6.238" />
        <code value="2180-8" />
        <display value="Puerto Rican" />
      </valueCoding>
    </extension>
  </extension>
  <extension url="http://www.hl7.org/fhir/us/core/StructureDefinition/us-core-race">
    <extension url="text">
      <valueString value="Native Hawaiian or Other Pacific Islander" />
    </extension>
    <extension url="ombCategory">
      <valueCoding>
        <system value="urn:oid:2.16.840.1.113883.6.238" />
        <code value="2076-8" />
        <display value="Native Hawaiian or Other Pacific Islander" />
      </valueCoding>
    </extension>
    <extension url="text">
      <valueString value="Tahitian" />
    </extension>
    <extension url="detailed">
      <valueCoding>
        <system value="urn:oid:2.16.840.1.113883.6.238" />
        <code value="2081-8" />
        <display value="Tahitian" />
      </valueCoding>
    </extension>
  </extension>
  <extension url="http://www.hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex">
    <valueCodeableConcept>
      <coding>
        <system value="http://www.hl7.org/fhir/us/core/ValueSet/us-core-birthsex" />
        <code value="M" />
        <display value="Male" />
      </coding>
    </valueCodeableConcept>
  </extension>
  <extension url="http://www.hl7.org/fhir/StructureDefinition/birthPlace">
    <valueAddress>
      <type value="postal" />
      <line value="42 Example Street" />
      <city value="Boston" />
      <district value="Suffolk" />
      <state value="Massachusetts" />
      <postalCode value="02101" />
      <country value="United States" />
    </valueAddress>
  </extension>
  <identifier>
    <type>
      <coding>
        <code value="BR" />
        <display value="Social Beneficiary Identifier" />
      </coding>
    </type>
    <system value="urn:oid:2.16.840.1.113883.4.1" />
    <value value="123-45-6789" />
  </identifier>
  <name>
    <use value="official" />
    <family value="Smith" />
    <given value="Robert" />
    <given value="John" />
    <suffix value="Jr." />
  </name>
  <name>
    <use value="nickname" />
    <text value="Bobby" />
  </name>
  <gender value="male" />
  <birthDate value="1974-12-31" />
  <deceasedDateTime value="2017-12-31" />
  <address>
    <extension url="http://www.hl7.org/fhir/us/vrdr/StructureDefinition/Within-City-Limits-Indicator">
      <valueBoolean value="true" />
    </extension>
    <use value="home" />
    <line value="9 Example Street" />
    <city value="Bedford" />
    <district value="Middlesex" />
    <state value="Massachusetts" />
    <postalCode value="01730" />
    <country value="United States" />
  </address>
  <maritalStatus>
    <coding>
      <system value="http://www.hl7.org/fhir/ValueSet/marital-status" />
      <code value="S" />
      <display value="Never Married" />
    </coding>
  </maritalStatus>
</Patient>