A lightweight Windows application for receiving, validating, and acknowledging HL7 messages over TCP (MLLP).
Built with .NET 8, NHapi, and a focus on clarity, diagnostics, and simplicity, ideal for local testing or integration development environments.
GitHub Release GitHub Downloads (all assets, all releases) GitHub Repo stars π¦ Run Tests
- β‘ Real-time HL7 listener β Receives messages via MLLP over TCP/IP.
- π§Ύ Structured message logging β Each inbound message is timestamped and stored in a designated folder.
- π Schema validation β Optional HL7 schema validation using configurable JSON definitions.
- π©Ί Automatic ACK generation β Builds version-specific acknowledgements (AA, AE, AR).
- πͺΆ Clean user interface β Simple, colour-coded status indicators and live message viewer.
- πΎ Session persistence β Remembers last used port and save location.
- π§ Tray mode β Minimise to the Windows system tray with quick Start/Stop controls.
- 𧩠Extensible design β HL7 parsing and validation implemented through modular, testable classes.
- Launch the application.
- Set the listening port and save location for incoming HL7 messages.
- Click Start to begin listening.
- Send HL7 messages to your configured port using your preferred HL7 sender or integration engine.
- Watch messages appear in the live log and message viewer panes.
- Stop or minimise to tray when finished.
- Option 1: Run the compiled
.exefrom the Releases page. - Option 2: Build the project from source using Visual Studio 2022 or later.
- Requires
.NET 8 SDK - Recommended: Windows 10 or later
- Requires
If you need assistance or want to learn more, check out the Wiki within this repository.
It includes guides on:
- Understanding the schema system
- Configuring validation rules
- Testing with HL7 senders
- Troubleshooting connection or ACK issues
If you discover a bug or have a feature request, please open a new issue in the
Issues section of this repository.
Powered by NHapi, .NET 8, and a clinically precise cup of coffee β