Get Vehicle Unit Address (UA)

Last updated
Save as PDF

getVehicleUA

Given a vehicle identifier, returns the UA (unit address) of the mobile communications terminal or mobile computing platform that is currently assigned to the vehicle.

String getVehicleUA(AssetIdentifier vehicle) throws WSException

vehicle: A QTWebServices AssetIdentifier containing the SCAC and ID of the vehicle whose mobile terminal unit address is to be returned.

Returns a null string on exceptions; otherwise returns a string containing the Vehicle UA.

Authorization Requirements

The credentials supplied with this method call (as specified in the accompanying WS-Security header) must be authorized to the following application(s) and their associated role-based permissions.

Required Application Licenses
- Remote Integration

Required User Permissions
- Can use QTRACS

Customer integrators are authorized to their own company's data only.

Sample XML Request

Only the SOAP body is shown. To see a sample SOAP Envelope and Header, click here.

<soap:Body>

<getVehicleUA>

<vehicle>

<id>OAKSTMCT</id>

<scac></scac>

</vehicle>

</getVehicleUA>

</soap:Body>

Sample XML Response

<soapenv:Body>

<getVehicleUAResponse>

<getVehicleUAReturn>0049712572</getVehicleUAReturn>

</getVehicleUAResponse>

</soapenv:Body>

Exceptions

002 Required field not specified.
003 Company not authorized for access through integration.
004 User is not authorized.
005 SCAC is required.
006 SCAC is invalid.
007 Vehicle ID is required.
008 Vehicle not found.