Change Vehicle Management Group

Last updated
Save as PDF

changeVehicleManagementGroup

Change a vehicle's performance management group on the Services Portal in Performance Monitoring only.

void changeVehicleManagementGroup(AssetIdentifier vehicle, String vehicleManagementGroup) throws WSException

vehicle: An AssetIdentifier containing the SCAC and ID of the vehicle to be changed.
vehicleManagementGroup: A string that contains the identifier of the performance management group to which the vehicle belongs. Blanks are valid and indicate that the vehicle is not part of a management group.

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>

<changeVehicleManagementGroup>

<vehicle>

<id>A00003</id>

<scac></scac>

</vehicle>

<vehicleManagementGroup>SOUTHEAST</vehicleManagementGroup>

</changeVehicleManagementGroup>

</soap:Body>

Sample XML Response

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

<soapenv:Body>

<changeVehicleManagementGroupResponse/>

</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 Management invalid.