Homerton ADT FHIR Mapping: Difference between revisions

From Discovery Data Service
Jump to navigation Jump to search
Line 3: Line 3:
{| class="wikitable"
{| class="wikitable"
|+
|+
FHIR Resource:  
FHIR Resource: Patient
!Field#
!Field#
!FieldName
!FieldName
Line 99: Line 99:
{| class="wikitable"
{| class="wikitable"
|+
|+
FHIR Resource:  
FHIR Resource: Patient
!Field#
!Field#
!FieldName
!FieldName
Line 119: Line 119:
This file contains
This file contains
{| class="wikitable"
{| class="wikitable"
|+FHIR Resource:  
|+FHIR Resource: Patient
!Field#
!Field#
!FieldName
!FieldName
Line 161: Line 161:
|}
|}


== Notes ==
== Segment - PV1 - Patient Visit ==
This file lists all patient notes linked to a case.
This file
{| class="wikitable"
{| class="wikitable"
|+FHIR Resource: Flag
|+FHIR Resource: Encounter
!Field#
!FieldName
!FieldName
!FHIR Mapping
!FHIR Mapping
!Extension
|-
|-
|CaseRef
|PV1.2
|id  together with patientId and ReviewDateTime
|Patient class
|Encounter.class
|
|-
|-
|PatientRef
|PV1.4
|subject  patient reference
|Admission type
|Encounter.extension
|encounter-admission-type
|-
|-
|ReviewDateTime
|PV1.6
|period.start
|Prior patient  location
|Encounter.location&  Location
|
|-
|-
|NoteText
|PV1.7
|code  as text only
|Attending  doctor
|Encounter.participant  & Practitioner
|
|-
|-
|Obsolete
|PV1.8
|n/a - ignored where equals true
|Referring doctor
|Encounter.participant  & Practitioner
|
|-
|-
|Active
|PV1.9
|status
|Consulting  doctor
|Encounter.participant&  Practitioner
|
|-
|-
|UserRef
|PV1.10
|author reference
|Hospital service
|}
|Encounter.serviceProvider&  Organization
 
|
== Patient ==
Details all the patients seen as part of the OOH service linked to a case.
{| class="wikitable"
|+FHIR Resource: Patient
!FieldName
!FHIR Mapping
|-
|-
|PatientRef
|PV1.14
|id
|Admit source
|Encounter.hospitalization.origin
|
|-
|-
|Forename
|PV1.17
|givenName
|Admitting  doctor
|Encounter.participant  & Practitioner
|
|-
|-
|Surname
|PV1.18
|familyName
|Patient  type
|Encounter.type
|
|-
|-
|DOB
|PV1.19
|birthDate
|Visit  number
|EpisodeOfCare.identifier
|
|-
|-
|NHSNumber
|PV1.36
|identifier
|Discharge  disposition
|Encounter.hospitalization.dischargeDisposition
|
|-
|-
|NHSNoTraceStatus
|PV1.37
|identifier
|Discharged  to location
|Encounter.hospitalization.destination
|
|-
|-
|Language
|PV1.39
|communicationComponent.language CodableConcept
|Servicing  facility
speaks English extension if language = English
|Encounter.managingOrganization
|
|-
|-
|Ethnicity
|PV1.41
|enthnicity extension (only attempt match if field 27 blank)
|Account status
|Encounter.status
|
|-
|-
|Gender
|PV1.44
|gender
|Admit date/time
|Encounter.statusHistory.start
|
|-
|-
|RegistrationType
|PV1.45
|episode of care registration type extension
|Discharge  date/time
|Encounter.statusHistory.end
|
|-
|-
|HomeAddressBuilding
|PV1.50
|address.line, use = HOME
|Alternate visit  ID
|Encounter.identifier
|
|-
|-
|HomeAddressStreet
|PV1.52
|address.line, use = HOME
|Other  healthcare provider
|-
|Encounter.participant&  Practitioner
|HomeAddressTown
|
|address.town, use = HOME
|-
|HomeAddressLocality
|address.line, use = HOME
|-
|HomeAddressPostcode
|address.postcode, use = HOME
|-
|MobilePhone
|contactPoint, use = MOBILE
|-
|HomePhone
|contactPoint, use = HOME
|-
|EthnicCode
|enthnicity extension
|}
|}


== Consultation ==
== Segment - PV2 - Patient Visit - Additional Information ==
This file details the patient consultations associated with a case.
This file
{| class="wikitable"
{| class="wikitable"
|+FHIR Resource: Encounter
|+FHIR Resource: Encounter
!Field#
!FieldName
!FieldName
!FHIR Mapping
!FHIR Mapping
!Extension
|-
|-
|CaseRef
|PV2.3
|EpisodeOfCare  reference
|Admit reason
Used to derive Patient reference
|Encounter.reason
|
|-
|-
|ConsultationRef
|PV2.4
|id
|Transfer  reason
|Encounter.reason
|
|-
|-
|StartDateTime
|PV2.8
|period.start
|Expected admit  date/time
|Encounter.statusHistory.start
|
|}
 
== Segment - MSH - Message Header ==
This file
{| class="wikitable"
|+FHIR Resource:
!Field#
!FieldName
!FHIR Mapping
!Extension
|-
|-
|EndDateTime
|MSH.3
|period.end
|Sending  application
|MessageHeader.source.software
|
|-
|-
|CaseType
|MSH.4
|CodableConcept encounter_source
|Sending facility
|MessageHeader.source.name
|
|-
|-
|History
|MSH.5
|Observation.comments  linked to Encounter
|Receiving  application
|MessageHeader.destination.extension
|message-header-destination-software-extension
|-
|-
|Examination
|MSH.6
|Observation.comments linked to Encounter
|Receiving  facility
|MessageHeader.destination.name & MessageHeader.responsible
|
|-
|-
|Diagnosis
|MSH.7
|Observation.comments  linked to Encounter
|Message  date/time
|MessageHeader.timestamp
|
|-
|-
|TreatmentPlan
|MSH.9
|Observation.comments  linked to Encounter
|Message type
|MessageHeader.event.code
|
|-
|-
|PatientName
|MSH.10
|n/a - Patient reference used
|Message  control id
|MessageHeader.extension
|message-header-message-control-id-extension
|-
|-
|PatientForename
|MSH.12
|n/a -  Patient reference used
|Version ID
|-
|MessageHeader.event.version
|PatientSurname
|
|n/a -  Patient reference used
|-
|-
|UserRef
|MSH.13
|Participant Primary Performer reference
|Sequence number
|MessageHeader.extension
|message-header-sequence-number-extension
|}
|}



Revision as of 15:58, 3 March 2021

Segment - PID - Patient Identification

This file contains

FHIR Resource: Patient
Field# FieldName FHIR Mapping Extension
PID.2 Patient ID Patient.identifier
PID.3 Patient Identifier List Patient.identifier
PID.4 Alternate PatientIidentifier Patient.identifier
PID.5 Patient Name Patient.name
PID.7 Date/Time Of Birth Patient.birthDate & Patient.extension primarycare-contact-birth-time-extension
PID.8 Sex Patient.gender
PID.9 Patient Alias Patient.name
PID.11 Patient Address Patient.address
PID.13 Phone Number - Home Patient.telecom
PID.14 Phone Number - Business Patient.telecom
PID.15 Primary Language Patient.communication.language
PID.16 Marital Status Patient.maritalStatus
PID.17 Religion Patient.extension primarycare-religion-category-extension
PID.18 Patient Account Number Patient.identifier
PID.22 Ethnic Group Patient.extension primarycare-ethnic-category-extension
PID.29 Patient Death Date and Time Patient.deceased
PID.30 Patient Death Indicator Patient.deceased

Segment - PD1 - Patient Additional Demographic

This file contains

FHIR Resource: Patient
Field# FieldName FHIR Mapping Extension
PD1.3 Patient primary facility Patient.careProvider& Organization
PD1.4 Patient primary care provider Patient.careProvider& Practitioner

Segment - NK1 - Next of Kin / Associated Parties

This file contains

FHIR Resource: Patient
Field# FieldName FHIR Mapping Extension
NK1.2 Name Patient.contact.name
NK1.3 Relationship Patient.contact.relationship
NK1.4 Address Patient.contact.address
NK1.5 Phone number Patient.contact.telecom.value
NK1.6 Business phone number Patient.contact.telecom.value
NK1.7 Contact role Patient.contact.extension primarycare-contact-role-category-extension
NK1.20 Primary language Patient.contact.extension primarycare-contact-main-language-category-extension

Segment - PV1 - Patient Visit

This file

FHIR Resource: Encounter
Field# FieldName FHIR Mapping Extension
PV1.2 Patient class Encounter.class
PV1.4 Admission type Encounter.extension encounter-admission-type
PV1.6 Prior patient location Encounter.location& Location
PV1.7 Attending doctor Encounter.participant & Practitioner
PV1.8 Referring doctor Encounter.participant & Practitioner
PV1.9 Consulting doctor Encounter.participant& Practitioner
PV1.10 Hospital service Encounter.serviceProvider& Organization
PV1.14 Admit source Encounter.hospitalization.origin
PV1.17 Admitting doctor Encounter.participant & Practitioner
PV1.18 Patient type Encounter.type
PV1.19 Visit number EpisodeOfCare.identifier
PV1.36 Discharge disposition Encounter.hospitalization.dischargeDisposition
PV1.37 Discharged to location Encounter.hospitalization.destination
PV1.39 Servicing facility Encounter.managingOrganization
PV1.41 Account status Encounter.status
PV1.44 Admit date/time Encounter.statusHistory.start
PV1.45 Discharge date/time Encounter.statusHistory.end
PV1.50 Alternate visit ID Encounter.identifier
PV1.52 Other healthcare provider Encounter.participant& Practitioner

Segment - PV2 - Patient Visit - Additional Information

This file

FHIR Resource: Encounter
Field# FieldName FHIR Mapping Extension
PV2.3 Admit reason Encounter.reason
PV2.4 Transfer reason Encounter.reason
PV2.8 Expected admit date/time Encounter.statusHistory.start

Segment - MSH - Message Header

This file

FHIR Resource:
Field# FieldName FHIR Mapping Extension
MSH.3 Sending application MessageHeader.source.software
MSH.4 Sending facility MessageHeader.source.name
MSH.5 Receiving application MessageHeader.destination.extension message-header-destination-software-extension
MSH.6 Receiving facility MessageHeader.destination.name & MessageHeader.responsible
MSH.7 Message date/time MessageHeader.timestamp
MSH.9 Message type MessageHeader.event.code
MSH.10 Message control id MessageHeader.extension message-header-message-control-id-extension
MSH.12 Version ID MessageHeader.event.version
MSH.13 Sequence number MessageHeader.extension message-header-sequence-number-extension

Prescriptions

Details the drug items given during the Consultation which links back to a case. 

These will be Snomed DM&D coded as part of phase 2.
FHIR Resource: MedicationStatement
FieldName FHIR Mapping
CaseRef id = CaseRef + ConsulationRef + PatientId

Used to derive Patient reference

ConsultationRef Used to derive effectiveDate, i.e. same as consultation date and practitioner from

Consultation UserRef Encounter reference

DrugName CodableConcept.code.text
Preparation units extension
Dosage dosage
Quantity quanity extension
DMDCode CodableConcept.code
Issue if (not N) then creates linked MedicationOrder resource


Clinical codes

Details all the clinical codes added during a Consultation which links back to a case.

FHIR Resource: Observation
FieldName FHIR Mapping
CaseRef id = CaseRef + ConsulationRef + ClinicalCode

Used to derive Patient reference

ConsultationRef Used to derive effectiveDate, i.e. same as consultation date and the UserRef of the consultation for the Observation clinician

Encounter reference

ClinicalCode CodableConcept.code as Read2.  Also mapped to Snomed.
Term CodableConcept.code.text as Read2.  Also mapped to Snomed.

Provider

Details the patient GP practice and locations.

FHIR Resource: Organization. Linked to the Patient resource Care Provider
FieldName FHIR Mapping
GPPracticeNatCode Organization.identifier.value
GPPracitceName Organization.name
GPPracticePostcode Organization.address.postcode

Users

Details the clinical users/practitioners, linking into all UserRef references in other resources.

FHIR Resource: Practitioner
FieldName FHIR Mapping
UserRef id
Forename HumanName.given
Surname HumanName.family
FullName HumanName.text
ProviderGMC if a GP, create an http://endeavourhealth.org/fhir/Identifier/gmc-number identifier
ProviderNMC if a Nurse, create an http://endeavourhealth.org/fhir/Identifier/nmc-number identifier