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
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 pieces, pallets or handling units. Required if allowSpot = "Y" |
Additional parameters below required to submit individual piece 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 piece dimensions. |
PieceLength1 thru PieceLength20 | numeric value for the length of the piece. Required if allowSpot = "Y" |
PieceWidth1 thru PieceWidth20 | numeric value for width of the piece. Required if allowSpot = "Y" |
PieceHeight1 thru PieceHeight20 | numeric value for height of the piece. 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 pieces, pallets or handling units. Required if allowSpot = "Y" |
Additional parameters required for Dimension-Based Dynamic Pricing. | |
DimsOption | set to "I" for individual piece dimensions. |
PieceLength1 thru PieceLength20 | numeric value for the length of the piece. |
PieceWidth1 thru PieceWidth20 | numeric value for width of the piece. |
PieceHeight1 thru PieceHeight20 | numeric value for height of the piece. |
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 pieces, pallets or 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. |
ACCESORIALS | |
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 |
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. |