WebConnect for RESTful MySEFL Rate Quotes:

The ability to submit, retrieve and list MySEFL Rate Quotes with responses available in XML or JSON is exposed through a RESTful Web Service. For each of these requests your MySEFL credentials are required and should be sent using Basic HTTP Authorization via the Authorization HTTP header. The WADL for this web service can be accessed here.

To submit a quote, an HTTP POST request should be sent to https://www.sefl.com/webconnect/ratequotes/rest/submitQuote providing the Submit Parameters listed below as form data. The response from a successful POST will include a quote number for reference as well as links to the quote summary and full quote detail.

To retrieve a quote summary, an HTTP GET request should be sent to https://www.sefl.com/webconnect/ratequotes/rest/XXXXXXXXX.
To retrieve a quote with full detail, an HTTP GET request should be sent to https://www.sefl.com/webconnect/ratequotes/rest/XXXXXXXXX?ReturnDetail=Y
where XXXXXXXXX is the quote number being referenced. The response from a successful GET will include "status" which will have one of the following values


To request a list of recently submitted quotes, an HTTP GET request should be sent to https://www.sefl.com/webconnect/ratequotes/rest/list.

Sample java code utilizing this service as well as a helper class for performing the HTTP POST and GET methods is available here. In addition example responses are available here.

Submit Parameters.

CustomerAccount Account number of party requesting quote
returnX set to "Y"
rateXML set to "Y"
CustomerName Name of customer for account number specified above
CustomerStreet Street address of customer requesting quote
CustomerCity City for customer requesting quote
CustomerState State for customer requesting quote
CustomerZip 5 digit zip code for customer requesting quote
Option "S" if customer is the shipper, "C" if consignee, "T" if third party
PickupDateMM 2 digit Month for pickup date (01-12)
PickupDateDD 2 digit day of Month for pickup date
PickupDateYYYY 4 digit year for pickup date
Terms "P" for prepaid, "C" for collect
EmailAddress Email address where quote will be sent if it must be rated by hand
OriginCity  
OriginState  
OriginZip  
OrigCountry "U" if US origin, "C" if Canadian and "M" if Mexican
DestinationCity  
DestinationState  
DestinationZip  
DestCountry "U" if US destination, "C" if Canadian and "M" if Mexican
Class1 thru Class20 valid entries: 50,55,60,65,70,77,775,85,92,925,100,110,125,150,175,200,250,300,400,500
Weight1 thru Weight20  
WeightUnitOfMeasure1 thru WeightUnitOfMeasure20 Valid Entries: LBS, KG If Weight UOM is not present the system will assume LBS.
CubicFt1 thru CubicFt20 Required on shipments to or from Puerto Rico and for customers with density based rates
Description1 thru Description20 You must provide a description if shipping to/from Alaska, Hawaii, or Mexico
  * at least one class/weight pair must be passed in
Additional parameters below required on shipments greater than 5,000 lbs. (2,267.962kg) or occupying at least 10 feet of trailer space.
allowSpot set to "Y" on any shipment greater than 5,000lbs or occupying at least 10ft of trailer space.
DimsOption set to "T" for total shipment dimensions.
floorSpace numeric value for floor space (entire shipment length) in whole feet. Required if allowSpot = "Y"
heightSpace numeric value for entire shipment height in whole feet. Required if allowSpot = "Y"
widthSpace numeric value for entire shipment width in whole feet. Required if allowSpot = "Y"
Pieces1 thru Pieces20 number of handling units. Required if allowSpot = "Y"
Additional parameters below required to submit individual handling unit dimensions for shipments greater than 5,000 lbs. or occupying at least 10 feet of trailer space.
allowSpot set to "Y" on any shipment greater than 5,000lbs or occupying at least 10ft of trailer space.
DimsOption set to "I" for individual handling unit dimensions.
PieceLength1 thru PieceLength20 numeric value for the length of the handling unit. Required if allowSpot = "Y"
PieceWidth1 thru PieceWidth20 numeric value for width of the handling unit. Required if allowSpot = "Y"
PieceHeight1 thru PieceHeight20 numeric value for height of the handling unit. Required if allowSpot = "Y"
UnitOfMeasure1 thru UnitOfMeasure20 unit of measurement (F = Feet, I = Inches, M = Meters or C = Centimeters). Required if DimsOption = "I"
NumberOfUnits1 thru NumberOfUnits20 numeric value for the number of units. Required if DimsOption = "I"
Pieces1 thru Pieces20 number of handling units. Required if allowSpot = "Y"
Additional parameters required for Dimension-Based Dynamic Pricing.
DimsOption set to "I" for individual handling unit dimensions.
PieceLength1 thru PieceLength20 numeric value for the length of the handling unit.
PieceWidth1 thru PieceWidth20 numeric value for width of the handling unit.
PieceHeight1 thru PieceHeight20 numeric value for height of the handling unit.
UnitOfMeasure1 thru UnitOfMeasure20 unit of measurement (F = Feet, I = Inches, M = Meters or C = Centimeters). Required if DimsOption = "I"
NumberOfUnits1 thru NumberOfUnits20 numeric value for the number of units. Required if DimsOption = "I"
Additional parameter required for Class-Based Dynamic Pricing.
Pieces1 thru Pieces20 number of handling units.
Additional parameters required for Pallet Pricing.
shipPallet must always be set to TRUE.
Pieces1 thru Pieces20 number of pieces or pallets for each detail line.
PcsPlts1 thru PcsPlts20 specified for each commodity being shipped. Use PLTS for pallets or PCS for any other type.
Additional parameters for NMFC Specific Pricing.
NMFC1 thru NMFC20 NMFC item number of commodity.
NMFCSub1 thru NMFCSub20 NMFC item sub number of commodity.
   
