DH HL7 Interfaces for SIU and ADT Messages

DH HL7 Interfaces for SIU and ADT Messages

About HL7 File Importing with Dialog Health


For most clients, the Scheduling information provided in the SIU files provide the necessary Patient and Appointment information necessary to facilitate on-going messaging.  Dialog Health can additionally support the delivery of ADT messages should the delivery of Discharge information and more up-to-date Patient Demographics also need to be delivered.  The key Patient and Appointment data fields of interest to be mapped to Dialog Health are as follows:

About Sending HL7 to DH

Dialog Health supports the delivery of HL7 Messages via either SFTP or TCP/IP

SFTP - Dialog Health’s own FTP Server provides a scalable and secure option for those Clients and Partners who wish to automate the delivery and import of CSV Files
  1. Leverages Port 22 and IP White-Listing
  2. The Dialog Health IT Team will work with your team to confirm the formatting of your CSV Files
  3. Additionally, this team will provide you with confidential login credentials, unique console codes and your directory hierarchy to ensure the successful import of your data
  4. Dialog Health will require the IP, or range of IP’s, from within your organization which will be sending your data. These IP’s will be white-listed on our servers for security purpose  
TCP/IP - The Internet protocol suite, commonly known as TCP/IP, is the set of communications protocols used in the Internet and similar computer networks. The current foundational protocols in the suite are the Transmission Control Protocol and the Internet

About Patients Information Requested:

    1. Last Name (Required to add Patient)
    2. First Name (Required to add Patient)
    3. Mobile Phone Number (Required to add Patient)
    4. Patient ID (Required to enable Updating & Deleting)
    5. Date of Birth
    6. Additional Phone Number
    7. Address Information, if available
      1. Address 1
      2. Address 2
      3. City
      4. State
      5. Postal Code
    8. Patient Miscellaneous 1 – an available field for Patient Information

About Appointment/Visit Information Requested:

    1. Appointment Name (Required to add Appointment)
    2. Appointment Date (Required to add Appointment)
    3. Appointment Start Time (Required to add Appointment)
    4. Appointment ID (Required to Update and Delete Appointments)
    5. Appointment Location
    6. Appointment Status
    7. Appointment Provider (e.g. Doctor Names)
    8. Appointment Miscellaneous Fields
      1. Appointment Miscellaneous 1
      2. Appointment Miscellaneous 2
    9. Appointment Notes

About Sending SIU Messages:


SIU Message Triggers Accepted by Dialog Health:
  1. SIU-S12 – Notification of new appointment booking
  2. SIU-S13 – Notification of appointment rescheduling
  3. SIU-S14 – Notification of appointment modification
  4. SIU-S15 – Notification of appointment cancellation
  5. SIU-S17 – Notification of appointment deletion
  6. SIU-S26 – Notification that patient did not show up for scheduled appointment

SIU Sample Messages:

HL7 Messages - Additional Information
§  Dialog Health’s Console Code should be sent in PV1 Seq. 3
§  Dialog Health’s Console Code will be provided during Setup
§  For Clients messaging to Patient independent of their Scheduled Appointments, ADT File Importing can be configured.

About ADT and Triggers

  1. ADT messages carry patient demographic information for HL7 communications but also provide important information about trigger events (such as patient admit, discharge, transfer, registration, etc.). When a patient's record is updated, an ADT message is sent.

ADT example:


    • Related Articles

    • DH Trigger SMS API

      Introduction Trigger is a message to one particular person which can be set up for a client and sent on demand as API call. The trigger works only for known patients/employees, who are already registered in Dialog Health database. Triggers can be ...

    • DH Send SMS API

      Access HTTP Basic Authentication basic Endpoints https://[dialoghealth-server]/dialoghealth-simplepay-api/ Silent opt-in and message delivery submit POST /submit/{console-code} Parameters Path Parameter Name Description Required Pattern ...

    • DH Message Results Writeback API

      DH Message Results Writeback API Access · HTTP Basic Authentication basic Endpoints https://[dialoghealth-server]/dialoghealth-writeback-api/ ApiController responses GET /api/responses/{consoleCode}/{startTimestamp}/{endTimestamp} Parameters Path ...

    • DH Patient and Appointment REST XML API

      Access HTTP Basic Authentication basic Endpoints https://[dialoghealth-server]/dh-integration/rest/ Import Patients' data POST /import/protocall/authbase/{CONSOLE-CODE} Content Type application/xml; charset=utf-8 Parameters Request Body - XML ...

    • DH Patient & Visit SOAP API Specifications

      Endpoints http://[dialoghealth-server]/dialoghealth-source-api/soap/DataShare http://[dialoghealth-server]/dh-integration/soap/DataShare Target namespace: https://www.dialoghealth.com/ DataShareSoapBinding getReturnCodeStr POST /GetReturnCodeStr ...