avalara 0.0.1

data/spec/fixtures/net/get_tax/success.yml

@@ -0,0 +1,106 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :post
+    uri: https://%{API_USERNAME}:%{API_PASSWORD}@rest.avalara.net:443/1.0/tax/get
+    body: |-
+      {
+        "CustomerCode": 1,
+        "DocDate": "2012-01-01",
+        "CompanyCode": 83,
+        "Lines": [
+          {
+            "LineNo": "1",
+            "DestinationCode": "1",
+            "OriginCode": "1",
+            "Qty": "1",
+            "Amount": 10
+          }
+        ],
+        "Addresses": [
+          {
+            "AddressCode": "1",
+            "Line1": "435 Ericksen Avenue Northeast",
+            "Line2": "#250",
+            "PostalCode": "98110"
+          }
+        ]
+      }
+    headers: 
+      date: 
+      - Thu, 02 Feb 2012 15:20:51 GMT
+      user-agent: 
+      - avalara/0.0.1 (Rubygems; Ruby 1.9.2 x86_64-darwin11.0.0)
+      content-length: 
+      - "373"
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      cache-control: 
+      - private
+      content-type: 
+      - text/json; charset=utf-8
+      server: 
+      - Microsoft-IIS/7.5
+      x-aspnet-version: 
+      - 4.0.30319
+      x-powered-by: 
+      - ASP.NET
+      date: 
+      - Thu, 02 Feb 2012 15:20:47 GMT
+      content-length: 
+      - "885"
+    body: |
+      {
+      "DocCode": "1402892f-c3f3-4786-b976-622a0c622cf4",
+      "DocDate": "2012-01-01",
+      "Timestamp": "2012-02-02T15:20:47.5076773Z",
+      "TotalAmount": "10",
+      "TotalDiscount": "0",
+      "TotalExemption": "10",
+      "TotalTaxable": "0",
+      "TotalTax": "0",
+      "TotalTaxCalculated": "0",
+      "TaxDate": "2012-01-01",
+      "TaxLines": [
+      {
+      "LineNo": "1",
+      "TaxCode": "P0000000",
+      "Taxability": "true",
+      "Taxable": "0",
+      "Rate": "0",
+      "Tax": "0",
+      "Discount": "0",
+      "TaxCalculated": "0",
+      "Exemption": "10",
+      "TaxDetails": [
+      {
+      "Country": "US",
+      "Region": "WA",
+      "JurisType": "State",
+      "Taxable": "0",
+      "Rate": "0",
+      "Tax": "0",
+      "JurisName": "WASHINGTON",
+      "TaxName": "WA STATE TAX"}
+      ]
+      }
+      ]
+      ,
+      "TaxAddresses": [
+      {
+      "Address": "435 ERICKSEN AVE NE STE 250",
+      "AddressCode": "1",
+      "City": "BAINBRIDGE ISLAND",
+      "Country": "US",
+      "PostalCode": "98110-2876",
+      "Region": "WA",
+      "TaxRegionId": "2109716",
+      "JurisCode": "5303503736"}
+      ]
+      ,
+      "ResultCode": "Success"}
+
+    http_version: "1.1"

data/spec/models/avalara/configuration_spec.rb

@@ -0,0 +1,55 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+
+describe Avalara::Configuration do
+  let(:configuration) { Avalara::Configuration.new }
+
+  context '#endpoint' do
+    it 'defaults to https://rest.avalara.net' do
+      configuration.endpoint.should == 'https://rest.avalara.net'
+    end
+
+    it 'may be overridden' do
+      expect {
+        configuration.endpoint = 'https://example.local/'
+      }.to change(configuration, :endpoint).to('https://example.local/')
+    end
+  end
+  
+  context '#version' do
+    it 'defaults to 1.0' do
+      configuration.version.should == '1.0'
+    end
+
+    it 'may be overridden' do
+      expect {
+        configuration.version = '2.0'
+      }.to change(configuration, :version).to('2.0')
+    end
+  end
+
+  context '#username' do
+    it 'is unset by default' do
+      configuration.username.should be_nil
+    end
+
+    it 'may be set' do
+      expect {
+        configuration.username = 'abcdefg'
+      }.to change(configuration, :username).to('abcdefg')
+    end
+  end
+  
+  context '#password' do
+    it 'is unset by default' do
+      configuration.password.should be_nil
+    end
+
+    it 'may be set' do
+      expect {
+        configuration.password = 'abcdefg'
+      }.to change(configuration, :password).to('abcdefg')
+    end
+  end
+end

data/spec/models/avalara/request/address_spec.rb

