Web Services

Web Services provide information to web clients, bypassing the traditional HTML forms approach. The information provided is customized based upon the options determined at the time of inquiry. There are two data formats available:

1. HTML links are standard URL query strings with additional parameters that take the requestor to the defined www.estes-express.com website for the desired information. This method is well suited for situations where automation is not restricted to going to the www.estes-express.com website.
   
   
2. XML (extensible markup language) links are also standard URL query strings with additional parameters that request data from a host site (www.estes-express.com) and provide data as machine readable XML documents instead of taking the requestor to an HTML web page. This method is well suited for computer-to-computer communications because the requesting client does not receive an HTML web page.

If you are sending the request via an HTTP GET, all data in the query string must be URL encoded.

Shipment Tracking
Image Retrieval
Rate Inquiry


Shipment Tracking

Unsecured Access (does not require logging into My Estes to perform the operation)

• Using URL
  http://www.estes-express.com/cgi-dta/edn419.mbr/output?search_criteria=**
  
  
• Using XML
  http://www.estes-express.com/cgi-dta/edn419.mbr/output?search_criteria=**&output_format=xml
  
  

Secured Access (requires a secure login to perform the operation)

• Using URL
  http://www.estes-express.com/cgi-dta/edn419.mbr/output?search_criteria=**&user_name=##& password=$$
  
  
• Using XML
  http://www.estes-express.com/cgi-dta/edn419.mbr/output?search_criteria=**&output_format= xml&user_name=##&password=$$
  ** = Enter SEARCH CRITERIA (Estes Express Lines PRO Number)
  ## = Enter your My Estes USERNAME
  $$ = Enter your My Estes PASSWORD
  
  Contact the webmaster with technical questions and suggestions.
  
  [Top]

Image Retrieval

This option is only available for Secured Access (requires a secure login to perform the operation)

• Using URL for a Delivery Receipt (DR)
  http://www.estes-express.com/cgi-dta/pdn100.mbr/output? search_criteria=**&search_type=F&doctype=DR& user_name=##&password=$$
  
  
• Using URL for Bill of Lading (BOL)
  http://www.estes-express.com/cgi-dta/pdn100.mbr/output? search_criteria=**&search_type=F&doctype=BOL& user_name=##&password=$$
  
  
** = Enter SEARCH CRITERIA (Estes Express Lines PRO Number)
## = Enter your My Estes USERNAME
$$ = Enter your My Estes PASSWORD


• Using XML
  Estes provides a SOAP-based web service for retrieving scanned images.
  
  The WSDL for the web service can be accessed at the following URL:
  http://www.estes-express.com/imageretrieval/services/ImageViewService?wsdl
  
  The WSDL describes the valid operations for the web service.
  
  The schemas used in the WSDL can be accessed at the links below:
  http://www.estes-express.com/imageretrieval/services/ImageViewService?xsd=availableImagesRequest.xsd
  
  http://www.estes-express.com/imageretrieval/services/ImageViewService?xsd=availableImagesResponse.xsd
  
  http://www.estes-express.com/imageretrieval/services/ImageViewService?xsd=imagesRequest.xsd
  
  http://www.estes-express.com/imageretrieval/services/ImageViewService?xsd=imagesResponse.xsd
  
  http://www.estes-express.com/imageretrieval/services/ImageViewService?xsd=imageViewCommon.xsd
  
  

  Retrieving the image is a two step process.

  1. imageCheck
     Request the available images using the PRO number.
     The response gives the available image types - Bill of Lading (BOL) and/or Delivery Receipt (DR).
  2. imageView
     Send a 2nd request with the PRO and image type.
     The response contains the image file name and a base64-encoded string representation of the file contents.
  
  [Top]

Rate Inquiry

This option is only available for Secured Access (requires a secure login to perform the operation).
The following table is used to determine the proper string sequence.

Rate Inquiry Information
Reference	Field	Description	Example	Required	Resulting String
1	QCFROM	From Zip Code	23860	Yes	QCFROM=23860
2	QCTO	To Zip Code	98032	Yes	QCTO=98032
3	QCCL1	Class for item 1	50.0	Yes	QCCL1=50.0
4	QCSWT1	Weight for item 1	1000	Yes	QCSWT1=1000
5	QCCL2	Class for item 2	50.0		QCCL2=50.0
6	QCSWT2	Weight for item 2	100		QCSWT2=100
7	QCCL3	Class for item 3	50.0		QCCL3=50.0
8	QCSWT3	Weight for item 3	150		QCSWT3=150
9	QCCL4	Class for item 4	77.5		QCCL4=77.5
10	QCSWT4	Weight for item 4	150		QCSWT4=150
11	QCCL5	Class for item 5	60.0		QCCL5=60.0
12	QCSWT5	Weight for item 5	100		QCSWT5=100
13	QCCL6	Class for item 6			QCCL6=
14	QCSWT6	Weight for item 6			QCSWT6=
15	QCDWP	Payor of charges (ie, S=Shipper, C=Consignee)	S	Yes	QCDWP=S
16	QCDTRM	Terms (ie; P=Prepaid, C=Collect)	P	Yes	QCDTRM=P
17	QCDAC1	Accessorial Charges #1 (see accessorial list)	HAZ		QCDAC1=HAZ
18	QCDAC2	Accessorial Charges #2 (see accessorial list)			QCDAC2=
19	QCDAC3	Accessorial Charges #3 (see accessorial list)			QCDAC3=
20	format	Output format (xml or html)	xml	Yes	format=xml
21	user_name	Secured user's login name	##	Yes	user_name=##
22	password	Secured user's password	$$	Yes	password=$$
23	QCACT	Estes Account number used for rating	1234567		QCACT=1234567

Note: All fields must be included in the string even if no value is provided.
Note: Field #23 is required when customer's user profile is associated with multiple accounts which may have different rates.

• Using URL
  Using the string design above, the Output Format should be shown as html (ie; format=html)
  Example string based upon the items above:
  http://www.estes-express.com/cgi-dta/qun100.mbr/output?QCFROM=23860&QCTO=98032& QCCL1=50.0&QCSWT1=1000& QCCL2=50.0& QCSWT2=100&QCCL3=50.0&QCSWT3=150&QCCL4=77.5& QCSWT4=150&QCCL5=60.0&QCSWT5=100&QCCL6=&QCSWT6=& QCDWP=S&QCDTRM=P&QCDAC1=HAZ&QCDAC2=&QCDAC3=& format=html&user_name=##&password=$$&QCACT=1234567
  
  
• Using XML
  Using the string design above, the Output Format should be shown as xml (ie; format=xml) Example string based upon the items above:
  http://www.estes-express.com/cgi-dta/qun100.mbr/output? QCFROM=23860&QCTO=98032&QCCL1=50.0&QCSWT1=1000&QCCL2=50.0 &QCSWT2=100&QCCL3=50.0&QCSWT3=150&QCCL4=77.5&QCSWT4=150 &QCCL5=60.0&QCSWT5=100&QCCL6=&QCSWT6=&QCDWP=S &QCDTRM=P&QCDAC1=HAZ&QCDAC2=&QCDAC3=&format=xml &user_name=##&password=$$&QCACT=1234567
  ## = Enter your My Estes USERNAME between the brackets
  $$ = Enter your My Estes PASSWORD between the brackets
  
  Please contact the webmaster for technical questions and suggestions.
  
  [Top]