Skip to main content
Omnitracs Knowledge Base

Set Trailer Mileage Threshold

setTrailerMileageThreshold

Sets the trailer mileage threshold to monitor and alert recipients to notify given a SCAC and trailer identifier.

void setTrailerMileageThreshold (AssetIdentifier trailer,  MileageThresholdMonitoring mileageThresholdMonitoring) throws WSException

  • trailer: An AssetIdentifier that uniquely identifies the trailer to which the mileage monitoring will be set.
  • mileageThresholdMonitoring: A  MileageThresholdMonitoring object containing the mileage monitoring information.

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 Trailer Tracks
- Can assign monitoring plans OR can maintain trailers 

Customer integrators are authorized to their own company's data only. 

Exceptions

002 Required field not specified.
003 Company not authorized for integration.
004 User not authorized.
005 Trailer mileage reporting not enabled.
006 Trailer mileage reporting not supported
007 Trailer SCAC not specified.
008 Trailer ID not specified.
009 Trailer SCAC/Trailer ID invalid.
010 Threshold not valid.
011 Trailer threshold must be greater than trailer's mileage counter
012 Email address is invalid.

Sample setTrailerMileageThreshold Request

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

<soapenv:Body>

<setTrailerMileageThreshold>

    <trailer>

        <id>ALIVE595</id>

        <scac>LABU</scac>

    </trailer>

    <MileageThresholdMonitoring>

        <active>true</active>

        <threshold>100000</threshold>

        <notification>

            <Email>

                <address>romanowski@volpico.com</address>

            </Email>

            <Email>

                <address>spalmer@volpico.com</address>

            </Email>

        </notification>

    <MileageThresholdMonitoring/>

</setTrailerMileageThreshold>

</soapenv:Body>

 

Sample setTrailerMileageThreshold Response

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

<soapenv:Body>

<setTrailerMileageThresholdResponse/>

</soapenv:Body>

  • Was this article helpful?