Work in progress.
This section of the Implementation Guide is subject to change.

Profile EEBasePatient


Profile Purpose

Patient is a FHIR resource intended for documenting demographical and/or administrative information about the individual on the receiving end of healthcare services. In context of Estonian healthcare data exchange, the patient MUST be identifiable at least by either Estonian Personal Identification Number (if the subject is an Estonian resident) or TIS Personal Idenitification Number (if the subject is a non-resident).

Example usage scenarios

  • Query for patients that share the same general practitioner using the query parameter Patient.generalPractitioner
  • Query for patients that share the same custodian organization using the query parameter Patient.managingOrganization
  • Exchange patient information within a FHIR document or message

Snapshot View

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
est-idS Σ0..1EEBase Estonian Personal Identification Number
tis-idΣ0..1EEBase TIS ID
activeS Σ ?!1..1boolean
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
textS Σ0..1string
familyS Σ0..1string
givenS Σ0..*string
prefixΣ0..*string
suffixΣ0..*string
periodΣ I0..1Period
telecomS Σ I0..*ContactPoint
genderS Σ0..1codeBinding
id0..1string
birthTimeI0..1Extension(dateTime)
value0..1System.Date
deceasedBooleanboolean
deceasedDateTimedateTime
addressS Σ0..*EEBase Address
maritalStatus0..1CodeableConceptBinding
multipleBirthBooleanboolean
multipleBirthIntegerinteger
photoI0..*Attachment
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
relationship0..*CodeableConceptBinding
name0..1HumanName
telecomI0..*ContactPoint
address0..1EEBase Address
gender0..1codeBinding
organizationI0..1Reference(EEBase Organization)
periodI0..1Period
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
language1..1CodeableConceptBinding
preferred0..1boolean
generalPractitionerS I0..*Reference(EEBase Practitioner | EEBase PractitionerRole)
managingOrganizationΣ I0..1Reference(EEBase Organization)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
otherΣ I1..1Reference(EEBase Patient | EEBase RelatedPerson)
typeΣ1..1codeBinding

Differential View

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
est-idS Σ0..1EEBase Estonian Personal Identification Number
tis-idΣ0..1EEBase TIS ID
activeS Σ ?!1..1boolean
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
textS Σ0..1string
familyS Σ0..1string
givenS Σ0..*string
prefixΣ0..*string
suffixΣ0..*string
periodΣ I0..1Period
telecomS Σ I0..*ContactPoint
genderS Σ0..1codeBinding
id0..1string
birthTimeI0..1Extension(dateTime)
value0..1System.Date
deceasedBooleanboolean
deceasedDateTimedateTime
addressS Σ0..*EEBase Address
maritalStatus0..1CodeableConceptBinding
multipleBirthBooleanboolean
multipleBirthIntegerinteger
photoI0..*Attachment
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
relationship0..*CodeableConceptBinding
name0..1HumanName
telecomI0..*ContactPoint
address0..1EEBase Address
gender0..1codeBinding
organizationI0..1Reference(EEBase Organization)
periodI0..1Period
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
language1..1CodeableConceptBinding
preferred0..1boolean
generalPractitionerS I0..*Reference(EEBase Practitioner | EEBase PractitionerRole)
managingOrganizationΣ I0..1Reference(EEBase Organization)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
otherΣ I1..1Reference(EEBase Patient | EEBase RelatedPerson)
typeΣ1..1codeBinding

Hybrid View

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
est-idS Σ0..1EEBase Estonian Personal Identification Number
tis-idΣ0..1EEBase TIS ID
activeS Σ ?!1..1boolean
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
textS Σ0..1string
familyS Σ0..1string
givenS Σ0..*string
prefixΣ0..*string
suffixΣ0..*string
periodΣ I0..1Period
telecomS Σ I0..*ContactPoint
genderS Σ0..1codeBinding
id0..1string
birthTimeI0..1Extension(dateTime)
value0..1System.Date
deceasedBooleanboolean
deceasedDateTimedateTime
addressS Σ0..*EEBase Address
maritalStatus0..1CodeableConceptBinding
multipleBirthBooleanboolean
multipleBirthIntegerinteger
photoI0..*Attachment
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
relationship0..*CodeableConceptBinding
name0..1HumanName
telecomI0..*ContactPoint
address0..1EEBase Address
gender0..1codeBinding
organizationI0..1Reference(EEBase Organization)
periodI0..1Period
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
language1..1CodeableConceptBinding
preferred0..1boolean
generalPractitionerS I0..*Reference(EEBase Practitioner | EEBase PractitionerRole)
managingOrganizationΣ I0..1Reference(EEBase Organization)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
otherΣ I1..1Reference(EEBase Patient | EEBase RelatedPerson)
typeΣ1..1codeBinding

