## eRef /Patient Resource Profile
**Completeness: 50%**
_This profile is under development. To discuss this (and other related) profiles, please visit the [FHIR Resources](https://3.basecamp.com/3573371/buckets/7773495/vaults/1115843863) folder in Basecamp and post your comments._
---
The Patient resources contains demographics and other administrative information about the individual who is the subject of the ereferral.
| Name | Card | Type | Comments
|---|---|---|---|
|identifier| 0..* | Identifier | COMMENTS REQUIRED - re: HCN, and sender system identifier. |
| ~~active~~ |~~0..1~~|~~boolean~~||
| name | 0..* | HumanName | will use name.family and name.given only. Middle name is supported by using subsequent given names.
| telecom | 0..* | ContactPoint | see notes on [Common Resource Elements](https://simplifier.net/guide/eReferraldraftiGuide/CommonResourceElements)
| gender | 0..1 | code | "male \ female \ other \ unknown" (valueset [Administrative Gender](http://hl7.org/fhir/2018Jan/valueset-administrative-gender.html))
| birthDate | 0..1 | date | e.g., 1928-06-29
| ~~deceased~~ |~~0..1~~|||
| address | 0..* | Address | see "Notes on the use of Address elements" below
| maritalStatus | 0..1 | CodeableConcept | Use the [FHIR marital status codeset](http://hl7.org/fhir/2018Jan/valueset-marital-status.html)
| ~~multipleBirth[x]~~ |~~0..1~~|||
| ~~photo~~ |~~0..1~~|~~Attachment~~||
| contact | 0..* | BackboneElement | Represents various types of alternate contacts for the patient
| contact.relationship| 0..* | CodeableConcept | use patient.relationship.text as free text to hold values such as "Parent \ Mother \ Father \ Child \ Sibling \ Friend \ Legal Guardian \ Power of Attornet \ Substitute Decision Maker \ Emergency Contact"
| contact.name | 0..1 | HumanName | will use name.family and name.given only. Middle name is supported by using subsequent given names.
| contact.telecom | 0..* | ContactPoint | see "Notes on the use of Telecom elements"
| contact.address | 0..1 | Address | see "Notes on the use of Address elements"
| contact.gender | 0..1 | code | "male \ female \ other \ unknown" (valueset [Administrative Gender](http://hl7.org/fhir/2018Jan/valueset-administrative-gender.html))
| `contact.organization` | 0..1 | Reference (Organization)|`candidate for future use`
| contact.period | 0..1 | Period |
| ~~animal~~ |~~0..1~~|~~BackboneElement~~||
| communication | 0..* | BackboneElement |
| communication.language | 1..1 | CodeableConcept | use patient.communication.lanugage.text as free text to hold languages
| communication.preferred | 0..1 | boolean | true for primary language
| generalPractitioner | 0..* | Reference (Practitioner) | reference to a /practitionerRole resource representing the patients primary care provider / family doctor (note: referencing /practitionerRole is not yet part of the standard, but is [currently proposed to be added](http://build.fhir.org/patient-definitions.html#Patient.generalPractitioner)
| `link` | 0..* | BackboneElement | `candidate for future use`
### Profile (Draft STU4)
Full Documentation: [Patient STU3.2](http://hl7.org/fhir/2018Jan/patient.html)
{{tree:CanadianeReferral/STU4Patient-jpg}}
### Element Notes - For Current Use
* *.identifier* - COMMENTS REQUIRED - re: HCN, and sender system identifier.
* *.name* - will use name.family and name.given only. Middle name is supported by using subsequent given names.
* *.telecom* - see "Notes on the use of Telecom elements"
* *.gender* - "male | female | other | unknown" (valueset [Administrative Gender](http://hl7.org/fhir/2018Jan/valueset-administrative-gender.html))
* *.birthdate* - e.g., 1928-06-29
* *.address* - see "Notes on the use of Address elements" below.
* *.maritalStatus* - Use the [FHIR marital status codeset](http://hl7.org/fhir/2018Jan/valueset-marital-status.html))
* *contact* - Represents various types of alternate contacts for the patient
* .relationships. - use patient.relationship.text as free text to hold values such as "Parent | Mother | Father | Child | Sibling | Friend | Legal Guardian | Power of Attornet | Substitute Decision Maker | Emergency Contact"
* .name - will use name.family and name.given only. Middle name is supported by using subsequent given names.
* *.telecom* - see "Notes on the use of Telecom elements"
* *.address* - see "Notes on the use of Address elements"
* *.gender* - "male | female | other | unknown" (valueset [Administrative Gender](http://hl7.org/fhir/2018Jan/valueset-administrative-gender.html))
* *.communication.language* - use patient.communication.lanugage.text as free text to hold languages
* *.communication.preferred* - true for primary language
* *generalPractitioner* - reference to a /practitionerRole resource representing the patients primary care provider / family doctor (note: referencing /practitionerRole is not yet part of the standard, but is [current proposed to be added](http://build.fhir.org/patient-definitions.html#Patient.generalPractitioner)
Notes on the use of *.telecom* elements:
* ".system" (phone | email) & ".value" are required.
* "rank" can be used to indicate 1 (Primary) | 2 (Secondary) | etc..., and is the preferred way to indicate phone use priority.
* ".use" can be used for home | work | mobile as extra information on top of ".rank". When ".rank" is not specificed, ".use = home" will be treated as the ".rank = 1"
Notes on the use of *.address* elements:
Address elements are used to send address in data in a structured format, with the following notable rules:
* .line (with only one value) represents the street # and name
* .line (with two values), the first represents unit # and the second represents street # and name.
* .line entries 3 and above will be ignored.
* .country will be assumed to be the country of the referred service if omitted in the payload.
* .text may be ignored if submitted in the payload, but may be included when the resource is retrieved.
### Element Notes - For Future Use
* .contact.relationship - extended code set for (Contact Role)[http://hl7.org/fhir/2018Jan/v2/0131/index.html]
* .contact.organization
* .link
* [EXTENSION] DHIR address
* [EXTENSION] "Interpreter Required" patient [extension](patient-interpreterRequired)
### Extensions
*
### Implementation Notes
*
## === SPECIFICATION DEVELOPMENT DISCUSSION ===
### Rationale for exclusions
### Discussion
* The (code set "Contact Role")[http://hl7.org/fhir/2018Jan/v2/0131/index.html] for contact.relationship is a bit confusing. Is it about relationship (e.g., mother, father, friend) or role (alt contact, emergency contact, etc...)?
* May need to consider a significant extension that deals with this (also think of SDM, POA, legal guardian).
* Indicate on profile page that in telecom, name & system are required.
*
### STU3 profile (awaiting STU4)
Full Documentation: [/Patient STU3](http://hl7.org/fhir/stu3/patient.html)
{{tree:CanadianeReferral/MyPatient}}
[Download Xml/Json](https://simplifier.net/CanadianeReferral/MyPatient)