XML RATE QUOTES

This document deals with obtaining automated rate quotes via XML. To utilize the HTTP rate quote API, you need to submit an HTTP request with a URL constructed as follows (replacing “xxx” with your three-character CLI acronym):

Please strip out all non-standard or special characters from text fields. Including such characters in text fields will cause requests to fail.

https://www.standardforwarding.com/scripts/cgiip.exe/WService=wsbroker1/ratequote.xml?xmlv=yes&xmluser=USERID&xmlpass=PASSWORD&vozip=90210&vdzip=11598&wpieces[1]=10&wpallets[1]=1&wweight[1]=1320&vclass[1]=92.5&RESDEL=Yes

• USERNAME needs to be the user-id that company would use to login to the website.
• PASSWORD needs to be the password that company would use to login to the website.

Required Variables: #

• xmluser = the user-id that company would use to log in to the website. In the example above, the user-id is “USERID.”
• xmlpass = the password that company would use to login to the website. In the example above, the password is “PASSWORD.”
• vozip = origin (shipper’s) zip code. In the example above, the zip is “90210.”
• vdzip = destination (consignee’s) zip code. In the example above, the zip is “11598.”
• wpieces[1] = number of pieces being shipped on line “1.” In the example above, the pieces is “10.”
• wpallets[1] = number of pallets being shipped on line “1.” In the example above, there is “1.”
• wweight[1] = weight in pounds being shipped on line “1.” In the example above, the weight is “1320.”
• vclass[1] = freight class being shipped on line “1.” In the example above, the class is “92.5.”

Optional Variables: #

• If you add the field “quotenumber” with a value of “yes”, you will receive a Quote Number.
• Additional freight lines: The variables wpieces, wpallets, wweights, and vclass are an array. If there are additional freight lines then these four variables can be submitted with the next integer value (i.e., 2, 3, 4) inside of the brackets [].
• Accessorials: The accessorial code can be submitted with an argument of “yes.” In the example above, the accessorial is: “RESDEL.” For a list of accessorial charges, click here:
  https://www.standardforwarding.com/scripts/cgiip.exe/WService=wsbroker1/keywordlist.xml

Response: #

The system will provide an XML response which can be parsed to determine the charges, etc. The response for the example is:

<ratequote>
  <ratequoteline>
    <pallets>1</pallets>
    <pieces>10</pieces>
    <chargedesc>CHARGES</chargedesc>
    <weight>1320</weight>
    <dimweight>0</dimweight>
    <class>092</class>
    <rate>86.10</rate>
    <charge>1,136.52</charge>
  </ratequoteline>
  <ratequoteline>
    <chargedesc>DISCOUNT 76</chargedesc>
    <charge>-63.76</charge>
  </ratequoteline>
  <ratequoteline>
    <chargedesc>FUEL SURCHARGE</chargedesc>
    <charge>90.01</charge>
  </ratequoteline>
  <ratequoteline>
    <chargedesc>RESIDENTIAL DELIVERY</chargedesc>
    <charge>66.00</charge>
  </ratequoteline>
  <ratequoteline>
    <chargedesc>DELIVERY SURCHARGE</chargedesc>
    <charge>25.00</charge>
  </ratequoteline>
  <quotetotal>453.77</quotetotal>
  <totalpallets>1</totalpallets>
  <totalpieces>10</totalpieces>
  <totalweight>1320</totalweight>
  <busdays>6</busdays>
  <quoteversion>ratequote-20100927</quoteversion>
  <quotedatetime>08/10/2011 15:15:07.062-07:00</quotedatetime>
</ratequote>