Table View

Patient..
Patient.identifier1..
Patient.identifierEEBase Estonian Personal Identification Number..1
Patient.identifierEEBase TIS ID..1
Patient.active1..
Patient.name..
Patient.name.text..
Patient.name.family..
Patient.name.given..
Patient.telecom..
Patient.gender..
Patient.birthDate..
Patient.birthDate.extension0..
Patient.birthDate.extensionExtension0..
Patient.deceased[x]..
Patient.addressEEBase Address..
Patient.contact..
Patient.contact.addressEEBase Address..
Patient.contact.organizationReference(EEBase Organization)..
Patient.communication..
Patient.communication.language..
Patient.generalPractitionerReference(EEBase Practitioner | EEBase PractitionerRole)..
Patient.managingOrganizationReference(EEBase Organization)..
Patient.link..
Patient.link.otherReference(EEBase Patient | EEBase RelatedPerson)..

XML View

<StructureDefinition xmlns="http://hl7.org/fhir">
    <id value="EEBase-Patient" />
    <meta>
        <lastUpdated value="2022-11-21T13:21:13.515441+00:00" />
    </meta>
    <url value="https://hl7.ee/fhir/StructureDefinition/EEBase-Patient" />
    <version value="1.0.0" />
    <name value="EEBasePatient" />
    <title value="EEBase Patient" />
    <status value="draft" />
    <date value="2022-11-21T13:22:24.2179018+00:00" />
    <publisher value="HL7 Estonia" />
    <fhirVersion value="4.0.1" />
    <kind value="resource" />
    <abstract value="false" />
    <type value="Patient" />
    <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Patient" />
    <derivation value="constraint" />
    <differential>
        <element id="Patient.identifier">
            <path value="Patient.identifier" />
            <slicing>
                <discriminator>
                    <type value="value" />
                    <path value="system" />
                </discriminator>
                <rules value="open" />
            </slicing>
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="Patient.identifier:est-id">
            <path value="Patient.identifier" />
            <sliceName value="est-id" />
            <short value="Estonian personal identification" />
            <definition value="Eesti isikukoodi identifikaator" />
            <max value="1" />
            <type>
                <code value="Identifier" />
                <profile value="https://hl7.ee/fhir/StructureDefinition/EEBase-ESTID" />
            </type>
        </element>
        <element id="Patient.identifier:tis-id">
            <path value="Patient.identifier" />
            <sliceName value="tis-id" />
            <short value="Person&#39;s unique code generated by National Health System" />
            <definition value="Isiku unikaalne tunnus, mille alusel saab teda eristada teistest isikutest TIS-is. Saab kasutada nii v&#228;limaalaste kui ka tundmatu isiku jaoks (juhtudel, kui puudub Eesti isikukood). M&#245;eldud andmevahetuseks Tervise infos&#252;steemiga." />
            <max value="1" />
            <type>
                <code value="Identifier" />
                <profile value="https://hl7.ee/fhir/StructureDefinition/EEBase-TISID" />
            </type>
        </element>
        <element id="Patient.active">
            <path value="Patient.active" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="Patient.name">
            <path value="Patient.name" />
            <mustSupport value="true" />
        </element>
        <element id="Patient.name.text">
            <path value="Patient.name.text" />
            <mustSupport value="true" />
        </element>
        <element id="Patient.name.family">
            <path value="Patient.name.family" />
            <mustSupport value="true" />
        </element>
        <element id="Patient.name.given">
            <path value="Patient.name.given" />
            <mustSupport value="true" />
        </element>
        <element id="Patient.telecom">
            <path value="Patient.telecom" />
            <mustSupport value="true" />
        </element>
        <element id="Patient.gender">
            <path value="Patient.gender" />
            <mustSupport value="true" />
            <isModifierReason value="Neede for proper reference ranges" />
        </element>
        <element id="Patient.birthDate">
            <path value="Patient.birthDate" />
            <mustSupport value="true" />
        </element>
        <element id="Patient.birthDate.extension">
            <path value="Patient.birthDate.extension" />
            <slicing>
                <discriminator>
                    <type value="value" />
                    <path value="url" />
                </discriminator>
                <rules value="open" />
            </slicing>
            <min value="0" />
        </element>
        <element id="Patient.birthDate.extension:birthTime">
            <path value="Patient.birthDate.extension" />
            <sliceName value="birthTime" />
            <min value="0" />
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/StructureDefinition/patient-birthTime" />
            </type>
            <isModifier value="false" />
        </element>
        <element id="Patient.deceased[x]">
            <path value="Patient.deceased[x]" />
            <mustSupport value="true" />
        </element>
        <element id="Patient.address">
            <path value="Patient.address" />
            <type>
                <code value="Address" />
                <profile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Address" />
            </type>
            <mustSupport value="true" />
        </element>
        <element id="Patient.contact.address">
            <path value="Patient.contact.address" />
            <type>
                <code value="Address" />
                <profile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Address" />
            </type>
        </element>
        <element id="Patient.contact.organization">
            <path value="Patient.contact.organization" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Organization" />
            </type>
        </element>
        <element id="Patient.communication.language">
            <path value="Patient.communication.language" />
            <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" />
                <valueSet value="http://hl7.org/fhir/ValueSet/all-languages" />
            </binding>
        </element>
        <element id="Patient.generalPractitioner">
            <path value="Patient.generalPractitioner" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Practitioner" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-PractitionerRole" />
                <versioning value="independent" />
            </type>
            <mustSupport value="true" />
        </element>
        <element id="Patient.managingOrganization">
            <path value="Patient.managingOrganization" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Organization" />
            </type>
        </element>
        <element id="Patient.link">
            <path value="Patient.link" />
            <mustSupport value="true" />
        </element>
        <element id="Patient.link.other">
            <path value="Patient.link.other" />
            <type>
                <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-hierarchy">
                    <valueBoolean value="false" />
                </extension>
                <code value="Reference" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Patient" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-RelatedPerson" />
            </type>
        </element>
    </differential>
