HL7_DELIVERY_FAILED
HL7 agent did not deliver: what the HL7_DELIVERY_FAILED error means and how to fix it.
HTTP 502. Problem type: https://docs.ovok.com/errors/hl7-delivery-failed.
What this means
The connection's HL7 agent could not deliver a reading to the hospital system, most often because it cannot reach the receiver's MLLP address from inside the hospital network. You see this in the connection's delivery log, not in a user request.
Troubleshooting
- Check the agent's own log on the hospital's host for the reason, such as a refused or timed-out connection.
- Check that the connection's destination (
mllp://host:port) is the receiver's current address, and that the receiver is listening. - Wait for the next attempt. Ovok retries the delivery for about 34 minutes, so a short outage recovers on its own.
Retry safely
Retrying is safe. Every attempt sends the same message with the same control id (MSH-10), so the receiver can drop a repeat.
If the problem persists
Share the HTTP status, problem type, request path, response timestamp and traceId with your administrator or support contact. Remove access tokens, provider secrets and patient data first. The Error responses guide explains the response fields, and the machine-code registry lists every endpoint-specific type.
Last updated on