Web Service Details | Midwest Motor Express

The Document Search Web Service provides a way for developers to pass a number of criteria programmatically and in return receive a Document details and other output for use in a client-side or local program. Webservice returns a url from where the image can be copied to the clients machine. The service is a SOAP-based web service. The file contains WSDL,Sample code(C#) and element list.
If you have questions or comments, email us.

Url : https://www.aaacooper.com/ws/ActDocumentSearch.asmx?wsdl

Web Service Description Language:

<wsdl:types xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
    <s:schema elementFormDefault="qualified" targetNamespace="http://www.aaacooper.com/" xmlns:s="http://www.w3.org/2001/XMLSchema">
      <s:element name="GetDocument">
        <s:complexType>
          <s:sequence>
            <s:element minOccurs="0" maxOccurs="1" name="actImgSearchServiceRequestVO" type="tns:ActImgSearchServiceRequestVO" />
          </s:sequence>
        </s:complexType>
      </s:element>
      <s:complexType name="ActImgSearchServiceRequestVO">
        <s:sequence>
          <s:element minOccurs="0" maxOccurs="1" name="ProNo" type="s:string" />
          <s:element minOccurs="0" maxOccurs="1" name="ImageType" type="s:string" />
          <s:element minOccurs="0" maxOccurs="1" name="ImageFormat" type="s:string" />
        </s:sequence>
      </s:complexType>
      <s:element name="GetDocumentResponse">
        <s:complexType>
          <s:sequence>
            <s:element minOccurs="0" maxOccurs="1" name="GetDocumentResult" type="tns:ActImgSearchServiceResponseVO" />
          </s:sequence>
        </s:complexType>
      </s:element>
      <s:complexType name="ActImgSearchServiceResponseVO">
        <s:sequence>
          <s:element minOccurs="0" maxOccurs="1" name="ProNo" type="s:string" />
          <s:element minOccurs="0" maxOccurs="1" name="ImageType" type="s:string" />
          <s:element minOccurs="0" maxOccurs="1" name="ImageFormat" type="s:string" />
          <s:element minOccurs="0" maxOccurs="unbounded" name="ImageUrl" />
          <s:element minOccurs="0" maxOccurs="1" name="ErrorMessage" type="s:string" />
        </s:sequence>
      </s:complexType>
      <s:element name="UserCredentials" type="tns:UserCredentials" />
      <s:complexType name="UserCredentials">
        <s:sequence>
          <s:element minOccurs="0" maxOccurs="1" name="token" type="s:string" />
        </s:sequence>
        <s:anyAttribute />
      </s:complexType>
    </s:schema>
  </wsdl:types>
  <wsdl:message name="GetDocumentSoapIn" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
    <wsdl:part name="parameters" element="tns:GetDocument" />
  </wsdl:message>
  <wsdl:message name="GetDocumentSoapOut" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
    <wsdl:part name="parameters" element="tns:GetDocumentResponse" />
  </wsdl:message>
  <wsdl:message name="GetDocumentUserCredentials" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
    <wsdl:part name="UserCredentials" element="tns:UserCredentials" />
  </wsdl:message>
  <wsdl:portType name="ActDocumentSearchSoap" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
    <wsdl:operation name="GetDocument">
      <wsdl:input message="tns:GetDocumentSoapIn" />
      <wsdl:output message="tns:GetDocumentSoapOut" />
    </wsdl:operation>
  </wsdl:portType>
  <wsdl:binding name="ActDocumentSearchSoap" type="tns:ActDocumentSearchSoap" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
    <soap:binding transport="http://schemas.xmlsoap.org/soap/http" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" />
    <wsdl:operation name="GetDocument">
      <soap:operation soapAction="http://www.aaacooper.com/GetDocument" style="document" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" />
      <wsdl:input>
        <soap:body use="literal" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" />
        <soap:header message="tns:GetDocumentUserCredentials" part="UserCredentials" use="literal" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" />
      </wsdl:input>
      <wsdl:output>
        <soap:body use="literal" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" />
      </wsdl:output>
    </wsdl:operation>
  </wsdl:binding>
  <wsdl:binding name="ActDocumentSearchSoap12" type="tns:ActDocumentSearchSoap" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
    <soap12:binding transport="http://schemas.xmlsoap.org/soap/http" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" />
    <wsdl:operation name="GetDocument">
      <soap12:operation soapAction="http://www.aaacooper.com/GetDocument" style="document" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" />
      <wsdl:input>
        <soap12:body use="literal" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" />
        <soap12:header message="tns:GetDocumentUserCredentials" part="UserCredentials" use="literal" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" />
      </wsdl:input>
      <wsdl:output>
        <soap12:body use="literal" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" />
      </wsdl:output>
    </wsdl:operation>
  </wsdl:binding>
  <wsdl:service name="ActDocumentSearch" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
    <wsdl:port name="ActDocumentSearchSoap" binding="tns:ActDocumentSearchSoap">
      <soap:address location="https://www.mmeinc.com/pwb/WS/ActDocumentSearch.asmx" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" />
    </wsdl:port>
    <wsdl:port name="ActDocumentSearchSoap12" binding="tns:ActDocumentSearchSoap12">
      <soap12:address location="https://www.mmeinc.com/pwb/WS/ActDocumentSearch.asmx" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" />
    </wsdl:port>
  </wsdl:service>

Web Service Elements:

GetDocumentRequest Elements
Element Name	Description	Required	Constraint or Note	Length
Token	Token Number	Yes	Authentication Credentials required	36
ProNo	PRO Number	Yes	Associated to user	10
ImageType	Document Type	Yes	List of possible Document Type
ImageFormat	Document Format	Yes	e.g. TIF, PDF

List of Document Types

Attached is the list of valid Document Types that needs to be passed to the web service.

Document Type	Description
BL	Bill of Lading
DR	Delivery Receipt
WBILL	Weigh Bill Certificates
FREIGHT DOCUMENTS	To receive all the Freight Documents (BL, DR, WBILL)

Possible Error Messages:

Attached is the list of the list of Error Messages that can be returned when an error occurs for the request.

Error Message	Description
Invalid Token	The value sent for the Token input is not correct
Invalid Pro	The value sent for the Pro Number is invalid or not associated to the user
Invalid Image Type	The Image Type is not included in the List of possible Document Type
Image Type cannot be empty	Image Type is required
Invalid Image Format	Image Format must Tif or PDF
Image Format cannot be empty	Image Format is required

Sample Code (C#):


/* All sample code is provided for illustrative purposes only.
   These examples have not been thoroughly tested under all conditions. 
   We, therefore, cannot guarantee or imply reliability, serviceability,
   or function of these programs. All programs contained herein are provided to you "AS IS" 
   without any warranties of any kind. The implied warranties of non-infringement, 
   merchantability and fitness for a particular purpose are expressly disclaimed.
*/
using System;
using System.Web.UI;

using YourNameSpace;

namespace YourNameSpace
{
  public partial class Default1 : Page
  {
    protected void Page_Load(object sender, EventArgs e)
    {
      try
      {
        ActDocumentSearch ws = new ActDocumentSearch();
        ActImgSearchServiceRequestVO request = new ActImgSearchServiceRequestVO();
        UserCredentials credentials = new UserCredentials();
        credentials.token = "8e3c61c7-9b7c-2d3b-b47f-ed343c4f6577";
        ws.UserCredentialsValue = credentials;
        request.ProNo = "12345678";
        request.ImageFormat = "TIF";
        request.ImageType = "Freight Documents";
        ActImgSearchServiceResponseVO response = ws.GetDocument(request);
        //Code for downloading Image on the requested path 
        DownLoadDocument(response);
      }
      catch (SoapException ex)
      {
        throw ex;
      }
      catch (Exception ex)
      {
        throw ex;
      }
    }

    private void DownLoadDocument(ActImgSearchServiceResponseVO response)
    {
      WebClient wb = new WebClient();
      foreach (string strImagePath in response.ImageUrl)
      {
        // PRONUM_IMAGETYPE.IMAGEFORMAT
        wb.DownloadFile(strImagePath, @"C:\12345678_BOL.TIF"); 
      }
    }
  }
}

Sample xml Request :


<?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:Header>
    <UserCredentials xmlns="http://www.aaacooper.com/">
      <token>8e3c61c7-9b7c-2d3b-b47f-ed343c4f6577</token>
    </UserCredentials>
  </soap:Header>
  <soap:Body>
    <GetDocument xmlns="http://www.aaacooper.com/">
      <actImgSearchServiceRequestVO>
        <ProNo>12345678</ProNo>
        <ImageType>Freight Documents</ImageType>
        <ImageFormat>TIF</ImageFormat>
      </actImgSearchServiceRequestVO>
    </GetDocument>
  </soap:Body>
</soap:Envelope>

List of Document Types

Submit

Okay

Cancel