<StructureDefinition xmlns="http://hl7.org/fhir">
  <id value="ext-ethnicity" />
  <url value="http://hl7.org/fhir/ca/baseline/StructureDefinition/ext-ethnicity" />
  <version value="0.3.1" />
  <name value="ExtensionEthnicity" />
  <title value="Extension: Ethnicity" />
  <status value="draft" />
  <date value="2024-08-09" />
  <publisher value="HL7 Canada - FHIR Implementation Work Group" />
  <contact>
    <telecom>
      <system value="url" />
      <value value="https://infocentral.infoway-inforoute.ca/en/collaboration/wg/fhir-implementations" />
    </telecom>
  </contact>
  <description value="A code classifying the person's ethnic group or ethnicity as the category of people who identify with each other, usually on the basis of a presumed common genealogy or ancestry or on other similarities. This should not be confused with citizenship or nationality." />
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166" />
      <code value="CA" />
    </coding>
  </jurisdiction>
  <fhirVersion value="4.0.1" />
  <mapping>
    <identity value="rim" />
    <uri value="http://hl7.org/v3" />
    <name value="RIM Mapping" />
  </mapping>
  <kind value="complex-type" />
  <abstract value="false" />
  <context>
    <type value="element" />
    <expression value="Patient" />
  </context>
  <type value="Extension" />
  <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Extension" />
  <derivation value="constraint" />
  <differential>
    <element id="Extension">
      <path value="Extension" />
      <definition value="A code classifying the person's ethnic group or ethnicity as the category of people who identify with each other, usually on the basis of a presumed common genealogy or ancestry or on other similarities." />
      <comment value="This attribute is based on the belief of the person or the person reporting the attribute, not on any formal analysis of genetic, geneological or historical relationships as these would need to be captured as observations." />
      <min value="0" />
      <max value="1" />
      <isModifier value="false" />
      <mapping>
        <identity value="HL7v2" />
        <map value="PID.22 [Ethnic Group]" />
        <comment value="This field further defines the patient's ancestry.  Refer to User-defined Table 0189 - Ethnic Group in Chapter 2C, Code Tables, for suggested values." />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="Person.ethnicGroupCode" />
        <comment value="A code classifying the person into a named category of humans sharing a common real or presumed heritage" />
      </mapping>
      <mapping>
        <identity value="CDA" />
        <map value="/ClinicalDocument/recordTarget/patientRole/patient/sdtc:ethnicGroupCode" />
        <comment value="This CDA R2 SDTC ethnicGroupCode extension is used to record additional ethnicity groups for the recordTarget or subjectPerson" />
      </mapping>
    </element>
    <element id="Extension.url">
      <path value="Extension.url" />
      <min value="1" />
      <max value="1" />
      <fixedUri value="http://hl7.org/fhir/ca/baseline/StructureDefinition/ext-ethnicity" />
    </element>
    <element id="Extension.valueCoding">
      <path value="Extension.valueCoding" />
      <definition value="Concepts classifying the person into a named category of humans sharing common history, traits, geographical origin or nationality" />
      <min value="1" />
      <max value="1" />
      <example>
        <label value="Example of the Ethnicity extension" />
        <valueCoding>
          <system value="http://snomed.info/sct" />
          <code value="733446001" />
          <display value="Canadian (ethnic group)" />
        </valueCoding>
      </example>
      <binding>
        <strength value="preferred" />
        <description value="One of [self-reported ethnic group codes](https://tgateway.infoway-inforoute.ca/vs/ethnicitycode) representing the ethnicity concept and should not be confused with citizenship or nationality." />
        <valueSet value="https://fhir.infoway-inforoute.ca/ValueSet/ethnicitycode" />
      </binding>
      <mapping>
        <identity value="HL7v2" />
        <map value="PID.22 [Ethnic Group]" />
        <comment value="This field further defines the patient's ancestry.  Refer to User-defined Table 0189 - Ethnic Group in Chapter 2C, Code Tables, for suggested values." />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="Person.ethnicGroupCode" />
        <comment value="A code classifying the person into a named category of humans sharing a common real or presumed heritage" />
      </mapping>
      <mapping>
        <identity value="CDA" />
        <map value="/ClinicalDocument/recordTarget/patientRole/patient/sdtc:ethnicGroupCode" />
        <comment value="This CDA R2 SDTC ethnicGroupCode extension is used to record additional ethnicity groups for the recordTarget or subjectPerson" />
      </mapping>
    </element>
    <element id="Extension.valueCoding.system">
      <path value="Extension.valueCoding.system" />
      <short value="Identity of the terminology system" />
      <comment value="Expected URI is one of the following: SNOMED CT International (http://snomed.info/sct) or SNOMED CT CA Edition (https://fhir.infoway-inforoute.ca/CodeSystem/snomedctcaextension)" />
      <min value="1" />
    </element>
    <element id="Extension.valueCoding.code">
      <path value="Extension.valueCoding.code" />
      <short value="Code defining ethnicity concept" />
      <definition value="One of [self-reported ethnic group codes](https://tgateway.infoway-inforoute.ca/vs/ethnicitycode) representing the ethnicity concept and should not be confused with citizenship or nationality." />
      <min value="1" />
    </element>
    <element id="Extension.valueCoding.display">
      <path value="Extension.valueCoding.display" />
      <short value="Optional description of the ethnicity code" />
      <definition value="Plain text representation of the ethnicity concept" />
    </element>
  </differential>
</StructureDefinition>