SOAPwareXchangeHL7 User Guide

The SOAPwareXchangeHL7 interface is used to process lab, pathology, radiology, even transcription reports, and have them automatically filed into the patient's chart in SOAPware from HL7 compliant messages. The module reads the demographic information in the report, finds the matching chart in SOAPware, transfers the report, and notifies the provider all automatically.

Here you will find a brief walk through for setting up and using the SOAPwareXchangeHL7. For help installing, visit the Install/Update lesson.

Ensure the SOAPwareXchangeHL7 is Open and Started

Ensure the SOAPwareXchangeHL7 is Open and Started

The SOAPwareXchangeHL7 must be open in order to process results. This requires you log in, just as you would with SOAPware. You will also have to click the Start button, in order to allow results to process into SOAPware. If  you turn off the computer where the HL7 is located, you must open it again once the computer has been restarted.

*Note: Both the SOAPwareXchangeHL7 and SOAPwareXchange may be setup to auto-start by following the instructions here.

Ensure the Source Folder is set Correctly

Ensure the Source Folder is set Correctly

The majority of HL7 interfaces will be via a FTP connection, meaning that the participating lab(s) will be delivering results to a shared folder, and this is often the same machine that the SOAPwareXchangeHL7 is installed on.  Make sure the Source is selected and the port is set as 0. If you are not sure where the results are being delivered, contact your lab's technical support.

A few labs will be delivering results via TCP/IP rather than to a shared folder.  In this case, the source will be left blank and a port # will be indicated. If you are not sure how the results are being delivered, contact your lab's technical support. The maximum port number allowed is 32000.

Check for Unrecognized Messages

Check for Unrecognized Messages

If labs are not showing up in SOAPware, they could be located in Unrecognized Messages. In SOAPwareXchangeHL7, go to Mappings > Edit/View Unmapped Messages. If this is the case, it will be necessary to contact SOAPware Support to obtain a modified file that is necessary to allow reports to process.  

Check for Unmatched Patients/Physicians

Check for Unmatched Patients/Physicians

It is also important to watch for unmapped patients/physicians. If either say YES, you must match them under Mappings > Edit/View Unmatched Patients, as in this case.

Select the unmatched item, Click Map, and Select the patient from the chart rack.

You can also use the SOAPwareXchangeHL7 Remote Management Utility to attend to unmatched items similarly to how you would from the XchangeHL7 interface. This Utility is automatically installed with SOAPwareXchangeHL7.  See screen shot below.

Additional options

Each report that is generated by the SOAPwareXchangeHL7 is automatically assigned a task item in the SOAPware Task list and assigned to the ordering provider.

Another option found in the SOAPwareXchangeHL7 are the Task Status Settings. This gives you the ability to select what type of action status each task item will be set as in the SOAPware Task list for normal and abnormal results. Go to Settings - Advanced - Task Status Settings.

Here you will be able to choose the action status for both normal and abmormal results. This includes and custom action status you have created in your SOAPware.

SOAPWareXchange HL7 Remote Management Utility

SOAPWareXchange HL7 Remote Management Utility

The SOAPwareXchangeHL7 Remote Management Utility is also installed whenever you install the SOAPwareXchangeHL7 application. This utility can be useful if you wish to assign the task of maintaining patient mappings to a user/computer other than the one where actual messages are being delivered and processed. An example would be if you receive HL7 messages to your server, but wish to assign the patient mappings task to a client machine.

Review the Report in SOAPware

Once processed, the provider will be assigned a task list item from where they can open the patients chart, and report.

Example of Generic Lab Report

Example of Generic Lab Report

Above is an example of a generic lab report. While most results will be pulled into the Labs chart section, some may also pull results into the Radiology or Pathology sections, depending on the interface used.

Printing Reports

Printing Reports

Often times, it is necessary to print out or send reports via PDF out of SOAPware. To easily accomplish this, you may use the Share Charts feature in SOAPware. This feature allows you to print multiple reports from a specific section of SOAPware, for a specific patient. Refer to the Share Charts article for more details.