Skip to main content
Omnitracs Knowledge Base

Web Service Details



Web Service URL  

The Unit Transfer Service is located at the following URL:

https://wsgw.omnitracs.com/autows/autows_v1_0
 

WSDL  

The WSDL is available for download at the same URL:

https://wsgw.omnitracs.com/autows/autows_v1_0?wsdl
 

Operations  

The web service contains only one operation ("Operation"). This operation is used for all requests to the Unit Transfer Service. Different request types are differentiated in the payload of the request in the SOAP body.

Please refer to the individual Request Types for more information.
 

Web Service Security  

The Unit Transfer Service follows the WS Security specification to identify requests from its various clients. Specifically, the UsernameToken Profile 1.0 is used. A unique username token is to be sent by each client making web service calls to the Unit Transfer Service. Though optional for the UsernameToken profile, a password is required in all web service calls.

The username and password are allocated by Omnitracs.
A sample SOAP envelope with security header is shown below:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:oid:1.3.6.1.4.1.1449.5.1">
   <soapenv:Header>
      <wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
         <wsse:UsernameToken wsu:Id="UsernameToken-4117493" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
            <wsse:Username>USERNAME</wsse:Username>
            <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">PASSWORD</wsse:Password>
            <wsse:Nonce>GK9BBK+/i34m3t8h3Arw6A==</wsse:Nonce>
            <wsu:Created>2010-11-01T04:22:02.089Z</wsu:Created>
         </wsse:UsernameToken>
      </wsse:Security>
   </soapenv:Header>
   <soapenv:Body>
     ... SOAP body goes here ...
   </soapenv:Body>
</soapenv:Envelope>​​​​​​​
  • Was this article helpful?