Skip to main content
Omnitracs Knowledge Base

Carrier->Add

Add (Carrier Function, North America)

Add
This function adds a single Carrier record. Name is a required field that may not be either empty strings or null.
If any other request fields are null, corresponding Carrier table fields will be set to null.
If a request field value is an empty string, corresponding field in the database will be updated with it.

XML Request

Definitions

  • null fields are the fields that are either omitted or initialized to a special value - string "NULL".
    • E.g., <Street>NULL<Street/> will be interpreted as a null field.
  • Empty string fields are, e.g., <Street /> or <Street></Street>

The Add function takes the following request parameters:

Parameter Type Optional Description
MiscInfo String Yes Additional information. This can be used to match the corresponding company's office information field
Name String No Carrier name, must be unique, or 'Record already exists' will be returned. Must be at least 4 characters.
City String Yes City segment of Carrier address
USDotNumber String Yes Identifying number issued by DOT
Postal String Yes Postal code segment of Carrier address
State String Yes State segment of Carrier address
Street String Yes Street segment of Carrier address
Street2 String Yes Street segment of Carrier address - line 2

 

<?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>
    <Add xmlns="http://www.omnitracs.com">
        <carrierData>
            <Name>string</Name>
            <Street>string</Street>
            <Street2>string</Street2>
            <City>string</City>
            <State>string</State>
            <Postal>string</Postal>
            <MiscInfo>string</MiscInfo>
            <USDotNumber>string</USDotNumber>
    </carrierData>
</Add>
</soap:Body>
</soap:Envelope>
 

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>
        <AddResponse xmlns="http://www.omnitracs.com" />
    </soap:Body>
</soap:Envelope>

  • Was this article helpful?