Skip to main content
Omnitracs Knowledge Base

Rename Driver

renameDriver

Given a driver ID, new driver ID and optional company ID, this web service changes the ID of the specified driver. Note that if a driver is currently logged into a vehicle, the driver will be logged off.

void renameDriver(String companyId, String driverId, String newDriverId} throws WSException

  • companyId: (optional) A string of maximum length 10 that specifies the unique company identifier. If no company is specified, the company of the authorized user will be used.
  • driverId: A string of maximum length 10 that specifies the unique driver identifier.
  • newDriverId: A string of maximum length 10 that specifies the new 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
- 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>

   <renameDriver>

      <companyId>MYCOMPANY</companyId>

      <driverId>JSMITH</driverId>

      <newDriverId>JOHNS</newDriverId>

   </renameDriver>

</soap:Body>

Sample XML Response

<soapenv:Body>

   <p861:renameDriverResponse xmlns:p861="http://websvcs.qtracswebws"/>

</soapenv:Body>

Exceptions

001 Unknown Error.
003 Company not authorized for integration.
004 User not authorized.
005 Invalid company id.
006 Invalid driver id.
007 Invalid new driver id.
008 Delete driver action pending.
009 New driver id already exists.
010 New driver id already exists in Performance Monitoring.

  • Was this article helpful?