Skip to main content
Omnitracs Knowledge Base

Delete Driver

deleteDriver

Deletes a driver entry on the Services Portal given a driver identifier. Driver group membership (from both adhoc and management groups) is terminated as well. Performance history is not deleted when a driver is deleted, nor is historical key performance measurement data removed from the cube. The driver is deleted from both QTRACS and Performance Monitoring.

void deleteDriver(String driverId) throws WSException

  • driverId: A string containing a unique driver identifier.

 

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 set up drivers
OR
- Can use Performance Monitoring
- Can maintain vehicles and drivers

- 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>

   <deleteDriver>

      <driverId>JADAMS</driverId>

   </deleteDriver>

</soap:Body>



 

 

Sample XML Response

 

An empty response conveys success. If there was an error, an exception would have been thrown.

<soapenv:Body>

   <deleteDriverResponse/>

</soapenv:Body>



 

 

Exceptions

 

001 Unknown Error.
002 Required field not specified.
003 Company not authorized for integration.
004 User is not authorized.
005 Driver does not exist.
006 Driver logged on to a vehicle.
007 Driver is pending deletion.

  • Was this article helpful?