HL7_TIMEOUT
HL7 agent timed out: what the HL7_TIMEOUT error means and how to fix it.
HTTP 504. Problem type: https://docs.ovok.com/errors/hl7-timeout.
What this means
No HL7 agent answered within 10 seconds when Ovok sent a reading for this connection. Most often the agent is offline: stopped, or its host lost its outbound HTTPS connection. You see this in the connection's delivery log, not in a user request.
Troubleshooting
- Check the connection's agent status with
GET /v1/hl7-connections/<id>.disconnectedmeans the agent is not signed in. - Restart the agent on the hospital's host, and check that the host can reach the Ovok API over HTTPS (443).
- Wait for the next attempt once the agent is back. Ovok retries for about 34 minutes, so a short outage recovers on its own.
- For a longer outage, resend the readings that were missed once the agent is connected again.
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