HL7 ADT: Difference between revisions

From Voror_Wiki
 
(47 intermediate revisions by 4 users not shown)
Line 1: Line 1:
The Discovery Data Service (DDS) takes HL7 ADT messages from a number of suppliers, transforms the data into FHIR, and makes this available for subscriber use. This page explains the HL7 ADT message types, structure, transform process, and the ADT -> FHIR -> Compass2 mappings.
To see the latest Compass V2 schema, please see [[Discovery Remote Subscriber Database Familiarisation#Data_Mapping]]
 
The Discovery Data Service (DDS) takes HL7 ADT messages from a number of suppliers, transforms the data into FHIR, and makes this available for subscriber use. This page provides an overview the HL7 ADT message types, structure, transform process, and the ADT -> FHIR -> Compass2 mappings.
 
Further segment level details are described in the article  [[Publisher API HL7 Messages]] where details of cardinality are also  given


== Message Types ==
== Message Types ==
{| class="wikitable"
{| class="mw-collapsible" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top; width:100%;"
!Publisher
|- style="background-color:#04466b; color: white; vertical-align: top;"
!Message Type
! scope="col" width="25%" |Publisher
!Message Name
! scope="col" width="25%" |Message Type
! scope="col" width="50%" |Message Name
|-
|-
|Barts Health  
|Barts Health  
Line 109: Line 114:


=== Structure A – Patient level messages ===
=== Structure A – Patient level messages ===
{| class="sortable" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top;"
{| class="sortable" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top; width:100%;"
|- style="background-color:#90A4AE; color: white; vertical-align: top;"  
|- style="background-color:#04466b; color: white; vertical-align: top;"  
! scope="col" width="33%" |Applies to
! scope="col" width="33%" |Applies to
! scope="col" width="34%" |Standard segments
! scope="col" width="34%" |Standard segments
Line 117: Line 122:
| style="text-align: left" |
| style="text-align: left" |
* ADT^A01 (Admit/visit notification)
* ADT^A01 (Admit/visit notification)
* ADT^A02 (Transfer a patient)
* ADT^A02 (Transfer a patient)
* ADT^A03 (Discharge/end visit)
* ADT^A03 (Discharge/end visit)
Line 132: Line 136:
| style="text-align: left" |
| style="text-align: left" |
* MSH [1..1] Message header
* MSH [1..1] Message header
* EVN [1..1]  Event information
* EVN [1..1]  Event information
* PID [1..1] Patient information
* PID [1..1] Patient information
Line 145: Line 148:
*NTE [0..*] Notes and comments
*NTE [0..*] Notes and comments
| style="text-align: left" |
| style="text-align: left" |
* ZAL [0..*] Additional allergy information
* ZQA [0..1] Questionnaire information
* ZPI [0..1] Additional person information
* ZVI [0..1] Additional visit information
|}
{| class="wikitable"
|Applies to:
*ADT^A01 (Admit/visit notification)
* ADT^A02 (Transfer a patient)
* ADT^A03 (Discharge/end visit)
* ADT^A04 (Register a patient)
*ADT^A05 (Pre-admit a patient)
*ADT^A06 (Change an outpatient to an inpatient)
*ADT^A07 (Change an inpatient to an outpatient)
* ADT^A08 (Update patient information)
* ADT^A11 (Cancel admit/visit notification)
* ADT^A12 (Cancel transfer)
* ADT^A13 (Cancel discharge/end visit)
*ADT^A14 (Pending admit)
* ADT^A23 (Delete a patient record)
|Standard segments
* MSH [1..1] Message header
* EVN [1..1]  Event information
* PID [1..1] Patient information
* PD1 [0..1] Additional demographics
*NK1 [0..*] Next of kin / associated parties
* PV1 [1..1] Patient visit information
* PV2 [0..1] Patient visit additional
*OBX [0..*] Obs (used by Homerton for misc. admin data)
*AL1 [0..*] Allergies
*ACC [0..*] Accident information
*DG1 [0..*] Diagnosis information
*NTE [0..*] Notes and comments
|Cerner custom segments:
* ZAL [0..*] Additional allergy information
* ZAL [0..*] Additional allergy information
* ZQA [0..1] Questionnaire information
* ZQA [0..1] Questionnaire information
Line 191: Line 155:


=== Structure B – Person level messages (without encounter information) ===
=== Structure B – Person level messages (without encounter information) ===
{| class="wikitable"
{| class="sortable" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top; width:100%;"
|Applies to:
|- style="background-color:#04465b; color: white; vertical-align: top;"  
 
! scope="col" width="33%" |Applies to
! scope="col" width="34%" |Standard segments
! scope="col" width="33%" |Cerner custom segments
|-
| style="text-align: left" |
*ADT^A28 (Add person information)
*ADT^A28 (Add person information)
* ADT^A31 (Update person information)
* ADT^A31 (Update person information)
|Standard segments:
| style="text-align: left" |
 
* MSH [1..1] Message header
* MSH [1..1] Message header
* EVN [1..1] Event information
* EVN [1..1] Event information
Line 206: Line 173:
*AL1 [0..*] Allergies
*AL1 [0..*] Allergies
*NTE [0..*] Notes and comments
*NTE [0..*] Notes and comments
|Cerner custom segments:
| style="text-align: left" |
 
* ZAL [0..*] Additional allergy information
* ZAL [0..*] Additional allergy information
* ZPI [0..1] Additional person information
* ZPI [0..1] Additional person information
Line 213: Line 179:


=== Structure C – Swap patients ===
=== Structure C – Swap patients ===
Applicable to Homerton '''only'''
{| class="sortable" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top; width:100%;"
{| class="wikitable"
|- style="background-color:#04466b; color: white; vertical-align: top;"  
|Applies to:
! scope="col" width="33%" |Applies to
 
! scope="col" width="34%" |Standard segments
! scope="col" width="33%" |Cerner custom segments
|-
| style="text-align: left" |
*ADT^A17 (Swap patients)
*ADT^A17 (Swap patients)
|Standard segments:
| style="text-align: left" |
 
* MSH [1..1] Message header
* MSH [1..1] Message header
* EVN [1..1] Event information
* EVN [1..1] Event information
Line 226: Line 194:
* PV2 [0..1] Patient visit additional
* PV2 [0..1] Patient visit additional
*OBX [0..*] Obs (used by Homerton for misc. admin data)
*OBX [0..*] Obs (used by Homerton for misc. admin data)
|Cerner custom segments:
| style="text-align: left" |
 
* ZPI [0..1] Additional person information
* ZPI [0..1] Additional person information
* ZVI [0..1] Additional visit information
* ZVI [0..1] Additional visit information
Line 233: Line 200:


=== Structure D – Merge patient information ===
=== Structure D – Merge patient information ===
{| class="wikitable"
{| class="sortable" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top; width:80%;"
|Applies to:
|- style="background-color:#04466b; color: white; vertical-align: top;"
 
! scope="col" width="50%" |Applies to
! scope="col" width="50%" |Standard segments
|-
| style="text-align: left" |
* A34 (Merge patient information)
* A34 (Merge patient information)
* A44 (Move account information)
* A44 (Move account information)
 
| style="text-align: left" |
 
|Standard segments:
 
* MSH [1..1] Message header
* MSH [1..1] Message header
* EVN [1..1] Event information
* EVN [1..1] Event information
Line 250: Line 217:


=== Structure E – Merge account number ===
=== Structure E – Merge account number ===
{| class="wikitable"
{| class="sortable" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top; width:80%;"
|Applies to:
|- style="background-color:#04466b; color: white; vertical-align: top;"
 
! scope="col" width="50%" |Applies to
! scope="col" width="50%" |Standard segments
|-
| style="text-align: left" |
* A35 (Merge account number)
* A35 (Merge account number)
 
| style="text-align: left" |
 
|Standard segments:
 
* MSH [1..1] Message header
* MSH [1..1] Message header
* EVN [1..1] Event information
* EVN [1..1] Event information
Line 268: Line 235:
== Transformation ==
== Transformation ==
The diagram below shows a simplified view of the HL7 to FHIR transform for structure A with the source HL7 segments on the left and target FHIR resources on the right.
The diagram below shows a simplified view of the HL7 to FHIR transform for structure A with the source HL7 segments on the left and target FHIR resources on the right.
{| class="wikitable"
{|
|Barts Health
|'''Barts Health'''
[[File:HL7_ADT_Transformation_Overview.jpg|alt=|frameless|500x500px]]
|'''Homerton'''
|
|-
 
|[[File:HL7_ADT_Transformation_Overview.jpg|frameless|500x500px]]
||[[File:Transformation Overview Homerton V2.jpg|frameless|500x500px]]
|-
|<div style="width: 100px"></div>
|<div style="text-align:center">''As Barts Health plus NK1 and ZVI''</div>
|}


OR
|Homerton
[[File:Transformation Overview Homerton V2.jpg|frameless|500x500px]]
|}
The following sections show each transformation in detail, including field mappings.
The following sections show each transformation in detail, including field mappings.
=== Message Header ===
=== Message Header ===
{| class="wikitable"
{|
|Barts Health
|'''Barts Health'''
[[File:MSH_Overview.jpg|alt=|frameless|500x500px]]
|'''Homerton'''
|-
|[[File:MSH_Overview.jpg|frameless|500x500px]]
|[[File:MSH EVN Overview.jpg|frameless|500x500px]]
|-
|''Message Header (MSH)''
|''Message Header (MSH) & Even Type (EVN)''
|}


Message Header (MSH)
===== MSH field mapping =====
|
{| class="mw-collapsible" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top; width:100%;"
 
|- style="background-color:#04466b; color: white; vertical-align: top;"
 
! scope="col" width="20%" |Publisher
 
! scope="col" width="15%" |Field#
OR
! scope="col" width="20%" |FieldName
|Homerton
! scope="col" width="25%" |FHIR Mapping
[[File:MSH EVN Overview.jpg|frameless|500x500px]]
! scope="col" width="20%" |Extension
 
Message Header (MSH) & Even Type (EVN)
|}
{| class="wikitable"
|+MSH field mapping
!Publisher
!Field#
!FieldName
!FHIR Mapping
!Extension
!Compass Schema Table
!Field
|-
|-
|Barts Health
|Barts Health
Line 311: Line 273:
|Sending application
|Sending application
|MessageHeader.source.software
|MessageHeader.source.software
|
|
|
|
|-
|-
Line 320: Line 280:
|Sending facility
|Sending facility
|MessageHeader.source.name
|MessageHeader.source.name
|
|
|
|
|-
|-
Line 330: Line 288:
|MessageHeader.destination.extension
|MessageHeader.destination.extension
|message-header-destination-software-extension
|message-header-destination-software-extension
|
|
|-
|-
|Barts Health
|Barts Health
Line 338: Line 294:
|Receiving facility
|Receiving facility
|MessageHeader.destination.name  & MessageHeader.responsible
|MessageHeader.destination.name  & MessageHeader.responsible
|
|
|
|
|-
|-
Line 347: Line 301:
|Message date/time
|Message date/time
|MessageHeader.timestamp
|MessageHeader.timestamp
|
|
|
|
|-
|-
Line 356: Line 308:
|Message type
|Message type
|MessageHeader.event.code
|MessageHeader.event.code
|
|
|
|
|-
|-
Line 366: Line 316:
|MessageHeader.extension
|MessageHeader.extension
|message-header-message-control-id-extension
|message-header-message-control-id-extension
|
|
|-
|-
|Barts Health
|Barts Health
Line 374: Line 322:
|Version ID
|Version ID
|MessageHeader.event.version
|MessageHeader.event.version
|
|
|
|
|-
|-
Line 383: Line 329:
|MessageHeader.extension
|MessageHeader.extension
|message-header-sequence-number-extension
|message-header-sequence-number-extension
|
|
|}
|}
{| class="wikitable"
 
|+EVN field mapping
===== EVN field mapping =====
!Publisher
{| class="mw-collapsible" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top; width:100%;"
!Field#
|- style="background-color:#04466b; color: white; vertical-align: top;"
!FieldName
! scope="col" width="20% |Publisher
!FHIR Mapping
! scope="col" width="15%" |Field#
!Compass Schema Table
! scope="col" width="20%" |FieldName
!Field
! scope="col" width="45%" |FHIR Mapping
|-
|-
|Homerton
|Homerton
Line 399: Line 343:
|Operator ID
|Operator ID
|MessageHeader.enterer  & Practitioner.identifier & Practitioner.name
|MessageHeader.enterer  & Practitioner.identifier & Practitioner.name
|
|
|}
|}


Line 420: Line 362:
Patient Identification (PID), Patient Additional Demographic (PD1), & Next of Kin (NK1) segments
Patient Identification (PID), Patient Additional Demographic (PD1), & Next of Kin (NK1) segments
|}
|}
<br />


{| class="wikitable"
===== PID field mapping =====
|+
{| class="mw-collapsible" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top; width:100%;"
PID field mapping
|- style="background-color:#04466b; color: white; vertical-align: top;"
!Publisher
! scope="col" width="7.5%" |Publisher
!Field#
! scope="col" width="7.5%" |Field#
!FieldName
! scope="col" width="15%" |FieldName
!FHIR Mapping
! scope="col" width="20%" |FHIR Mapping
!Extension
! scope="col" width="15%" |Extension
!Compass Schema Table
! scope="col" width="15%" |Compass Schema Table
!Field
! scope="col" width="20%" |Field
|-
|-
|Barts Health
|Barts Health
Line 439: Line 380:
|Patient.identifier
|Patient.identifier
|
|
|
|patient
|
|nhs_number
or null
|-
|-
|Barts Health
|Barts Health
Line 448: Line 390:
|Patient.identifier
|Patient.identifier
|
|
|
|patient
|
|nhs_number
 
or null
|-
|-
|Barts Health
|Barts Health
Line 456: Line 400:
|Patient.identifier.value
|Patient.identifier.value
|
|
|
|patient
|
|nhs_number
 
or null
|-
|-
|Barts Health
|Barts Health
|  - PID.3.4
|  - PID.3.4
|Assigning authority
|Assigning authority
|Patient.identifier.system
|Patient.identifier.system
|
|
|
| style="color:grey;" |'''&#8211;'''
|
| style="color:grey;" |'''&#8211;'''
|-
|-
|Homerton
|Homerton
Line 472: Line 418:
|Patient.identifier
|Patient.identifier
|
|
|
|patient
|
|nhs_number
 
or null
|-
|-
|Barts Health
|Barts Health
Line 481: Line 429:
|Patient.name
|Patient.name
|
|
|
|patient
|
|first_names
last_name
|-
|-
|Barts Health
|Barts Health
Line 489: Line 438:
|Patient.name.family
|Patient.name.family
|
|
|
|patient
|
|last_name
|-
|-
|Barts Health
|Barts Health
|  - PID.5.2
|  - PID.5.2
|Given Name
|Given Name
|Patient.name.given
|Patient.name.given
|
|
|
|patient
|
|first_names
|-
|-
|Barts Health
|Barts Health
|  - PID.5.3
|  - PID.5.3
|Middle Name
|Middle Name
|Patient.name.given
|Patient.name.given
|
|
|
|patient
|
|first_names
|-
|-
|Barts Health
|Barts Health
Line 513: Line 462:
|Patient.name.prefix
|Patient.name.prefix
|
|
|
|patient
|
|title
|-
|-
|Barts Health
|Barts Health
|  - PID.5.7
|  - PID.5.7
|Name Type Code
|Name Type Code
|Patient.name.use
|Patient.name.use
|
|
|
| style="color:grey;" |'''&#8211;'''
|
| style="color:grey;" |'''&#8211;'''
|-
|-
|Barts Health
|Barts Health
Line 530: Line 479:
|Patient.birthDate & Patient.extension
|Patient.birthDate & Patient.extension
|primarycare-contact-birth-time-extension
|primarycare-contact-birth-time-extension
|
|patient
|
|date_of_birth
|-
|-
|Barts Health
|Barts Health
Line 539: Line 488:
|Patient.gender
|Patient.gender
|
|
|
|patient
|
|gender_concept_id
|-
|-
|Barts Health
|Barts Health
Line 548: Line 497:
|Patient.name
|Patient.name
|
|
|
| style="color:grey;" |'''&#8211;'''
|
| style="color:grey;" |'''&#8211;'''
|-
|-
|Barts Health
|Barts Health
Line 557: Line 506:
|Patient.address
|Patient.address
|
|
|
|patient
|
|current_address_id
|-
|-
|Barts Health
|Barts Health
Line 565: Line 514:
|Patient.address.line
|Patient.address.line
|
|
|
|patient_address
|
|address_line_1
|-
|-
|Barts Health
|Barts Health
|<nowiki>- PID.11.2</nowiki>
|<nowiki>- PID.11.2</nowiki>
|Other Designation
|Other Designation
|Patient.address.line
|Patient.address.line
|
|
|
|patient_address
|
|address_line_2
|-
|-
|Barts Health
|Barts Health
Line 581: Line 530:
|Patient.address.city
|Patient.address.city
|
|
|
|patient_address
|
|city
|-
|-
|Barts Health
|Barts Health
|<nowiki>- PID.11.5</nowiki>
|<nowiki>- PID.11.5</nowiki>
|Zip Or Postal Code
|Zip Or Postal Code
|Patient.address.postalCode
|Patient.address.postalCode
|
|
|
|patient_address
|
|postcode
|-
|-
|Barts Health
|Barts Health
|<nowiki>- PID.11.7</nowiki>
|<nowiki>- PID.11.7</nowiki>
|Address Type
|Address Type
|Patient.address.use
|Patient.address.use
|
|
|
|patient_address
|
|use_concept_id
|-
|-
|Barts Health
|Barts Health
|<nowiki>- PID.11.8</nowiki>
|<nowiki>- PID.11.8</nowiki>
|Other Geographic Designation
|Other Geographic Designation
|Patient.address.line
|Patient.address.line
|
|
|
|patient_address
|
|address_line_3
|-
|-
|Barts Health
|Barts Health
|<nowiki>- PID.11.9</nowiki>
|<nowiki>- PID.11.9</nowiki>
|County/Parish Code
|County/Parish Code
|Patient.address.district
|Patient.address.district
|
|
|
|patient_address
|
|ward_code
local_authority_code
|-
|-
|Barts Health
|Barts Health
Line 622: Line 572:
|Patient.telecom
|Patient.telecom
|
|
|
|patient_contact
|
|type_concept_id
|-
|-
|Barts Health
|Barts Health
Line 630: Line 580:
|Patient.telecom.value
|Patient.telecom.value
|
|
|
|patient_contact
|
|value
|-
|-
|Barts Health
|Barts Health
|<nowiki>- PID.13.2</nowiki>
|<nowiki>- PID.13.2</nowiki>
|Telecommunication Use Code
|Telecommunication Use Code
|Patient.telecom.use
|Patient.telecom.use
|
|
|
|patient_contact
|
|use_concept_id
|-
|-
|Barts Health
|Barts Health
Line 647: Line 597:
|Patient.telecom
|Patient.telecom
|
|
|
|patient_contact
|
|type_concept_id
|-
|-
|Barts Health
|Barts Health
Line 655: Line 605:
|Patient.telecom.value
|Patient.telecom.value
|
|
|
|patient_contact
|
|value
|-
|-
|Barts Health
|Barts Health
|<nowiki>- PID.14.2</nowiki>
|<nowiki>- PID.14.2</nowiki>
|Telecommunication Use Code
|Telecommunication Use Code
|Patient.telecom.use
|Patient.telecom.use
|
|
|
|patient_contact
|
|use_concept_id
|-
|-
|Barts Health
|Barts Health
Line 672: Line 622:
|Patient.communication.language
|Patient.communication.language
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Barts Health
|Barts Health
Line 681: Line 631:
|Patient.maritalStatus
|Patient.maritalStatus
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Barts Health
|Barts Health
Line 690: Line 640:
|Patient.extension
|Patient.extension
|primarycare-religion-category-extension
|primarycare-religion-category-extension
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Barts Health
|Barts Health
Line 699: Line 649:
|Patient.identifier
|Patient.identifier
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Barts Health
|Barts Health
Line 708: Line 658:
|Patient.extension
|Patient.extension
|primarycare-ethnic-category-extension
|primarycare-ethnic-category-extension
|
|patient
|
|ethnic_code_concept_id
|-
|-
|Barts Health
|Barts Health
Line 717: Line 667:
|Patient.deceased
|Patient.deceased
|
|
|
|patient
|
|date_of_death
|-
|-
|Barts Health
|Barts Health
Line 726: Line 676:
|Patient.deceased
|Patient.deceased
|
|
|
| style="color:grey;" |'''&#8211;'''
|
| style="color:grey;" |'''&#8211;'''
|}<br />
|}
{| class="wikitable"
<span style="color: red;">'''&#x2717;'''</span> = Data available but not published to Compass schema <br /><span style="color:grey;">'''&#8211;'''</span> = Not applicable
|+
 
PD1 field mapping
===== PD1 field mapping =====
!Publisher
{| class="mw-collapsible" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top; width:100%;"
!Field#
|- style="background-color:#04466b; color: white; vertical-align: top;"
!FieldName
! scope="col" width="7.5%" |Publisher
!FHIR Mapping
! scope="col" width="7.5%" |Field#
!Compass Schema Table
! scope="col" width="15%" |FieldName
!Field
! scope="col" width="20%" |FHIR Mapping
! scope="col" width="30%" |Compass Schema Table
! scope="col" width="20%" |Field
|-
|-
|Barts Health
|Barts Health
Homerton
Homerton
|PD1.3
|PD1.3
|Patient primary facility
|Patient primary facility
|Patient.careProvider& Organization
|Patient.careProvider& Organization
|
|patient
|
|organization_id
|-
|-
|Barts Health
|Barts Health
Line 751: Line 703:
|ID number
|ID number
|Organization.identifier.value
|Organization.identifier.value
|
|organization
|
|ods_code
|-
|-
|Barts Health
|Barts Health
Homerton
Homerton
|PD1.4
|PD1.4
|Patient primary care provider
|Patient primary care provider
|Patient.careProvider& Practitioner
|Patient.careProvider& Practitioner
|
|patient
|
|registered_practice_organization_id
|-
|-
|Barts Health
|Barts Health
Line 766: Line 718:
|ID number
|ID number
|Practitioner.identifier.value
|Practitioner.identifier.value
|
|practitioner
|
|gmc_code
|-
|-
|Barts Health
|Barts Health
Line 773: Line 725:
|Family name
|Family name
|Practitioner.name.family
|Practitioner.name.family
|
|practitioner
|
|name
|-
|-
|Barts Health
|Barts Health
Line 780: Line 732:
|Given name
|Given name
|Practitioner.name.given
|Practitioner.name.given
|
|practitioner
|
|name
|-
|-
|Barts Health
|Barts Health
Line 787: Line 739:
|Assigning authority
|Assigning authority
|Practitioner.identifier.system
|Practitioner.identifier.system
|
|practitioner
|
|organization_id
|}
|}
{| class="wikitable"
 
|+NK1 field mapping
===== NK1 field mapping =====
!Publisher
{| class="mw-collapsible" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top; width:100%;"
!Field#
|- style="background-color:#04466b; color: white; vertical-align: top;"
!FieldName
! scope="col" width="7.5%" |Publisher
!FHIR Mapping
! scope="col" width="7.5%" |Field#
!Extension
! scope="col" width="15%" |FieldName
!Compass Schema Table
! scope="col" width="20%" |FHIR Mapping
!Field
! scope="col" width="15%" |Extension
! scope="col" width="15%" |Compass Schema Table
! scope="col" width="20%" |Field
|-
|-
|Homerton
|Homerton
Line 805: Line 759:
|Patient.contact.name
|Patient.contact.name
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Homerton
|Homerton
Line 813: Line 767:
|Patient.contact.relationship
|Patient.contact.relationship
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Homerton
|Homerton
Line 821: Line 775:
|Patient.contact.address
|Patient.contact.address
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Homerton
|Homerton
|NK1.5
|NK1.5
|Phone number
|Phone number
|Patient.contact.telecom.value
|Patient.contact.telecom.value
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Homerton
|Homerton
|NK1.6
|NK1.6
|Business phone number
|Business phone number
|Patient.contact.telecom.value
|Patient.contact.telecom.value
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Homerton
|Homerton
|NK1.7
|NK1.7
|Contact role
|Contact role
|Patient.contact.extension
|Patient.contact.extension
|primarycare-contact-role-category-extension
|primarycare-contact-role-category-extension
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Homerton
|Homerton
|NK1.20
|NK1.20
|Primary language
|Primary language
|Patient.contact.extension
|Patient.contact.extension
|primarycare-contact-main-language-category-extension
|primarycare-contact-main-language-category-extension
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|}
|}
 
<span style="color: red;">'''&#x2717;'''</span> = Data available but not published to Compass schema <br />Encounter
=== Encounter ===
{| class="wikitable"
{| class="wikitable"
|Barts Health
|Barts Health
Line 881: Line 834:


If the PV1 Attendance Number has previously been seen by Discovery, then the Encounter is linked to the existing EpisodeOfCare.
If the PV1 Attendance Number has previously been seen by Discovery, then the Encounter is linked to the existing EpisodeOfCare.
{| class="wikitable"
 
|+PV1 field mapping
===== PV1 field mapping =====
!Publisher use
{| class="mw-collapsible" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top; width:100%;"
!Field#
|- style="background-color:#04466b; color: white; vertical-align: top;"
!FieldName
! scope="col" width="7.5%" |Publisher
!FHIR Mapping
! scope="col" width="7.5%" |Field#
!Extension
! scope="col" width="15%" |FieldName
!Compass Schema Table
! scope="col" width="20%" |FHIR Mapping
!Field
! scope="col" width="15%" |Extension
! scope="col" width="15%" |Compass Schema Table
! scope="col" width="20%" |Field
|-
|-
|Barts Health
|Barts Health
Line 897: Line 852:
|Encounter.class
|Encounter.class
|
|
|
|encounter
|
|core_concept_id
 
non_core_concept_id
 
admission_method
|-
|-
|Barts Health
|Barts Health
Line 907: Line 866:
&  Location
&  Location
|
|
|
|encounter
|
location
|institution_location_id
 
id
|-
|-
|Barts Health
|Barts Health
Line 915: Line 877:
|Encounter.location
|Encounter.location
|
|
|
|encounter
|
|institution_location_id
|-
|-
|Barts Health
|Barts Health
Line 923: Line 885:
|Encounter.location
|Encounter.location
|
|
|
|encounter
|
|institution_location_id
|-
|-
|Barts Health
|Barts Health
Line 931: Line 893:
|Encounter.location
|Encounter.location
|
|
|
|encounter
|
|institution_location_id
|-
|-
|Barts Health
|Barts Health
Line 941: Line 903:
Encounter.location
Encounter.location
|
|
|
|encounter
|
|institution_location_id
|-
|-
|Barts Health
|Barts Health
Line 949: Line 911:
|Encounter.location
|Encounter.location
|
|
|
|encounter
|
|institution_location_id
|-
|-
|Homerton
|Homerton
Line 957: Line 919:
|Encounter.extension
|Encounter.extension
|encounter-admission-type
|encounter-admission-type
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Homerton
|Homerton
|PV1.6
|PV1.6
|Prior patient location
|Prior patient location
|Encounter.location&  Location
|Encounter.location&  Location
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Barts Health
|Barts Health
Homerton
Homerton
|PV1.7
|PV1.7
|Attending doctor
|Attending doctor
|Encounter.participant  & Practitioner
|Encounter.participant  & Practitioner
|
|
|
|encounter
|
practitioner
|practitioner_id
 
id
|-
|-
|Barts Health
|Barts Health
Line 982: Line 947:
|Practitioner.identifier.value
|Practitioner.identifier.value
|
|
|
|practitioner
|
|gmc_code
|-
|-
|Barts Health
|Barts Health
Line 990: Line 955:
|Practitioner.name.family
|Practitioner.name.family
|
|
|
|practitioner
|
|name
|-
|-
|Barts Health
|Barts Health
Line 998: Line 963:
|Practitioner.name.given
|Practitioner.name.given
|
|
|
|practitioner
|
|name
|-
|-
|Barts Health
|Barts Health
Line 1,006: Line 971:
|Practitioner.identifier.system
|Practitioner.identifier.system
|
|
|
|practitioner
|
|organization_id
|-
|-
|Barts Health
|Barts Health
Homerton
Homerton
|PV1.8
|PV1.8
|Referring doctor
|Referring doctor
|Encounter.participant  & Practitioner
|Encounter.participant  & Practitioner
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Barts Health
|Barts Health
Line 1,023: Line 988:
|Practitioner.identifier.value
|Practitioner.identifier.value
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Barts Health
|Barts Health
Line 1,031: Line 996:
|Practitioner.name.family
|Practitioner.name.family
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Barts Health
|Barts Health
Line 1,039: Line 1,004:
|Practitioner.name.given
|Practitioner.name.given
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Barts Health
|Barts Health
Line 1,047: Line 1,012:
|Practitioner.identifier.system
|Practitioner.identifier.system
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Homerton
|Homerton
|PV1.9
|PV1.9
|Consulting doctor
|Consulting doctor
|Encounter.participant&  Practitioner
|Encounter.participant&  Practitioner
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Barts Health
|Barts Health
Homerton
Homerton
|PV1.10
|PV1.10
|Hospital service
|Hospital service
|Encounter.serviceProvider&  Organization
|Encounter.serviceProvider&  Organization
|
|
|
|encounter
|
organization
|organization_id
 
service_provider_organization_id
 
id
|-
|-
|Homerton
|Homerton
Line 1,072: Line 1,042:
|Encounter.hospitalization.origin
|Encounter.hospitalization.origin
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Homerton
|Homerton
|PV1.17
|PV1.17
|Admitting doctor
|Admitting doctor
|Encounter.participant  & Practitioner
|Encounter.participant  & Practitioner
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Barts Health
|Barts Health
Homerton
Homerton
|PV1.18
|PV1.18
|Patient type
|Patient type
|Encounter.type
|Encounter.type
|
|
|
|encounter
|
|core_concept_id
 
non_core_concept_id
|-
|-
|Barts Health
|Barts Health
Homerton
Homerton
|PV1.19
|PV1.19
|Visit number
|Visit number
|EpisodeOfCare.identifier
|EpisodeOfCare.identifier
|
|
|
|episode_of_care
|
|id
|-
|-
|Barts Health
|Barts Health
Homerton
Homerton
|PV1.36
|PV1.36
|Discharge disposition
|Discharge disposition
|Encounter.hospitalization.dischargeDisposition
|Encounter.hospitalization.dischargeDisposition
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Barts Health
|Barts Health
Homerton
Homerton
|PV1.37
|PV1.37
|Discharged to location
|Discharged to location
|Encounter.hospitalization.destination
|Encounter.hospitalization.destination
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Homerton
|Homerton
|PV1.39
|PV1.39
|Servicing facility
|Servicing facility
|Encounter.managingOrganization
|Encounter.managingOrganization
|
|
|
| style="color:grey;" |'''&#8211;'''
|
| style="color:grey;" |'''&#8211;'''
|-
|-
|Barts Health
|Barts Health
Line 1,133: Line 1,105:
|Encounter.status
|Encounter.status
|
|
|
|episode_of_care
|
|registration_status_concept_id
|-
|-
|Barts Health
|Barts Health
Line 1,142: Line 1,114:
|Encounter.statusHistory.start
|Encounter.statusHistory.start
|
|
|
|encounter
|
encounter_event
|clinical_effective_date
<br />
|-
|-
|Barts Health
|Barts Health
Homerton
Homerton
|PV1.45
|PV1.45
|Discharge date/time
|Discharge date/time
|Encounter.statusHistory.end
|Encounter.statusHistory.end
|
|
|
|encounter
|
encounter_event
|end_date
clinical_effective_date
|-
|-
|Homerton
|Homerton
|PV1.50
|PV1.50
|Alternate visit ID
|Alternate visit ID
|Encounter.identifier
|Encounter.identifier
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Homerton
|Homerton
|PV1.52
|PV1.52
|Other healthcare provider
|Other healthcare provider
|Encounter.participant&  Practitioner
|Encounter.participant&  Practitioner
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|}
|}
{| class="wikitable"
 
|+PV2 field mapping
===== PV2 field mapping =====
!Publisher use
{| class="mw-collapsible" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top; width:100%;"
!Field#
|- style="background-color:#04466b; color: white; vertical-align: top;"
!FieldName
! scope="col" width="7.5%" |Publisher
!FHIR Mapping
! scope="col" width="7.5%" |Field#
!Compass Schema Table
! scope="col" width="15%" |FieldName
!Field
! scope="col" width="20%" |FHIR Mapping
! scope="col" width="30%" |Compass Schema Table
! scope="col" width="20%" |Field
|-
|-
|Barts Health
|Barts Health
Line 1,184: Line 1,162:
|Admit reason
|Admit reason
|Encounter.reason
|Encounter.reason
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Homerton
|Homerton
|PV2.4
|PV2.4
|Transfer reason
|Transfer reason
|Encounter.reason
|Encounter.reason
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Barts Health
|Barts Health
Homerton
Homerton
|PV2.8
|PV2.8
|Expected admit date/time
|Expected admit date/time
|Encounter.statusHistory.start
|Encounter.statusHistory.start
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Homerton
|Homerton
Line 1,206: Line 1,184:
|Expected discharge date/time
|Expected discharge date/time
|Encounter.statusHistory.end
|Encounter.statusHistory.end
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|}
|}
{| class="wikitable"
 
|+EVN field mapping
===== EVN field mapping =====
!Publisher use
{| class="mw-collapsible" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top; width:100%;"
!Field#
|- style="background-color:#04466b; color: white; vertical-align: top;"
!FieldName
! scope="col" width="7.5%" |Publisher
!FHIR Mapping
! scope="col" width="7.5%" |Field#
!Extension
! scope="col" width="15%" |FieldName
!Compass Schema Table
! scope="col" width="20%" |FHIR Mapping
!Field
! scope="col" width="15%" |Extension
! scope="col" width="15%" |Compass Schema Table
! scope="col" width="20%" |Field
|-
|-
|Barts Health
|Barts Health
|EVN.2
|EVN.2
|Recorded date/time
|Recorded date/time
|Encounter.extension
|Encounter.extension
|primarycare-recorded-date-extension
|primarycare-recorded-date-extension
|
|encounter
|
|date_recorded
|-
|-
|
|Homerton
|EVN.5
|EVN.5
|Operator ID
|Operator ID
|MessageHeader.enterer  & Practitioner.identifier & Practitioner.name
|MessageHeader.enterer  & Practitioner.identifier & Practitioner.name
|
|
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|}
|}
{| class="wikitable"
 
|+ZVI field mapping
===== ZVI field mapping =====
!Publisher use
{| class="mw-collapsible" border="1" style="border-collapse:collapse; text-align: center;  vertical-align:top; width:100%;"
!Field#
|- style="background-color:#04466b; color: white; vertical-align: top;"
!FieldName
! scope="col" width="7.5%" |Publisher
!FHIR Mapping
! scope="col" width="7.5%" |Field#
!Compass Schema Table
! scope="col" width="15%" |FieldName
!Field
! scope="col" width="20%" |FHIR Mapping
! scope="col" width="30%" |Compass Schema Table
! scope="col" width="20%" |Field
|-
|-
|Homerton
|Homerton
Line 1,248: Line 1,230:
|Admit mode
|Admit mode
|Encounter.hospitalization.admitSource
|Encounter.hospitalization.admitSource
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|-
|-
|Homerton
|Homerton
Line 1,255: Line 1,237:
|Assign to location date/time
|Assign to location date/time
|Encounter.location.period
|Encounter.location.period
|
| style="color: red;" |'''&#x2717;'''
|
| style="color: red;" |'''&#x2717;'''
|}
|}
<span style="color: red;">'''&#x2717;'''</span> = Data available but not published to Compass schema <br/><span style="color:grey;">'''&#8211;'''</span> = Not applicable

Latest revision as of 12:48, 14 November 2024

To see the latest Compass V2 schema, please see Discovery Remote Subscriber Database Familiarisation#Data_Mapping

The Discovery Data Service (DDS) takes HL7 ADT messages from a number of suppliers, transforms the data into FHIR, and makes this available for subscriber use. This page provides an overview the HL7 ADT message types, structure, transform process, and the ADT -> FHIR -> Compass2 mappings.

Further segment level details are described in the article Publisher API HL7 Messages where details of cardinality are also given

Message Types

Publisher Message Type Message Name
Barts Health

Homerton

ADT^A01 Admit / visit notification
Barts Health

Homerton

ADT^A02 Transfer a patient
Barts Health

Homerton

ADT^A03 Discharge/end visit
Barts Health

Homerton

ADT^A04 Register a patient
Homerton ADT^A05 Pre-admit a patient
Homerton ADT^A06 Change an outpatient to an inpatient
Homerton ADT^A07 Change an inpatient to an outpatient
Barts Health

Homerton

ADT^A08 Update patient information
Barts Health ADT^A11 Cancel admit/visit notification
Barts Health

Homerton

ADT^A12 Cancel transfer
Barts Health

Homerton

ADT^A13 Cancel discharge/end visit
Homerton ADT^A14 Pending admit
Homerton ADT^A17 Swap patients
Barts Health

Homerton

ADT^A23 Delete a patient record
Homerton ADT^A27 Cancel pending admit
Barts Health

Homerton

ADT^A28 Add person information
Barts Health

Homerton

ADT^A31 Update person information
Barts Health

Homerton

ADT^A34 Merge patient information - patient ID only
Barts Health

Homerton

ADT^A35 Merge patient information - account number only
Barts Health

Homerton

ADT^A44 Move account information - patient account number

Message Structures

The messages types are grouped by their structure for transformation to FHIR, since this avoids a large amount of code repetition.

When saving FHIR to the Discovery store there are variations in handling of message types within the message structure groups.

The structures are as follows:

Structure A – Patient level messages

Applies to Standard segments Cerner custom segments
  • ADT^A01 (Admit/visit notification)
  • ADT^A02 (Transfer a patient)
  • ADT^A03 (Discharge/end visit)
  • ADT^A04 (Register a patient)
  • ADT^A05 (Pre-admit a patient)
  • ADT^A06 (Change an outpatient to an inpatient)
  • ADT^A07 (Change an inpatient to an outpatient)
  • ADT^A08 (Update patient information)
  • ADT^A11 (Cancel admit/visit notification)
  • ADT^A12 (Cancel transfer)
  • ADT^A13 (Cancel discharge/end visit)
  • ADT^A14 (Pending admit)
  • ADT^A23 (Delete a patient record)
  • MSH [1..1] Message header
  • EVN [1..1]  Event information
  • PID [1..1] Patient information
  • PD1 [0..1] Additional demographics
  • NK1 [0..*] Next of kin / associated parties
  • PV1 [1..1] Patient visit information
  • PV2 [0..1] Patient visit additional
  • OBX [0..*] Obs (used by Homerton for misc. admin data)
  • AL1 [0..*] Allergies
  • ACC [0..*] Accident information
  • DG1 [0..*] Diagnosis information
  • NTE [0..*] Notes and comments
  • ZAL [0..*] Additional allergy information
  • ZQA [0..1] Questionnaire information
  • ZPI [0..1] Additional person information
  • ZVI [0..1] Additional visit information

Structure B – Person level messages (without encounter information)

Applies to Standard segments Cerner custom segments
  • ADT^A28 (Add person information)
  • ADT^A31 (Update person information)
  • MSH [1..1] Message header
  • EVN [1..1] Event information
  • PID [1..1] Patient information
  • PD1 [0..1] Additional demographics
  • NK1 [0..*] Next of kin / associated parties
  • OBX [0..*] Obs (used by Homerton for misc. admin data)
  • AL1 [0..*] Allergies
  • NTE [0..*] Notes and comments
  • ZAL [0..*] Additional allergy information
  • ZPI [0..1] Additional person information

Structure C – Swap patients

Applies to Standard segments Cerner custom segments
  • ADT^A17 (Swap patients)
  • MSH [1..1] Message header
  • EVN [1..1] Event information
  • PID [1..1] Patient information
  • PV1 [1..1] Patient visit information
  • PV2 [0..1] Patient visit additional
  • OBX [0..*] Obs (used by Homerton for misc. admin data)
  • ZPI [0..1] Additional person information
  • ZVI [0..1] Additional visit information

Structure D – Merge patient information

Applies to Standard segments
  • A34 (Merge patient information)
  • A44 (Move account information)
  • MSH [1..1] Message header
  • EVN [1..1] Event information
  • PID [1..1] Patient information
  • PD1 [0..1] Additional demographics
  • MRG [1..1] Merge information

Structure E – Merge account number

Applies to Standard segments
  • A35 (Merge account number)
  • MSH [1..1] Message header
  • EVN [1..1] Event information
  • PID [1..1] Patient information
  • PD1 [0..1] Additional demographics
  • PV1 [1..1] Patient visit information
  • MRG [1..1] Merge information

Transformation

The diagram below shows a simplified view of the HL7 to FHIR transform for structure A with the source HL7 segments on the left and target FHIR resources on the right.

Barts Health Homerton
HL7 ADT Transformation Overview.jpg Transformation Overview Homerton V2.jpg
As Barts Health plus NK1 and ZVI

The following sections show each transformation in detail, including field mappings.

Message Header

Barts Health Homerton
MSH Overview.jpg MSH EVN Overview.jpg
Message Header (MSH) Message Header (MSH) & Even Type (EVN)
MSH field mapping
Publisher Field# FieldName FHIR Mapping Extension
Barts Health

Homerton

MSH.3 Sending application MessageHeader.source.software
Barts Health

Homerton

MSH.4 Sending facility MessageHeader.source.name
Barts Health

Homerton

MSH.5 Receiving application MessageHeader.destination.extension message-header-destination-software-extension
Barts Health

Homerton

MSH.6 Receiving facility MessageHeader.destination.name & MessageHeader.responsible
Barts Health

Homerton

MSH.7 Message date/time MessageHeader.timestamp
Barts Health

Homerton

MSH.9 Message type MessageHeader.event.code
Barts Health

Homerton

MSH.10 Message control id MessageHeader.extension message-header-message-control-id-extension
Barts Health

Homerton

MSH.12 Version ID MessageHeader.event.version
Homerton MSH.13 Sequence number MessageHeader.extension message-header-sequence-number-extension
EVN field mapping
Publisher Field# FieldName FHIR Mapping
Homerton EVN.5 Operator ID MessageHeader.enterer & Practitioner.identifier & Practitioner.name

Patient

Barts Health

Patient Identification (PID), & Patient Additional Demographic (PD1)



OR

Homerton

PID PD1 NK1 segments.jpg

Patient Identification (PID), Patient Additional Demographic (PD1), & Next of Kin (NK1) segments

PID field mapping
Publisher Field# FieldName FHIR Mapping Extension Compass Schema Table Field
Barts Health

Homerton

PID.2 Patient ID Patient.identifier patient nhs_number

or null

Barts Health

Homerton

PID.3 Patient Identifier List Patient.identifier patient nhs_number

or null

Barts Health - PID.3.1 ID Patient.identifier.value patient nhs_number

or null

Barts Health - PID.3.4 Assigning authority Patient.identifier.system – –
Homerton PID.4 Alternate PatientIidentifier Patient.identifier patient nhs_number

or null

Barts Health

Homerton

PID.5 Patient Name Patient.name patient first_names

last_name

Barts Health - PID.5.1 Family Name Patient.name.family patient last_name
Barts Health - PID.5.2 Given Name Patient.name.given patient first_names
Barts Health - PID.5.3 Middle Name Patient.name.given patient first_names
Barts Health - PID.5.5 Prefix Patient.name.prefix patient title
Barts Health - PID.5.7 Name Type Code Patient.name.use – –
Barts Health

Homerton

PID.7 Date/Time Of Birth Patient.birthDate & Patient.extension primarycare-contact-birth-time-extension patient date_of_birth
Barts Health

Homerton

PID.8 Sex Patient.gender patient gender_concept_id
Barts Health

Homerton

PID.9 Patient Alias Patient.name – –
Barts Health

Homerton

PID.11 Patient Address Patient.address patient current_address_id
Barts Health - PID.11.1 Street Address Patient.address.line patient_address address_line_1
Barts Health - PID.11.2 Other Designation Patient.address.line patient_address address_line_2
Barts Health - PID.11.3 City Patient.address.city patient_address city
Barts Health - PID.11.5 Zip Or Postal Code Patient.address.postalCode patient_address postcode
Barts Health - PID.11.7 Address Type Patient.address.use patient_address use_concept_id
Barts Health - PID.11.8 Other Geographic Designation Patient.address.line patient_address address_line_3
Barts Health - PID.11.9 County/Parish Code Patient.address.district patient_address ward_code

local_authority_code

Barts Health

Homerton

PID.13 Phone Number - Home Patient.telecom patient_contact type_concept_id
Barts Health - PID.13.1 Patient Number Patient.telecom.value patient_contact value
Barts Health - PID.13.2 Telecommunication Use Code Patient.telecom.use patient_contact use_concept_id
Barts Health

Homerton

PID.14 Phone Number - Business Patient.telecom patient_contact type_concept_id
Barts Health - PID.14.1 Patient Number Patient.telecom.value patient_contact value
Barts Health - PID.14.2 Telecommunication Use Code Patient.telecom.use patient_contact use_concept_id
Barts Health

Homerton

PID.15 Primary Language Patient.communication.language ✗ ✗
Barts Health

Homerton

PID.16 Marital Status Patient.maritalStatus ✗ ✗
Barts Health

Homerton

PID.17 Religion Patient.extension primarycare-religion-category-extension ✗ ✗
Barts Health

Homerton

PID.18 Patient Account Number Patient.identifier ✗ ✗
Barts Health

Homerton

PID.22 Ethnic Group Patient.extension primarycare-ethnic-category-extension patient ethnic_code_concept_id
Barts Health

Homerton

PID.29 Patient Death Date and Time Patient.deceased patient date_of_death
Barts Health

Homerton

PID.30 Patient Death Indicator Patient.deceased – –

✗ = Data available but not published to Compass schema
– = Not applicable

PD1 field mapping
Publisher Field# FieldName FHIR Mapping Compass Schema Table Field
Barts Health

Homerton

PD1.3 Patient primary facility Patient.careProvider& Organization patient organization_id
Barts Health - PD1.3.3 ID number Organization.identifier.value organization ods_code
Barts Health

Homerton

PD1.4 Patient primary care provider Patient.careProvider& Practitioner patient registered_practice_organization_id
Barts Health - PD1.4.1 ID number Practitioner.identifier.value practitioner gmc_code
Barts Health - PD1.4.2 Family name Practitioner.name.family practitioner name
Barts Health - PD1.4.3 Given name Practitioner.name.given practitioner name
Barts Health - PD1.4.9 Assigning authority Practitioner.identifier.system practitioner organization_id
NK1 field mapping
Publisher Field# FieldName FHIR Mapping Extension Compass Schema Table Field
Homerton NK1.2 Name Patient.contact.name ✗ ✗
Homerton NK1.3 Relationship Patient.contact.relationship ✗ ✗
Homerton NK1.4 Address Patient.contact.address ✗ ✗
Homerton NK1.5 Phone number Patient.contact.telecom.value ✗ ✗
Homerton NK1.6 Business phone number Patient.contact.telecom.value ✗ ✗
Homerton NK1.7 Contact role Patient.contact.extension primarycare-contact-role-category-extension ✗ ✗
Homerton NK1.20 Primary language Patient.contact.extension primarycare-contact-main-language-category-extension ✗ ✗

✗ = Data available but not published to Compass schema
Encounter

Barts Health

PV1 PV2 EVN Segments.jpg

Patient Visit (PV1), Patient Visit - additional (PV2), & Event Type (EVN)



OR

Homerton

PV1 PV2 ZVI segments.jpg

Patient Visit (PV1), Patient Visit - additional (PV2), & Additional Visit Information (ZVI) segments

Note - Each ADT message containing a PV1 segment (i.e. Structure A messages) results in a new FHIR Encounter resource being created.

The newly created FHIR Encounter is linked to an EpisodeOfCare resource based on the PV1’s Visit Number (this is carried in the Attendance Number field).

If the PV1 Visit Number is new – i.e. has not previously been seen by Discovery – this causes a new EpisodeOfCare resource to be created.

If the PV1 Attendance Number has previously been seen by Discovery, then the Encounter is linked to the existing EpisodeOfCare.

PV1 field mapping
Publisher Field# FieldName FHIR Mapping Extension Compass Schema Table Field
Barts Health

Homerton

PV1.2 Patient class Encounter.class encounter core_concept_id

non_core_concept_id

admission_method

Barts Health PV1.3 Assigned patient location Encounter.location

& Location

encounter

location

institution_location_id

id

Barts Health - PV1.3.1 Point of Care Encounter.location encounter institution_location_id
Barts Health - PV1.3.2 Room Encounter.location encounter institution_location_id
Barts Health - PV1.3.3 Bed Encounter.location encounter institution_location_id
Barts Health - PV1.3.4 Facility Encounter.location

Encounter.location

encounter institution_location_id
Barts Health - PV1.3.7 Building Encounter.location encounter institution_location_id
Homerton PV1.4 Admission type Encounter.extension encounter-admission-type ✗ ✗
Homerton PV1.6 Prior patient location Encounter.location& Location ✗ ✗
Barts Health

Homerton

PV1.7 Attending doctor Encounter.participant & Practitioner encounter

practitioner

practitioner_id

id

Barts Health - PV1.7.1 ID number Practitioner.identifier.value practitioner gmc_code
Barts Health - PV1.7.2 Family name Practitioner.name.family practitioner name
Barts Health - PV1.7.3 Given name Practitioner.name.given practitioner name
Barts Health - PV1.7.9 Assigning authority Practitioner.identifier.system practitioner organization_id
Barts Health

Homerton

PV1.8 Referring doctor Encounter.participant & Practitioner ✗ ✗
Barts Health - PV1.8.1 ID number Practitioner.identifier.value ✗ ✗
Barts Health - PV1.8.2 Family name Practitioner.name.family ✗ ✗
Barts Health - PV1.8.3 Given name Practitioner.name.given ✗ ✗
Barts Health - PV1.8.9 Assigning authority Practitioner.identifier.system ✗ ✗
Homerton PV1.9 Consulting doctor Encounter.participant& Practitioner ✗ ✗
Barts Health

Homerton

PV1.10 Hospital service Encounter.serviceProvider& Organization encounter

organization

organization_id

service_provider_organization_id

id

Homerton PV1.14 Admit source Encounter.hospitalization.origin ✗ ✗
Homerton PV1.17 Admitting doctor Encounter.participant & Practitioner ✗ ✗
Barts Health

Homerton

PV1.18 Patient type Encounter.type encounter core_concept_id

non_core_concept_id

Barts Health

Homerton

PV1.19 Visit number EpisodeOfCare.identifier episode_of_care id
Barts Health

Homerton

PV1.36 Discharge disposition Encounter.hospitalization.dischargeDisposition ✗ ✗
Barts Health

Homerton

PV1.37 Discharged to location Encounter.hospitalization.destination ✗ ✗
Homerton PV1.39 Servicing facility Encounter.managingOrganization – –
Barts Health

Homerton

PV1.41 Account status Encounter.status episode_of_care registration_status_concept_id
Barts Health

Homerton

PV1.44 Admit date/time Encounter.statusHistory.start encounter

encounter_event

clinical_effective_date


Barts Health

Homerton

PV1.45 Discharge date/time Encounter.statusHistory.end encounter

encounter_event

end_date

clinical_effective_date

Homerton PV1.50 Alternate visit ID Encounter.identifier ✗ ✗
Homerton PV1.52 Other healthcare provider Encounter.participant& Practitioner ✗ ✗
PV2 field mapping
Publisher Field# FieldName FHIR Mapping Compass Schema Table Field
Barts Health

Homerton

PV2.3 Admit reason Encounter.reason ✗ ✗
Homerton PV2.4 Transfer reason Encounter.reason ✗ ✗
Barts Health

Homerton

PV2.8 Expected admit date/time Encounter.statusHistory.start ✗ ✗
Homerton PV2.9 Expected discharge date/time Encounter.statusHistory.end ✗ ✗
EVN field mapping
Publisher Field# FieldName FHIR Mapping Extension Compass Schema Table Field
Barts Health EVN.2 Recorded date/time Encounter.extension primarycare-recorded-date-extension encounter date_recorded
Homerton EVN.5 Operator ID MessageHeader.enterer & Practitioner.identifier & Practitioner.name ✗ ✗
ZVI field mapping
Publisher Field# FieldName FHIR Mapping Compass Schema Table Field
Homerton ZVI.9 Admit mode Encounter.hospitalization.admitSource ✗ ✗
Homerton ZVI.15 Assign to location date/time Encounter.location.period ✗ ✗

✗ = Data available but not published to Compass schema
– = Not applicable

Retrieved from ‘https://wiki.voror.co.uk/index.php?title=HL7_ADT&oldid=6853’
Last modified
This page was last modified on 14 November 2024, at 12:48.