Skip to main content

​
HL7 Connectivity Providers Client

A Java desktop application for healthcare providers to manage patient eligibility verification, service registration, and cancellations through HL7 messaging protocols.

Get StartedAPI Reference

​
Quick Start

Get up and running with the HL7 client in minutes

1

Build the application

Clone the repository and build the JAR file using Maven:
git clone https://github.com/deltalogan/hl7-connectivity-providers-client.git
cd hl7-connectivity-providers-client
mvn clean package
The build creates a shaded JAR with all dependencies at target/connectivity-providers-client-1.0-SNAPSHOT.jar
2

Launch the client

Run the application with Java 8 or higher:
java -jar target/connectivity-providers-client-1.0-SNAPSHOT.jar
The login screen will appear where you can select your environment and enter credentials.
3

Authenticate

Enter your credentials in the login form:
  • Email: Your provider account email
  • Password: Your account password
  • API Key: Your organization’s API key
  • Environment: Select DEV, STAGING, or PRODUCTION
The client automatically manages session tokens and refreshes authentication before expiration.
4

Process HL7 transactions

Once authenticated, use the main interface to:
  • Check eligibility: Verify patient coverage and benefits
  • Register services: Submit service claims with detailed items
  • Cancel registrations: Cancel previously submitted claims
All operations return structured HL7 responses with validation results.

​
Key Features

Everything you need for healthcare provider connectivity

HL7 Messaging

Complete implementation of eligibility, registration, and cancellation workflows with automatic error handling and validation.

Session Management

Automatic token refresh, multi-environment support, and graceful session expiration handling for uninterrupted workflows.

Dental Module

Comprehensive dental benefit calculations with surface-level detail, piece tracking, and rule-based validation engine.

Modern UI

Built with FlatLaf for a native look and feel with customizable themes, date pickers, and responsive layouts.

​
Explore by Topic

Deep dive into specific areas

Authentication

Learn how login, logout, and token refresh work

Configuration

Configure environments and connection settings

Architecture

Understand the client’s internal structure

Building

Build and package the application

API Client

Low-level HTTP client and auth refresh

Result Types

Handle success, error, and partial results

​
Ready to get started?

Follow the quickstart guide to build and run the HL7 client in your environment.

View Quickstart Guide

Build docs developers (and LLMs) love

Get started for freeTalk to us