</StructureDefinition>

JSON View

{
    "resourceType": "StructureDefinition",
    "id": "EEBase-Patient",
    "meta": {
        "lastUpdated": "2022-11-21T13:21:13.515441+00:00"
    },
    "url": "https://hl7.ee/fhir/StructureDefinition/EEBase-Patient",
    "version": "1.0.0",
    "name": "EEBasePatient",
    "title": "EEBase Patient",
    "status": "draft",
    "date": "2022-11-21T13:22:24.2179018+00:00",
    "publisher": "HL7 Estonia",
    "fhirVersion": "4.0.1",
    "kind": "resource",
    "abstract": false,
    "type": "Patient",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Patient",
    "derivation": "constraint",
    "differential": {
        "element":  [
            {
                "id": "Patient.identifier",
                "path": "Patient.identifier",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "value",
                            "path": "system"
                        }
                    ],
                    "rules": "open"
                },
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "Patient.identifier:est-id",
                "path": "Patient.identifier",
                "sliceName": "est-id",
                "short": "Estonian personal identification",
                "definition": "Eesti isikukoodi identifikaator",
                "max": "1",
                "type":  [
                    {
                        "code": "Identifier",
                        "profile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-ESTID"
                        ]
                    }
                ]
            },
            {
                "id": "Patient.identifier:tis-id",
                "path": "Patient.identifier",
                "sliceName": "tis-id",
                "short": "Person's unique code generated by National Health System",
                "definition": "Isiku unikaalne tunnus, mille alusel saab teda eristada teistest isikutest TIS-is. Saab kasutada nii välimaalaste kui ka tundmatu isiku jaoks (juhtudel, kui puudub Eesti isikukood). Mõeldud andmevahetuseks Tervise infosüsteemiga.",
                "max": "1",
                "type":  [
                    {
                        "code": "Identifier",
                        "profile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-TISID"
                        ]
                    }
                ]
            },
            {
                "id": "Patient.active",
                "path": "Patient.active",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "Patient.name",
                "path": "Patient.name",
                "mustSupport": true
            },
            {
                "id": "Patient.name.text",
                "path": "Patient.name.text",
                "mustSupport": true
            },
            {
                "id": "Patient.name.family",
                "path": "Patient.name.family",
                "mustSupport": true
            },
            {
                "id": "Patient.name.given",
                "path": "Patient.name.given",
                "mustSupport": true
            },
            {
                "id": "Patient.telecom",
                "path": "Patient.telecom",
                "mustSupport": true
            },
            {
                "id": "Patient.gender",
                "path": "Patient.gender",
                "mustSupport": true,
                "isModifierReason": "Neede for proper reference ranges"
            },
            {
                "id": "Patient.birthDate",
                "path": "Patient.birthDate",
                "mustSupport": true
            },
            {
                "id": "Patient.birthDate.extension",
                "path": "Patient.birthDate.extension",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "value",
                            "path": "url"
                        }
                    ],
                    "rules": "open"
                },
                "min": 0
            },
            {
                "id": "Patient.birthDate.extension:birthTime",
                "path": "Patient.birthDate.extension",
                "sliceName": "birthTime",
                "min": 0,
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/StructureDefinition/patient-birthTime"
                        ]
                    }
                ],
                "isModifier": false
            },
            {
                "id": "Patient.deceased[x]",
                "path": "Patient.deceased[x]",
                "mustSupport": true
            },
            {
                "id": "Patient.address",
                "path": "Patient.address",
                "type":  [
                    {
                        "code": "Address",
                        "profile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Address"
                        ]
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "Patient.contact.address",
                "path": "Patient.contact.address",
                "type":  [
                    {
                        "code": "Address",
                        "profile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Address"
                        ]
                    }
                ]
            },
            {
                "id": "Patient.contact.organization",
                "path": "Patient.contact.organization",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "Patient.communication.language",
                "path": "Patient.communication.language",
                "binding": {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-maxValueSet",
                            "valueCanonical": "http://hl7.org/fhir/ValueSet/all-languages"
                        },
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
                            "valueString": "Language"
                        },
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-isCommonBinding",
                            "valueBoolean": true
                        }
                    ],
                    "strength": "preferred",
                    "valueSet": "http://hl7.org/fhir/ValueSet/all-languages"
                }
            },
            {
                "id": "Patient.generalPractitioner",
                "path": "Patient.generalPractitioner",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Practitioner",
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-PractitionerRole"
                        ],
                        "versioning": "independent"
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "Patient.managingOrganization",
                "path": "Patient.managingOrganization",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "Patient.link",
                "path": "Patient.link",
                "mustSupport": true
            },
            {
                "id": "Patient.link.other",
                "path": "Patient.link.other",
                "type":  [
                    {
                        "extension":  [
                            {
                                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-hierarchy",
                                "valueBoolean": false
                            }
                        ],
                        "code": "Reference",
                        "targetProfile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Patient",
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-RelatedPerson"
                        ]
                    }
                ]
            }
        ]
    }
}


identifier (Must Support)

This is a mandatory data element.
The values allowed for this data element are limited and MUST originate from the systems defined by Estonian Personal Identification Number NamingSystem or TIS Personal Identification Number.
Business identifier for identifying the patient across multiple systems.
At least one value (identifier.value) MUST be provided: est-id.value should be populated if the patient has an Estonian Personal Identification Number, alternatively, tis-id.value should be populated in case the patient is of foreign nationality/does not have an Estonian Personal Identification Number.

active (Must Support)

This is a mandatory data element.
Boolean value indicating whether this patient record is in active use. Please note that this data element is subject to organization's business rules (e.g - the logic by which this data element is populated is not universal among different organizations).

name (Must Support)

The name(s) the patient is known by.
Please note that name.text, name.family, and name.given use Must Support flags as well.


telecom (Must Support)

Any contact point (phone or email address for example) by which the patient may be contacted.


gender (Must Support)

Gender of patient (used for administrative purposes).
The required ValueSet used in this case is administrative-gender, meaning these values MUST be exchanged. Local value sets SHOULD be mapped to the required ValueSet.


HTML View

This code system http://hl7.org/fhir/administrative-gender defines the following codes:

CodeDisplayDefinition
maleMaleMale.
femaleFemaleFemale.
otherOtherOther.
unknownUnknownUnknown.

