Skip to main content
Omnitracs Knowledge Base

Create Vehicle Management Group

createVehicleManagementGroup

Given an Id and description, this web service creates a vehicle management group. The management group is presently a Performance Monitoring construct only.

void createVehicleManagementGroup(String vehicleManagementGroupId, String vehicleManagementGroupDescription) throws WSException

  • vehicleManagementGroupId: A string of maximum length 10 that contains the unique identifier of the vehicle management group to be created.
  • vehicleManagementGroupDescription: A string of maximum length 50 that contains the description of the vehicle management group to be created.

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

Required User Permissions
- Can use Performance Monitoring
- Can maintain vehicles and drivers

Sample XML Request

Only the SOAP body is shown. To see a sample SOAP Envelope and Header, click here.

<soap:Body>

 <createVehicleManagementGroup>

    <vehicleManagementGroupId>SOUTHEAST</vehicleManagementGroupId>

    <vehicleManagementGroupDescription>Southeast Management Group</vehicleManagementGroupDescription>

 </createVehicleManagementGroup>

</soap:Body>

Sample XML Response

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

<soapenv:Body>

   <p431:createVehicleManagementGroupResponse xmlns:p431="http://websvcs.stracswebws"/>

</soapenv:Body>

Exceptions

001 Unknown Error.
003 Company not authorized for integration.
004 User not authorized.
005 Invalid vehicle management group id.
006 Invalid vehicle management description.

  • Was this article helpful?