Get Trailer Information

Last updated
Save as PDF

getTrailerInformation

Given the Asset Identifier of the trailer, return select status-related attributes of the trailer in a Trailer object. The information returned includes current location, geofence, monitoring plan, etc. Most of the information returned by this method is information that may change over time. It represents the current status of the trailer.

Trailer getTrailerInformation(AssetIdentifier trailer) throws WSException

trailer: An AssetIdentifier that contains the identifier of the trailer whose status information will be retrieved.

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

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 and Trailer ID not specified.
006 Trailer SCAC/Trailer ID invalid.

Sample getTrailerInformation Request

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

<soapenv:Body>

<getTrailerInformation>

<trailer>

<id>ALIVE595</id>

<scac>LABU</scac>

</trailer>

</getTrailerInformation>

</soapenv:Body>

Sample getTrailerInformation Response

<soapenv:Body>

<getTrailerInformationResponse>

<getTrailerInformationReturn>

<type>DRY</type>

<posTime>2006-03-03T15:37:42Z</posTime>

<latitude xsi:nil="true" />

<longitude xsi:nil="true" />

<proximityTown>

<placeType>TOWN</placeType>

<distance>0.0</distance>

<direction>@</direction>

<placeName xsi:nil="true" />

<city>Carlisle</city>

<state>PA</state>

<country>US</country>

<zip>17013</zip>

</proximityTown>

<proximityCity>

<placeType>CITY</placeType>

<distance>17.41</distance>

<direction>WSW</direction>

<placeName xsi:nil="true" />

<city>Harrisburg</city>

<state>PA</state>

<country>US</country>

<zip>17101</zip>

</proximityCity>

<vehicle>

<id>OAKSTMCT</id>

<scac>LABU</scac>

</vehicle>

<lost>Y</lost>

<eventDesc>Chg Trlr Monitoring</eventDesc>

<eventTime>2006-03-30T19:33:18Z</eventTime>

<trlrMonPlan>

<id>DEES</id>

<desc>Dee's monitoring</desc>

<override>N</override>

<compat>0</compat>

<manageGrp>CSDIOPTGRP</manageGrp>

<optNotGrp>DAVESGRP</optNotGrp>

</trlrMonPlan>

<battCharge>1</battCharge>

<battReplace>2005-02-01T20:14:00Z</battReplace>

<foreignTrlr>N</foreignTrlr>

<loaded>L</loaded>

<loadTime>2006-02-07T17:51:50Z</loadTime>

<cargoSnsr>2</cargoSnsr>

<cargoSnsrTime>2006-02-07T17:50:18Z</cargoSnsrTime>

<doorSnsr>1</doorSnsr>

<doorSnsrTime>2006-02-08T18:58:33Z</doorSnsrTime>

<auxSnsr>1</auxSnsr>

<auxSnsrTime>2006-02-08T20:47:36Z</auxSnsrTime>

<geofence>

<desc>GWTEST</desc>

<centerPref>2</centerPref>

<centerLat>040.09.56.0000.N</centerLat>

<centerLon>075.52.12.0000.E</centerLon>

<nsLength>620.0</nsLength>

<ewLength>620.0</ewLength>

<startDate>2006-02-03T01:00:00Z</startDate>

<stopDate>2006-03-05T01:00:00Z</stopDate>

<active>N</active>

<ongoing xsi:nil="true" />

<checkInt>+00001000000</checkInt>

<entryAction>001</entryAction>

<exitAction>000</exitAction>

</geofence>

<geoText>(expired)</geoText>

<insideGeo>N</insideGeo>

<geoExists>Y</geoExists>

<geoPndSelfCent>0</geoPndSelfCent>

<newGeoSent>N</newGeoSent>

</getTrailerInformationReturn>

</getTrailerInformationResponse>

</soapenv:Body>