Setup Requirements
Saia Web Services require secure information. You must be registered for Saia Secure and the account must have
a valid Contact Name, Local Phone Number. To register please by click the Login/Register Link on the top right of the Saia Home Page
and complete required information. To update account information please login to SaiaSecure and click the
Update Account Information link on the SaiaSecure home page.
General Programming Overview
All Request Documents have a required element called <TestMode>. TestMode must be set to Yes, this allows the exchange of generic information
for testing applications without issuing live data. Once testing is complete switch to No to initiate live data.
All Response Documents contain 4 error handling elements <Code>, <Element>, <Fault>,
and <Message>. Verification is required for each response. If the <Code> element contains a value
then an error has occurred. Proceed to other elements for description information about the specific failure.
All Elements are case sensitive to ensure compatibility with existing programming languages. If casing is not
correct the system will assume the element is missing and the action will fail during validation.
Adding the <?xml version="1.0" encoding="utf-8"?> prefix on the first line of the XML document is not mandatory
within our Request Documents, however it is common practice. All Response XML Documents will contain this prefix.
When programming against Saia's XML Documents do not access the elements based on their position
within the document. Access the element by name only. Saia reserves the right to
add new elements into this document at any location based on customer requests and
requirements.
Securing Rate Quote Pricing
In order for the this quote pricing to be honored the quote number must be referenced on original bill of lading given to the driver at pickup.
Update History by Version
Version 1 (V1) - Updates
- Introduced versioning to provide for structured adoption of released updated.
- Introduced request property PickupDate which will take a past date up to 1 year from current date to allow for auditing of historic shipments. Future dates are not accepted.
- All rate quote request with accessorial codes TradeShowPickup or TradeShowDelivery will auto update all weight classes to 125 as per Saia's tariff.
Web Service URLs (Uniform Resource Locator)
Production - Web Service URLs (Uniform Resource Locator)
When submitting quote request that will be used with actual shipment point to one of the following URL
Version 1 - Below are URL links for Version 1 release of our RateQuote Web Service.
DEPRECATED - Below are the original versionless list of URL links used to access Saia's RateQuote Web Service. (These should not be used for new implementations and current implementations should schedule moving to the latest versioned URL links.)
Test / Pilot - Web Service URLs (Uniform Resource Locator)
The following endpoints are to be used during development and integration testing.
Version 1 - Below are URL links for Version 1 test/Pilot RateQuote Web Service.
Request Document - RateQuote <Create>
Below is a list of the elements and descriptions used to build a <Create> document/object to create a rate quote.
Note: These rates are provided for informational purposes only and are not a
binding contract. Actual charges shall be determined by actual shipment
characteristics and any Saia rules tariff applicable at time of shipment.
Information must be accurate for a correct rate.
Element / Parameter |
Type |
Required |
MaxLength |
Description |
<Create> |
Array |
Yes |
1 |
Document Name |
<UserID> |
String |
Yes |
20 |
Saia Secure User ID |
<Password> |
String |
Yes |
14 |
Saia Secure Password |
<TestMode> |
String |
Yes |
1 |
Testing Flag
Y = Yes (Testing)
N = No (Not Testing)
Note: This element is used to verify your request document is formatted correctly and contains valid data, once testing is complete switch to <TestMode>N</TestMode>.
|
<BillingTerms> |
String |
Yes |
10 |
Billing Terms
Prepaid
Collect
|
<AccountNumber> |
String |
Yes |
7 |
Saia Account Number |
<Application> |
String |
Yes |
10 |
Rate Application
Inbound
Outbound
ThirdParty
Note: This element is used to specify how rates are applied to quote.
Outbound requires destination city, state and zip code.
Inbound requires origin city, state and zip code.
Third Party requires both origin and destination city state and zip codes.
|
<PickupDate> |
String |
No |
10 |
Date of Pickup - (Introduced in Version 1) Can be past date up to one year. No future dates allowed. If omitted current pricing is used.
Format: YYYY-MM-DD, Local Date
|
<OriginCity> |
String |
See Note |
20 |
Origin City
Note: Origin City, State, and Zipcode are required for Inbound and ThirdParty requests.
|
<OriginState> |
String |
|
2 |
Origin State
|
<OriginZipcode> |
String |
|
6 |
Origin Zipcode
|
<DestinationCity> |
String |
See Note |
20 |
Destination City
Note: Destination City, State, and Zipcode are required for Outbound and ThirdParty requests.
|
<DestinationState> |
String |
|
2 |
Destination State
Note: Use a state of MX if the City and Zipcode are for Mexico.
|
<DestinationZipcode> |
String |
|
6 |
Destination Zipcode
|
<CODAmount> |
Decimal |
|
7, 2 |
COD Amount
|
<WeightUnits> |
String |
See Note |
3 |
Weight Units of Measurement
Note: The default of LBS is used if element is not specified.
LBS = Pounds
KGS = Kilograms
|
<TotalCube> |
Decimal |
See Note |
7, 2 |
Total Cube
Note: Total Cube is only required when calculating cube based rates. For example to our Offshore Markets such as
Hawaii, Alaska, Mexico, Puerto Rico, etc... The Dimensions array below can also be specified
and the system will auto calculate the Total Cube element.
|
<TotalCubeUnits> |
String |
See Note |
4 |
Total Cube Units of Measurement
Note: The default of CUFT is used if element is not specified.
CUFT = Cubic Feet
CM = Cubic Meters
|
<CommodityDescription> |
String |
See Note |
30 |
Commodity Description
Note: Commodity Description can optionally be provided.
|
<DeclaredValue> |
Decimal |
See Note |
9, 2 |
Declared Value
Note: Declared Value can optionally be provided.
|
<BorderLocation> |
String |
See Note |
6 |
U.S. Border Crossing Location Zipcode
Note: This element is only useful for quotes with a Destination State outside the Continental United States.
The default U.S. Border Crossing Location Zipcode for the Destination State is used if element is not specified.
The purpose of this element is to set the zipcode which the freight will cross the U.S. border for
rating purposes.
98424 = Destination State: AK via Fife, Wa (Default for AK) 32201 = Destination State: DR via Jacksonville, Fl (Default for DR) 92833 = Destination State: GU via Orange, Ca (Default for GU) 92831 = Destination State: HI via Orange, Ca (Default for HI) 78040 = Destination State: MX via Laredo, Tx (Default for MX) 79905 = Destination State: MX via El Paso, Tx 32201 = Destination State: PR via Jacksonville, Fl (Default for PR) 32201 = Destination State: VI via Jacksonville, Fl (Default for VI)
|
<FullValueCoverage> |
Decimal |
No. See Note |
9,2 |
Full Value Coverage
Note: Full Value Coverage is the entire covered amount being requested by you for carrier liability on the shipment.
The amount that you request for Full Value Coverage replaces in its entirety all other carrier cargo liability limitations, including any 'per pound' limitations.
Unless special arrangements are made with Saia in advance of shipment, Full Value Coverage request cannot exceed $250,000.00 for new commodities, or
$1000.00 per package for household Goods and Personal Effects, $50,000.00 on shipments originating in Mexico and is not available for certain prohibited
commodities. See Saia Rules Tariff Item 108 for all terms and conditions applicable to full value coverage.
|
<ExcessiveLengthTotalInches> |
string |
No. See Note |
3 |
ExcessiveLengthTotalInches
If using the accessorial ExcessiveLength, this is a required field. Excessive Length Total Inches is the length in inches.
|
<Promotion> |
string |
No |
NoLimit |
Promotion
Promotion information for multi-shipment discount incentive. Should be displayed to user so they are aware of available additional discounts if they shipment multiple shipments at a single pickup.
|
<Details> |
Array |
Yes |
1 |
Collection of Detail Items |
<DetailItem> |
Array |
Yes |
5 |
Detail Item describing the specific rate quote weight and class details.
Note: Saia's rate quote system currently only supports 5 detail items max.
|
<Weight> |
Decimal |
Yes |
7, 0 |
Weight
Note: The units of measurement are based on the value specified in the WeightUnits element.
|
<Class> |
String |
Yes |
6 |
NMFC Class Code
Please contact your Traffic Department concerning NMFC class codes.
50
55
60
65
70
77.5
85
92.5
100
110
125
150
175
200
250
300
400
500
|
<Length> |
Decimal |
No |
2, 0 |
Length of pallet in Inches (Max. 48)
Note: This element is only required for per pallet based rates.
|
<Width> |
Decimal |
No |
2, 0 |
Width of pallet in Inches (Max. 48)
Note: This element is only required for per pallet based rates.
|
<Height> |
Decimal |
No |
2, 0 |
Height of pallet in Inches (Max. 84)
Note: This element is only required for per pallet based rates.
|
</DetailItem> |
Array |
Yes |
5 |
|
</Details> |
Array |
Yes |
1 |
|
<Accessorials> |
Array |
|
1 |
Collection of Accessorial Items |
<AccessorialItem> |
Array |
Yes |
No Limit |
Accessorial Item describing the specific accessorial to be added to the rate quote.
|
<Code> |
String |
Yes |
50 |
Accessorial Code
Note: This list does not contain all Saia Standard Charges only the most frequently used.
For all charges please refer to the current Saia 170 Rules & Special Charges. Please click
the link for each code to view specific accessorial details.
SingleShipment
ArrivalNotice/Appointment
Marking/Tagging
LimitedAccessLocationPU
LimitedAccessLocation
LiftgateServicePU
LiftgateService
InBond
InsidePickup
InsideDelivery
ExcessiveLengt
Hazardous
ProtectionFromFreezing
ResidentialPickup
ResidentialDelivery
RoomOfChoice
WhiteGlove
Sorting/Segregating
Sorting/SegregatingPickup
BorderCrossing
TradeShowPickup - (All weight changed to class 125)
TradeShowDelivery - (All weight changed to class 125)
XtremeAssurance
GroceryWarehouse
|
</AccessorialItem> |
Array |
Yes |
No Limit |
|
</Accessorials> |
Array |
|
1 |
|
<Dimensions> |
Array |
See Note |
1 |
Collection of Dimension Items
Note: Dimensions are only required when calculating cube based rates. However if the TotalCube element is specified the individual
dimensions are not required. If the individual dimensions are specified the TotalCube element will be auto calculated.
|
<DimensionItem> |
Array |
Yes |
10 |
Dimension Item describing the specific rate quote cube information.
Note: Saia's rate quote system currently only supports 10 dimension items max.
|
<Length> |
Decimal |
Yes |
7, 2 |
Length
|
<Width> |
Decimal |
Yes |
7, 2 |
Width
|
<Height> |
Decimal |
Yes |
7, 2 |
Height
|
<Type> |
String |
See Note |
2 |
Type of Measurement
Note: The default of IN is used if element is not specified.
IN = Inches
FT = Feet
M = Meters
CM = Centimeters
|
<Units> |
Decimal |
Yes |
2, 0 |
# of Units
|
</DimensionItem> |
Array |
Yes |
10 |
|
</Dimensions> |
Array |
See Note |
1 |
|
</Create> |
Array |
Yes |
1 |
|
Response Document - RateQuote <Response>
Below is a list of the elements and descriptions used to read a <Response> document/object returned by
our system to verify your request document/object has been processed successfully and retrieve
a rate quote number.
This quote is based on the information provided. The rates provided are for information purposes only and are not a binding contract. Actual charges shall be determined by the current Saia rules tariff, the actual shipment characteristics, and any accessorial charges that are applicable to the shipment at the time of the shipment. If volume of shipment exceeds 10 standard pallet spaces or 16' of vehicle used, contact the truckload department.
Notes applicable to specific states:
AK | Above rates and times are based on the options you entered. Total charges are estimated based on information provided and may NOT include all applicable accessorial charges from the Saia 170 D Rules Tariff. Transit times are approximate and may vary based on actual origin, destination, and day of the week shipped. Guaranteed or Expedited options are not available on non-direct shipments. Cargo liability may be subject to limitations as outlined in the Saia 170 D Rules Tariff. Please review Item 108 of the Saia 170 D Rules tariff for more information. |
DR | Above rates and times are based on the options you entered. Total charges are estimated based on information provided and may NOT include all applicable accessorial charges from the Saia 170 D Rules Tariff. Transit times are approximate and may vary based on actual origin, destination, and day of the week shipped. Guaranteed or Expedited options are not available on non-direct shipments. Cargo liability may be subject to limitations as outlined in the Saia 170 D Rules Tariff. Please review Item 108 of the Saia 170 D Rules tariff for more information. |
GU | Above rates and times are based on the options you entered. Total charges are estimated based on information provided and may NOT include all applicable accessorial charges from the Saia 170 D Rules Tariff. Transit times are approximate and may vary based on actual origin, destination, and day of the week shipped. Guaranteed or Expedited options are not available on non-direct shipments. Cargo liability may be subject to limitations as outlined in the Saia 170 D Rules Tariff. Please review Item 108 of the Saia 170 D Rules tariff for more information. |
HI | Above rates and times are based on the options you entered. Total charges are estimated based on information provided and may NOT include all applicable accessorial charges from the Saia 170 D Rules Tariff. Transit times are approximate and may vary based on actual origin, destination, and day of the week shipped. Guaranteed or Expedited options are not available on non-direct shipments. Cargo liability may be subject to limitations as outlined in the Saia 170 D Rules Tariff. Please review Item 108 of the Saia 170 D Rules tariff for more information. |
MX | Unless otherwise mentioned, the Rate is based on pallets/units being stackable. If pallets/units are not stackable per bill of lading instructions, a W&R will be issued and the height will be based at 90" which will change the density/class and rate. The Mexico rates do not include any border crossing drayage services between the Laredo, TX and Nuevo Laredo, Tamaulipas gateway, nor do they include any US/Mexico Customs Brokerage Services. All Taxes, Duties or Service fees by US or Mexican Customs will be settled between Importer / Exporter and their Customs Brokerage Company. The above mentioned rates do not include any accessorial fees such as loading, unloading, waiting times, appointments, storage, etc. Rates in Mexico do not include Cargo Liability Insurance. Cargo Liability Insurance is available while freight is in Mexico for an additional cost of 1.0% of total commodity value. If this option is required, it must be clearly stated on Original Bill of Lading in 1" Black Letters. The cost may vary depending on commodity and value. This service must be requested PRIOR to the shipment moving in transit within Mexico. If the shipment is Hazardous Material and not disclosed at time of rate request, the rate will not be applicable. |
PR | Above rates and times are based on the options you entered. Total charges are estimated based on information provided and may NOT include all applicable accessorial charges from the Saia 170 D Rules Tariff. Transit times are approximate and may vary based on actual origin, destination, and day of the week shipped. Guaranteed or Expedited options are not available on non-direct shipments. Cargo liability may be subject to limitations as outlined in the Saia 170 D Rules Tariff. Please review Item 108 of the Saia 170 D Rules tariff for more information. |
VI | Above rates and times are based on the options you entered. Total charges are estimated based on information provided and may NOT include all applicable accessorial charges from the Saia 170 D Rules Tariff. Transit times are approximate and may vary based on actual origin, destination, and day of the week shipped. Guaranteed or Expedited options are not available on non-direct shipments. Cargo liability may be subject to limitations as outlined in the Saia 170 D Rules Tariff. Please review Item 108 of the Saia 170 D Rules tariff for more information. |