RelatedPerson Profile

Canonical	../StructureDefinition/nexus-emr-core-relatedperson
Status	draft · 1.26.0
Base	RelatedPerson (constraint)
Source	FSH · JSON

Nexus EMR profile for RelatedPerson, capturing an alternative contact for a patient — a person the practice can reach on the patient's behalf, with a personal relationship, any number of contact purposes, contact details, an optional note, and an optional primary (call-first) flag. Backs the Patient Profile Relationships section.

Examples

Alternative Contact (sister, primary)

Avery's sister as primary alternative contact -- shows relationship carrying BOTH the personal relationship and the contact purposes in one array distinguished only by system, plus the work-number extension digits on the contact-point-phone extension

RelatedPerson/relatedperson-avery-sister-mira — claims conformance to RelatedPerson Profile

{
  "resourceType": "RelatedPerson",
  "id": "relatedperson-avery-sister-mira",
  "meta": {
    "profile": [
      "../StructureDefinition/nexus-emr-core-relatedperson"
    ]
  },
  "text": {
    "status": "generated",
    "div": "<div xmlns='http://www.w3.org/1999/xhtml'><p>Mira Linwood, Avery's sister, is the primary alternative contact -- also the emergency contact and substitute decision maker.</p><p>The shape to note: <code>relationship</code> carries BOTH the personal relationship (SIS, from the official relatedperson-relationshiptype value set) AND zero or more contact purposes (the local contact-purpose system, dual-coded with an official code where one exists) in the SAME array, distinguished only by <code>system</code>. Readers MUST discriminate by matching system AND code -- taking <code>relationship[0]</code> or matching on code alone will mis-read a purpose as the relationship.</p><p>Also shown: the work number's extension digits ride on the contact-point-phone-extension, because R4 ContactPoint has nowhere to put them.</p></div>"
  },
  "extension": [
    {
      "url": "../StructureDefinition/nexus-emr-contact-primary",
      "valueBoolean": true
    },
    {
      "url": "../StructureDefinition/nexus-emr-contact-note",
      "valueString": "Prefers to be called after 6pm. Has a key to the apartment."
    }
  ],
  "patient": {
    "reference": "Patient/avery-linwood",
    "display": "Avery Linwood"
  },
  "relationship": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
          "code": "SIS",
          "display": "sister"
        }
      ],
      "text": "Sister"
    },
    {
      "coding": [
        {
          "system": "../CodeSystem/nexus-emr-contact-purpose",
          "code": "emergency",
          "display": "Emergency Contact"
        },
        {
          "system": "http://terminology.hl7.org/CodeSystem/v2-0131",
          "code": "C",
          "display": "Emergency Contact"
        }
      ],
      "text": "Emergency contact"
    },
    {
      "coding": [
        {
          "system": "../CodeSystem/nexus-emr-contact-purpose",
          "code": "substitute-decision-maker",
          "display": "Substitute Decision Maker"
        }
      ],
      "text": "Substitute decision maker"
    }
  ],
  "name": [
    {
      "use": "official",
      "family": "Linwood",
      "given": [
        "Mira"
      ]
    }
  ],
  "telecom": [
    {
      "system": "phone",
      "value": "+1-403-555-0132",
      "use": "mobile"
    },
    {
      "system": "phone",
      "value": "+1-403-555-0900",
      "use": "work",
      "extension": [
        {
          "url": "../StructureDefinition/nexus-emr-contact-point-phone-extension",
          "valueString": "4471"
        }
      ]
    },
    {
      "system": "email",
      "value": "mira.linwood@example.com",
      "use": "home"
    }
  ]
}