Table View

CodeSystem.id[0]administrative-gender
CodeSystem.meta[0].lastUpdated[0]2019-11-01T09:29:23.356+11:00
CodeSystem.extension[0].url[0]http://hl7.org/fhir/StructureDefinition/structuredefinition-wg
CodeSystem.extension[0].value[0]pa
CodeSystem.extension[1].url[0]http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status
CodeSystem.extension[1].value[0]normative
CodeSystem.extension[2].url[0]http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm
CodeSystem.extension[2].value[0]5
CodeSystem.extension[3].url[0]http://hl7.org/fhir/StructureDefinition/structuredefinition-normative-version
CodeSystem.extension[3].value[0]4.0.0
CodeSystem.url[0]http://hl7.org/fhir/administrative-gender
CodeSystem.identifier[0].system[0]urn:ietf:rfc:3986
CodeSystem.identifier[0].value[0]urn:oid:2.16.840.1.113883.4.642.4.2
CodeSystem.version[0]4.0.1
CodeSystem.name[0]AdministrativeGender
CodeSystem.title[0]AdministrativeGender
CodeSystem.status[0]active
CodeSystem.experimental[0]False
CodeSystem.date[0]2019-11-01T09:29:23+11:00
CodeSystem.description[0]The gender of a person used for administrative purposes.
CodeSystem.caseSensitive[0]True
CodeSystem.valueSet[0]http://hl7.org/fhir/ValueSet/administrative-gender
CodeSystem.content[0]complete
CodeSystem.concept[0].extension[0].url[0]http://hl7.org/fhir/StructureDefinition/codesystem-concept-comments
CodeSystem.concept[0].extension[0].value[0]Male
CodeSystem.concept[0].code[0]male
CodeSystem.concept[0].display[0]Male
CodeSystem.concept[0].definition[0]Male.
CodeSystem.concept[1].extension[0].url[0]http://hl7.org/fhir/StructureDefinition/codesystem-concept-comments
CodeSystem.concept[1].extension[0].value[0]Female
CodeSystem.concept[1].code[0]female
CodeSystem.concept[1].display[0]Female
CodeSystem.concept[1].definition[0]Female.
CodeSystem.concept[2].extension[0].url[0]http://hl7.org/fhir/StructureDefinition/codesystem-concept-comments
CodeSystem.concept[2].extension[0].value[0]The administrative gender is a value other than male/female/unknown. Where this value is selected, systems may often choose to include an extension with the localized more specific value.
CodeSystem.concept[2].code[0]other
CodeSystem.concept[2].display[0]Other
CodeSystem.concept[2].definition[0]Other.
CodeSystem.concept[3].extension[0].url[0]http://hl7.org/fhir/StructureDefinition/codesystem-concept-comments
CodeSystem.concept[3].extension[0].value[0]A proper value is applicable, but not known. Usage Notes: This means the actual value is not known. If the only thing that is unknown is how to properly express the value in the necessary constraints (value set, datatype, etc.), then the OTH or UNC flavor should be used. No properties should be included for a datatype with this property unless: Those properties themselves directly translate to a semantic of "unknown". (E.g. a local code sent as a translation that conveys 'unknown') Those properties further qualify the nature of what is unknown. (E.g. specifying a use code of "H" and a URL prefix of "tel:" to convey that it is the home phone number that is unknown.)
CodeSystem.concept[3].code[0]unknown
CodeSystem.concept[3].display[0]Unknown
CodeSystem.concept[3].definition[0]Unknown.

