Mental Health FHIR Store Mappings

Patient Demographics

The Patient Demographic resource is

MHS001: Master Patient Index. To carry personal details of the patient. One occurrence of this group is required.

Property	Description	Conformance	FHIR STU3 Mapping	Value Set
LOCAL PATIENT IDENTIFIER (EXTENDED)	This is a number used to identify a PATIENT uniquely within a Health Care Provider. It may be different from the PATIENT's casenote number and may be assigned automatically by the computer system. LOCAL PATIENT IDENTIFIER (EXTENDED) is used where IT systems have a LOCAL PATIENT IDENTIFIER which is longer than 10 characters and LOCAL PATIENT IDENTIFIER cannot be used for data submission.	M	Patient.Identifier
ORGANISATION IDENTIFIER (LOCAL PATIENT IDENTIFIER)	The ORGANISATION IDENTIFIER of the organisation that assigned the local patient identifier.	M	Patient.Organization.identifier
ORGANISATION IDENTIFIER (EDUCATIONAL ESTABLISHMENT)	ORGANISATION IDENTIFIER (EDUCATIONAL ESTABLISHMENT) is the ORGANISATION IDENTIFIER of the Educational Establishment, including Schools.	R	Patient.Organization.identifier
NHS NUMBER	A number used to identify a PATIENT uniquely within the NHS in England and Wales	R	Patient.identifier(nhsnumber)
NHS NUMBER STATUS INDICATOR CODE (MENTAL HEALTH AND MATERNITY)	The NHS NUMBER STATUS INDICATOR of the PATIENT	R	CareConnect-NHSNumberVerificationStatus-1 https://fhir.hl7.org.uk/STU3/CodeSystem/CareConnect-NHSNumberVerificationStatus-1	01- Number present and verified 02- Number present but not traced 03- Trace required 04- Trace attempted - No match or multiple match found 05- Trace needs to be resolved - (NHS Number or patient detail conflict) 06- Trace in progress 07- Number not present and trace not required
PERSON BIRTH DATE	The date on which a PERSON was born or is officially deemed to have been born	R	Patient.birthDate
POSTCODE OF USUAL ADDRESS	The POSTCODE of the ADDRESS nominated by the PATIENT with ADDRESS ASSOCIATION TYPE 'Main Permanent Residence' or 'Other Permanent Residence'	R	Patient.address.postalCode
GENDER IDENTITY CODE	The gender identity of a PERSON as stated by the PERSON	R	Patient.gender.code	1- Male (including trans man) 2- Female (including trans woman) 3- Non-binary 4- Other (not listed) X- Not Known (not recorded) Z- Not Stated (person asked but declined to provide a response)
GENDER IDENTITY SAME AT BIRTH INDICATOR	An indication of whether the patient's gender identity is the same as their gender assigned at birth.	R	Patient.gender.extension(suggestion of an extension for GENDER IDENTITY SAME AT BIRTH INDICATOR)	Y- Yes - the person's gender identity is the same as their gender assigned at birth N- No - the person's gender identity is not the same as their gender assigned at birth X- Not Known (not asked) Z- Not Stated (person asked but declined to provide a response)
PERSON STATED GENDER CODE	The gender of a PERSON. PERSON STATED GENDER CODE is self declared or inferred by observation for those unable to declare their PERSON STATED GENDER.	R	Patient.gender.code	1- Male 2- Female 9- Indeterminate (unable to be classified as either male or female) X- Not Known (PERSON STATED GENDER CODE not recorded)
PERSON MARITAL STATUS	The legal marital status of a PERSON.	R	Patient.maritalStatus	S- Single M- Married/Civil Partner D- Divorced/Person whose Civil Partnership has been dissolved W- Widowed/Surviving Civil Partner P- Separated N- Not disclosed 8- Not applicable 9- Not known
ETHNIC CATEGORY	The ethnicity of a PERSON, as specified by the PERSON.	R	Patient.extension(ethnicCategory)	A- White - British B- White - Irish C- White - Any other White background D- Mixed - White and Black Caribbean E- Mixed - White and Black African F- Mixed - White and Asian G- Mixed - Any other mixed background H- Asian or Asian British - Indian J- Asian or Asian British - Pakistani K- Asian or Asian British - Bangladeshi L- Asian or Asian British - Any other Asian background M- Black or Black British - Caribbean N- Black or Black British - African P- Black or Black British - Any other Black background R- Other Ethnic Groups - Chinese S- Other Ethnic Groups - Any other ethnic group Z- Not stated 99- Not known
ETHNIC CATEGORY 2021	Placeholder data item to accommodate the 2021 census when it goes live	P	Patient.extension(suggestion of an extension for ETHNIC CATEGORY 2021)
LANGUAGE CODE (PREFERRED)	LANGUAGE CODE (PREFERRED) is the language the PATIENT prefers to use for communication with a Health Care Provider. LANGUAGE CODE is based on the ISO 639-1 two character language codes, see the ISO 639.2 Registration Authority website, plus five communication method extensions.	R	Patient.communication.language	All Spoken Languages ISO 639-1 codes at http://www.loc.gov/standards/iso639-2/php/code_list.php Extensions q1- Braille (for people who are unable to see) q2- American Sign Language q3- Australian Sign Language q4- British Sign Language q5- Makaton (devised for children and adults with a variety of communication and Learning Disabilities)
PERSON DEATH DATE	The date on which a person died or is officially deemed to have died, as recorded on the death certificate.	R	Patient.deceased[x].deceasedDateTime

