LTL Rate: References

POST https://api.ushipsandbox.com/v2/raterequests

  • Provide specific and accurate rate request information for Service Providers to provide the most accurate rates.

  • Service Providers respond to the notification with bookable rates.

    • Although Optional the following fields are important to avoid REBILLS

      • Accessorial values associated with Pickup and Delivery

        • These options should be selectable in integrators platform during shipping flow
      • Address Type i.e. BusinessWithLoadingDockOrForklift

  • Response: Upon successful call a 201 code will be returned, and the rateRequestId will be located in the Response Headers under Location

Javascript
Copy

Route Object

Although an optional field, it's strongly suggested that integrators use this field and add the proper AddressType in order to receive a precise rate. You can view valid AddressTypes here: Address Type

earliestArrival and latestArrival MUST be the same date and timeFrameType must be set to "on." This is due to the fact that LTL carriers need a single day window and not a range. Failure to set this properly will result in an empty rate set when rates are retrieved. Please reach out to API support with any questions at api-support@uship.com.

  • The "streetAddress" is required
  • If no address type is specified, the default is "Residence" where the "companyName" field is not required in the contact object.
  • The pick up time frame is the only one available and is required. Do not specify the delivery time frame.
  • The only time frame type you can specify for pick up is "on" where the time frame dates must match exactly.
  • Either specify the zip codes or the latitude and longitude for both pick up and delivery addresses.

Commodity Object

FieldTypeDescription
commodityStringSpecify the LTL Freight commodity found in the reference enumeration section below. "Commodity Codes". Required.
unitCountIntegerIf no value is provided, the default is set to one (1).
handlingUnitString

The method in which the unit is handled by a carrier during transport. If a number of packages have been secured to a single pallet and cannot be separated during transport, the quantity is referred to as (1) handling unit. Required. Dimensions: Include pallets and other packaging materials.

Example: A shipment containing 10 boxes stretch-wrapped to a single pallet should be described as (1) handling unit. A shipment containing 10 un-palletized “loose” boxes should be described as (10) handling units.

Valid example string for a handling unit "Pallets48x40Inches". A lookup will be available to get all valid values.

stackableBoolean

The item has flat surfaces and can sustain the weight of another object.

  • true - Item is stackable.
  • false - Item is not stackable. (Default)
lengthInMetersDecimalThe length of the item or unit in meters. Required unless freight class is supplied.
heightInMetersDecimalThe height of the item or unit in meters. Required unless freight class is supplied.
weightInGramsIntegerThe total weight of the item or unit in grams. Required unless freight class is supplied.
freightClassDecimal

Carriers use freight classes to calculate shipping costs. They are defined in the National Motor Freight Classification Guide. If you are unsure of your shipment's freight class, simply enter the dimensions and weight for a rate request. A lookup will be available to get all valid values.

Freight class is determined by four factors:

  • density
  • value
  • stowability
  • handling characteristics
hazardousBoolean

A substance or material may be classified as hazardous if the transportation of the material in a particular amount and form poses an unreasonable risk to health and safety or property. Hazardous materials are defined by the U.S. Department of Transportation in accordance with the Federal Hazardous Material Law and require special handling and documentation. For more general information, go to the U.S. DOT website at http://www.phmsa.dot.gov/hazmat.

  • true - Provide rate for a shipment containing hazardous materials.
  • false - Rate does not account for hazardous materials. (Default)

Pickup/Delivery Accessorials

FieldTypeDescription
insideBoolean

Inside pickup/delivery

  • true - If the driver is required to go inside (beyond the front door or loading dock) to pick up or deliver the shipment instead of remaining at the dock or truck, additional fees will be charged.
  • false - Rate does not account for inside pick up or delivery. (Default)
liftgateRequiredBoolean

Liftgate service at pickup/delivery. If a liftgate is required for the shipment, it must be specified especially when the address type is “Residence” or “BusinessWithoutLoadingDock”. Providing the service requires extra charge.

  • true - When the shipping or receiving address does not have a loading dock or forklift, manual loading or unloading is necessary. A liftgate is a hydraulic platform attached to the back of specially equipped trucks that can raise and lower a shipment from the truck to the ground and vice versa.
  • false - Rate does not account for a liftgate.
