Change Vehicle Parameter Type

Last updated
Save as PDF

changeVehicleParmType

Change a Performance Monitoring vehicle's parameter type and send parameters to the mobile device.

void changeVehicleParmType(AssetIdentifier vehicle, String vehicleParmType) throws WSException

vehicle: An AssetIdentifier containing the SCAC and ID of the vehicle to be changed.
vehicleParmType: A string that contains the vehicle's SensorTRACS parameter type. The parameter type must already exist.

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 Performance Monitoring
- Can maintain vehicles and 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>

<changeVehicleParmType>

<vehicle>

<id>TRUCK10</id>

<scac></scac>

</vehicle>

<vehicleParmType>VAN</vehicleParmType>

</changeVehicleParmType>

</soap:Body>

Sample XML Response

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

<soapenv:Body>

<changeVehicleParmTypeResponse/>

</soapenv:Body>

Exceptions

001 Unknown Error.
002 Required field not specified.
003 Company not authorized for access through integration.
004 User is not authorized.
005 Vehicle invalid.
006 Vehicle Parameter Type invalid; or an extract is currently pending from specified vehicle
007 Cannot change vehicle parameter type for a vehicle without a device.