Message |
Entity |
Matching Criteria |
Behaviour (Matched) |
Behaviour (Not Matched) |
A28 |
[[Patient]] |
See here for full details of our approach to matching [[Patient]] entities via HL7. |
Partial update will be performed on the [[Patient]] if the supplied MSH-7 timestamp is greater than or equal to [[Patient.Entered Timestamp]] held on the record. Note: the [[Patient.Entered Timestamp]] may have been set via any route e.g HL7, FHIR or UI.
See PID specification for which fields will be left unmodified if a blank is provided.
|
New [[Patient]] created.
[[Patient.Entered Timestamp]] will be set to the value in MSH-7. |
|
[[Contact]] |
[[Contact.Type]] and [[Contact.Value]]. Note that only email contacts can be added via HL7 - the phone number is stored directly on the [[Patient]]. |
No action. Any contacts already known will remain on the record. |
New [[Contact]] created, unless this message is updating an existing [[Patient]] which does not already have an email address. See here for more information on how PKB handles email addresses. |
|
[[National ID]] |
Since only a single National ID for any given National ID Type is permitted on a medical record, an instance of a National ID for a patient can be matched on the [[National ID Type]] alone. |
The corresponding [[National ID.Value]] is updated if a valid value was provided. An existing National ID can be changed but not removed. |
New [[National ID]] added to the medical record. |
|
[[National ID Type]] |
[[National ID Type.HL7 Assigning Authority]] as derived from PID-2.4 and PID-3.4 and [[National ID Type.HL7 Type Code]] as derived from PID-2.5 and PID-3.5. |
Matching the type is a prerequisite for processing the corresponding National ID. |
The corresponding National ID is silently ignored. New types cannot be created via HL7 messaging. |
|
[[Organisation Level ID]] |
[[Organisation Level ID.Value]] as derived from PID-2.1 and PID-3.1 in conjunction with the specified [[Organisation Level ID Type]] |
No action. Any Organisation Level IDs already known will remain on the record. |
New [[Organisation Level ID]] added to the medical record. |
|
[[Organisation Level ID Type]] |
[[Organisation Level ID Type.HL7 Assigning Authority]] as derived from PID-2.4 and PID-3.4 and [[Organisation Level ID Type.HL7 Type Code]] as derived from PID-2.5 and PID-3.5. |
Matching the type is a prerequisite for processing the corresponding Organisation Level ID. |
The corresponding Organisation Level ID is silently ignored. New types cannot be created via HL7 messaging. |
|
[[Team Level ID]] |
[[Team Level ID.Value]] as derived from PID-2.1 and PID-3.1 in conjunction with the specified [[Team Level ID Type]] |
No action. Any Team Level IDs already known will remain on the record. |
New [[Team Level ID]] added to the medical record. |
|
[[Team Level ID Type]] |
[[Team Level ID Type.HL7 Assigning Authority]] as derived from PID-2.4 and PID-3.4 and [[Team Level ID Type.HL7 Type Code]] as derived from PID-2.5 and PID-3.5. |
Matching the type is a prerequisite for processing the corresponding Team Level ID. |
The corresponding Team Level ID is silently ignored. New types cannot be created via HL7 messaging. |
|
[[Allergy]] |
[[Allergy.Allergen]] as derived from AL1-3 |
The matching [[Allergy]] is replaced with the new information. A partial update is not performed.
Note: Any allergies previously stored by this organisation, but which were not provided this time, will be deleted. |
A new [[Allergy]] is added to the medical record. |
|
[[Diagnosis]] |
[[Diagnosis.Diagnosis]] as derived from DG1-3 |
The matching [[Diagnosis]] is replaced with the new information. A partial update is not performed.
Note: Any diagnoses previously stored by this organisation, but which were not provided this time, will be deleted. |
A new [[Diagnosis]] is added to the medical record. |
|
[[Medication]] |
[[Medication.Substance]] as derived from ZRX-2 and [[Medication.Start Date]] as derived from ZRX-1.4.
Note: a match on both Substance and Start Date is sought first, but failing that a match on just Substance is accepted. |
The matching [[Medication]] is replaced with the new information. A partial update is not performed.
Note: Any medications previously stored by this organisation, but which were not provided this time, will be deleted. |
A new [[Medication]] is added to the medical record. |