callBeforeArrivalBoolean

The Shipping Customer requires the Service Provider to call the specified contact at the delivery address before arriving at the location. Providing this notice requires extra charge.

  • true - Calculate the rate to include a Service Provider calling the destination location before arriving on site.
  • false - Rate does not account for calling before arriving at the destination. (Default)
appointmentRequiredBoolean

The Shipping Customer requires the Service Provider to set an appointment for when to deliver. Providing this service requires extra charge.

  • true - Calculate the rate to include a Service Provider setting up an appointment with the Shipping Customer.
  • false - Rate does not account for setting an appointment. (Default)

Additional Services Accessorials

FieldTypeDescription
protectFromFreezingBoolean

Protect from freezing

  • true - Choose this option if your shipment includes temperature sensitive items that need to be protected from reaching below 32° F/0° C.
  • false - Rate does not account for protection from freezing. (Default)
blindShipmentCoordinationBoolean

Blind shipment coordination

  • true - Blind shipping service should be requested if you do not want the shipper and/or consignee to know the other’s identity. This is typically requested when a third party controls the freight.
  • false - Rate does not account for blind pick up or delivery coordination. (Default)
sortandSegregateBoolean

Sort & segregate

  • true - Upon request, a carrier will sort through and segregate a load by marks, brands, sizes, or other distinguishing characteristics.
  • false - Rate does not account for a Service Provider organizing and marking the freight items. (Default)

ThirdPartyID

Optional unique string identifier used in conjunction with the X-Affiliate header to tie the request to a unique identifier. Useful for uShip API consumers and third parties to identify rate requests in their own applications and systems.

Reference Enumerations: Commodity Codes

Business and Industrial Goods Categories

String
WoodPaperProducts
LiquidsGasesChemicals
StoneMetalsMinerals
CommoditiesDryBulk
GeneralFreight
MixedFreight
Utilities
PharmaceuticalProducts
Fertilizers
PlasticsRubber
TextilesLeather
MiscellaneousManufacturedProducts
OtherBusinessIndustrialGoods
PaperProducts
LogsandOtherWoodintheRough
WoodProducts
PaperorPaperboardArticles
PrintedProducts
LiquidsGases
Chemicals
CrudePetroleumOil
WaterWell
GasolineandAviationTurbineFuel
FuelOils
ChemicalProductsandPreparationsnec
BuildingMaterials
MachineryLargeObjects
ElectronicandOtherElectricalEquipmentandComponentsandOfficeEquipment
PrecisionInstrumentsandApparatus
CoalorCoke
MonumentalorBuildingStone
NaturalSands
GravelandCrushedStone
NonMetallicMineralsnec
MetallicOresandConcentrates
CoalandPetroleumProductsnec
NonMetallicMineralProducts
Metalsheetscoilsrolls
BaseMetalinPrimaryorSemiFinishedFormsandinFinishedBasic
ArticlesofBaseMetal

Vehicle, Boat, Food & Agricultural Goods Categories

String
VehicleParts
BoatParts
RefrigeratedFood
MeatFishSeafood
CerealGrainsincludingseed
AnimalFeedProductsofAnimalOrigin
MilledGrainProductsPreparationsandBakeryProducts
Beverages
AlcoholicBeverages
OtherPreparedFoodstuffsandFatsandOils
TobaccoProducts
OtherFoodAgriculture

LTL Freight Categories

String
NewCommercialGoods
UsedCommercialGoods
WineLiquorBeerSpirits
NonPerishableFoodsBeverages
OtherLessthanTruckloadGoods

Handling Units

Valid String Values
Boxes
Cartons
Crates
Drums
Bags
Bales
Bundles
Cans
Carboys
Carpets
Cases
Coils
Cylinders
Loose
NoPackagingRequired
PackagingHelpRequired
Pallets48X40Inches
Pails
Reels
Rolls
TubesPipes
Other
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard