dhonig / spree_active_shipping

Spree integration for Shopify's active_shipping gem

Active Shipping

This is a Spree extension that wraps the popular active_shipping plugin.

UPS

You will need a UPS developer account to get rate quotes (even in development and test mode.) The UPS calculators also require that you set the following configuration properties. You will also need a USPS account to use USPS rate quote system. Note: acquiring the USPS developer account is easy but has a confusion activation step. Look for related sicussion in ActiveShipping's original discussion group as well as carefully read your USPS confirmation email.

Spree::ActiveShipping::Config[:origin_country]
Spree::ActiveShipping::Config[:origin_city]
Spree::ActiveShipping::Config[:origin_state]
Spree::ActiveShipping::Config[:origin_zip]
Spree::ActiveShipping::Config[:ups_login]
Spree::ActiveShipping::Config[:ups_password]
Spree::ActiveShipping::Config[:ups_key]
Spree::ActiveShipping::Config[:usps_login]

It will soon be possible to set these properties through a new admin configuration screen (even sooner if someone else writes the patch!)

Global Handling Fee

Spree::ActiveShipping::Config[:handling_fee]

This property allows you to set a global handling fee that will be added to all calculated shipping rates. Specify the number of cents, not dollars.

Using Migrations

If you'd like to set your shipping configuration as part of a migration you could add something like this to your site extension.

class AddUpsConfiguration < ActiveRecord::Migration
  def self.up
    Spree::ActiveShipping::Config.set(:ups_login => "dpbrowning")
    Spree::ActiveShipping::Config.set(:ups_password => "doublewide")
    Spree::ActiveShipping::Config.set(:ups_key => "5B8DDE509EFDA5D6")
    Spree::ActiveShipping::Config.set(:usps_login => "13658997AOE2568XOE")
  end

  def self.down
  end
end

Installation

1. Add the following to your applications Gemfile

   gem 'spree_active_shipping'

   #only required until gem 0.9.13 is released gem 'active_shipping', :git => 'git://github.com/Shopify/active_shipping.git'

2. Run bundler

   bundle install

Further Reading

Andrea Singh has also written an excellent blog post covering the use of this extension in detail.