XIG: ConceptMap/direct-alerts

FHIR IG Statistics: ConceptMap/direct-alerts

Package	hl7.fhir.us.davinci-alerts
Resource Type	ConceptMap
Id	direct-alerts
FHIR Version	R4
Source	http://hl7.org/fhir/us/davinci-alerts/https://build.fhir.org/ig/HL7/davinci-alerts/ConceptMap-direct-alerts.html
URL	http://hl7.org/fhir/us/davinci-alerts/ConceptMap/direct-alerts
Version	1.1.0
Status	active
Date	2024-10-29
Name	DirectAlerts
Title	Direct ADT to Da Vinci Alerts ConceptMap
Realm	us
Authority	hl7
Description	Since May 1, 2021 CMS requires that hospitals send notifications electronically for admit, transfer and discharge events to the patient's care team members, for which most implementations currently use V2 ADT messages. As a result DirectTrust, a consensus body of forty organizations and individuals representing the care continuum, collaborated in creating an Implementation Guide using Direct Secure Messaging for both senders and receivers. The Event Notifications via the Direct Standard® defines the necessary data element to cover the CMS rules, maps those to the V2 elements in several ADT message structures and provides the value sets for coded elements. These V2 elements have been mapped them to their respective location in this DaVinci FHIR IG for the Admit-Transfer-Discharge Use case. In addition, the value set concepts between the two product families have been mapped, where possible. This ConceptMap summarizes the Direct ADT message to the Da Vinci Notification Terminology Mappings. Complete mappings can be downloaded as an excel file at https://hl7.org/fhir/us/davinci-alerts/tables/DirectToDaVinciMap.xlsx.
Copyright	1. This material contains content from LOINC (http://loinc.org). LOINC is copyright \\xA9 1995-2020, Regenstrief Institute, Inc. and the Logical Observation # Identifiers Names and Codes (LOINC) Committee and is available at no cost under the license at http://loinc.org/license. LOINC\\xAE is a registered United States trademark of Regenstrief Institute, Inc. 2. This value set includes content from SNOMED CT, which is copyright © 2002+ International Health Terminology Standards Development Organisation (IHTSDO), and distributed by agreement between IHTSDO and HL7. Implementer use of SNOMED CT is not covered by this agreement.

Resources that use this resource

No resources found

Resources that this resource uses

CodeSystem
loinc.org	LOINC Code System
sct	SNOMED CT (all versions)
diagnosis-role	Diagnosis Role
v2-0001	administrativeSex
v2-0004	patientClass
v2-0007	admissionType
v2-0052	diagnosisType
v2-0063	relationship
v2-0200	nameType2
v2-0201	telecommunicationUse
v2-0443	providerRole
v3-ActCode	ActCode
v3-ParticipationType	ParticipationType
v3-RoleCode	RoleCode
administrative-gender	Administrative Gender
notification-event	Da Vinci Event CodeSystem Notification

Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: ConceptMap direct-alerts

Mapping from (not specified) to (not specified)

Group 1 Mapping from Logical Observation Identifiers, Names and Codes (LOINC) to Da Vinci Event CodeSystem Notification

Source Code

Relationship

Target Code

Comment

86530-3 (Visit notification)

is equivalent to

notification-referral (Referral Notification)

86532-9 (Admission notification)

is equivalent to

notification-admit (Admit Notification)

Alerts terminology doesn't distinguish types of sevice locations

98141-5 (Emergency department Admission notification)

is equivalent to

notification-admit (Admit Notification)

79429-7 (Hospital Admission notification)

is equivalent to

notification-admit (Admit Notification)

Alerts terminology doesn't distinguish between in and out patients

79430-5 (Hospital Discharge notification)

(not mapped)

80110-0 (Emergency department Visit notification)

(not mapped)

98143-1 (Emergency department Arrival notification)

(not mapped)

86532-9 (Admission notification)

(not mapped)

98144-9 (Emergency department Departure notification)

(not mapped)

86531-1 (Discharge notification)

is equivalent to

notification-discharge (Discharge Notification)

98142-3 (Emergency department Discharge notification)

(not mapped)

98145-6 (Outpatient Visit notification)

is equivalent to

notification-outpatient-visit (Outpatient Visit Notification)

Group 2 Mapping from patientClass to ActCode

Source Code

Relationship

Target Code

Comment

E (Emergency)

is equivalent to

EMER (emergency)

I (Inpatient)

is equivalent to

IMP (inpatient encounter)

O (Outpatient)

is equivalent to

AMB (ambulatory)

P (Preadmit)

is equivalent to

PRENC (pre-admission)

R (Recurring patient)

(not mapped)

B (Obstetrics)

(not mapped)

C (Commercial Account)

(not mapped)

N (Not Applicable)

(not mapped)

U (Unknown)

(not mapped)

I (Inpatient)

is equivalent to

ACUTE (inpatient acute)

If this is needed in Direct Trust, can consider expanding the value set

I (Inpatient)

is equivalent to

NONAC (inpatient non-acute)

If this is needed in Direct Trust, can consider expanding the value set

Group 3 Mapping from unspecified code system to ActCode

Source Code

Relationship

Target Code

Comment

S (Short Stay)

is equivalent to

SS (short stay)

S is an extension to the base PV1-2 patientClass value set in V2

V (Observation)

is equivalent to

OBSENC (observation encounter)

V is an extension to the base PV1-2 patientClass value set in V2

Group 4 Mapping from providerRole to ParticipationType

Source Code

Relationship

Target Code

Comment

AD (Admitting)

is equivalent to

ADM (admitter)

Also in PV1-17 Admitting Doctor in v2

AT (Attending)

is equivalent to

ATND (attender)

Also in PV1-7 Attending Doctor in v2

CP (Consulting Provider)

is equivalent to

CON (consultant)

Also in PV1-9 Consulting Doctor

FHCP (Family Health Care Professional)

(not mapped)

PP (Primary Care Provider)

(not mapped)

RP (Referring Provider)

is equivalent to

REF (referrer)

Also in PV1-8 Referring doctor in v2

RT (Referred to Provider)

is equivalent to

REFT (Referred to)

Group 5 Mapping from unspecified code system to ParticipationType

Source Code

Relationship

Target Code

Comment

TF (Treating Facility)

is equivalent to

LOC (location)

TF is an extension to the base ROL-3 providerRole value set in V2

Group 6 Mapping from administrativeSex to AdministrativeGender

Source Code

Relationship

Target Code

Comment

F (Female)

is equivalent to

female

M (Male)

is equivalent to

male

O (Other)

is equivalent to

other

U (Unknown)

is equivalent to

unknown

A (Ambiguous)

is equivalent to

other

Since the binding in USCorePatient is required, will have to map to "other"

N (Not Applicable)

is equivalent to

other

Since the binding in USCorePatient is required, will have to map to "other"

X (Non-Binary)

is equivalent to

other

Since the binding in USCorePatient is required, will have to map to "other"

Group 7 Mapping from nameType2 to NameUse

Source Code

Relationship

Target Code

N (Nickname)

is equivalent to

nickname

D (Customary Name)

is equivalent to

usual

L (Official Registry Name)

is equivalent to

official

TEMP (Temporary Name)

is equivalent to

temp

S (Pseudonym)

is equivalent to

anonymous

BAD (Bad Name)

is equivalent to

old

M (Maiden Name)

is equivalent to

maiden (Name changed for Marriage)

O (Other)

(not mapped)

A (Assigned)

(not mapped)

B (Birth name)

is equivalent to

maiden (Name changed for Marriage)

C (Adopted Name)

is equivalent to

official

F (Fathers Name)

(not mapped)

I (Licensing Name)

(not mapped)

K (Business name)

(not mapped)

MSK (Masked)

is equivalent to

anonymous

NAV (Temporarily Unavailable)

(not mapped)

NB (Newborn Name)

(not mapped)

NOUSE (No Longer To Be Used)

is equivalent to

old

P (Name of Partner/Spouse)

(not mapped)

R (Registered Name)

(not mapped)

REL (Religious)

(not mapped)

T (Indigenous/Tribal)

is equivalent to

official

U (Unknown)

(not mapped)

Group 8 Mapping from admissionType to SNOMED CT (all versions)

Source Code

Relationship

Target Code

A (Accident)

(not mapped)

E (Emergency)

is equivalent to

4525004 (Emergency department patient visit)

L (Labor and Delivery)

(not mapped)

R (Routine)

is equivalent to

308335008 (Patient encounter procedure)

N (Newborn (Birth in healthcare facility))

(not mapped)

U (Urgent)

(not mapped)

C (Elective)

(not mapped)

Group 9 Mapping from diagnosisType to Diagnosis Role

Source Code

Relationship

Target Code

A (Admitting)

is equivalent to

AD (Admission diagnosis)

W (Working)

(not mapped)

F (Final)

is equivalent to

DD (Discharge diagnosis)

Group 10 Mapping from relationship to RoleCode

Source Code

Relationship

Target Code

Comment

MTH (Mother)

is equivalent to

MTH (Mother)

This is described specifically for the maternal health use case

Group 11 Mapping from telecommunicationUse to ContactPointUse

Source Code

Relationship

Target Code

Comment

PRN (Primary Residence Number)

is equivalent to

home

FHIR doesn't distinguish types of homes for contacts

ORN (Other Residence Number)

is equivalent to

home

FHIR doesn't distinguish types of homes for contacts

WPN (Work Number)

is equivalent to

work

VHN (Vacation Home Number)

is equivalent to

home

FHIR doesn't distinguish types of homes for contacts

ASN (Answering Service Number)

(not mapped)

EMR (Emergency Number)

(not mapped)

PRS (Personal)

(not mapped)

Group 12 Mapping from telecommunicationUse to ContactPointSystem

Source Code

Relationship

Target Code

Comment

NET (Network (email) Address)

is equivalent to

would need to map to different datatype element and use different value set

BPN (Beeper Number)

is equivalent to

pager

would need to map to different datatype element and use different value set

Group 13 Mapping from telecommunicationUse to unspecified code system

Source Code

Relationship

Target Code

DSM (Direct Secure Messaging)

(not mapped)

Source

{
  "resourceType": "ConceptMap",
  "id": "direct-alerts",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "inm"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 2,
      "_valueInteger": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/us/davinci-alerts/ImplementationGuide/hl7.fhir.us.davinci-alerts"
          }
        ]
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode": "trial-use",
      "_valueCode": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/us/davinci-alerts/ImplementationGuide/hl7.fhir.us.davinci-alerts"
          }
        ]
      }
    }
  ],
  "url": "http://hl7.org/fhir/us/davinci-alerts/ConceptMap/direct-alerts",
  "identifier": {
    "system": "urn:ietf:rfc:3986",
    "value": "urn:oid:2.16.840.1.113883.4.642.40.47.18.1"
  },
  "version": "1.1.0",
  "name": "DirectAlerts",
  "title": "Direct ADT to Da Vinci Alerts ConceptMap",
  "status": "active",
  "experimental": false,
  "date": "2024-10-29",
  "publisher": "HL7 International / Infrastructure And Messaging",
  "contact": [
    {
      "name": "HL7 International / Infrastructure And Messaging",
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/inm"
        },
        {
          "system": "email",
          "value": "inm@lists.hl7.org"
        }
      ]
    }
  ],
  "description": "Since May 1, 2021 CMS requires that hospitals send notifications electronically for admit, transfer and discharge events to the patient's care team members, for which most implementations currently use V2 ADT messages. As a result DirectTrust, a consensus body of forty organizations and individuals representing the care continuum, collaborated in creating an Implementation Guide using Direct Secure Messaging for both senders and receivers. The Event Notifications via the Direct Standard® defines the necessary data element to cover the CMS rules, maps those to the V2 elements in several ADT message structures and provides the value sets for coded elements.\n\nThese V2 elements have been mapped them to their respective location in this DaVinci FHIR IG for the Admit-Transfer-Discharge Use case. In addition, the value set concepts between the two product families have been mapped, where possible.\n\nThis ConceptMap summarizes the Direct ADT message to the Da Vinci Notification Terminology Mappings. Complete mappings can be downloaded as an excel file at https://hl7.org/fhir/us/davinci-alerts/tables/DirectToDaVinciMap.xlsx.\n",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "urn:iso:std:iso:3166",
          "code": "US"
        }
      ]
    }
  ],
  "copyright": "\n1. This material contains content from LOINC (http://loinc.org). LOINC is copyright \\\\xA9 1995-2020, Regenstrief Institute, Inc. and the Logical Observation # Identifiers Names and Codes (LOINC) Committee and is available at no cost under the license at http://loinc.org/license. LOINC\\\\xAE is a registered United States trademark of Regenstrief Institute, Inc.\n2. This value set includes content from SNOMED CT, which is copyright © 2002+ International Health Terminology Standards Development Organisation (IHTSDO), and distributed by agreement between IHTSDO and HL7. Implementer use of SNOMED CT is not covered by this agreement.",
  "group": [
    {
      "source": "http://loinc.org",
      "target": "http://hl7.org/fhir/us/davinci-alerts/CodeSystem/notification-event",
      "element": [
        {
          "code": "86530-3",
          "display": "Visit notification",
          "target": [
            {
              "code": "notification-referral",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "86532-9",
          "display": "Admission notification",
          "target": [
            {
              "code": "notification-admit",
              "equivalence": "equivalent",
              "comment": "Alerts terminology doesn't distinguish types of sevice locations"
            }
          ]
        },
        {
          "code": "98141-5",
          "display": "Emergency department Admission notification",
          "target": [
            {
              "code": "notification-admit",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "79429-7",
          "display": "Hospital Admission notification",
          "target": [
            {
              "code": "notification-admit",
              "equivalence": "equivalent",
              "comment": "Alerts terminology doesn't distinguish between in and out patients"
            }
          ]
        },
        {
          "code": "79430-5",
          "display": "Hospital Discharge notification",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "In DaVinci the notifications are not indicating the current treatment facility type/location, but rather the discharge to location - can expand the valueset, since binding is extensible"
            }
          ]
        },
        {
          "code": "80110-0",
          "display": "Emergency department Visit notification",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "In DaVinci the notifications are not differentiating between visit and admit for ER - can expand the valueset, since binding is extensible"
            }
          ]
        },
        {
          "code": "98143-1",
          "display": "Emergency department Arrival notification",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "In DaVinci the notifications are not differentiating between arrival and admit for ER - can expand the valueset, since binding is extensible"
            }
          ]
        },
        {
          "code": "86532-9",
          "display": "Admission notification",
          "target": [
            {
              "equivalence": "unmatched"
            }
          ]
        },
        {
          "code": "98144-9",
          "display": "Emergency department Departure notification",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "In DaVinci the notifications are not differentiating between departure and discharge for ER - can expand the valueset, since binding is extensible"
            }
          ]
        },
        {
          "code": "86531-1",
          "display": "Discharge notification",
          "target": [
            {
              "code": "notification-discharge",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "98142-3",
          "display": "Emergency department Discharge notification",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "In DaVinci the notifications are not indicating the current treatment facility type/location, but rather the discharge to location - can expand the valueset, since binding is extensible"
            }
          ]
        },
        {
          "code": "98145-6",
          "display": "Outpatient Visit notification",
          "target": [
            {
              "code": "notification-outpatient-visit",
              "equivalence": "equivalent"
            }
          ]
        }
      ]
    },
    {
      "source": "http://terminology.hl7.org/CodeSystem/v2-0004",
      "target": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
      "element": [
        {
          "code": "E",
          "display": "Emergency",
          "target": [
            {
              "code": "EMER",
              "display": "emergency",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "I",
          "display": "Inpatient",
          "target": [
            {
              "code": "IMP",
              "display": "inpatient encounter",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "O",
          "display": "Outpatient",
          "target": [
            {
              "code": "AMB",
              "display": "ambulatory",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "P",
          "display": "Preadmit",
          "target": [
            {
              "code": "PRENC",
              "display": "pre-admission",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "R",
          "display": "Recurring patient",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Since binding is extensible, can extend valueset definition to include CHR : Chronic from https://hl7.org/fhir/R4/v3/ActCode/cs.html#v3-ActCode-_ActMedicalServiceCode"
            }
          ]
        },
        {
          "code": "B",
          "display": "Obstetrics",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Since binding is extensible, can extend valueset definition to include OBS : Obstetrics from https://hl7.org/fhir/R4/v3/ActCode/cs.html#v3-ActCode-_ActMedicalServiceCode"
            }
          ]
        },
        {
          "code": "C",
          "display": "Commercial Account",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Need more information to know how this is used in ADT to find the proper translation"
            }
          ]
        },
        {
          "code": "N",
          "display": "Not Applicable",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Since binding is extensible, can extend valueset definition to include NA : not applicable from https://terminology.hl7.org/CodeSystem-v3-NullFlavor.html"
            }
          ]
        },
        {
          "code": "U",
          "display": "Unknown",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Since binding is extensible, can extend valueset definition to include UNK : unknown from https://terminology.hl7.org/CodeSystem-v3-NullFlavor.html"
            }
          ]
        },
        {
          "code": "I",
          "display": "Inpatient",
          "target": [
            {
              "code": "ACUTE",
              "display": "inpatient acute",
              "equivalence": "equivalent",
              "comment": "If this is needed in Direct Trust, can consider expanding the value set"
            }
          ]
        },
        {
          "code": "I",
          "display": "Inpatient",
          "target": [
            {
              "code": "NONAC",
              "display": "inpatient non-acute",
              "equivalence": "equivalent",
              "comment": "If this is needed in Direct Trust, can consider expanding the value set"
            }
          ]
        }
      ]
    },
    {
      "target": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
      "element": [
        {
          "code": "S",
          "display": "Short Stay",
          "target": [
            {
              "code": "SS",
              "display": "short stay",
              "equivalence": "equivalent",
              "comment": "S is an extension to the base PV1-2 patientClass  value set in V2"
            }
          ]
        },
        {
          "code": "V",
          "display": "Observation",
          "target": [
            {
              "code": "OBSENC",
              "display": "observation encounter",
              "equivalence": "equivalent",
              "comment": "V is an extension to the base PV1-2 patientClass  value set in V2"
            }
          ]
        }
      ]
    },
    {
      "source": "http://terminology.hl7.org/CodeSystem/v2-0443",
      "target": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
      "element": [
        {
          "code": "AD",
          "display": "Admitting",
          "target": [
            {
              "code": "ADM",
              "display": "admitter",
              "equivalence": "equivalent",
              "comment": "Also in PV1-17 Admitting Doctor in v2"
            }
          ]
        },
        {
          "code": "AT",
          "display": "Attending",
          "target": [
            {
              "code": "ATND",
              "display": "attender",
              "equivalence": "equivalent",
              "comment": "Also in PV1-7 Attending Doctor in v2"
            }
          ]
        },
        {
          "code": "CP",
          "display": "Consulting Provider",
          "target": [
            {
              "code": "CON",
              "display": "consultant",
              "equivalence": "equivalent",
              "comment": "Also in PV1-9 Consulting Doctor"
            }
          ]
        },
        {
          "code": "FHCP",
          "display": "Family Health Care Professional",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "participant type valueset binding is extensible, so could add in \"FHCP\" from https://terminology.hl7.org/2.1.0/CodeSystem-v2-0443.html"
            }
          ]
        },
        {
          "code": "PP",
          "display": "Primary Care Provider",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "participant type valueset binding is extensible, so could add in \"PP\" from https://terminology.hl7.org/2.1.0/CodeSystem-v2-0443.html"
            }
          ]
        },
        {
          "code": "RP",
          "display": "Referring Provider",
          "target": [
            {
              "code": "REF",
              "display": "referrer",
              "equivalence": "equivalent",
              "comment": "Also in PV1-8 Referring doctor in v2"
            }
          ]
        },
        {
          "code": "RT",
          "display": "Referred to Provider",
          "target": [
            {
              "code": "REFT",
              "display": "Referred to",
              "equivalence": "equivalent"
            }
          ]
        }
      ]
    },
    {
      "target": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
      "element": [
        {
          "code": "TF",
          "display": "Treating Facility",
          "target": [
            {
              "code": "LOC",
              "display": "location",
              "equivalence": "equivalent",
              "comment": "TF  is an extension to the base ROL-3 providerRole value set in V2"
            }
          ]
        }
      ]
    },
    {
      "source": "http://terminology.hl7.org/CodeSystem/v2-0001",
      "target": "http://hl7.org/fhir/administrative-gender",
      "element": [
        {
          "code": "F",
          "display": "Female",
          "target": [
            {
              "code": "female",
              "display": "Female",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "M",
          "display": "Male",
          "target": [
            {
              "code": "male",
              "display": "Male",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "O",
          "display": "Other",
          "target": [
            {
              "code": "other",
              "display": "Other",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "U",
          "display": "Unknown",
          "target": [
            {
              "code": "unknown",
              "display": "Unknown",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "A",
          "display": "Ambiguous",
          "target": [
            {
              "code": "other",
              "display": "Other",
              "equivalence": "equivalent",
              "comment": "Since the binding in USCorePatient is required, will have to map to \"other\""
            }
          ]
        },
        {
          "code": "N",
          "display": "Not Applicable",
          "target": [
            {
              "code": "other",
              "display": "Other",
              "equivalence": "equivalent",
              "comment": "Since the binding in USCorePatient is required, will have to map to \"other\""
            }
          ]
        },
        {
          "code": "X",
          "display": "Non-Binary",
          "target": [
            {
              "code": "other",
              "display": "Other",
              "equivalence": "equivalent",
              "comment": "Since the binding in USCorePatient is required, will have to map to \"other\""
            }
          ]
        }
      ]
    },
    {
      "source": "http://terminology.hl7.org/CodeSystem/v2-0200",
      "target": "http://hl7.org/fhir/name-use",
      "element": [
        {
          "code": "N",
          "display": "Nickname",
          "target": [
            {
              "code": "nickname",
              "display": "Nickname",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "D",
          "display": "Customary Name",
          "target": [
            {
              "code": "usual",
              "display": "Usual",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "L",
          "display": "Official Registry Name",
          "target": [
            {
              "code": "official",
              "display": "Official",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "TEMP",
          "display": "Temporary Name",
          "target": [
            {
              "code": "temp",
              "display": "Temp",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "S",
          "display": "Pseudonym",
          "target": [
            {
              "code": "anonymous",
              "display": "Anonymous",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "BAD",
          "display": "Bad Name",
          "target": [
            {
              "code": "old",
              "display": "Old",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "M",
          "display": "Maiden Name",
          "target": [
            {
              "code": "maiden",
              "display": "Name changed for Marriage",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "O",
          "display": "Other",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Not mapable, since binding in USCorePatient is required"
            }
          ]
        },
        {
          "code": "A",
          "display": "Assigned",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Not mapable, since binding in USCorePatient is required"
            }
          ]
        },
        {
          "code": "B",
          "display": "Birth name",
          "target": [
            {
              "code": "maiden",
              "display": "Name changed for Marriage",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "C",
          "display": "Adopted Name",
          "target": [
            {
              "code": "official",
              "display": "Official",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "F",
          "display": "Fathers Name",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Not mapable, since binding in USCorePatient is required"
            }
          ]
        },
        {
          "code": "I",
          "display": "Licensing Name",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Not mapable, since binding in USCorePatient is required"
            }
          ]
        },
        {
          "code": "K",
          "display": "Business name",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Not mapable, since binding in USCorePatient is required"
            }
          ]
        },
        {
          "code": "MSK",
          "display": "Masked",
          "target": [
            {
              "code": "anonymous",
              "display": "Anonymous",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "NAV",
          "display": "Temporarily Unavailable",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Not mapable, since binding in USCorePatient is required"
            }
          ]
        },
        {
          "code": "NB",
          "display": "Newborn Name",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Not mapable, since binding in USCorePatient is required"
            }
          ]
        },
        {
          "code": "NOUSE",
          "display": "No Longer To Be Used",
          "target": [
            {
              "code": "old",
              "display": "Old",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "P",
          "display": "Name of Partner/Spouse",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Not mapable, since binding in USCorePatient is required"
            }
          ]
        },
        {
          "code": "R",
          "display": "Registered Name",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Not mapable, since binding in USCorePatient is required"
            }
          ]
        },
        {
          "code": "REL",
          "display": "Religious",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Not mapable, since binding in USCorePatient is required"
            }
          ]
        },
        {
          "code": "T",
          "display": "Indigenous/Tribal",
          "target": [
            {
              "code": "official",
              "display": "Official",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "U",
          "display": "Unknown",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Not mapable, since binding in USCorePatient is required"
            }
          ]
        }
      ]
    },
    {
      "source": "http://terminology.hl7.org/CodeSystem/v2-0007",
      "target": "http://snomed.info/sct",
      "element": [
        {
          "code": "A",
          "display": "Accident",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Include codes from AMA (I have no license to see, so could not include) and http: //snomed.info/sct where concept is-a 308335008 (Patient encounter procedure)\n Not sure this is the right mapping - concepts seem not alinged\n Need to take to PA to find out how folks are currently using https://terminology.hl7.org/5.2.0/CodeSystem-v2-0007.html values - and then decide, if these need to be updated to match what US Core is doing (much more granular)\n in CDA use https://vsac.nlm.nih.gov/valueset/2.16.840.1.113883.3.88.12.80.32/expansion/Latest"
            }
          ]
        },
        {
          "code": "E",
          "display": "Emergency",
          "target": [
            {
              "code": "4525004",
              "display": "Emergency department patient visit",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "L",
          "display": "Labor and Delivery",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Include codes from AMA (I have no license to see, so could not include) and http: //snomed.info/sct where concept is-a 308335008 (Patient encounter procedure)\n Not sure this is the right mapping - concepts seem not alinged\n Need to take to PA to find out how folks are currently using https://terminology.hl7.org/5.2.0/CodeSystem-v2-0007.html values - and then decide, if these need to be updated to match what US Core is doing (much more granular)\n in CDA use https://vsac.nlm.nih.gov/valueset/2.16.840.1.113883.3.88.12.80.32/expansion/Latest"
            }
          ]
        },
        {
          "code": "R",
          "display": "Routine",
          "target": [
            {
              "code": "308335008",
              "display": "Patient encounter procedure",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "N",
          "display": "Newborn (Birth in healthcare facility)",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Include codes from AMA (I have no license to see, so could not include) and http: //snomed.info/sct where concept is-a 308335008 (Patient encounter procedure)\n Not sure this is the right mapping - concepts seem not alinged\n Need to take to PA to find out how folks are currently using https://terminology.hl7.org/5.2.0/CodeSystem-v2-0007.html values - and then decide, if these need to be updated to match what US Core is doing (much more granular)\n in CDA use https://vsac.nlm.nih.gov/valueset/2.16.840.1.113883.3.88.12.80.32/expansion/Latest"
            }
          ]
        },
        {
          "code": "U",
          "display": "Urgent",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Include codes from AMA (I have no license to see, so could not include) and http: //snomed.info/sct where concept is-a 308335008 (Patient encounter procedure)\n Not sure this is the right mapping - concepts seem not alinged\n Need to take to PA to find out how folks are currently using https://terminology.hl7.org/5.2.0/CodeSystem-v2-0007.html values - and then decide, if these need to be updated to match what US Core is doing (much more granular)\n in CDA use https://vsac.nlm.nih.gov/valueset/2.16.840.1.113883.3.88.12.80.32/expansion/Latest"
            }
          ]
        },
        {
          "code": "C",
          "display": "Elective",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Include codes from AMA (I have no license to see, so could not include) and http: //snomed.info/sct where concept is-a 308335008 (Patient encounter procedure)\n Not sure this is the right mapping - concepts seem not alinged\n Need to take to PA to find out how folks are currently using https://terminology.hl7.org/5.2.0/CodeSystem-v2-0007.html values - and then decide, if these need to be updated to match what US Core is doing (much more granular)\n in CDA use https://vsac.nlm.nih.gov/valueset/2.16.840.1.113883.3.88.12.80.32/expansion/Latest"
            }
          ]
        }
      ]
    },
    {
      "source": "http://terminology.hl7.org/CodeSystem/v2-0052",
      "target": "http://terminology.hl7.org/CodeSystem/diagnosis-role",
      "element": [
        {
          "code": "A",
          "display": "Admitting",
          "target": [
            {
              "code": "AD",
              "display": "Admission diagnosis",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "W",
          "display": "Working",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "Since binding is extensible, can extend valueset, should submit UTG proposal to add to code system"
            }
          ]
        },
        {
          "code": "F",
          "display": "Final",
          "target": [
            {
              "code": "DD",
              "display": "Discharge diagnosis",
              "equivalence": "equivalent"
            }
          ]
        }
      ]
    },
    {
      "source": "http://terminology.hl7.org/CodeSystem/v2-0063",
      "target": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
      "element": [
        {
          "code": "MTH",
          "target": [
            {
              "code": "MTH",
              "display": "Mother",
              "equivalence": "equivalent",
              "comment": "This is described specifically for the maternal health use case"
            }
          ]
        }
      ]
    },
    {
      "source": "http://terminology.hl7.org/CodeSystem/v2-0201",
      "target": "http://hl7.org/fhir/contact-point-use",
      "element": [
        {
          "code": "PRN",
          "display": "Primary Residence Number",
          "target": [
            {
              "code": "home",
              "display": "Home",
              "equivalence": "equivalent",
              "comment": "FHIR doesn't distinguish types of homes for contacts"
            }
          ]
        },
        {
          "code": "ORN",
          "display": "Other Residence Number",
          "target": [
            {
              "code": "home",
              "display": "Home",
              "equivalence": "equivalent",
              "comment": "FHIR doesn't distinguish types of homes for contacts"
            }
          ]
        },
        {
          "code": "WPN",
          "display": "Work Number",
          "target": [
            {
              "code": "work",
              "display": "Work",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "VHN",
          "display": "Vacation Home Number",
          "target": [
            {
              "code": "home",
              "display": "Home",
              "equivalence": "equivalent",
              "comment": "FHIR doesn't distinguish types of homes for contacts"
            }
          ]
        },
        {
          "code": "ASN",
          "display": "Answering Service Number",
          "target": [
            {
              "equivalence": "unmatched"
            }
          ]
        },
        {
          "code": "EMR",
          "display": "Emergency Number",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "unsure how to map this"
            }
          ]
        },
        {
          "code": "PRS",
          "display": "Personal",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "unsure how to map this"
            }
          ]
        }
      ]
    },
    {
      "source": "http://terminology.hl7.org/CodeSystem/v2-0201",
      "target": "http://hl7.org/fhir/contact-point-system",
      "element": [
        {
          "code": "NET",
          "display": "Network (email) Address",
          "target": [
            {
              "code": "email",
              "display": "Email",
              "equivalence": "equivalent",
              "comment": "would need to map to different datatype element and use different value set"
            }
          ]
        },
        {
          "code": "BPN",
          "display": "Beeper Number",
          "target": [
            {
              "code": "pager",
              "display": "Pager",
              "equivalence": "equivalent",
              "comment": "would need to map to different datatype element and use different value set"
            }
          ]
        }
      ]
    },
    {
      "source": "http://terminology.hl7.org/CodeSystem/v2-0201",
      "element": [
        {
          "code": "DSM",
          "display": "Direct Secure Messaging",
          "target": [
            {
              "equivalence": "unmatched",
              "comment": "does not map at the vocabulary level - maps to extension in US Core = https://hl7.org/fhir/us/core/StructureDefinition-us-core-direct.html"
            }
          ]
        }
      ]
    }
  ]
}