Skip to main content
Omnitracs Knowledge Base

Set Load Status


Sets the trailer loaded status given a SCAC and trailer identifier when the loaded status is not being updated automatically by UTT reported cargo state. If the 'Use cargo state for loaded status' is checked on the TrailerTRACS Company Settings page then the loaded status will not be able to be set.

void setLoadedStatus(AssetIdentifier trailer, String loadedState) throws WSException

  • trailer: An AssetIdentifier that uniquely identifies the trailer to which the loaded status will be set.
  • loadedState: The loaded status to which the trailer will be set. Possible values are: 
    U Unknown
    L Loaded
    E Empty

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 Loaded state not specified.
009 Loaded state invalid.
010 Loaded status being set by cargo state.

Sample setLoadedStatus Request

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










Sample setLoadedStatus Response

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




  • Was this article helpful?