vizjerai-avalara 0.1.0

data/spec/fixtures/net/Avalara/_get_tax/with_missing_required_field/unsuccessful_response.yml

@@ -0,0 +1,73 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://API_BASIC_AUTH@API_ENDPOINT/1.0/tax/get
+    body:
+      encoding: UTF-8
+      string: ! "{\n  \"CustomerCode\": null,\n  \"DocDate\": \"2013-06-11\",\n  \"CompanyCode\":
+        83,\n  \"Lines\": [\n    {\n      \"LineNo\": \"1\",\n      \"DestinationCode\":
+        \"1\",\n      \"OriginCode\": \"1\",\n      \"Qty\": \"1\",\n      \"Amount\":
+        10\n    }\n  ],\n  \"Addresses\": [\n    {\n      \"AddressCode\": 1,\n      \"Line1\":
+        \"435 Ericksen Avenue Northeast\",\n      \"Line2\": \"#250\",\n      \"PostalCode\":
+        \"98110\"\n    }\n  ]\n}"
+    headers:
+      Accept:
+      - application/json
+      Content-Type:
+      - text/json
+      Date:
+      - Tue, 11 Jun 2013 14:25:21 GMT
+      User-Agent:
+      - avalara/0.0.2 (Rubygems; Ruby 1.9.3 x86_64-freebsd8.1)
+      Content-Length:
+      - '374'
+  response:
+    status:
+      code: 500
+      message: Internal Server Error
+    headers:
+      Cache-Control:
+      - private
+      Content-Type:
+      - text/json; charset=utf-8
+      X-Aspnet-Version:
+      - 4.0.30319
+      X-Powered-By:
+      - ASP.NET
+      Date:
+      - Tue, 11 Jun 2013 14:25:21 GMT
+      Content-Length:
+      - '215'
+      Set-Cookie:
+      - TS6198e2=6b8238c1ba9f886ffe742e8d094cc3fa3a10d0eeb29e4ce851b73351; Path=/
+      - TS6198e2_28=adb1456b4bb2ed5d9ad7bfb38be60cdc3a10d0eeb29e4ce800000000000000000051b73351cf2467f60807d03e;
+        Path=/
+    body:
+      encoding: US-ASCII
+      string: ! '{
+
+        "ResultCode": "Error",
+
+        "Messages": [
+
+        {
+
+        "Summary": "CustomerCode is required.",
+
+        "Details": "This value must be specified.",
+
+        "RefersTo": "CustomerCode",
+
+        "Severity": "Error",
+
+        "Source": "Avalara.AvaTax.Services"}
+
+        ]
+
+        }
+
+'
+    http_version: 
+  recorded_at: Tue, 11 Jun 2013 14:25:22 GMT
+recorded_with: VCR 2.5.0

data/spec/fixtures/net/Avalara/_validate_address/successful_response.yml

@@ -0,0 +1,76 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://API_BASIC_AUTH@API_ENDPOINT/1.0/address/validate?Line1=435%20Ericksen%20Avenue%20Northeast&Line2=%23250&PostalCode=98110
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - application/json
+      Content-Type:
+      - text/json
+      Date:
+      - Tue, 11 Jun 2013 19:07:56 GMT
+      User-Agent:
+      - avalara/0.0.2 (Rubygems; Ruby 1.9.3 x86_64-freebsd8.1)
+      Content-Length:
+      - '0'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - private
+      Content-Type:
+      - text/json; charset=utf-8
+      X-Aspnet-Version:
+      - 4.0.30319
+      X-Powered-By:
+      - ASP.NET
+      Date:
+      - Tue, 11 Jun 2013 19:07:56 GMT
+      Content-Length:
+      - '297'
+      Set-Cookie:
+      - TS6198e2=636d7e08a1ba939e74f09679205034ff17aef1bec375cc4e51b7758d; Path=/
+      - TS6198e2_28=d504e6ad8384879a66c8f948ac046f1317aef1bec375cc4e00000000000000000051b7758c8a73661fdfaad314;
+        Path=/
+    body:
+      encoding: US-ASCII
+      string: ! '{
+
+        "ResultCode": "Success",
+
+        "Address": {
+
+        "Line1": "250",
+
+        "Line2": "435 Ericksen Ave NE",
+
+        "City": "Bainbridge Island",
+
+        "Region": "WA",
+
+        "PostalCode": "98110-1896",
+
+        "Country": "US",
+
+        "County": "Kitsap",
+
+        "FipsCode": "5303500000",
+
+        "CarrierRoute": "C051",
+
+        "PostNet": "981101896999",
+
+        "AddressType": "H"}
+
+        }
+
+'
+    http_version: 
+  recorded_at: Tue, 11 Jun 2013 19:07:57 GMT
+recorded_with: VCR 2.5.0