XML View

<CodeSystem xmlns="http://hl7.org/fhir">
    <id value="administrative-gender" />
    <meta>
        <lastUpdated value="2019-11-01T09:29:23.356+11:00" />
    </meta>
    <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
        <valueCode value="pa" />
    </extension>
    <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
        <valueCode value="normative" />
    </extension>
    <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
        <valueInteger value="5" />
    </extension>
    <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-normative-version">
        <valueCode value="4.0.0" />
    </extension>
    <url value="http://hl7.org/fhir/administrative-gender" />
    <identifier>
        <system value="urn:ietf:rfc:3986" />
        <value value="urn:oid:2.16.840.1.113883.4.642.4.2" />
    </identifier>
    <version value="4.0.1" />
    <name value="AdministrativeGender" />
    <title value="AdministrativeGender" />
    <status value="active" />
    <experimental value="false" />
    <date value="2019-11-01T09:29:23+11:00" />
    <description value="The gender of a person used for administrative purposes." />
    <caseSensitive value="true" />
    <valueSet value="http://hl7.org/fhir/ValueSet/administrative-gender" />
    <content value="complete" />
    <concept>
        <extension url="http://hl7.org/fhir/StructureDefinition/codesystem-concept-comments">
            <valueString value="Male" />
        </extension>
        <code value="male" />
        <display value="Male" />
        <definition value="Male." />
    </concept>
    <concept>
        <extension url="http://hl7.org/fhir/StructureDefinition/codesystem-concept-comments">
            <valueString value="Female" />
        </extension>
        <code value="female" />
        <display value="Female" />
        <definition value="Female." />
    </concept>
    <concept>
        <extension url="http://hl7.org/fhir/StructureDefinition/codesystem-concept-comments">
            <valueString value="The administrative gender is a value other than male/female/unknown. Where this value is selected, systems may often choose to include an extension with the localized more specific value." />
        </extension>
        <code value="other" />
        <display value="Other" />
        <definition value="Other." />
    </concept>
    <concept>
        <extension url="http://hl7.org/fhir/StructureDefinition/codesystem-concept-comments">
            <valueString value="A proper value is applicable, but not known.  Usage Notes: This means the actual value is not known. If the only thing that is unknown is how to properly express the value in the necessary constraints (value set, datatype, etc.), then the OTH or UNC flavor should be used. No properties should be included for a datatype with this property unless:  Those properties themselves directly translate to a semantic of &quot;unknown&quot;. (E.g. a local code sent as a translation that conveys &#39;unknown&#39;) Those properties further qualify the nature of what is unknown. (E.g. specifying a use code of &quot;H&quot; and a URL prefix of &quot;tel:&quot; to convey that it is the home phone number that is unknown.)" />
        </extension>
        <code value="unknown" />
        <display value="Unknown" />
        <definition value="Unknown." />
    </concept>
</CodeSystem>

JSON View

