...
A popup as below usually indicates firewall access. There is no need to enter any credentials. If no popup is displayed then this could mean:
Your firewall has not been opened.
Your IP address has not been whitelisted by PKB (only applicable to production endpoint)
...
Telnet test
If you have telnet installed on your server then you can test connectivity to the HL7 endpoint port.
E.g.
telnet http://sandbox.patientsknowbest.com 7443
telnet nww.patientsknowbest.com 7443
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.
| Code Block |
|---|
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:Header/soapenv:Bodywss:acceptMessage<arg0>
MSH|^~\&|Sender||HL7API|PKB|20231011103248+0100||QRY^A19|71e1361c-1123-431e-8def-96c0db7147ff|P|2.8
QRD|20231011103248+0100|||b4975da4-faeb-4df6-8155-3d70694de660|||1^RD||STA
</arg0></wss:acceptMessage></soapenv:Body></soapenv:Envelope>' |