Skip to main content
Omnitracs Knowledge Base

Create Tethered Reefer Trailer

createTetheredReeferTrailer

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

void createTetheredReeferTrailer(AssetIdentifier trailer, String trlrUA) throws WSException

  • trailer An AssetIdentifier containing the SCAC and ID of the tethered reefer trailer to be created.
  • trlrUA: A string containing the serial number (unit address) of the trailer tracking device to be assigned to this tethered reefer 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.
006 Trailer ID not specified.
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 createTetheredReeferTrailer Request

 

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

<soapenv:Body>

   <createTetheredReeferTrailer>

      <trailer>

        <id>ALIVE595</id>

        <scac>LABU</scac>

      </trailer>

      <trlrUA>0030000696</trlrUA>

   <createTetheredReeferTrailer>

</soapenv:Body>

 

Sample createTetheredReeferTrailer Response

 

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

<soapenv:Body>

   <createTetheredReeferTrailerResponse/>

</soapenv:Body>

  • Was this article helpful?