Page Comparison

...

• Port 7443. The PKB HL7 endpoint uses port 7443. This is a non standard port and may need to be added to your firewall rules.

  • HTTPS port 443 must be permitted to allow access to our REST and FHIR APIs.

Checking your TLS protocols and Ciphers

Ensure you are connecting to us (and can establish a handshake) using a supported TLS version and cipher by checking against our PKB SSL support report - https://www.ssllabs.com/ssltest/analyze.html?d=my.patientsknowbest.com

Whitelisting your production HL7 feed source IP(s) at PKB

...

If it connects successfully it will likely result in a black box with a flashing cursor – anything else would suggest a firewall issue still exists.

HL7 QRY A19 test

If the connectivity seems OK but you have an application, e.g. your TIE, which is not working correctly, you might like to try a direct connection from the command line using curl. This will help to narrow down where the problem lies. For example, the following is a simple QRY A19 which asks for a maximum of 1 patient records to be returned. Although in theory any HL7 message could be used, the benefit of a query message is that you do not need to send any data to your patient records to confirm the connection.

curl -v --connect-timeout 10 -u username:password https://sandbox.patientsknowbest.com:7443/services/hl7 --header "Content-Type:text/xml" -X POST --data \
$'<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wss="http://wsssl.hl7api.patientsknowbest.com/">soapenv><soapenv:Header/soapenv><soapenv:BodywssBody><wss:acceptMessage<arg0>acceptMessage><arg0>
MSH|^~\&amp;|SenderHello7||HL7API|PKB|2023101110324820231011162923+0100||QRY^A19|71e1361c38efef7a-1123461f-431e4de7-8def8fd8-96c0db7147ff1879d4fb0118|P|2.84
QRD|2023101110324820231011162923+0100|||b4975da40220d40c-faeb9a51-4df6446e-81558642-3d70694de660e43f161c3b6c|||1^RD||STA
</arg0></wss:acceptMessage></soapenv:Body></soapenv:Envelope>'