@@ -0,0 +1,24 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+
+describe Avalara::Request::Address do
+  let(:params) { Factory.attributes_for(:address) }
+  let(:address) { Factory.build_via_new(:address) }
+
+  context 'sets all attributes' do
+    subject { address }
+
+    its(:AddressCode) { should == params[:address_code] }
+    its(:Line1) { should == params[:line_1] }
+    its(:Line2) { should == params[:line_2] }
+    its(:Line3) { should == params[:line_3] }
+    its(:City) { should == params[:city] }
+    its(:Region) { should == params[:region] }
+    its(:Country) { should == params[:country] }
+    its(:PostalCode) { should == params[:postal_code] }
+    its(:Latitude) { should == params[:latitude] }
+    its(:Longitude) { should == params[:longitude] }
+    its(:TaxRegionId) { should == params[:tax_region_id] }
+  end
+end

data/spec/models/avalara/request/detail_level_spec.rb

@@ -0,0 +1,18 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+
+describe Avalara::Request::DetailLevel do
+  let(:params) { Factory.attributes_for(:detail_level) }
+  let(:detail_level) { Factory.build_via_new(:detail_level) }
+
+  context 'sets all attributes' do
+    subject { detail_level }
+
+    its(:Line) { should == params[:line] }
+    its(:Summary) { should == params[:summary] }
+    its(:Document) { should == params[:document] }
+    its(:Tax) { should == params[:tax] }
+    its(:Diagnostic) { should == params[:diagnostic] }
+  end
+end

data/spec/models/avalara/request/invoice_spec.rb

@@ -0,0 +1,33 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+
+describe Avalara::Request::Invoice do
+  let(:params) { Factory.attributes_for(:invoice) }
+  let(:invoice) { Factory.build_via_new(:invoice) }
+
+  context 'sets all attributes' do
+    subject { invoice }
+
+    its(:CustomerCode) { should == params[:customer_code] }
+    its(:DocDate) { should == Avalara::Types::Date.coerce(params[:doc_date]) }
+    its(:CompanyCode) { should == params[:company_code] }
+    its(:Commit) { should == params[:commit] }
+    its(:CustomerUsageType) { should == params[:customer_usage_type] }
+    its(:Discount) { should == params[:discount] }
+    its(:DocCode) { should == params[:doc_code] }
+    its(:PurchaseOrderNo) { should == params[:purchase_order_no] }
+    its(:ExemptionNo) { should == params[:exemption_no] }
+    its(:DetailLevel) { should == params[:detail_level] }
+    its(:DocType) { should == params[:doc_type] }
+    its(:PaymentDate) { should == params[:payment_date] }
+    its(:Lines) { should == params[:lines] }
+    its(:Addresses) { should == params[:addresses] }
+    its(:ReferenceCode) { should == params[:reference_code] }
+  end
+  
+  context 'converts nested objects to json' do
+    subject { invoice.to_json }
+    it { should_not be_nil }
+  end
+end

data/spec/models/avalara/request/line_spec.rb

@@ -0,0 +1,25 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+
+describe Avalara::Request::Line do
+  let(:params) { Factory.attributes_for(:line) }
+  let(:line) { Factory.build_via_new(:line) }
+
+  context 'sets all attributes' do
+    subject { line }
+
+    its(:LineNo) { should == params[:line_no] }
+    its(:DestinationCode) { should == params[:destination_code] }
+    its(:OriginCode) { should == params[:origin_code] }
+    its(:ItemCode) { should == params[:item_code] }
+    its(:TaxCode) { should == params[:tax_code] }
+    its(:CustomerUsageType) { should == params[:customer_usage_type] }
+    its(:Qty) { should == params[:qty] }
+    its(:Amount) { should == params[:amount] }
+    its(:Discounted) { should == params[:discounted] }
+    its(:TaxIncluded) { should == params[:tax_included] }
+    its(:Ref1) { should == params[:ref_1] }
+    its(:Ref2) { should == params[:ref_2] }
+  end
+end

data/spec/models/avalara_spec.rb