data/spec/fixtures/net/Avalara/_validate_address/with_missing_postal_code/unsuccessful_response.yml

@@ -0,0 +1,68 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://API_BASIC_AUTH@API_ENDPOINT/1.0/address/validate?Line1=435%20Ericksen%20Avenue%20Northeast&Line2=%23250&PostalCode=
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - application/json
+      Content-Type:
+      - text/json
+      Date:
+      - Tue, 11 Jun 2013 19:07:54 GMT
+      User-Agent:
+      - avalara/0.0.2 (Rubygems; Ruby 1.9.3 x86_64-freebsd8.1)
+      Content-Length:
+      - '0'
+  response:
+    status:
+      code: 500
+      message: Internal Server Error
+    headers:
+      Cache-Control:
+      - private
+      Content-Type:
+      - text/json; charset=utf-8
+      X-Aspnet-Version:
+      - 4.0.30319
+      X-Powered-By:
+      - ASP.NET
+      Date:
+      - Tue, 11 Jun 2013 19:07:55 GMT
+      Content-Length:
+      - '253'
+      Set-Cookie:
+      - TS6198e2=927716e1d83dd5e3fa61af30db5ced304c62f84ba8d8a59b51b7758b; Path=/
+      - TS6198e2_28=22ec2375be97493e8f7a884bc8271dc54c62f84ba8d8a59b00000000000000000051b7758b2814d6a370a5270d;
+        Path=/
+    body:
+      encoding: US-ASCII
+      string: ! '{
+
+        "ResultCode": "Error",
+
+        "Messages": [
+
+        {
+
+        "Summary": "Insufficient address information",
+
+        "Details": "You must specify at least Line/ZIP, or Line/City/State",
+
+        "RefersTo": "PostalCode",
+
+        "Severity": "Error",
+
+        "Source": "Avalara.AvaTax.Services.Address"}
+
+        ]
+
+        }
+
+'
+    http_version: 
+  recorded_at: Tue, 11 Jun 2013 19:07:56 GMT
+recorded_with: VCR 2.5.0

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,20 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+
+describe Avalara::Request::Address do
+  let(:params) { FactoryGirl.attributes_for(:address) }
+  let(:address) { FactoryGirl.build_via_new(:address) }
+
+  context 'sets all attributes' do
+    subject { address }
+
+    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] }
+  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) { FactoryGirl.attributes_for(:detail_level) }
+  let(:detail_level) { FactoryGirl.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_address_spec.rb

@@ -0,0 +1,24 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+
+describe Avalara::Request::InvoiceAddress do
+  let(:params) { FactoryGirl.attributes_for(:invoice_address) }
+  let(:invoice_address) { FactoryGirl.build_via_new(:invoice_address) }
+
+  context 'sets all attributes' do
+    subject { invoice_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/invoice_spec.rb

@@ -0,0 +1,32 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+
+describe Avalara::Request::Invoice do
+  let(:params) { FactoryGirl.attributes_for(:invoice) }
+  let(:invoice) { FactoryGirl.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(: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) { FactoryGirl.attributes_for(:line) }
+  let(:line) { FactoryGirl.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,300 @@
+# 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 '.cancel_tax' do
+    let(:cancel_tax) { FactoryGirl.build_via_new(:cancel_tax) }
+    let(:request) { Avalara.cancel_tax(cancel_tax) }
+
+    it 'successful response', :vcr do
+      expect(request).to be_a Avalara::Response::CancelTax
+      expect(request).to be_success
+
+      expect(request.transaction_id).to be 431361022
+      expect(request.doc_id).to eq '34279849'
+      expect(request.result_code).to eq 'Success'
+      expect(request.messages).to be_nil
+    end
+
+    context 'with missing doc code', :vcr do
+      let(:cancel_tax) { FactoryGirl.build_via_new(:cancel_tax, :doc_code => nil) }
+      it 'unsuccessful response' do
+        expect(request).to be_a Avalara::Response::CancelTax
+        expect(request).to_not be_success
+
+        expect(request.transaction_id).to be 431377420
+        expect(request.doc_id).to be_nil
+        expect(request.result_code).to eq 'Error'
+        expect(request).to have(1).message
+
+        message = request.messages.first
+        expect(message.details).to eq "This value must be specified."
+        expect(message.refers_to).to eq "DocCode"
+        expect(message.severity).to eq "Error"
+        expect(message.source).to eq "Avalara.AvaTax.Services"
+        expect(message.summary).to eq "DocCode 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 { request }.to raise_error(Avalara::TimeoutError)
+      end
+    end
+  end
+
+  describe '.get_tax' do
+    let(:doc_date) { Date.parse("January 1, 2012") }
+    let(:invoice) { FactoryGirl.build_via_new(:invoice, :doc_date => doc_date) }
+    let(:request) { Avalara.get_tax(invoice) }
+
+    it 'successful response', :vcr do
+      expect(request).to be_kind_of Avalara::Response::Invoice
+      expect(request).to be_success
+
+      expect(request.doc_code).to_not be_nil
+      expect(request.doc_date).to eq "2012-01-01"
+      expect(request.result_code).to eq "Success"
+      expect(request.tax_date).to_not be_nil
+      expect(request.timestamp).to_not be_nil
+      expect(request.total_amount).to eq "10"
+      expect(request.total_discount).to eq "0"
+      expect(request.total_exemption).to eq "10"
+      expect(request.total_tax).to eq "0"
+      expect(request.total_tax_calculated).to eq "0"
+      expect(request.tax_lines.length).to be 1
+
+      tax_line = request.tax_lines.first
+      expect(tax_line.line_no).to eq "1"
+      expect(tax_line.tax_code).to eq "P0000000"
+      expect(tax_line.taxability).to eq "true"
+      expect(tax_line.taxable).to eq "0"
+      expect(tax_line.rate).to eq "0"
+      expect(tax_line.tax).to eq "0"
+      expect(tax_line.discount).to eq "0"
+      expect(tax_line.tax_calculated).to eq "0"
+      expect(tax_line.exemption).to eq "10"
+      expect(tax_line.tax_details.length).to be 1
+
+      tax_detail = tax_line.tax_details.first
+      expect(tax_detail.taxable).to eq "0"
+      expect(tax_detail.rate).to eq "0"
+      expect(tax_detail.tax).to eq "0"
+      expect(tax_detail.region).to eq "WA"
+      expect(tax_detail.country).to eq "US"
+      expect(tax_detail.juris_type).to eq "State"
+      expect(tax_detail.juris_name).to eq "WASHINGTON"
+      expect(tax_detail.tax_name).to eq "WA STATE TAX"
+
+      expect(request.tax_addresses.length).to be 1
+    end
+
+    context 'with missing required field', :vcr do
+      let(:invoice) { FactoryGirl.build_via_new(:invoice, customer_code: nil) }
+
+      it 'unsuccessful response' do
+        expect(request).to be_kind_of Avalara::Response::Invoice
+        expect(request).to_not be_success
+
+        message = request.messages.first
+        expect(message.details).to eq "This value must be specified."
+        expect(message.refers_to).to eq "CustomerCode"
+        expect(message.severity).to eq "Error"
+        expect(message.source).to eq "Avalara.AvaTax.Services"
+        expect(message.summary).to eq "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 { request }.to raise_error(Avalara::TimeoutError)
+      end
+    end
+  end
+
+  describe '.geographical_tax' do
+    let(:latitude) { '47.627935' }
+    let(:longitude) { '-122.51702' }
+    let(:sales_amount) { 100 }
+    let(:request) { Avalara.geographical_tax(latitude, longitude, sales_amount) }
+
+    it 'successful response', :vcr do
+      expect(request).to be_kind_of Avalara::Response::Tax
+      expect(request).to be_success
+
+      expect(request.rate).to eq 0.086
+      expect(request.tax).to eq 8.6
+      expect(request.tax_details).to have(2).items
+
+      state_tax_detail = request.tax_details.first
+      expect(state_tax_detail.rate).to eq 0.065
+      expect(state_tax_detail.tax).to eq 6.5
+      expect(state_tax_detail.juris_type).to eq 'State'
+
+      city_tax_detail = request.tax_details.last
+      expect(city_tax_detail.rate).to eq 0.021
+      expect(city_tax_detail.tax).to eq 2.1
+      expect(city_tax_detail.juris_type).to eq 'City'
+    end
+
+    context 'with incomplete address', :vcr do
+      let(:longitude) { '122.51702' }
+
+      it 'unsuccessful response' do
+        expect(request).to be_kind_of Avalara::Response::Tax
+        expect(request).to_not be_success
+
+        expect(request.rate).to be_nil
+        expect(request.tax).to be_nil
+        expect(request.tax_details).to be_nil
+      end
+    end
+
+    context 'on timeout' do
+      let(:longitude) { '-122.51702' }
+      it 'raises an avalara timeout error' do
+        Avalara::API.should_receive(:get).and_raise(Timeout::Error)
+        expect { request }.to raise_error(Avalara::TimeoutError)
+      end
+    end
+  end
+
+  describe '.validate_address' do
+    let(:address) { FactoryGirl.build_via_new(:address) }
+    let(:request) { Avalara.validate_address(address) }
+
+    it 'successful response', :vcr do
+      expect(request).to be_kind_of Avalara::Response::AddressValidation
+      expect(request).to be_success
+
+      expect(request.address).to be_a Avalara::Response::ValidationAddress
+
+      address = request.address
+      expect(address.line_1).to eq '250'
+      expect(address.line_2).to eq '435 Ericksen Ave NE'
+      expect(address.line_3).to be_nil
+      expect(address.city).to eq 'Bainbridge Island'
+      expect(address.region).to eq 'WA'
+      expect(address.country).to eq 'US'
+      expect(address.address_type).to eq 'H'
+      expect(address.address_type_name).to eq 'High-rise or business complex'
+      expect(address.postal_code).to eq '98110-1896'
+      expect(address.county).to eq 'Kitsap'
+      expect(address.fips_code).to eq '5303500000'
+      expect(address.carrier_route).to eq 'C051'
+      expect(address.carrier_route_name).to eq 'City delivery'
+      expect(address.tax_region_id).to be_nil
+      expect(address.post_net).to eq '981101896999'
+    end
+
+    context 'with missing postal code', :vcr do
+      let(:address) { FactoryGirl.build_via_new(:address, :postal_code => nil) }
+
+      it 'unsuccessful response' do
+        expect(request).to be_kind_of Avalara::Response::AddressValidation
+        expect(request).to_not be_success
+      end
+    end
+
+    context 'on timeout' do
+      it 'raises an avalara timeout error' do
+        Avalara::API.should_receive(:get).and_raise(Timeout::Error)
+        expect { request }.to raise_error(Avalara::TimeoutError)
+      end
+    end
+  end
+
+end