Updating or Removing Patient Allergies - HL7 Module - Foundation 23.1 - Foundation 23.1 - Ready - OnBase - Essential - Premier - Standard - external - Premier - Standard - Essential

HL7 Module

Platform
OnBase
Product
HL7 Module
Release
Foundation 23.1
License
Premier
Standard
Essential

By default, the Allergy Processor either adds or updates allergy information for a patient. Allergies already assigned to the patient's record are updated; allergies not yet assigned are added.

To remove a specific allergy from a patient's record, the HL7 message must provide a value of CR for the Processing Code 1 chart data field. The Processing Code chart data field must be mapped to a field in the same segment as the allergy information.

Note:

It is considered a best practice to map the Processing Code chart data field to the HL7 message template as a chart field override. As an alternative, you can map the Processing Code chart data field by configuring its HL7 Reference Field, but this value will be ignored if the Processing Code is mapped as a chart field override anywhere in the message template.

Supported processing codes are described in the following table:

Processing Code

Description

AJ

Adds the specified allergy to the patient's record if it is not already assigned. If the allergy is already assigned to the record, it will be updated with the information in the message.

This is the default action if no processing code is specified.

CA

Adds the specified allergy to the patient's record. If the allergy is already assigned to the record, then the incoming allergy will be assigned as a new allergy. If one of the allergies is not removed from the record, the allergy will appear twice on the record.

This behavior allows allergies to be removed and reassigned in place. For example, in a single HL7 message, one segment may use the CR code to remove a specific allergy from a patient's record, and another segment may use the CA code to add the same allergy with revised information.

CR

Removes the specified allergy from the patient's record.

1 This field may be named Allergy - Processing Code if OnBase was upgraded from an earlier version. The internal ID number for this field is 162.