{
    "resourceType": "CodeSystem",
    "id": "administrative-gender",
    "meta": {
        "lastUpdated": "2019-11-01T09:29:23.356+11:00"
    },
    "extension":  [
        {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
            "valueCode": "pa"
        },
        {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
            "valueCode": "normative"
        },
        {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
            "valueInteger": 5
        },
        {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-normative-version",
            "valueCode": "4.0.0"
        }
    ],
    "url": "http://hl7.org/fhir/administrative-gender",
    "identifier":  [
        {
            "system": "urn:ietf:rfc:3986",
            "value": "urn:oid:2.16.840.1.113883.4.642.4.2"
        }
    ],
    "version": "4.0.1",
    "name": "AdministrativeGender",
    "title": "AdministrativeGender",
    "status": "active",
    "experimental": false,
    "date": "2019-11-01T09:29:23+11:00",
    "description": "The gender of a person used for administrative purposes.",
    "caseSensitive": true,
    "valueSet": "http://hl7.org/fhir/ValueSet/administrative-gender",
    "content": "complete",
    "concept":  [
        {
            "extension":  [
                {
                    "url": "http://hl7.org/fhir/StructureDefinition/codesystem-concept-comments",
                    "valueString": "Male"
                }
            ],
            "code": "male",
            "display": "Male",
            "definition": "Male."
        },
        {
            "extension":  [
                {
                    "url": "http://hl7.org/fhir/StructureDefinition/codesystem-concept-comments",
                    "valueString": "Female"
                }
            ],
            "code": "female",
            "display": "Female",
            "definition": "Female."
        },
        {
            "extension":  [
                {
                    "url": "http://hl7.org/fhir/StructureDefinition/codesystem-concept-comments",
                    "valueString": "The administrative gender is a value other than male/female/unknown. Where this value is selected, systems may often choose to include an extension with the localized more specific value."
                }
            ],
            "code": "other",
            "display": "Other",
            "definition": "Other."
        },
        {
            "extension":  [
                {
                    "url": "http://hl7.org/fhir/StructureDefinition/codesystem-concept-comments",
                    "valueString": "A proper value is applicable, but not known.  Usage Notes: This means the actual value is not known. If the only thing that is unknown is how to properly express the value in the necessary constraints (value set, datatype, etc.), then the OTH or UNC flavor should be used. No properties should be included for a datatype with this property unless:  Those properties themselves directly translate to a semantic of \"unknown\". (E.g. a local code sent as a translation that conveys 'unknown') Those properties further qualify the nature of what is unknown. (E.g. specifying a use code of \"H\" and a URL prefix of \"tel:\" to convey that it is the home phone number that is unknown.)"
                }
            ],
            "code": "unknown",
            "display": "Unknown",
            "definition": "Unknown."
        }
    ]
}



birthDate (Must Support)

The date of birth of the individual.
Please note that the element birthDate is also supplemented with extension patient-birthTime which marks the exact date and time when the patient was born. However, it is not a mandatory data element.


deceased[x] (Must support)

A boolean value referring whether the patient is deceased. The patient is considered alive when the value is missing.


address (Must Support)

Please note that the Address datatype used by this element has been standardized, see Address profile for more details.
An address of the individual.

maritalStatus

Coded value referring to most recent marital status of the patient.
The ValueSet used in this case is marital-status (Binding Strength = Extended), meaning these values SHOULD be exchanged, however, using additional concepts is allowed if necessary.

Code Display Definition
A Annulled Marriage contract has been declared null and to not have existed
D Divorced Marriage contract has been declared dissolved and inactive
I Interlocutory Subject to an Interlocutory Decree.
L Legally Separated
M Married A current marriage contract is active
C Common Law a marriage recognized in some jurisdictions and based on the parties' agreement to consider themselves married and can also be based on documentation of cohabitation. This definition was based on https://www.merriam-webster.com/dictionary/common-law%20marriage.
P Polygamous More than 1 current spouse.
T Domestic partner Person declares that a domestic partner relationship exists.
U unmarried Currently not in a marriage contract.
S Never Married No marriage contract has ever been entered
W Widowed The spouse has died
UNK unknown **Description:**A proper value is applicable, but not known. **Usage Notes**: This means the actual value is not known. If the only thing that is unknown is how to properly express the value in the necessary constraints (value set, datatype, etc.), then the OTH or UNC flavor should be used. No properties should be included for a datatype with this property unless: 1. Those properties themselves directly translate to a semantic of "unknown". (E.g. a local code sent as a translation that conveys 'unknown') 2. Those properties further qualify the nature of what is unknown. (E.g. specifying a use code of "H" and a URL prefix of "tel:" to convey that it is the home phone number that is unknown.)


multipleBirth[x]

A boolean or integer value (read more about the difference between these two from the FHIR specification) that marks whether the patient was part of a multiple birth and what was the birth number in the sequence.


photo

Image of the patient (if available).


contact

Please note that the contact person whose details have been used to populate patient.contact element does not have to be necessarily the same person as the one described by EEBaseRelatedPerson profile, although they may overlap.
A contact person for the patient.

communication

Data element for marking patient's preferred language(s).


generalPractitioner (Must Support)

Information about the patient's primary care provider by reference to EEBasePractitioner or EEBasePractitionerRole.


managingOrganization

Organization that is the custodian of the patient record by reference to EEBaseOrganization.