iSalusTPS.GetSender

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>