@@ -0,0 +1,204 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+
+describe Avalara do
+  maintain_contactology_configuration
+
+  let(:configuration) { Avalara.configuration }
+
+  describe '.configuration' do
+    it 'yields a Avalara::Configuration instance' do
+      Avalara.configuration do |yielded|
+        yielded.should be_kind_of Avalara::Configuration
+      end
+    end
+
+    it 'yields the same configuration instance across multiple calls' do
+      Avalara.configuration do |config|
+        Avalara.configuration do |config2|
+          config.object_id.should == config2.object_id
+        end
+      end
+    end
+
+    it 'returns the configuration when queried' do
+      Avalara.configuration do |config|
+        Avalara.configuration.object_id.should == config.object_id
+      end
+    end
+
+    it 'may be explicitly overridden' do
+      configuration = Avalara::Configuration.new
+      expect {
+        Avalara.configuration = configuration
+      }.to change(Avalara, :configuration).to(configuration)
+    end
+
+    it 'raises an ArgumentError when set to a non-Configuration object' do
+      expect {
+        Avalara.configuration = 'bad'
+      }.to raise_error(ArgumentError)
+    end
+  end
+
+  describe '.endpoint' do
+    it 'returns the configuration endpoint' do
+      Avalara.endpoint.should == configuration.endpoint
+    end
+
+    it 'overrides the configuration endpoint' do
+      expect {
+        Avalara.endpoint = 'https://example.local/'
+      }.to change(configuration, :endpoint).to('https://example.local/')
+    end
+  end
+
+  describe '.username' do
+    it 'returns the configuration username' do
+      configuration.username = 'username'
+      Avalara.username.should == configuration.username
+    end
+
+    it 'overrides the configuration username' do
+      expect {
+        Avalara.username = 'username'
+      }.to change(configuration, :username).to('username')
+    end
+  end
+  
+  describe '.password' do
+    it 'returns the configuration password' do
+      configuration.password = 'password'
+      Avalara.password.should == configuration.password
+    end
+
+    it 'overrides the configuration password' do
+      expect {
+        Avalara.password = 'password'
+      }.to change(configuration, :password).to('password')
+    end
+  end
+
+  describe '.version' do
+    it 'returns the configuration version' do
+      configuration.version = 'version'
+      Avalara.version.should == configuration.version
+    end
+
+    it 'overrides the configuration version' do
+      expect {
+        Avalara.version = 'version'
+      }.to change(configuration, :version).to('version')
+    end
+  end
+
+  describe '.get_tax' do
+    let(:doc_date) { Date.parse("January 1, 2012") }
+    let(:invoice) { Factory.build_via_new(:invoice, doc_date: doc_date) }
+    let(:request) { Avalara.get_tax(invoice) }
+    subject { request }
+    
+    context 'failure' do
+      let(:invoice) { Factory.build_via_new(:invoice, customer_code: nil) }
+      use_vcr_cassette 'get_tax/failure'
+
+      it 'rasises an error' do
+        expect { subject }.to raise_error(Avalara::ApiError)
+      end
+      
+      context 'the returned error' do
+        subject do
+          begin
+            request
+          rescue Avalara::ApiError => e
+            e.message.messages.first
+          end
+        end
+        
+        its(:details) { should == "This value must be specified." }
+        its(:refers_to) { should == "CustomerCode" }
+        its(:severity) { should == "Error" }
+        its(:source) { should == "Avalara.AvaTax.Services" }
+        its(:summary) { should == "CustomerCode is required." }
+      end
+    end
+    
+    context 'on timeout' do
+      it 'raises an avalara timeout error' do
+        Avalara::API.should_receive(:post).and_raise(Timeout::Error)
+        expect { subject }.to raise_error(Avalara::TimeoutError)
+      end
+    end
+
+    context 'success' do
+      use_vcr_cassette 'get_tax/success'
+    
+      it { should be_kind_of Avalara::Response::Invoice }
+    
+      its(:doc_code) { should_not be_nil }
+      its(:doc_date) { should == "2012-01-01" }
+      its(:result_code) { should == "Success" }
+      its(:tax_date) { should_not be_nil }
+      its(:timestamp) { should_not be_nil }
+      its(:total_amount) { should == "10" }
+      its(:total_discount) { should == "0" }
+      its(:total_exemption) { should == "10" }
+      its(:total_tax) { should == "0" }
+      its(:total_tax_calculated) { should == "0" }
+    
+      it 'returns 1 tax line' do
+        subject.tax_lines.length.should == 1
+      end
+
+      it 'returns 1 tax address' do
+        subject.tax_addresses.length.should == 1
+      end
+    
+      context 'the returned tax line' do
+        let(:tax_line) { request.tax_lines.first }
+        subject { tax_line }
+      
+        its(:line_no) { should == "1" }
+        its(:tax_code) { should == "P0000000" }
+        its(:taxability) { should == "true" }
+        its(:taxable) { should == "0" }
+        its(:rate) { should == "0" }
+        its(:tax) { should == "0" }
+        its(:discount) { should == "0" }
+        its(:tax_calculated) { should == "0" }
+        its(:exemption) { should == "10" }
+      
+        it 'returns 1 tax detail' do
+          subject.tax_details.length.should == 1
+        end
+      
+        context 'the returned tax detail' do
+          subject { tax_line.tax_details.first }
+
+          its(:taxable) { should == "0" }
+          its(:rate) { should == "0" }
+          its(:tax) { should == "0" }
+          its(:region) { should == "WA" }
+          its(:country) { should == "US" }
+          its(:juris_type) { should == "State" }
+          its(:juris_name) { should == "WASHINGTON" }
+          its(:tax_name) { should == "WA STATE TAX" }
+        end
+      end
+    end
+  end
+
+  describe '.geographical_tax' do
+    let(:latitude) { '47.627935' }
+    let(:longitude) { '-122.51702' }
+    let(:sales_amount) { 100 }
+
+    subject { Avalara.geographical_tax(latitude, longitude, sales_amount) }
+    use_vcr_cassette 'geographical_tax_no_sales'
+  
+    it "returns a rate of 0" do
+      expect { subject }.to raise_error(Avalara::NotImplementedError)
+    end
+  end
+end