Skip to main content
Omnitracs Knowledge Base

TPM Get Sent Configuration Status Webservice Details

 

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

  • Vehicle Maintenance
    The user must also have been granted the capability 'Can query Tire Pressure Monitoring settings' on the Customer portal.

 

Calling Interface

 

 

GetCurrentConfigurationResponse getCurrentConfiguration (GetCurrentConfigurationRequest getRequests) throws WSException
 

  • getCurrentConfiguration: The GetCurrentConfigurationRequest encapsulates the information required to query for last known TTIA alert configuration status on the mobile
     
  • returns GetCurrentConfigurationResponse
    • Indicates the TPM settings and the status

       

 

GetCurrentConfigurationRequest

 

 

Element

 

 

Type 

 

 

Description

 

 

Required

 

Routing

RoutingType

Contains the routing information for this message. The Primary Service Id should be set to 'VM', the secondary service Id should be set to 'TPMCONFIGURATION' the Destination should be filled in with the Vehicle Unified Address, and/or Vehicle Id. If both Vehicle Unified Address and Vehicle Id are present, Vehicle Id will take higher precedence.

Yes

 

Sample XML Requests

 

Only the SOAP body is shown. To see a sample SOAP Envelope and Header, click here.
This sample asks for all Pending requests.

<soapenv:Envelope xmlns:ns="http://cfg.data.eip.omnitracs.com/1.0" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">

   <soapenv:Body>

      <ns:GetCurrentConfigurationRequest>

         <Routing>

            <!--Zero or more repetitions:-->

            <Destination>

               <Type>Vehicle</Type>

               <SystemAssignedId>105375593</SystemAssignedId>

            </Destination>

            <Service>

               <Primary>

                  <Id>VM</Id>

               </Primary>

               <Secondary>

                  <Id>

                     <Id>TPMCONFIGURATION</Id>

                  </Id>

               </Secondary>

            </Service>

         </Routing>

      </ns:GetCurrentConfigurationRequest>

   </soapenv:Body>

</soapenv:Envelope>


 

 

 GetCurrentConfigurationResponse

 

 

Element

 

 

Type 

 

 

Description

 

 

Required

 

Configuration

ConfigurationType

List of Mobiles and the configuration and the status for each mobile.

Yes

 

 

ConfigurationType

 

 

Element

 

 

Type 

 

 

Description

 

 

Required

 

Routing

RoutingType

Contains the information about how the message was routed

Yes

Configuration

ConfigurationResourceType

Container for actual payload in the message

No

Status

ConfigurationStatusType

Message creation time 

Yes

Resources

AssociatedResourceType

Any additional information about the creation and changes to the message

No

MetaData

NameValueType

Any additional information about the creation and changes to the message

No

 

 

ConfigurationStatusType

 

 

Element

 

 

Type 

 

 

Description

 

 

Required

 

State

ConfigurationStateType

The state of configuration. The possible values are Pending/Failed/Delivered/Unknown/NoValue

Yes

StateTime

dateTime

When the state is updated.

No

Reason

string

Detail reason why the mobile has this state.

No


 

 

Sample XML Response

 

The payload is not returned for GetSentMessagesRequest.

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

   <SOAP-ENV:Header/>

   <SOAP-ENV:Body>

      <ns4:GetCurrentConfigurationResponse xmlns:ns4="http://cfg.data.eip.omnitracs.com/1.0" xmlns:ns3="http://res.data.eip.omnitracs.com/1.0" xmlns:ns5="http://base.data.eip.omnitracs.com/1.0">

         <Configuration>

            <Routing>

               <Destination>

                  <Type>Vehicle</Type>

                  <SystemAssignedId>106017282</SystemAssignedId>

                  <CustomerAssignedId>0106017282</CustomerAssignedId>

               </Destination>

               <Service>

                  <Primary>

                     <Id>VM</Id>

                  </Primary>

                  <Secondary>

                     <Id>

                        <Id>TPMCONFIGURATION</Id>

                     </Id>

                  </Secondary>

               </Service>

            </Routing>

            <Configuration>

               <Payload>

                  <Type>Text</Type>

                  <Text><![CDATA[[<tns:ConfigurationPayload xmlns:tns="http://www.omnitracs.com/TPMInput" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.omnitracs.com/TPMInput ConfigurationPayload.xsd ">

                    <TPMConfigurationPayload>

                        <EquipToTrack>Tractor Only</EquipToTrack>

                        <PeriodicTPMSReportsEnable>true</PeriodicTPMSReportsEnable>

                        <TPMPeriodicReportInterval>80</TPMPeriodicReportInterval>

                    </TPMConfigurationPayload>

                </tns:ConfigurationPayload>

                  ]]></Text>

               </Payload>

            </Configuration>

            <Status>

               <State>Delivered</State>

               <StateTime>2013-06-18T18:48:35.000Z</StateTime>

            </Status>

         </Configuration>

      </ns4:GetCurrentConfigurationResponse>

   </SOAP-ENV:Body>

</SOAP-ENV:Envelope>

  • Was this article helpful?