Skip to main content
Omnitracs Knowledge Base

Change Vehicle License Plate Info

changeVehicleLicensePlateInfo

This web service allows the a vehicle's license plate information to be changed.

void changeVehicleLicensePlateInfo(String companyId, AssetIdentifier vehicle, LicensePlate licensePlate) throws WSException

  • companyId: A string of maximum length 10 that specifies the unique company identifier.
  • vehicle: An AssetIdentifier object containing the SCAC and ID of the vehicle whose identification information is to be returned.
  • licensePlate: A LicensePlate object containing the number and jurisdiction of the license plate. NOTE: license plate jurisdiction will no longer be required in upcoming Services Portal 3.8 release (1st quarter 2021).

 

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>

    <changeVehicleLicensePlateInfo>

        <companyId>MYCOMPANY</companyId>

        <vehicle>

            <id>EON01</id>

            <scac></scac>

        </vehicle>

        <licensePlate>

            <number>FHN3423</number>

            <jurisdiction>US-PA</jurisdiction>

        </licensePlate>

    </changeVehicleLicensePlateInfo>

</soap:Body>

 

Sample XML Response

 

<soapenv:Body>

    <changeVehicleLicensePlateInfoResponse/>

</soapenv:Body>

 

Exceptions

 

002 Required field not specified.
003 Company not authorized for integration.
004 User is not authorized.
005 Invalid Company Id
006 SCAC is required.
007 SCAC is invalid.
008 Vehicle ID is required.
009 Vehicle not found.
010 License Plate Number invalid.
011 License Plate Jurisdiction invalid.
012 License Plate fields cannot be changed for an auxiliary vehicle.

  • Was this article helpful?