Rate Quote Web Service v2.2
This web service version will be deprecated in the future. Please use, or upgrade to Rate Quote Web Service v4.0.
Introduction
The Rate Quote web service provides the functionality for Estes’ customers to obtain a rate quote for a shipment.
Quality of Service
The service should be available 24 hours a day, 7 days a week. However, the service may not be available during planned outages.
Technical Support
Please email the Estes Express Web Support Team for web service information or support: websupport@estes-express.com.
WSDL
The following WSDL URI should be used to access the web service. In order to use the web service, a My Estes account must be created so that authentication will work. If you do not yet have a My Estes account, you may register for one here: My Estes Signup.
WSDL Production
https://www.estes-express.com/rating/ratequote/services/RateQuoteService?wsdl
Detailed Service Information
Estes’ rate quote web service provides customers with the ability to obtain a standard rate or a guaranteed rate quote for a potential shipment.
The WSDL describes the valid operations for the web service and serves as a template for the requests and responses for each operation. The rate quote web service has operations to test connectivity to the service and to create an Estes rate quote. Send the data required for the operation in the SOAP request. Samples of each request are listed in the following pages.
Schema Details
Each operation has a specific format defined by a schema within the WSDL. The schema contains elements that accept only a finite set of valid values. Listed below are those elements and their valid values.
| Field | Details | Description |
|---|---|---|
| auth | Required: Yes | This is the authentication for the SOAP request. It is required and all of its child elements are required. |
| auth/username | Required: Yes Data Type: String Min Length: 5 Max Length: 10 |
This is the My Estes username that is used to log in to the website. |
| auth/password | Required: Yes Data Type: String Min Length: 5 Max Length: 10 |
My Estes password that is used to login to the website. |
| rateRequest | Required: Yes | These are the details needed to determine the rate quote that will be provided to the customer. They are required, but not all child elements are required. |
| rateRequest/ requestID |
Required: Yes Data Type: String Min Length: 1 Max Length: 50 |
Unique identifier generated by the consumer that is between 1 and 50 characters long. |
| rateRequest/ account |
Required: Yes Data Type: String Min Length: 1 Max Length: 7 |
The customer’s account number that is between 1 and 7 characters long. |
| rateRequest/ originPoint |
Required: Yes | The pickup location for the shipment from which the user is requesting the rate. |
| rateRequest/ originPoint/ countryCode |
Required: Yes Data Type: String Min Length: 2 Max Length: 2 |
This is the country where origin point is located. Valid values are:
|
| rateRequest/ originPoint/ postalCode |
Required: Yes Data Type: String Min Length: 5 Max Length: 6 |
The 5-digit zip or 6-digit postal code for the originPoint. |
| rateRequest/ originPoint/ city |
Required: No Data Type: String Min Length: 1 Max Length: 50 |
The city for the originPoint. |
| rateRequest/ originPoint/ stateProvince |
Required: No Data Type: String Min Length: 2 Max Length: 2 |
The state or province abbreviation for the originPoint. |
| rateRequest/ destinationPoint |
Required: Yes | The arrival location for the shipment to which the user is requesting the rate. |
| rateRequest/ destinationPoint/ countryCode |
Required: Yes Data Type: String Min Length: 2 Max Length: 2 |
This is the country where the destination point is located. Valid values are:
|
| rateRequest/ destinationPoint/ postalCode |
Required: Yes Data Type: String Min Length: 5 Max Length: 6 |
The 5-digit zip or 6-digit postal code for the destinationPoint. |
| rateRequest/ destinationPoint/ city |
Required: No Data Type: String Min Length: 1 Max Length: 50 |
This is the city where the destination point is located. |
| rateRequest/ destinationPoint/ stateProvince |
Required: No Data Type: String MIn Length: 2 Max Length: 2 |
The state or province abbreviation for the destinationPoint. |
| rateRequest/ payor |
Required: Yes Data Type: String Min Length: 1 Max Length: 1 |
This enables the requestor to identify their role. Valid values are:
|
| rateRequest/ terms |
Required: Yes Data Type: String Min Length: 1 Max Length: 1 |
This identifies the payment terms to apply if the requested rate results in a pickup. Valid values are:
|
| rateRequest/ pickup |
Required: No | Additional information if rate request results in a pickup (time and location). |
| rateRequest/ pickup/ date |
Required: No Data Type: Date |
The date that any resulting pickup would occur.
|
| rateRequest/ pickup/ ready |
Required: No Data Type: Time (24-hour clock) |
The time the freight will be ready for any resulting pickup. Format:
|
| rateRequest/ pickup/ close |
Required: No Data Type: Time (24-hour clock) |
The time that the pickup location closes for any resulting pickup. Format:
|
| rateRequest/ liability |
Required: No Min Length: 1 Max Length: 1 |
The type of liability valuation being indicated for the freight. Valid values are:
|
| rateRequest/ declaredValue |
Required: No Data Type: Decimal |
The value being declared for the freight. Total Digits: 9 Fraction Digits: 2 |
| rateRequest/ hazmat |
Required: No Min Length: 1 Max Length: 1 |
Does the freight contain hazardous materials? Valid values are:
|
| rateRequest/ stackable |
Required: No Min Length: 1 Max Length: 1 |
Is the freight stackable? Valid values are:
|
| rateRequest/ baseCommodities |
Use the base commodity option for a standard rate quote. baseCommodities will return a LTL Standard Quote and possibly a LTL Guaranteed Quote. You must choose either baseCommodities or fullCommodities. |
|
| rateRequest/ baseCommodities/ commodity |
Commodities are used to describe the freight. | |
| rateRequest/ baseCommodities/ commodity/ class |
Required: Yes Data Type: Numerical |
This is the shipment class. Valid values are:
|
| rateRequest/ baseCommodities/ commodity/ weight |
Required: Yes Data Type: Integer Min Length: 1 Max Length: 9999999 |
The weight of the freight in pounds. |
| rateRequest/ fullCommodities |
Use the full commodity option for a guaranteed rate quote. fullCommodities will return Volume and Truckload, Time Critical and LTL quotes. You must choose either baseCommodities or fullCommodities. |
|
| rateRequest/ fullCommodities/ commodity |
Commodities are used to describe the freight. | |
| rateRequest/ fullCommodities/ commodity/ baseCommodity |
Describe the freight that is part of the potential shipment. | |
| rateRequest/ fullCommodities/ commodity/ baseCommodity/ class |
Required: Yes Data Type: Numerical |
This is the shipment class. Valid values are:
|
| rateRequest/ fullCommodities/ commodity/ baseCommodity/ weight |
Required: Yes Data Type: Integer Min Length: 1 Max Length: 9999999 |
The weight of the freight for the specified commodity in pounds. |
| rateRequest/ fullCommodities/ commodity/ pieces |
Required: Yes Data Type: Integer Min Length: 1 Max Length: 9999999 |
The number of pieces in the freight for the specified commodity. |
| rateRequest/ fullCommodities/ commodity/ pieceType |
Required: Yes Data Type: String Min Length: 2 Max Length: 2 |
A description of the freight container for the specified commodity. Valid values are:
|
| rateRequest/ fullCommodities/ commodity/ dimensions |
The length, width and height of the freight. | |
| rateRequest/ fullCommodities/ commodity/ dimensions/length |
Required: Yes Data Type: Integer Min Length: 1 Max Length: 999 |
The length of the freight for the specified commodity in inches. |
| rateRequest/ fullCommodities/ commodity/ dimensions/width |
Required: Yes Data Type: Integer Min Length: 1 Max Length: 999 |
The width of the freight for the specified commodity in inches. |
| rateRequest/ fullCommodities/ commodity/ dimensions/height |
Required: Yes Data Type: Integer Min Length: 1 Max Length: 999 |
The height of the freight for the specified commodity in inches. |
| rateRequest/ accessorials |
These are additional services that can be requested for a potential shipment. | |
| rateRequest/ accessorials/ accessorialCode |
Required: No Data Type: String Min Length: 1 Max Length: 6 |
Valid values are:
|
This web service operation allows an Estes customer to submit a request to test the connection to the Estes web service.
Service Operations
The pickup web service has the following operations:
- echo – A simple test operation to test connectivity to the RateQuote service
Preconditions
- N/A.
Postconditions
- A general error is provided indicating that the service is not responding (offline) at the time.
- A response is returned.
Input
<soapenv:Envelope xmlns:soapenv="https://schemas.xmlsoap.org/soap/envelope/" xmlns:rat="https://apidev.estes-express.com/ratequote">
<soapenv:Header/>
<soapenv:Body>
<rat:echoRequest>test</rat:echoRequest>
</soapenv:Body>
</soapenv:Envelope>Output
The operation will respond with the following format for a valid request:
<soapenv:Envelope xmlns:soapenv="https://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<rat:echoResponse xmlns:rat="https://ws.estesexpress.com/ratequote">test</rat:echoResponse>
</soapenv:Body>
</soapenv:Envelope>This web service operation allows an Estes customer to submit a request to obtain a standard or guaranteed rate quote for a shipment based on the provided shipment information.
Service Operations
The pickup web service has the following operations:
- getQuote – Create a standard or guarantee rate quote
Preconditions
- A requester must have a valid My Estes user account.
- Minimal information required to create a rate quote must be provided in the SOAP request to prevent the service from responding with errors.
Preconditions
- A requester must have a valid My Estes user account.
- Minimal information required to create a rate quote must be provided in the SOAP request to prevent the service from responding with errors.
Input for Standard Rate Quote
<soapenv:Envelope xmlns:soapenv="https://schemas.xmlsoap.org/soap/envelope/" xmlns:rat="https://ws.estesexpress.com/ratequote" xmlns:rat1="https://ws.estesexpress.com/schema/2017/07/ratequote">
<soapenv:Header>
<rat:auth>
<rat:user>test</rat:user>
<rat:password>test</rat:password>
</rat:auth>
</soapenv:Header>
<soapenv:Body>
<rat1:rateRequest>
<rat1:requestID>test</rat1:requestID>
<rat1:account>9999999</rat1:account>
<rat1:originPoint>
<rat1:countryCode>US</rat1:countryCode>
<rat1:postalCode>23229</rat1:postalCode>
<rat1:city>henrico</rat1:city>
<rat1:stateProvince>va</rat1:stateProvince>
</rat1:originPoint>
<rat1:destinationPoint>
<rat1:countryCode>US</rat1:countryCode>
<rat1:postalCode>94610</rat1:postalCode>
<rat1:city>oakland</rat1:city>
<rat1:stateProvince>ca</rat1:stateProvince>
</rat1:destinationPoint>
<rat1:payor>S</rat1:payor>
<rat1:terms>PPD</rat1:terms>
<rat1:pickup>
<rat1:date>2015-09-30</rat1:date>
</rat1:pickup>
<rat1:stackable>N</rat1:stackable>
<rat1:foodWarehouse>Publix</rat1:foodWarehouse>
<rat1:equipmentType>Trailer</rat1:equipmentType>
<rat1:declaredValueWaived/>
<rat1:baseCommodities>
<rat1:commodity>
<rat1:class>50</rat1:class>
<rat1:weight>1000</rat1:weight>
</rat1:commodity>
</rat1:baseCommodities>
</rat1:rateRequest>
</soapenv:Body>
</soapenv:Envelope>Output for Standard Rate Quote
The operation will respond with the following format if the request is valid:
<soapenv:Envelope xmlns:soapenv="https://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<rat:rateQuote xmlns:rat="https://ws.estesexpress.com/schema/2017/07/ratequote">
<rat:requestID>test</rat:requestID>
<rat:quote>
<rat:quoteNumber>1234567</rat:quoteNumber>
<rat:account>9999999</rat:account>
<rat:originPoint>
<rat:countryCode>US</rat:countryCode>
<rat:postalCode>23229</rat:postalCode>
<rat:city>HENRICO</rat:city>
<rat:stateProvince>VA</rat:stateProvince>
</rat:originPoint>
<rat:destinationPoint>
<rat:countryCode>US</rat:countryCode>
<rat:postalCode>94610</rat:postalCode>
<rat:city>OAKLAND</rat:city>
<rat:stateProvince>CA</rat:stateProvince>
</rat:destinationPoint>
<rat:payor>S</rat:payor>
<rat:shipmentTerms>P</rat:shipmentTerms>
<rat:pickup>
<rat:date>2016-11-16</rat:date>
</rat:pickup>
<rat:stackable>N</rat:stackable>
<rat1:foodWarehouse>Publix</rat1:foodWarehouse>
<rat1:equipmentType>Trailer</rat1:equipmentType>
<rat1:declaredValueWaived/>
<rat:lane>5</rat:lane>
<rat:disclaimer>
<rat:text>Guaranteed Disclaimer All quotes are estimates based on the information provided by the requesting party. Actual tariffs and contracts on file with Estes Express Lines and in place at the time of shipment prevail.</rat:text>
<rat:text>Standard LTL Disclaimer All quotes are estimates based on the information provided by the requesting party. Actual tariffs and contracts on file with Estes Express Lines and in place at the time of shipment prevail.</rat:text>
</rat:disclaimer>
</rat:quote>
</rat:rateQuote>
</soapenv:Body>
</soapenv:Envelope>Input for Guaranteed Rate Quote
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
<soap:Header>
<auth xmlns="https://ws.estesexpress.com/ratequote">
<user>test</user>
<password>test</password>
</auth>
</soap:Header>
<soap:Body>
<rateRequest xmlns="https://ws.estesexpress.com/schema/2017/07/ratequote">
<requestID>test</requestID>
<account>9999999</account>
<originPoint>
<countryCode>US</countryCode>
<postalCode>55317</postalCode>
<city>Chanhassen</city>
<stateProvince>MN</stateProvince>
</originPoint>
<destinationPoint>
<countryCode>US</countryCode>
<postalCode>22102</postalCode>
<city>MCLEAN</city>
<stateProvince>VA</stateProvince>
</destinationPoint>
<payor>S</payor>
<terms>PPD</terms>
<pickup>
<date>2015-09-30</date>
</pickup>
<fullCommodities>
<commodity>
<baseCommodity>
<class>100</class>
<weight>615</weight>
</baseCommodity>
<pieces>3</pieces>
<pieceType>CR</pieceType>
<dimensions>
<length>50</length>
<width>40</width>
<height>63</height>
</dimensions>
</commodity>
<commodity>
<baseCommodity>
<class>125</class>
<weight>406</weight>
</baseCommodity>
<pieces>1</pieces>
<pieceType>CR</pieceType>
<dimensions>
<length>50</length>
<width>40</width>
<height>53</height>
</dimensions>
</commodity>
<commodity>
<baseCommodity>
<class>125</class>
<weight>316</weight>
</baseCommodity>
<pieces>4</pieces>
<pieceType>CR</pieceType>
<dimensions>
<length>50</length>
<width>40</width>
<height>45</height>
</dimensions>
</commodity>
</fullCommodities>
</rateRequest>
</soap:Body>
</soap:Envelope>Output for Guaranteed Rate Quote
The operation will respond with the following format if the request is valid:
<soapenv:Envelope xmlns:soapenv="https://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<rat:rateQuote xmlns:rat="https://ws.estesexpress.com/schema/2017/07/ratequote">
<rat:requestID>test</rat:requestID>
<rat:quote>
<rat:quoteNumber>1234567</rat:quoteNumber>
<rat:account>9999999</rat:account>
<rat:originPoint>
<rat:countryCode>US</rat:countryCode>
<rat:postalCode>55317</rat:postalCode>
<rat:city>CHANHASSEN</rat:city>
<rat:stateProvince>MN</rat:stateProvince>
</rat:originPoint>
<rat:destinationPoint>
<rat:countryCode>US</rat:countryCode>
<rat:postalCode>22102</rat:postalCode>
<rat:city>MCLEAN</rat:city>
<rat:stateProvince>VA</rat:stateProvince>
</rat:destinationPoint>
<rat:payor>S</rat:payor>
<rat:shipmentTerms>P</rat:shipmentTerms>
<rat:pickup>
<rat:date>2016-11-16</rat:date>
</rat:pickup>
<rat:lane>3</rat:lane>
<rat:disclaimer>
<rat:text>Guaranteed Disclaimer All quotes are estimates based on the information provided by the requesting party. Actual tariffs and contracts on file with Estes Express Lines and in place at the time of shipment prevail.</rat:text>
<rat:text>Exclusive Use Disclaimer All quotes are estimates based on the information provided by the requesting party. Actual tariffs and contracts on file with Estes Express Lines and in place at the time of shipment prevail.</rat:text>
<rat:text>Standard LTL Disclaimer All quotes are estimates based on the information provided by the requesting party. Actual tariffs and contracts on file with Estes Express Lines and in place at the time of shipment prevail.</rat:text>
<rat:text>For delivery by 10 a.m. or 12 noon or for a customized time/date, expedited or exclusive use, all customers (including those with a Select Account Agreement) must contact the Time Critical department (1-866-378-3748, press 2) for authorization prior to shipping.</rat:text>
<rat:text>Time-critical guaranteed rates shown here may be different than the actual charges for your shipment. Differences may occur based on actual weight, dimensions and other factors. Exclusive Use rate is based on the availability of the specific vehicle type quoted at the time of order confirmation. Time-critical quotes expire at 3:00 p.m. today. Shipments must be tendered prior to 3:00 p.m. local shipping time on the day of pickup.</rat:text>
<rat:text>*Transit times apply to standard Estes LTL shipments and are based on the actual date and time of the pickup, which may be different from the shipment date entered. Travel times for specialty services and custom solutions provided by other Estes operating entities may differ based on service selected.</rat:text>
<rat:text>Additional charges may apply to shipments to or from Cape Cod, Massachusetts; Harbor points in the state of Washington; remote areas of northern Canada; remote areas of Montana, Nevada, Oregon, Utah, and the Eastern Sierra of California. Please refer to EXLA 105 series tariff Items 290 through 299 for a complete list of points and applicable charges.</rat:text>
<rat:text>All quotes are estimates based on the information provided by the requesting party. Actual tariffs and contracts on file at Estes Express Lines and in place at the time of shipment prevail. Unless otherwise provided, rules and service charges provided in EXLA 105 series tariff are applicable. Guaranteed LTL shipments consuming over 12 linear feet of trailer, exceeding 10,000 pounds OR containing seven (7) or more non-stackable skids will incur additional surcharges. Please call or email the Time Critical department (1-866-378-3748, press 2 or solutions@estes-express.com) for guaranteed volume, commodity-rated and over-length shipments.</rat:text>
<rat:text>The National Motor Freight Classification governs all freight classification disputes and is the sole source for determining actual classes. On collect shipments, if the consignee has a pricing program with Estes Express Lines, the consignee pricing prevails. Rates provided are only applicable to LTL shipments serviced by Estes Express Lines. Automated rate quotes are not applicable to service provided by other Estes operating entities.</rat:text>
<rat:text>*Rates shown here may be different than the actual charges for your shipment. Differences may occur based on actual weight, dimensions, and other factors. Consult the Estes Express Lines tariff for details. Exclusive Use rate is based on the availability of the specific vehicle type quoted at the time of order confirmation.</rat:text>
<rat:text>Time critical quotes expire at 3:00 PM today. Shipments must be tendered prior to 3:00 PM local shipping time on day of pickup.</rat:text>
</rat:disclaimer>
<rat:commodityInfo>
<rat:commodity>
<rat:class>100.0</rat:class>
<rat:pieces>3</rat:pieces>
<rat:pieceType>CR</rat:pieceType>
<rat:weight>615</rat:weight>
<rat:dimensions>
<rat:length>50</rat:length>
<rat:width>40</rat:width>
<rat:height>63</rat:height>
</rat:dimensions>
<rat:rate>51.46</rat:rate>
<rat:charge>316.48</rat:charge>
</rat:commodity>
<rat:commodity>
<rat:class>125.0</rat:class>
<rat:pieces>1</rat:pieces>
<rat:pieceType>CR</rat:pieceType>
<rat:weight>406</rat:weight>
<rat:dimensions>
<rat:length>50</rat:length>
<rat:width>40</rat:width>
<rat:height>53</rat:height>
</rat:dimensions>
<rat:rate>64.33</rat:rate>
<rat:charge>261.18</rat:charge>
</rat:commodity>
<rat:commodity>
<rat:class>125.0</rat:class>
<rat:pieces>4</rat:pieces>
<rat:pieceType>CR</rat:pieceType>
<rat:weight>316</rat:weight>
<rat:dimensions>
<rat:length>50</rat:length>
<rat:width>40</rat:width>
<rat:height>45</rat:height>
</rat:dimensions>
<rat:rate>64.33</rat:rate>
<rat:charge>203.28</rat:charge>
</rat:commodity>
</rat:commodityInfo>
<rat:pricing>
<rat:price>
<rat:deliveryDate>2016-11-21</rat:deliveryDate>
<rat:deliveryTime>17:00:00.000</rat:deliveryTime>
<rat:serviceLevel>LTL Standard Transit: 5PM</rat:serviceLevel>
<rat:discount>0.614</rat:discount>
<rat:totalDiscount>479.5</rat:totalDiscount>
<rat:standardPrice>345.15</rat:standardPrice>
</rat:price>
<rat:price>
<rat:deliveryDate>2016-11-21</rat:deliveryDate>
<rat:deliveryTime>12:00:00.000</rat:deliveryTime>
<rat:serviceLevel>Standard Transit Plus: 12PM</rat:serviceLevel>
<rat:discount>0.614</rat:discount>
<rat:totalDiscount>479.5</rat:totalDiscount>
<rat:guaranteedPrice>657.52</rat:guaranteedPrice>
</rat:price>
<rat:price>
<rat:deliveryDate>2016-11-17</rat:deliveryDate>
<rat:deliveryTime>04:00:00.000</rat:deliveryTime>
<rat:serviceLevel>Exclusive Use</rat:serviceLevel>
<rat:guaranteedPrice>4408.0</rat:guaranteedPrice>
</rat:price>
</rat:pricing>
</rat:quote>
</rat:rateQuote>
</soapenv:Body>
</soapenv:Envelope>Error Message Response
In the event that a business validation rule is violated, error descriptions will be returned to the user in the following format:
<soapenv:Envelope xmlns:soapenv="https://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header/>
<soapenv:Body>
<soapenv:Fault>
<faultcode>soapenv:Server</faultcode>
<faultstring>Schema validation error</faultstring>
<detail>
<rat:schemaError xmlns:rat="https://ws.estesexpress.com/ratequote">
<rat:error>Error message</rat:error>
<rat:error>Error message</rat:error>
</rat:schemaError>
</detail>
</soapenv:Fault>
</soapenv:Body>
</soapenv:Envelope>Simplify Your Shipping with APIs
See the codes, definitions, and capabilities of our latest REST APIs.