Carrier


Click here for a complete list of operations.

Update

Update oldCarrier with newCarrier data. oldCarrier is found based on Name specified in oldCarrier and on NMCAccount derived from the user login credentials. Only oldCarrier/Name field is used. Other oldCarrier fields are ignored.

If any other request fields are null, corresponding Carrier table fields will not be changed.
If a request field value is an empty string, database will be updated with it.
If there is no record with a given NMCAccount and Name, SOAP fault "System.Web.Services.Protocols.SoapException: Carrier with name '[Name]' does not exist." will result.
When updating Name keep in mind that it must be unique for a given NMCAccount. If this constraint is violated, SOAP fault "System.Web.Services.Protocols.SoapException: Record already exists." will result.

Test

The test form is only available for requests from the local machine.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /QHOSWSNA/carrier.asmx HTTP/1.1
Host: hos.omnitracs.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.omnitracs.com/Update"

<?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>
    <Update xmlns="http://www.omnitracs.com">
      <oldCarrier>
        <Name>string</Name>
        <Street>string</Street>
        <Street2>string</Street2>
        <City>string</City>
        <State>string</State>
        <Postal>string</Postal>
        <MiscInfo>string</MiscInfo>
        <USDotNumber>string</USDotNumber>
      </oldCarrier>
      <newCarrier>
        <Name>string</Name>
        <Street>string</Street>
        <Street2>string</Street2>
        <City>string</City>
        <State>string</State>
        <Postal>string</Postal>
        <MiscInfo>string</MiscInfo>
        <USDotNumber>string</USDotNumber>
      </newCarrier>
    </Update>
  </soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

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

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /QHOSWSNA/carrier.asmx HTTP/1.1
Host: hos.omnitracs.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <Update xmlns="http://www.omnitracs.com">
      <oldCarrier>
        <Name>string</Name>
        <Street>string</Street>
        <Street2>string</Street2>
        <City>string</City>
        <State>string</State>
        <Postal>string</Postal>
        <MiscInfo>string</MiscInfo>
        <USDotNumber>string</USDotNumber>
      </oldCarrier>
      <newCarrier>
        <Name>string</Name>
        <Street>string</Street>
        <Street2>string</Street2>
        <City>string</City>
        <State>string</State>
        <Postal>string</Postal>
        <MiscInfo>string</MiscInfo>
        <USDotNumber>string</USDotNumber>
      </newCarrier>
    </Update>
  </soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <UpdateResponse xmlns="http://www.omnitracs.com" />
  </soap12:Body>
</soap12:Envelope>