The GetSender webservice is intended retrieve a list of recently created orders for a specific lab/imaging facility connected to the application. Developers will be expected to pass in a valid TPS ID - this ID is used to identify the order location to receive results from. The webservice will respond with a list of available HL7 files.
Sample Request
<request> <security> <key>ClientUserID~ClientPassword~ClientDatabase</key> <version>1.0</version> <userid /> <account>AccountGUID</account> </security><tps_type_id>42</tps_type_id></request>
Request
The Request element will serve as a wrapper for the entire body of the XML request.
Request > Security
See documentation for the Security node here: Access to Webservices
Request > TPS_Type_ID
The TPS_Type_ID element will be a value that represents the unique order location to retrieve results from. This must be supplied to you by iSalus Healthcare.
Sample Response
No Results: When no results are available, the <Response> node will be empty.
<response xmlns="http://www.isalushealthcare.webservices/">
</response>
Results Available: When results are available, the <Response> node will contain the necessary HL7 files.
- TPS Send ID: This node is a unique ID for this result. This will be used in the iSalusTPS.SetSenderResponse webservice to confirm the successful pickup up this result.
- Data: This node will contain the full HL7 file for this lab.
<response><send_list><send_item><tps_send_id>12324</tps_send_id><data>HL7 FILE HERE</data></send_item></send_list> </response>
Error: When there is an error retrieving the results, and <Error> node will be returned with the appropriate code and description of the error.
<response xmlns="http://www.isalushealthcare.webservices/">
<error>
<code>1138</code>
<description>Failed to retrieve third party service sender information</description>
<log_id>350168</log_id>
</error>
</response>