ACCESSORIALS  
chkHM "on" for Hazardous Materials shipments
chkTL "on" for Truck Load shipments
TruckloadVanPup if chkTL = "on", must specify whether it's a Van (value="Van") or a Pup load (value="Pup").
TruckLoadPercent if chkTL = "on", must specify truck load % - value 0 to 100
chkDG "on" for Day Definite Guaranteed Service (only valid for direct points)
chkNG "on" for Noon Guaranteed Service (only valid for certain destinations)
chkIM "on" for Import Shipment
chkEX "on" for Export Shipment
chkAN "on" for Arrival Notice
chkLAP "on" for Limited Access Pickup
chkLAD "on" for Limited Access Delivery
chkID "on" for Inside Delivery
chkIB "on" for In Bond Fee
chkLGD "on" for Delivery Lift Gate
chkLGP "on" for Pickup Lift Gate
chkAPU "on" for Airport Pickup
chkAPD "on" for Airport Delivery
chkCVP "on" for Convention Center Pickup
chkCVD "on" for Convention Center Delivery
chkIP "on" for Inside Pickup
chkRC "on" for Redeliver to Consignee
chkPR "on" for Private Residence
chkRD "on" for Redeliver Dock Pickup
chkSHC "on" if shipper will bring shipment to carrier's dock, instead of carrier pickup
chkSHC07 "on" if consignee will pickup shipment at carrier's dock, instead of carrier delivery
chkRM "on" for remarking charge
chkFER "on" for ferry delivery charge
chkSPF "on" for blind shipment
chkSort "on" for Sort and Segregate
SortNum Number of pieces to be sorted.
chkOD "on" for Over Dimension Freight
ODLength Required Parameter when chkOD is selected. Should be length in whole feet or inches of overlength article.
ODLengthUnit Required Parameter when ODLength is provided. Unit of measurement (F = Feet, I = Inches).
chkIN "on" for Full Value Insurance
FVInsuranceAmount Required Parameter when chkIN is selected. Should be monetary amount.
   

 

 

Retrieve Full Detail Output:

TAG NAME DESCRIPTION
errorOccured True/False
errorMessage Any error messages that may cause the quote information to not be returned
quoteNumber The quote confirmation number
status Status of quote. RAT=rated, ENT=pending processing, UTR=unable to rate
pickupDate Pickup date requested for quote (does not generate a pickup request)
custAccount Customer account code of party requesting quote (following cust* info applies to this account)
custName Customer name
custAddress Customer Address
custAddress2 Customer Address
custCity Cutomer City
custZip Customer Zip
origCity Shipment origin city
origState Shipment origin state
origZip Shipment origin zip code
origDIP Value will be D for a directly serviced origin point, I for Interline service, P for interline service provided by one of our Partners
origPhone Origin terminal phone number
destCity Shipment destination city
destState Shipment destination state
destZip Shipment destintion zip code
destDIP Value will be D for a directly serviced destintation point, I for Interline service, or P for interline service provided by one of our Partners
destPhone Destination terminal phone number
quoteDIP Will be D if both origin and destination points are directly serviced, I if one point is an Interline, or P if one is a Partner Interline
transitMiles Miles the shipment will travel, may or may not contain the interline miles
transitTime Trasit Time for the shipment
details

The fields under the detail tag are the detail lines for the quote normally found on the jsp page when requesting a quote via the web page:

typeCharge P for prepaid, C for Collect, T for third Party
description May include items such as "MIN FRT CHG", "DISCOUNT", "NET FRT CHG", etc
weight Weight of shipment, or blank for some detail lines if not applicable
ratingClass Class of shipments, or blank if not applicable
rate cwt rate
charges charges applicable for this detail line entry

 
rateQuote Final quote amount
discountPercent discount applied to shipment
discountAmount discount value
specInstr Any special notations that affect/may affect your pricing/quote (i.e. exceptions, truckloads, import, export, etc).
quoteType Value will be D for Dynamic Pricing, TC for Tariff Class pricing, TD for Tariff Density Pricing and S for Spot Quote Pricing.