MHS002GP: GP Practice Registration. To carry details of the GP Practice Registration of the patient. One occurrence of this group is required for each change of GP Practice Registration.

Property	Description	Conformance	FHIR STU3 Mapping	Value Set
GENERAL MEDICAL PRACTICE CODE (PATIENT REGISTRATION)	The ORGANISATION CODE of the GP Practice that the PATIENT is registered with.	M	Patient.generalPractitioner
START DATE (GMP PATIENT REGISTRATION)	Start Date on which the PERSON registered with a General Medical Practitioner Practice.	R	Patient.generalPractitioner.extension(suggestion of an extension for START DATE (GMP PATIENT REGISTRATION))
END DATE (GMP PATIENT REGISTRATION)	The DATE on which the PERSON ceased to be registered with a General Medical Practitioner Practice.	R	Patient.generalPractitioner.extension(suggestion of an extension for END DATE (GMP PATIENT REGISTRATION))

MHS003: Accommodation Status. To carry accommodation details of the patient. One occurrence of this group is permitted for each accommodation type.

Property	Description	Conformance	FHIR STU3 Mapping	Value Set
ACCOMMODATION TYPE	An indication of the type of accommodation that a PATIENT currently has. This should be based on the PATIENT's main or permanent residence.	M	Patient.address.extension(suggestion of an extension for Accommodation Type)
SETTLED ACCOMMODATION INDICATOR	An indication of whether the main/permanent residence of the patient is settled accommodation.	R	Patient.address.extension(suggestion of an extension for Settled Accommodation Indicator)
ACCOMMODATION TYPE RECORDED DATE	The PERSON PROPERTY RECORDED DATE when the ACCOMMODATION TYPE was recorded.	R	Patient.address.extension(suggestion of an extension for ACCOMMODATION TYPE RECORDED DATE)
SECURE CHILDRENS HOME PLACEMENT TYPE	The type of placement for a child or young person accommodated in a Secure Children's Home.	R	Patient.address.extension(SECURE CHILDRENS HOME PLACEMENT TYPE)
ACCOMMODATION TYPE START DATE	The date that the patient's accommodation type started.	R	Patient.address.extension(suggestion of an extension for ACCOMMODATION TYPE START DATE)
ACCOMMODATION TYPE END DATE	The date that the patient's accommodation type ended.	R	Patient.address.extension(suggestion of an extension for ACCOMMODATION TYPE START END)

