Vital Records Death Reporting (VRDR) FHIR Implementation Guide
0.0.0-current - ci-build
Vital Records Death Reporting (VRDR) FHIR Implementation Guide, published by IHE Quality, Research and Public Health Technical Committee. This guide is not an authorized publication; it is the continuous build for version 0.0.0-current 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
The ALIAS and VOID IJE fields are used to direct an action be performed on a death record. These actions are now specified through message types in the accompanying Vital Records Messaging Implementation Guide message descriptions for Alias and Void. Sending a replacement death record is also specified through the Replace message type, but the status of the replacement is mapped to the VRDR IG (see DeathCertificate).
Several date/time fields (Date of Death, Date of Surgery, Date of Birth, and Date of Injury) in the IG allow components of the field to be unknown. The FHIR date and datetime fields provide the ability to leave the less significant components unspecified (e.g., 2018, 1973-06, or 1905-08-23 are valid dates). In addition to the built-in FHIR method for specifying partial dates, this IG provides extensions (PartialDate and PartialDateTime) that allow the components to be specified independently. When using these extensions, a value must be specified for each component (e.g., year, month, day), or a missing value code specified. This allows dates where any component is missing to be specified. Creators of conformant content are free to choose to always use the Partial date and datetime extensions to represent their dates and times.
A value of unknown (all 9’s) in IJE is equivalent to a null value and a DataAbsentReason extension with the value of “unknown”. See this DeathDate for an example of both unknown integer values – the day of death, “99” in IJE – and unknown time value – the time of death, “9999” in IJE.
A value of blank (all ‘ ‘) in IJE is equivalent to a null value and a DataAbsentReason extension with the value of “temp-unknown”.
FHIR addresses support a string value for city. The death record submission requires a 5 digit coded value, so the IG defines an extension CityCode for this purpose. The code should be selected to match the literal content of the city field. As of the date of publication, these codes should be in accordance with the NCHS Instruction Manual Part 8, Vital Records Geographic Classification, 2014.
FHIR addresses support a string value for county (district). The death record submission requires a 3 digit coded value, so the IG defines an extension DistrictCode for this purpose. The code should be selected to match the literal content of the district field. As of the date of publication, these codes should be in accordance with the NCHS Instruction Manual Part 8, Vital Records Geographic Classification, 2014.
States and jurisdictions are consistently represented using two letter postal codes bound to a string field. The IJE typically represents states using a 2 letter postal code and a separate literal field. Mapping from the 2 letter codes to literals must be provided outside of the VRDR IG, and can leverage the StatesTerritoriesProvincesVS.
Countries are consistently represented using two letter postal codes bound to a string field. The IJE typically represents countries using a 2 letter postal code and a separate literal field. Mapping from the 2 letter codes to literals must be provided outside of the VRDR IG, and can leverage the CountryCS.
Profile conformance requires that either a first, last, or middle name be provided based on US Core requirements. If no name components are available, a data absent reason should be provided for at least one name component in order to conform to the profile requirements.
NCHS submission requires only a last name. Last name is required for NCHS submission. If the decedent’s legal name is unknown, name.family should be reported as ‘UNKNOWN’, or omitted. Placeholder names such as ‘John Doe’ or ‘Jane Doe’ should not be reported.
Profile conformance requires that gender be provided. A value of ‘unknown’ will satisfy this requirement. There is no IJE field that is mapped to the Decedent.gender field.