Skip to main content
Omnitracs Knowledge Base

Create Trailer

createTrailer

Creates a trailer entry given the asset identifier and unit address of the mobile terminal assigned to the new trailer.  All other trailer attributes will be set to the system default values. This web service will create trailers equipped with either an untethered or tethered unit.

void createTrailer(AssetIdentifier trailer, String trlrUA) throws WSException

  • trailer An AssetIdentifier containing the SCAC and ID of the trailer to be created.
  • trlrUA: A string containing the serial number (unit address) of the trailer tracking device to be assigned to this trailer.

 

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 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 SCAC not specified or contains invalid characters.
006 Trailer ID not specified or contains invalid characters.
007 Trailer SCAC/Trailer ID invalid.
008 Trailer SCAC/Trailer ID already exists.
009 Trailer UA must be numeric.
010 Trailer UA not within valid range.
011 Trailer UA specified is already in use on another trailer.
012 Trailer ID and UA cannot be the same value.
013 Only owned trailers can be created.
014 Unexpected failure or error code returned.
015 Invalid tethered reefer equipped value.
016 Trailer UA is not within the valid range for a tethered reefer trailer.
017 Trailer created, but not as reefer equipped.
019 Trailer creation not supported for this device type.

 

Sample createTrailer Request

 

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

<soapenv:Body>

   <createTrailer>

      <trailer>

        <id>ALIVE595</id>

        <scac>LABU</scac>

      </trailer>

      <trlrUA>0120000696</trlrUA>

   <createTrailer>

</soapenv:Body>

 

Sample createTrailer Response

 

No response conveys success. If an error occurred, an exception would have been thrown.

<soapenv:Body>

   <createTrailerResponse/>

</soapenv:Body>

  • Was this article helpful?