Skip to main content
Omnitracs Knowledge Base

Create Tethered Reefer Trailer


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.




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.











Sample createTetheredReeferTrailer Response


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




  • Was this article helpful?