• Supported Transfer Protocol
• File Format
• Spec Table
• Field Naming / Placeholders

Supported Transfer Protocol

FormDr supports SFTP (Secure File Transfer Protocol) for HL7 exports.
You can configure the connection using either:

• SSH key file, or

• Username and password credentials.

This integration is compatible with any provider that supports HL7 v2.x.

Accessing HL7 Configuration

1. From the main menu, go to Integrations.
   (Navigation: Main Menu → Integrations)

  2. Open the HL7 configuration tile and select the forms you want to include in the export.
      You can also define the export frequency (e.g., daily, weekly, or custom schedule).

SFTP Configuration

Enter your SFTP connection details, including:

• Host address
• Port
• Username and password or key file

Provider and Receiver Information

Next, set up the default provider and receiver details for the HL7 message:

• Provider Info: Information about your practice or sending entity

• Receiver Info: Details about the system or organization receiving the data

Exporting HL7 Data

Once all configuration details are saved, FormDr will:

• Automatically generate the HL7 file on the selected schedule, and

• Deliver it to your configured SFTP directory.

You can also manually trigger an export at any time:

• Test Connection: Verify that your SFTP credentials are valid and the folder is accessible.

• Export Now: Immediately generate and send the HL7 file without waiting for the next scheduled run.

File Format

FormDr supports data export in HL7 v2.x format, following industry-standard specifications for healthcare data exchange.

Below is an example of a sample HL7 file generated by the FormDr platform:

MSH|^~\&|SendingApp|SendingFacility|ReceivingApp|ReceivingFacility|Prod(P)or
Test (T)||ORU^R01|||
PID|1|PatientSSD or Id
Num.|||PatientLastN^PatientFirstN|PatientMothersName|DOBYYYYMMDD|sex|alias|race|street^other^city^state^zip^country|
PV1|1|O|||||ProviderNPI^ProviderLastN^ProviderFirstN|
TXA|1|ReportUUID^ReportName|AP||ProviderId^ProviderMnemonic|CurrentDateYYYYMMDD|ResultDate-YYYYMMDD|||||ReportUUID|||||IP|
OBX|1|ED|PDFReport||^^^^base64-pdf-file-content-here
OBX|2|ST|Text|height|[[patientHeight]]|
OBX|3|ST|Text|weight|[[patientWeight]]|
OBX|4|ST|Text|BMI|[[patientBMI]]|
OBX|5|ST|Text|bloodPressure|[[patientBP]]|
OBX|6|ST|Text|heartRate|[[patientBPM]]|
OBX|7|ST|Text|spO2|[[patientSpO2]]|
OBX|8|ST|Text|pulseRate|[[patientPulse]]|
OBX|9|ST|Text|temperature|[[patientTemp]]|

Spec Table

Field Naming / Placeholders

Once you named a form field as one of the following place holders, the FormDr routines will be able to pick up the field value and inject it inside the generated HL7.

Supported fields: