Please Wait...

Get Started

SOAP

SOAP is an established standard and widely used as a tool for server-to-server and client-to-server communications. A basic understanding of Web Services and SOAP is required by the user. No attempt to document SOAP is provided here.

To access the WSDL file, which documents all of the SOAP calls available to Guardian users, can be downloaded from here

Note: Access to Web Services on test or production servers requires that the service be enabled for your company’s account.

Tools

There are many automated tools available that can read the WSDL file, and provide a testing interface prior to any development:

  • A free desktop package for any platform SoapUI
  • A quick and simple web based tester soapclient

Note: we recommended to utilize these testing tools to determine what data is needed and confirm connectivity and operability with our system. Your company can then use any development environment desired to create your Web Service calls to Guardian.

Sample Web Service Call to insert a new employee

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <mns:WS_pmitNewHire xmlns:mns="LLX_Guardian">
      <inComKey xsi:type="xsd:int">1</inComKey>
      <inComPW xsi:type="xsd:string">password</inComPW>
      <inEmpData SOAP-ENC:arrayType="xsd:string[13]">
        <item1>Last=Doe</item1>
        <item2>First=Jane</item2>
        <item3>Middle=G</item3>
        <item4>Address1=500 Elm Street</item4>
        <item6>Apartment=5A</item6>
        <item7>City=Phoenix</item7>
        <item8>State=AZ</item8>
        <item9>Zip=85028</item9>
        <item10>DOB=01-APR-1972</item10>
        <item11>Social=123456789</item11>
        <item12>DateHired=31-MAR-2009</item12>
        <item13>ID=675443</item13>
      </inEmpData>
    </mns:WS_pmitNewHire>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Sample Response

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
    <ns1:WS_pmitNewHireResponse xmlns:ns1="LLX_Guardian">
      <outResultCode xsi:type="xsd:int">0</outResultCode>
      <outResultMsg xsi:type="xsd:string">Employee Inserted</outResultMsg>
    </ns1:WS_pmitNewHireResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>