Vehicle->AddVehicle

Last updated
Save as PDF

AddVehicle (Vehicle Function)

This function adds a single vehicle record. This method is similar to the Add method but in addition, it allows adding the PlateNumber field.

The AddVehicle function takes the following request parameters:

Parameter	Type	Description
MCT	Integer	The MCT number assigned to the tractor.
Alias	String	String representing a name for the tractor.
DepotId	Short	Depot of the tractor.
TractorId	String	Unique identifier for this tractor.
VIN	String	Vehicle Identification Number (must be 17 characters), optional field
VehicleGroup	String	Group the tractor belongs to; if more than one, provide each string on a new line within the <VehicleGroup> tag.
PlateNumber	String	Vehicle plate number that may include authority.
ELDMode	Enum	Desired operating mode of the mobile device on the vehicle; As of Release 5.3, all new vehicles will be set to ELD_Mode, regardless of input value, as long as the unit belongs to the customer's account.

Required field: MCT

  
<?xml version="1.0" encoding="utf-8"?>  
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">  
  <soap:Body>  
    <AddVehicle xmlns="http://www.qualcomm.com">  
      <vd>  
        <MCT>int</MCT>  
        <Alias>string</Alias>  
        <DepotId>short</DepotId>  
        <TractorId>string</TractorId>  
        <VIN>string</VIN>  
        <VehicleGroup>  
          <string>string</string>  
          <string>string</string>  
        </VehicleGroup>  
        <PlateNumber>string</PlateNumber>  
        <ELDMode>ELD_Mode or AOBRD_Mode</ELDMode>  
      </vd>  
    </AddVehicle>  
  </soap:Body>  
</soap:Envelope>

AddVehicle (Vehicle Function) - XML Response

The return result indicates success or failure via SOAP exceptions.

  
<?xml version="1.0" encoding="utf-8"?>  
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">  
  <soap:Body>  
    <AddVehicleResponse xmlns="http://www.qualcomm.com">  
      <vd>  
        <MCT>int</MCT>  
        <Alias>string</Alias>  
        <DepotId>short</DepotId>  
        <TractorId>string</TractorId>  
        <VIN>string</VIN>  
        <VehicleGroup>  
          <string>string</string>  
          <string>string</string>  
        </VehicleGroup>  
        <PlateNumber>string</PlateNumber>  
        <ELDMode>ELD_Mode or AOBRD_Mode</ELDMode>  
      </vd>  
    </AddVehicleResponse>  
  </soap:Body>  
</soap:Envelope>