Change Vehicle Name

Last updated
Save as PDF

changeVehicleName

Change a vehicle's name in the Services Portal. The name is changed in both QTRACS and Performance Monitoring.

void changeVehicleName(AssetIdentifier vehicle, String vehicleName) throws WSException

vehicle: An AssetIdentifier containing the SCAC and ID of the vehicle to be changed.
vehicleName: A string containing a description of the vehicle.

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 vehicles
- Can see data for all assets OR the vehicle must be in the user's coverage or global group

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>

<changeVehicleName>

<vehicle>

<id>TRUCK10</id>

<scac></scac>

</vehicle>

<vehicleName>ABCD Truck 10</vehicleName>

</createVehicleName>

</soap:Body>

Sample XML Response

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

<soapenv:Body>

<changeVehicleNameResponse/>

</soapenv:Body>

Exceptions

001 Unknown Error.
002 Required field not specified.
003 Company not authorized for integration.
004 User is not authorized.
005 Vehicle invalid.
006 Vehicle Name invalid.