Skip to main content

HL7 Over HTTPS

AdvaPACS supports receiving HL7 messages passed via an API.

To use use this connectivity option, create an HL7 Service of type HL7 over HTTPS.

API​

Endpoint: POST https://<Region>.api.integration.advapacs.com/hl7/services/<Service ID>

You can also retrieve this API endpoint by viewing the HL7 Service you created and you can copy the URL from there.

You will need an API Key with the permission to Send HL7 over HTTPS.

The request body shall contain the HL7 message, formatted in either ER7 or XML. A Content-Type header of either application/hl7-v2+er7 or application/hl7-v2+xml shall be set. An Accept header of either application/hl7-v2+er7, application/json or application/hl7-v2+xml, application/json shall be set. The second Accept value is to allow any errors such as 401 Unauthenticated to be returned in JSON format.

The API will respond with a 200 status code and the response body shall contain an HL7 ACK, including if the ACK contains an error. If there is an error prior to HL7 processing such as Authentication or Authorization, then the response will be JSON with an appropriate HTTP status code.