HL7

Last updated
Save as PDF

About HL7

The Homecare Health Level Seven (HL7) interface is a standard messaging format for passing information from system to system. HL7 message processing includes the ability to process both inbound messages and outbound messages.

Currently, Homecare can handle seven message types: admission, transfer, discharge, register, add, update, and charge. An ACK/NACK message is returned for all incoming messages.

HL7 Inbound Charge Report

This report shows all inbound charges that have been processed through the HL7 interface within a selected date range. All records that have been inserted by the HL7 user ID and have not been verified appear in the report.

Inbound HL7 Message Processing Window

All inbound messages appear in the Inbound HL7 Message Processing window for review. Messages appear as they are received. Click on individual message lines to view and edit individual messages. You can refresh the HL7 Inbox by pressing F5.

To group data, click on a column heading and drag it to the area above the columns. Each unique value in the column appears as a single line item in the Inbox. Messages for each value appear under that value. You can also add columns to the area above the columns. To ungroup data, click the column that is now in the area above the columns and move it back with the other columns.

To sort data, click on a column heading. The rows sort in alphabetical order by the column you clicked.

To filter based on Data Set Name, Patient Name, Patient Master ID, or Social Security Number, select the drop-down arrow in the column. The default is All, which does not filter any data. To filter data, select a value or Custom. If you select Custom, the Custom Filter Window appears.

Complete the Custom Filter window and click OK. Information about the filter appears at the bottom of the screen. A description of the filter appears. You can uncheck the filter to activate it and check it again to inactivate it. If you click the exit button, the filter is removed. If you click Customize, the Filter builder window appears.

Inbox Column Headings

Status

•	N: Not Started - processing of the message has not been started by user.

•	D: Declined - user has declined the message.

•	X: Cancelled - user has cancelled the message.

•	C: Complete - user has completed the message.

>	Data Status

•	E: Error - the latest validation of the message resulted in errors. Messages with errors cannot be completed.

•	W: Warning - the latest validation of the message resulted in no errors, but with warnings. Messages with warnings and no errors may be completed.

•	S: Success - the latest validation of the message resulted in no errors or warnings. Messages with no warnings or errors may be completed.

>	Type: The standard HL7 message type.

>	Accept date: The date and time that the inbound HL7 message was accepted by Homecare.

>	Business Unit Name: The Allscripts Homecare Business Unit to which the patient referenced in the message belongs.

>	Patient Name: The name of the patient who is the subject of the message.

>	Pt Master ID: The master ID number of the patient who is the subject of the message.

>	SSN: The Social Security number of the patient who is the subject of the message.

>	Processed By: The Homecare operator ID of the user who processed the message.

>	Processed date: The date and time that the inbound HL7 message was processed by Homecare.

View HL-7 Inbound Messages

1.	Open the Interface component.

2.	From the HL-7 menu or the Outlook bar, select HL7 Inbound Message Processing.

The HL7 Inbound Processing window appears with messages appearing in the order they were received.

3.	Double-click a message or click the Edit Message button.

The Edit HL7 Message Data window appears.

Edit HL7 Inbound Message

1.	Open the Interface component.

2.	From the HL-7 menu or the Outlook bar, select HL7 Inbound Message Processing.

The HL7 Inbound Processing window appears.

3.	Double-click a message or click the Edit Message button.

The Edit HL7 Message Data window appears.

4.	For each tab in the Edit HL7 Message Data window, edit the values as necessary to correct the errors and warnings.

5.	Click Validate to determine if the message is now valid.

•	If the message passes validation, proceed to step 6.

•	If the message contains errors, an Error window appears. Go back to step 4.

6.	Click Save to save the information you edited to Homecare.

Sort HL7 Inbound Messages in Your Inbox

1.	Open the Interface component.

2.	From the HL-7 menu or the Outlook bar, select HL7 Inbound Message Processing.

The HL7 Inbound Processing window appears with messages appearing in the order they were received.

3.	Click and hold the column header you want to sort by (Status, Type, etc.), and drag it into the dark gray area above the column headers. Green arrows appear to point you to where to drag the header.