MHS004EmpStatus Employment Status To carry details of the employment status of the patient. One occurrence of this group is permitted for each employment status.

Property	Description	Conformance	FHIR STU3 Mapping	Value Set
EMPLOYMENT STATUS	The current PRIMARY EMPLOYMENT status of a PERSON.	M	Patient.extension(suggestion of an extension for EMPLOYMENT STATUS)
EMPLOYMENT STATUS START DATE	The date that the patient's employment status started.	R	Patient.extension(suggestion of an extension for EMPLOYMENT STATUS START DATE)
EMPLOYMENT STATUS END DATE	The date that the patient's employment status ended.	R	Patient.extension(suggestion of an extension for EMPLOYMENT STATUS END DATE)
EMPLOYMENT STATUS RECORDED DATE	The date that the patient's employment status details were recorded by the healthcare professional.	R	Patient.extension(suggestion of an extension for EMPLOYMENT STATUS RECORD DATE)
WEEKLY HOURS WORKED	The number of hours worked in a typical week.	R	Patient.extension(suggestion of an extension for WEEKLY HOURS WORKED)

MHS005PatInd Patient Indicators To carry details of specific indicators relating to a patient. One occurrence of this group is permitted containing the current or most recently recorded status or indicators and psychosis information.

Property	Description	Conformance	FHIR STU3 Mapping	Value Set
CONSTANT SUPERVISION AND CARE REQUIRED DUE TO DISABILITY INDICATOR	An indication of whether a disabled PATIENT needs constant (round the clock) care and/or supervision for maintenance of their safety and/or wellbeing.	R	Patient.extension(disability)
PARENTAL RESPONSIBILITIES INDICATOR	An indication of whether a PATIENT has Parental Responsibilities for a child or young person, as stated by the PATIENT.	R	Patient.link.other(RelatedPerson)
YOUNG CARER INDICATOR	An indication of whether a child or young person (PATIENT) has a caring role for an ill or disabled Parent/Carer/Sibling.	R	Patient.extension(suggestion of an extension for YOUNG CARER INDICATOR)
LOOKED AFTER CHILD INDICATOR	An indication of whether a PATIENT is a Looked After Child.	R	Patient.extension(suggestion of an extension for LOOKED AFTER CHILD INDICATOR)
LOOKED AFTER CHILD LEGAL STATUS	The legal status of the Looked After Child. This refers to the Children's Act 1989: see details https://www.legislation.gov.uk/ukpga/1989/41/contents	R	Patient.extension(suggestion of an extension for LOOKED AFTER CHILD LEGAL STATUS)
EDUCATIONAL ASSESSMENT OUTCOME	The outcome of an EDUCATIONAL ASSESSMENT.	R	Patient.extension(suggestion of an extension for EDUCATIONAL ASSESSMENT OUTCOME)
CHILD PROTECTION PLAN INDICATION CODE	An indication of whether the child or young person (PATIENT) is/has previously been subject to a child protection plan.	R	Patient.extension(suggestion of an extension for CHILD PROTECTION PLAN INDICATION CODE)
EX-BRITISH ARMED FORCES INDICATOR	An indication of whether the PATIENT is an ex-member of the British Armed Forces, i.e. army, navy or air force, or is a dependant of a person who is an ex-services member.	R	Patient.extension(suggestion of an extension for EX-BRITISH ARMED FORCES INDICATOR)
OFFENCE HISTORY INDICATION CODE	An indication of whether the PATIENT has a history of offences, including index offences (i.e. is recordable, committed in England and Wales, prosecuted by the police and is not a breach of the peace). This is completed by CARE PROFESSIONALS based on the PATIENT history, informed by referral information.	R	Patient.extension(suggestion of an extension for OFFENCE HISTORY INDICATION CODE)
PRODROME PSYCHOSIS DATE	Date at which first noticeable change in behaviour or mental state occurred prior to emergence of full-blown psychosis for the patient. There should be a clear deterioration in functioning from previous levels. Examples include poor attendance/worsening performance at school/work, trouble sleeping, withdrawing from/fighting with friends/family, attenuated psychotic symptoms (increased suspiciousness,/jealously, occasionally hearing name being called when no' ones around, whisperings, slight confusion in thinking etc.).	R	DetectedIssue.date Condition.onset[x].onsetDateTime(PRODROME PSYCHOSIS DATE)
EMERGENT PSYCHOSIS DATE	Date at which there was first clear evidence of a positive psychotic symptom for the patient (i.e. delusion, hallucination, or thought disorder), regardless of its duration. Such a symptom would be scored 4 or more on the PANSS.	R	DetectedIssue.date Condition.onset[x].onsetDateTime(EMERGENT PSYCHOSIS DATE)
MANIFEST PSYCHOSIS DATE	Date at which a positive psychotic symptom has lasted for a week for the patient. This is usually just 7 days after the date of the first psychotic symptom.	R	DetectedIssue.date Condition.onset[x].onsetDateTime(MANIFEST PSYCHOSIS DATE)
FIRST PRESCRIPTION DATE (ANTI-PSYCHOTIC MEDICATION)	Date the patient was first prescribed anti-psychotic medication following referral into an Early Intervention in Psychosis (EIP) Service.	R	MedicationRequest.authoredOn DetectedIssue.mitigation.date
PSYCHOSIS FIRST TREATMENT START DATE	Date the patient first commenced prescribed (not PRN) anti-psychotic medication, following referral into an Early Intervention in Psychosis (EIP) Service, and thereafter was compliant for at least 75% of the time during the subsequent month (using clinical judgement). Note: For the majority of people this will be the same date as the date of prescription.	R	MedicationRequest.authoredOn DetectedIssue.mitigation.date
REASONABLE ADJUSTMENT REQUIRED INDICATOR	An indicator to alert the clinician that this patient may need a reasonable adjustment made	R	Patient.extension(proposition of an extension for REASONABLE ADJUSTMENT REQUIRED INDICATOR)

MHS006MHCareCoord Mental Health Care Coordinator. To carry details of the Mental Health Care Coordinator assigned to a patient. One occurrence of this group is permitted for each Mental Health Care Coordinator assignment.

Property	Description	Conformance	FHIR STU3 Mapping	Value Set
START DATE (MENTAL HEALTH CARE COORDINATOR ASSIGNMENT PERIOD)	The start date of a Mental Health Care Coordinator Assignment Period for a patient.	M	CareTeam.period.start
CARE PROFESSIONAL LOCAL IDENTIFIER	A unique local CARE PROFESSIONAL IDENTIFIER within a Health Care Provider which may be assigned automatically by the computer system.	R	CareTeam.participant.member
END DATE (MENTAL HEALTH CARE COORDINATOR ASSIGNMENT PERIOD)	The end date of a Mental Health Care Coordinator Assignment Period for a patient.	R	CareTeam.period.end
CARE PROFESSIONAL SERVICE OR TEAM TYPE ASSOCIATION (MENTAL HEALTH)	The type of service or team the Care Professional is associated with.	R	CareTeam.participant.role

MHS007DisabilityType Disability Type To carry details of the type of disability affecting a patient, based on their perception or the perception of a patient proxy. One occurrence of this group is permitted for each disability identified.

Property	Description	Conformance	FHIR STU3 Mapping	Value Set
DISABILITY CODE	The DISABILITY of a PERSON. This could be where: the PERSON has been diagnosed as disabled or the PERSON considers themself to be disabled.	M	Condition.code
DISABILITY IMPACT PERCEPTION	The patient's perception of whether their day-to-day activities are limited because of a health problem or disability which has lasted, or is expected to last, at least 12 months.	R	Condition.extension(suggestion of an extension for DISABILITY IMPACT PERCEPTION)

MHS008CarePlanType Care Plan Type To carry details of Care Plans created for a patient by the organisation. One occurrence of this group is permitted for each Care Plan created for the patient.

Property	Description	Conformance	FHIR STU3 Mapping	Value Set
CARE PLAN IDENTIFIER	A unique identifierfor Care Plan.	M	CarePlan.identifier
CARE PLAN TYPE (MENTAL HEALTH)	The type of Care Plan for the patient, recorded by the service.	M	CarePlan.category
CARE PLAN CREATION DATE	The date that a Care Plan was created for a patient.	M	CarePlan.extension(suggestion of an extension for CARE PLAN CREATION DATE)
CARE PLAN CREATION TIME	The time that a Care Plan was created for a patient.	R	CarePlan.extension(suggestion of an extension for CARE PLAN CREATION TIME)
CARE PLAN LAST UPDATED DATE	The date that the Care Plan was last updated for a patient. Where the Care Plan has not otherwise been updated this will be the same as the Care Plan Creation Date.	R	CarePlan.extension(suggestion of an extension for CARE PLAN LAST UPDATE DATE)
CARE PLAN LAST UPDATED TIME	The time that the Care Plan was last updated for a patient. Where the Care Plan has not otherwise been updated this will be the same as the Care Plan Creation Time.	R	CarePlan.extension(suggestion of an extension for CARE PLAN LAST UPDATE TIME)
CARE PLAN IMPLEMENTATION DATE	The date that the Care Plan was implemented for a patient.	R	CarePlan.period.date

MHS009CarePlanAgreement Care Plan Agreement To carry details of any agreements to a Care Plan by a person, team or organisation. One occurrence of this group is permitted for each agreement of a Care Plan.

Property	Description	Conformance	FHIR STU3 Mapping	Value Set
FAMILY INVOLVED IN CARE PLAN INDICATOR	An indication of whether a member of the patient's family is currently involved in the patient's care plan. This only needs to be captured for inpatients that are in scope of Transforming Care.	R	Consent.actor.role Consent.actor.reference
FAMILY NOT INVOLVED IN CARE PLAN REASON	The reason that the patient's family is not currently involved in the patient's care plan. This only needs to be captured for inpatients that are in scope of Transforming Care.	R
CARE PLAN CONTENT AGREED BY	The type of PERSON, SERVICE or ORGANISATION that agreed the content of the CARE PLAN for the PATIENT.	M	Consent.consentingParty
CARE PLAN CONTENT AGREED DATE	The date on which the content of the CARE PLAN was agreed by a PATIENT or Patient Proxy.	R	Consent.dateTime
CARE PLAN CONTENT AGREED TIME	The time on which the content of the CARE PLAN was agreed by a PATIENT or Patient Proxy	R	Consent.dateTime

MHS010AssTechToSupportDisType Assistive Technology to Support Disability Type To carry details of when assistive technology is used to support a disabled patient. One occurrence of this group is permitted for each assistive technology type.

Property	Description	Conformance	FHIR STU3 Mapping	Value Set
ASSISTIVE TECHNOLOGY FINDING (SNOMED CT)	The SNOMED CT concept ID which is used to identify the finding relating to the assistive technology that a PATIENT is dependent on.	M	Device.extension(suggestion of an extension for ASSISTIVE TECHNOLOGY FINDING (SNOMED CT))
PRESCRIPTION TIMESTAMP (ASSISTIVE TECHNOLOGY)	The date, time and time zone for the prescription of Assistive Technology.	R	DeviceRequest.authoredOn OR Device.extension(suggestion of an extension for PRESCRIPTION TIMESTAMP ASSISTIVE TECHNOLOGY)