Skip to content
This repository has been archived by the owner on Sep 20, 2021. It is now read-only.

brodyhoskins/reactive_freight

Repository files navigation

Ruby Style Guide stability-wip

ReactiveFreight

ReactiveFreight extends ReactiveShipping to support LTL carriers.

Features specific to ReactiveFreight:

Important: The following features require carriers to be defined as a ReactiveFreight carriers specifically; this means that carriers included with ReactiveShipping function the same as before (and do not inherit the features).

  • Abstracted accessorials
  • Abstracted tracking events
  • Cubic feet and density calculations
  • Freight class calculations (and manual overriding)
  • Download scanned documents including bill of lading and/or proof of delivery where supported

Supported Freight Carriers & Platforms

This list varies day to day as this the project is a work in progress

In addition to the carriers supported by ReactiveShipping, ReactiveFreight supports the following carriers and platforms.

Carriers differ from platforms in that they have unique web services whereas platforms host several carriers' web services on a single service (platform). Carriers however may extend platforms and override them for carrier-specific functionality.

Carriers

Carrier BOL POD Rates Tracking
Best Overnite Express
Clear Lane Freight Systems
The Custom Companies
Dependable Highway Express
Forward Air
Frontline Freight
Peninsula Truck Lines
Roadrunner Transportation Services
Saia
Southeastern Freight Lines
Tforce Worldwide
Total Transportation & Distribution
Western Regional Delivery Service

Platforms

Versions

See releases

Installation

Using bundler, add to the Gemfile:

gem 'reactive_freight'

Or stand alone:

$ gem install reactive_freight

Sample Usage

Start off by initializing the carrier:

require 'reactive_freight'
carrier = ReactiveShipping::BTVP.new(account: 'account_number',
                                     username: 'username',
                                     password: 'password')

Documents

carrier.find_bol(tracking_number)
carrier.find_pod(tracking_number, path: 'POD.pdf') # path is optional

Tracking

Important: When a ReactiveFreight carrier is loaded ReactiveShipping::ShipmentEvent objects' name and status will return symbols rather than text — it is up to higher-level libraries to provide translations.

Carriers included with ReactiveShipping (typically non-freight) will retain the original behavior for compatibility.

tracking = carrier.find_tracking_info(tracking_number)

tracking.delivered?
tracking.status

tracking.shipment_events.each do |event|
  puts "#{event.name} at #{event.location.city}, #{event.location.state} on #{event.time}. #{event.message}"
end

Quoting

Note: Dimensions from ReactiveShipping were passed as an array in height x width x length order. While this is still supported, explicitly setting dimensions in a hash (as demonstrated below) is highly recommended to reduce confusion.

packages = [
  ReactiveShipping::Package.new(371 * 16,            # 371 lbs
                                {
                                  length: 40,        # inches
                                  width: 48,
                                  height: 47
                                },
                                units: :imperial),
  ReactiveShipping::Package.new(371 * 16,            # 371 lbs
                                {
                                  length: 40,        # inches
                                  width: 48,
                                  height: 47
                                },
                                freight_class: 125,  # override calculated freight class
                                units: :imperial)
]

origin = ReactiveShipping::Location.new(country: 'US',
                                        state: 'CA',
                                        city: 'Los Angeles',
                                        zip: '90001')

destination = ReactiveShipping::Location.new(country: 'US',
                                             state: 'IL',
                                             city: 'Chicago',
                                             zip: '60007')

accessorials = %i[
  appointment_delivery
  liftgate_delivery
  residential_delivery
]

response = carrier.find_rates(origin, destination, packages, accessorials: accessorials)
rates = response.rates
rates = response.rates.sort_by(&:price).collect { |rate| [rate.service_name, rate.price] }

Important: A ReactiveFreight RateEstimate returns a Hash rather than a String with the carrier's name; stock ReactiveShipping RateEstimates return the latter:

rate = rates.first
rate.carrier

=> "Best Overnite Express" # ReactiveShipping
=> {:scac=>"BTVP", :name=>"Best Overnite Express"} # ReactiveFreight

# To find the relevant information, check the hash
rate.carrier.dig(:name)
=> "Best Overnite Express"
rate.carrier.dig(:scac)
=> "BTVP"

# Maintain compatibility with ReactiveShipping
rate.carrier.is_a?(Hash) ? rate.carrier.dig(:name) : rate.carrier
=> "Best Overnite Express"

rate.carrier.is_a?(Hash) ? rate.carrier.dig(:scac) : nil
=> "BTVP"