4.	Release the mouse button.

The header remains in the dark gray area and the messages in the inbox appear sorted in alphabetical order by that heading.

Filter Inbound Messages

1.	Open the Interface component.

2.	From the HL-7 menu or the Outlook bar, select HL7 Inbound Message Processing.

The HL7 Inbound Processing window appears.

3.	Click the drop-down arrow on the Business Unit Name, Patient Name, Patient Master ID, or SSN (Social Security Number) column header and select Custom.

The Custom Filter window appears.

4.	Complete the fields as appropriate.

Click OK.

A description of the filter appears in a dark gray bar at the bottom of the HL7 Inbound Processing window.

6.	Click in the check box to deselect it if you want to deactivate the filter, or click to select it to activate the filter.

7.	Click the X to the left of the check box to remove the filter.

8.	Click Customize to add new conditions to the filter.

Send an HL7 Message to a Recipient

1.	Open the Interface component.

2.	From the HL-7 menu or the Outlook bar, select HL7 Outbound Message Processing.

The HL7 Outbound Message Processing window appears.

3.	Enter a start date and an end date, or click and select them.

Applicable messages appear in the grid.

4.	Select the needed check boxes in the Use column next to the messages to be sent.

5.	Click in the Destination field and select a destination.

Outbound HL7 Message Processing Window

To process outbound messages, complete the fields to set the criteria for outbound messages in the queue to be processed. See Outbound Message Processing.

Process Outbound Messages

1.	Open the Interface component.

2.	From the HL-7 menu or the Outlook bar, select HL7 Outbound Message Processing.

The HL7 Inbound Processing window appears.

3.	Enter a Start Date and an End Date for messages in the queue to be processed, or click and select them.

4.	Click to select a destination.

5.	Click the check boxes to select the message types you want to process.

6.	Click Next.

7.	Expand the message types and select individual messages to process, or click Select All to process all messages.

8.	Click Process.

The HL7 Outbound Processing report window appears.

9.	Click to print the report, or click Close to return to the Outbound HL7 Message Processing window.

Outbound HL7 Message Status Report

This report shows all outbound messages that have been processed through the HL7 interface within a specified date range. You can select which message statuses to include in the report. Records in the report are grouped by message status and message type. Within these groups, records are ordered by patient ID. See also Generating Outbound HL7 Message Status Report.

Preview or Print an HL7 Inbound Charge Report

1.	Open the Interface component.

2.	From the HL-7 menu or the Outlook bar, select HL7 Inbound Charge Report.

The HL7 Inbound Charge Report window appears.

3.	Enter a Begin Date for the report, or click and select it.

4.	Enter an End Date for the report, or click and select it.

5.	Click the Preview tab to view an onscreen preview of the report based on the parameters you entered.

6.	Click to print the report, or click Close to return to the HL7 Inbound Charge Report window.

Preview or Print an Outbound HL7 Message Status Report

1.	Open the Interface component.

2.	From the HL-7 menu or the Outlook bar, select Outbound HL7 Message Status Report.

The Outbound HL7 Message Status Report window opens.

3.	Specify the Begin Date for the report.

4.	Specify the End Date for the report.

5.	Check the message statuses to include in the report, or click Select All to include all message statuses in the report.

6.	Click the Preview tab to view an onscreen preview of the report based on the parameters you entered.

7.	Print the report or click Close to return to the Outbound HL7 Message Status Report window.

Patients in HL7 Status Report

This report shows all patients that currently have an HL7 type status code assigned. The report is grouped by status code and class, and then ordered by patient name.

Preview or Print Patients in HL7 Status Report

1.	Open the Interface component.

2.	From the HL-7 menu or the Outlook bar, select Patients in HL7 Status Report.

The Patients in HL7 Status Report window appears.

3.	Enter an As of Date for the report, or click and select it.

4.	Click the Preview tab to view an onscreen preview of the report based on the parameters you entered.

5.	Click to print the report, or click Close to return to the Patients in HL7 Status Report window.