<StructureDefinition xmlns="http://hl7.org/fhir">
  <id value="RelatedPerson" />
  <meta>
    <lastUpdated value="2019-11-01T09:29:23.356+11:00" />
  </meta>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-category">
    <valueString value="Base.Individuals" />
  </extension>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
    <valueCode value="trial-use" />
  </extension>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
    <valueInteger value="2" />
  </extension>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-security-category">
    <valueCode value="patient" />
  </extension>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
    <valueCode value="pa" />
  </extension>
  <url value="https://fhir.kemkes.go.id/r4/StructureDefinition/RelatedPerson" />
  <version value="4.0.1" />
  <name value="RelatedPerson" />
  <status value="draft" />
  <date value="2022-07-08T15:10:50.6856647+00:00" />
  <publisher value="Health Level Seven International (Patient Administration)" />
  <contact>
    <telecom>
      <system value="url" />
      <value value="http://hl7.org/fhir" />
    </telecom>
  </contact>
  <contact>
    <telecom>
      <system value="url" />
      <value value="http://www.hl7.org/Special/committees/pafm/index.cfm" />
    </telecom>
  </contact>
  <description value="Information about a person that is involved in the care for a patient, but who is not the target of healthcare, nor has a formal responsibility in the care process." />
  <purpose value="Need to track persons related to the patient or the healthcare process." />
  <fhirVersion value="4.0.1" />
  <mapping>
    <identity value="rim" />
    <uri value="http://hl7.org/v3" />
    <name value="RIM Mapping" />
  </mapping>
  <mapping>
    <identity value="w5" />
    <uri value="http://hl7.org/fhir/fivews" />
    <name value="FiveWs Pattern Mapping" />
  </mapping>
  <mapping>
    <identity value="v2" />
    <uri value="http://hl7.org/v2" />
    <name value="HL7 v2 Mapping" />
  </mapping>
  <kind value="resource" />
  <abstract value="false" />
  <type value="RelatedPerson" />
  <baseDefinition value="http://hl7.org/fhir/StructureDefinition/DomainResource" />
  <derivation value="specialization" />
  <differential>
    <element id="RelatedPerson">
      <path value="RelatedPerson" />
      <short value="A person that is related to a patient, but who is not a direct target of care" />
      <definition value="Information about a person that is involved in the care for a patient, but who is not the target of healthcare, nor has a formal responsibility in the care process." />
      <mapping>
        <identity value="rim" />
        <map value="role" />
      </mapping>
    </element>
    <element id="RelatedPerson.identifier">
      <path value="RelatedPerson.identifier" />
      <short value="A human identifier for this person" />
      <definition value="Identifier for a person within a particular scope." />
      <requirements value="People are known by a variety of ids. Some institutions maintain several, and most collect identifiers for exchange with other organizations concerning the patient. Examples are national person identifier and local identifier." />
      <type>
        <code value="Identifier" />
      </type>
      <isSummary value="true" />
      <mapping>
        <identity value="w5" />
        <map value="FiveWs.identifier" />
      </mapping>
      <mapping>
        <identity value="v2" />
        <map value="NK1-33" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value=".id" />
      </mapping>
    </element>
    <element id="RelatedPerson.active">
      <path value="RelatedPerson.active" />
      <short value="Whether this related person's record is in active use" />
      <definition value="Whether this related person record is in active use." />
      <comment value="This element is labeled as a modifier because it may be used to mark that the resource was created in error." />
      <requirements value="Need to be able to mark a related person record as not to be used, such as if it was created in error." />
      <max value="1" />
      <type>
        <code value="boolean" />
      </type>
      <meaningWhenMissing value="This resource is generally assumed to be active if no value is provided for the active element" />
      <isModifier value="true" />
      <isModifierReason value="This element is labelled as a modifier because it is a status element that can indicate that a record should not be treated as valid" />
      <isSummary value="true" />
      <mapping>
        <identity value="w5" />
        <map value="FiveWs.status" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value=".statusCode" />
      </mapping>
    </element>
    <element id="RelatedPerson.patient">
      <path value="RelatedPerson.patient" />
      <short value="The patient this person is related to" />
      <definition value="The patient this person is related to." />
      <requirements value="We need to know which patient this RelatedPerson is related to." />
      <min value="1" />
      <max value="1" />
      <type>
        <code value="Reference" />
        <targetProfile value="http://hl7.org/fhir/StructureDefinition/Patient" />
      </type>
      <isSummary value="true" />
      <mapping>
        <identity value="v2" />
        <map value="PID-3" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="scoper[classCode=PSN|ANM and determinerCode='INSTANCE']/playedRole[classCode='PAT']/id" />
      </mapping>
    </element>
    <element id="RelatedPerson.relationship">
      <path value="RelatedPerson.relationship" />
      <short value="The nature of the relationship" />
      <definition value="The nature of the relationship between a patient and the related person." />
      <requirements value="We need to know the relationship with the patient since it influences the interpretation of the information attributed to this person." />
      <type>
        <code value="CodeableConcept" />
      </type>
      <isSummary value="true" />
      <binding>
        <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
          <valueString value="PatientRelationshipType" />
        </extension>
        <strength value="preferred" />
        <description value="The nature of the relationship between a patient and the related person." />
        <valueSet value="http://hl7.org/fhir/ValueSet/relatedperson-relationshiptype" />
      </binding>
      <mapping>
        <identity value="w5" />
        <map value="FiveWs.class" />
      </mapping>
      <mapping>
        <identity value="v2" />
        <map value="NK1-3" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="code" />
      </mapping>
    </element>
    <element id="RelatedPerson.name">
      <path value="RelatedPerson.name" />
      <short value="A name associated with the person" />
      <definition value="A name associated with the person." />
      <requirements value="Related persons need to be identified by name, but it is uncommon to need details about multiple other names for that person." />
      <type>
        <code value="HumanName" />
      </type>
      <isSummary value="true" />
      <mapping>
        <identity value="v2" />
        <map value="NK1-2" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="name" />
      </mapping>
    </element>
    <element id="RelatedPerson.telecom">
      <path value="RelatedPerson.telecom" />
      <short value="A contact detail for the person" />
      <definition value="A contact detail for the person, e.g. a telephone number or an email address." />
      <comment value="Person may have multiple ways to be contacted with different uses or applicable periods.  May need to have options for contacting the person urgently, and also to help with identification." />
      <requirements value="People have (primary) ways to contact them in some way such as phone, email." />
      <type>
        <code value="ContactPoint" />
      </type>
      <isSummary value="true" />
      <mapping>
        <identity value="v2" />
        <map value="NK1-5 / NK1-6 / NK1-40" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="telecom" />
      </mapping>
    </element>
    <element id="RelatedPerson.gender">
      <path value="RelatedPerson.gender" />
      <short value="male | female | other | unknown" />
      <definition value="Administrative Gender - the gender that the person is considered to have for administration and record keeping purposes." />
      <requirements value="Needed for identification of the person, in combination with (at least) name and birth date." />
      <max value="1" />
      <type>
        <code value="code" />
      </type>
      <isSummary value="true" />
      <binding>
        <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
          <valueString value="AdministrativeGender" />
        </extension>
        <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-isCommonBinding">
          <valueBoolean value="true" />
        </extension>
        <strength value="required" />
        <description value="The gender of a person used for administrative purposes." />
        <valueSet value="http://hl7.org/fhir/ValueSet/administrative-gender|4.0.1" />
      </binding>
      <mapping>
        <identity value="v2" />
        <map value="NK1-15" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="administrativeGender" />
      </mapping>
    </element>
    <element id="RelatedPerson.birthDate">
      <path value="RelatedPerson.birthDate" />
      <short value="The date on which the related person was born" />
      <definition value="The date on which the related person was born." />
      <max value="1" />
      <type>
        <code value="date" />
      </type>
      <isSummary value="true" />
      <mapping>
        <identity value="rim" />
        <map value="player.birthTime" />
      </mapping>
    </element>
    <element id="RelatedPerson.address">
      <path value="RelatedPerson.address" />
      <short value="Address where the related person can be contacted or visited" />
      <definition value="Address where the related person can be contacted or visited." />
      <requirements value="Need to keep track where the related person can be contacted per postal mail or visited." />
      <type>
        <code value="Address" />
      </type>
      <isSummary value="true" />
      <mapping>
        <identity value="v2" />
        <map value="NK1-4" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="addr" />
      </mapping>
    </element>
    <element id="RelatedPerson.photo">
      <path value="RelatedPerson.photo" />
      <short value="Image of the person" />
      <definition value="Image of the person." />
      <requirements value="Many EHR systems have the capability to capture an image of persons. Fits with newer social media usage too." />
      <type>
        <code value="Attachment" />
      </type>
      <mapping>
        <identity value="v2" />
        <map value="OBX-5 - needs a profile" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="player[classCode='PSN' and determinerCode='INSTANCE']/desc" />
      </mapping>
    </element>
    <element id="RelatedPerson.period">
      <path value="RelatedPerson.period" />
      <short value="Period of time that this relationship is considered valid" />
      <definition value="The period of time during which this relationship is or was active. If there are no dates defined, then the interval is unknown." />
      <max value="1" />
      <type>
        <code value="Period" />
      </type>
      <mapping>
        <identity value="w5" />
        <map value="FiveWs.done[x]" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value=".effectiveTime" />
      </mapping>
    </element>
    <element id="RelatedPerson.communication">
      <path value="RelatedPerson.communication" />
      <short value="A language which may be used to communicate with about the patient's health" />
      <definition value="A language which may be used to communicate with about the patient's health." />
      <comment value="If no language is specified, this *implies* that the default local language is spoken.  If you need to convey proficiency for multiple modes, then you need multiple RelatedPerson.Communication associations.   If the RelatedPerson does not speak the default local language, then the Interpreter Required Standard can be used to explicitly declare that an interpreter is required." />
      <requirements value="If a related person does not speak the local language, interpreters may be required, so languages spoken and proficiency is an important things to keep track of both for patient and other persons of interest." />
      <type>
        <code value="BackboneElement" />
      </type>
      <mapping>
        <identity value="rim" />
        <map value="LanguageCommunication" />
      </mapping>
    </element>
    <element id="RelatedPerson.communication.language">
      <path value="RelatedPerson.communication.language" />
      <short value="The language which can be used to communicate with the patient about his or her health" />
      <definition value="The ISO-639-1 alpha 2 code in lower case for the language, optionally followed by a hyphen and the ISO-3166-1 alpha 2 code for the region in upper case; e.g. &quot;en&quot; for English, or &quot;en-US&quot; for American English versus &quot;en-EN&quot; for England English." />
      <comment value="The structure aa-BB with this exact casing is one the most widely used notations for locale. However not all systems actually code this but instead have it as free text. Hence CodeableConcept instead of code as the data type." />
      <requirements value="Most systems in multilingual countries will want to convey language. Not all systems actually need the regional dialect." />
      <min value="1" />
      <max value="1" />
      <type>
        <code value="CodeableConcept" />
      </type>
      <binding>
        <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-maxValueSet">
          <valueCanonical value="http://hl7.org/fhir/ValueSet/all-languages" />
        </extension>
        <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
          <valueString value="Language" />
        </extension>
        <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-isCommonBinding">
          <valueBoolean value="true" />
        </extension>
        <strength value="preferred" />
        <description value="A human language." />
        <valueSet value="http://hl7.org/fhir/ValueSet/languages" />
      </binding>
      <mapping>
        <identity value="rim" />
        <map value="player[classCode=PSN|ANM and determinerCode=INSTANCE]/languageCommunication/code" />
      </mapping>
    </element>
    <element id="RelatedPerson.communication.preferred">
      <path value="RelatedPerson.communication.preferred" />
      <short value="Language preference indicator" />
      <definition value="Indicates whether or not the patient prefers this language (over other languages he masters up a certain level)." />
      <comment value="This language is specifically identified for communicating healthcare information." />
      <requirements value="People that master multiple languages up to certain level may prefer one or more, i.e. feel more confident in communicating in a particular language making other languages sort of a fall back method." />
      <max value="1" />
      <type>
        <code value="boolean" />
      </type>
      <mapping>
        <identity value="rim" />
        <map value="preferenceInd" />
      </mapping>
    </element>
  </differential>
</StructureDefinition>