Home
Hey there! 👋
If you’ve just stumbled across this project — welcome aboard!
The HL7 Message Server is a lightweight, no-fuss way to receive, validate, and acknowledge HL7 messages locally without needing a full-blown integration engine or enterprise stack.
It’s perfect for developers, testers, and integration engineers who want to:
- Test HL7 messages quickly 🧪
- Validate messages against a schema 🧩
- Watch the full send → receive → ACK flow in real-time ⚡
- Listens for incoming HL7 messages on a TCP port
- Parses and validates messages using NHapi
- Automatically generates ACK responses
- Saves messages and ACKs as
.hl7files - Provides a clean UI with real-time colour-coded logs
- Minimizes to tray and keeps running quietly in the background
Use the links in the sidebar to jump straight to a topic, or start here:
| Section | Description |
|---|---|
| Installation | How to install and run the app |
| Usage | How to use the interface and send HL7 messages |
| Schema Validation | Understanding how validation works |
| Acknowledgements (ACKs) | What ACKs mean and how they’re built |
| Settings | Configuration, ports, and folders |
| Tray Mode | Running quietly in the system tray |
| Troubleshooting | Fixing common errors |
| Developer Docs | Architecture and extensibility for devs |
- C# (.NET 8.0)
- NHapi for HL7 parsing
- Windows Forms (WinUI)
- JSON schema validation
If something’s broken, confusing, or you just want to chat about HL7 things (we’ve all been there), you can:
- Check the Wiki (yep, you’re here already)
- Open an Issue in the Issues tab
- Or raise a PR if you’ve got a cool idea to add!
This tool was built to make HL7 message testing simple, visual, and frustration-free.
If it saves you time, gives you a smile, or makes debugging less painful — mission accomplished.