TPM Send Configuration 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 edit Tire Pressure Monitoring settings' on the Customer portal.

Calling Interface

SendConfigurationsResponse sendConfigurations (SendConfigurationsRequest sendMessages) throws WSException

sendConfigurations: The SendConfigurationsRequest encapsulates the information required to send TPM configurations to the mobiles. Please see below of a description of the necessary fields required for TPM configuration.
returns SendConfigurationsResponse
- The response indicates the successful acceptance of the TPM Configuration for processing. Status of the mobile configuration can be queried by calling getCurrentConfiguration.

SendConfigurationsRequest

Element	Type	Description	Required
Routing	RoutingType	Contains the routing information for this message. The Primary Service Id should be set to 'VM' and 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
Configuration	SendConfigurationType	Container for TPM Configuration Set.	Yes

Element

Type

Description

Required

Routing

RoutingType

Contains the routing information for this message. The Primary Service Id should be set to 'VM' and 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

Configuration

SendConfigurationType

Container for TPM Configuration Set.

Yes

Configuration (SendConfigurationType)

Element	Type	Description	Required
Configuration	ConfigurationResourceType	Customer supplied tracking id. The maximum size of a correlation Id is 100 characters.	Yes
Action	ActionType		No
Resource	BaseResourceType		No
Created	dateTime		No

ConfigurationResourceType

Element	Type	Description	Required
Resource	BaseResourceType	Only Type is required.	Yes
Payload	PayloadType	The container for TPM Configuration payload.	Yes
Resource	BaseResourceType		No
Created	dateTime		No

PayloadType

Element	Type	Description	Required
Type	Type	Text	Yes
Text	String	The text is in xml format. The xml must conform payload.xsd. For each TPM configurations, thefollowing constraints must be met. PeriodicTPMSReportsEnable is true or false. EquipToTrack is either 'Tractor Only' or 'Both Tractor and Trailer' 60 <= TPMPeriodicReportInterval <=1440	Yes

Element

Type

Description

Required

Type

Text

Yes

Text

String

The text is in xml format. The xml must conform payload.xsd.
For each TPM configurations, thefollowing constraints must be met.

PeriodicTPMSReportsEnable is true or false.
EquipToTrack is either 'Tractor Only' or 'Both Tractor and Trailer'
60 <= TPMPeriodicReportInterval <=1440

Yes

Sample XML Request

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

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

<soapenv:Body>

<ns:SendConfigurationsRequest>

<Routing>

<Destination>

<Type>Vehicle</Type>

<SystemAssignedId>123</SystemAssignedId>

</Destination>

<Service>

<Primary>

<Id>VM</Id>

</Primary>

</Service>

</Routing>

<Configuration>

<Resource>

<Type>Vehicle</Type>

</Resource>

<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>60</TPMPeriodicReportInterval>

</TPMConfigurationPayload>

</tns:ConfigurationPayload>

]]>

</Text>

</Payload>

</Configuration>

</ns:SendConfigurationsRequest>

</soapenv:Body>

</soapenv:Envelope>

SendMessagesResponse

Element	Type	Description	Required
SendMessageAck	IncomingAckType	Acknowledgement Status for each message sent in the request	Yes

Element

Type

Description

Required

SendMessageAck

IncomingAckType

Acknowledgement Status for each message sent in the request

Yes

Sample XML Response

This example shows the response to a successful send request

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

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<ns4:SendConfigurationsResponse 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"/>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>