Get Driver Login Information

Last updated
Save as PDF

getDriverLoginInfo

Given a driver identifier and a timestamp, this web service returns the vehicle to which the driver was logged in (if any) at that time.

AssetIdentifier getDriverLoginInfo(String driverId, String driverLoginTS) throws WSException

driverId: A string containing a unique driver identifier.
driverLoginTS: A string that contains a timestamp expressed in the following format in GMT timezone: yyyy-mm-ddThh:mm:ssZ.

Returns a null string on exceptions; otherwise returns an AssetIdentifier object.

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
- Can see drivers

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>

<getDriverLoginInfo>

<driverId>JADAMS</driverId>

<driverLoginTS>2009-12-01T14:58:01Z</driverLoginTS>

</getDriverLoginInfo>

</soap:Body>

Sample XML Response

<soapenv:Body>

<getDriverLoginInfoResponse>

<getDriverLoginInfoReturn>

<id>OAKSTMCT</id>

<scac>ABCD</scac>

</getDriverLoginInfoReturn>

</getDriverLoginInfoResponse>

</soapenv:Body>

Exceptions

001 Unknown Error.
002 Required field not specified.
003 Company not authorized for integration.
004 User is not authorized.
005 Driver ID invalid.
006 Driver Login Timestamp invalid.
007 Driver not logged into a vehicle at specified time.