Web Service Details
Web Service URL
The Unit Transfer Service is located at the following URL:
WSDL
The WSDL is available for download at the same URL:
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>