vizjerai-avalara 0.1.0

data/lib/avalara.rb

@@ -0,0 +1,121 @@
+# encoding: UTF-8
+
+require 'avalara/version'
+require 'avalara/errors'
+require 'avalara/configuration'
+
+require 'avalara/api'
+
+require 'avalara/types'
+require 'avalara/request'
+require 'avalara/response'
+
+module Avalara
+
+  def self.configuration
+    @@_configuration ||= Avalara::Configuration.new
+    yield @@_configuration if block_given?
+    @@_configuration
+  end
+
+  def self.configuration=(configuration)
+    raise ArgumentError, 'Expected a Avalara::Configuration instance' unless configuration.kind_of?(Configuration)
+    @@_configuration = configuration
+  end
+
+  def self.configure(&block)
+    configuration(&block)
+  end
+
+  def self.endpoint
+    configuration.endpoint
+  end
+  def self.endpoint=(endpoint)
+    configuration.endpoint = endpoint
+  end
+
+  def self.username
+    configuration.username
+  end
+  def self.username=(username)
+    configuration.username = username
+  end
+
+  def self.password
+    configuration.password
+  end
+  def self.password=(password)
+    configuration.password = password
+  end
+
+  def self.version
+    configuration.version
+  end
+  def self.version=(version)
+    configuration.version = version
+  end
+
+  def self.cancel_tax(cancel_invoice)
+    uri = [endpoint, version, 'tax', 'cancel'].join('/')
+
+    response = API.post(uri,
+      :body       => cancel_invoice.to_json,
+      :headers    => API.headers_for(cancel_invoice.to_json.length),
+      :basic_auth => authorization
+    )
+
+    Response::CancelTax.new(response)
+  rescue Timeout::Error => e
+    raise TimeoutError.new(e)
+  end
+
+  def self.geographical_tax(latitude, longitude, sales_amount)
+    uri = [endpoint, version, 'tax', "#{latitude},#{longitude}", 'get'].join('/')
+
+    response = API.get(uri, 
+      :headers    => API.headers_for(),
+      :query      => {:saleamount => sales_amount},
+      :basic_auth => authorization
+    )
+
+    Response::Tax.new(response)
+  rescue Timeout::Error => e
+    raise TimeoutError.new(e)
+  end
+
+  def self.get_tax(invoice)
+    uri = [endpoint, version, 'tax', 'get'].join('/')
+
+    response = API.post(uri,
+      :body       => invoice.to_json,
+      :headers    => API.headers_for(invoice.to_json.length),
+      :basic_auth => authorization
+    )
+
+    Response::Invoice.new(response)
+  rescue Timeout::Error => e
+    raise TimeoutError.new(e)
+  rescue ApiError => e
+    raise e
+  rescue Exception => e
+    raise Error.new(e)
+  end
+
+  def self.validate_address(address)
+    uri = [endpoint, version, 'address', 'validate'].join('/')
+    response = API.get(uri,
+      :headers => API.headers_for(),
+      :query => address.to_hash,
+      :basic_auth => authorization
+    )
+    Response::AddressValidation.new(response)
+  rescue Timeout::Error => e
+    raise TimeoutError.new(e)
+  end
+
+  private
+
+  def self.authorization
+    {:username => username, :password => password}
+  end
+end

data/spec/avalara.yml.example

@@ -0,0 +1,3 @@
+username: 'testaccount'
+password: 'testkey'
+endpoint: 'https://development.avalara.net'

data/spec/factories/addresses.rb

@@ -0,0 +1,11 @@
+FactoryGirl.define do
+  factory :address, :class => Avalara::Request::Address do
+    line_1 "435 Ericksen Avenue Northeast"
+    line_2 "#250"
+    # line_3 "line_3"
+    # city "city"
+    # region "region"
+    # country "country"
+    postal_code "98110"
+  end
+end

data/spec/factories/cancel_taxs.rb

@@ -0,0 +1,9 @@
+FactoryGirl.define do
+  factory :cancel_tax, :class => Avalara::Request::CancelTax do
+    company_code 83
+    doc_type 'SalesInvoice'
+    doc_code '1234'
+    cancel_code 'DocVoided'
+    #doc_id '12345678' #avatax's internal document_id
+  end
+end

data/spec/factories/detail_levels.rb

@@ -0,0 +1,9 @@
+FactoryGirl.define do
+  factory :detail_level, :class => Avalara::Request::DetailLevel do
+    line "line"
+    summary "summary"
+    document "document"
+    tax "tax"
+    diagnostic "diagnostic"
+  end
+end

data/spec/factories/invoice_addresses.rb

@@ -0,0 +1,15 @@
+FactoryGirl.define do
+  factory :invoice_address, :class => Avalara::Request::InvoiceAddress do
+    address_code 1
+    line_1 "435 Ericksen Avenue Northeast"
+    line_2 "#250"
+    # line_3 "line_3"
+    # city "city"
+    # region "region"
+    # country "country"
+    postal_code "98110"
+    # latitude "latitude"
+    # longitude "longitude"
+    # tax_region_id "tax_region_id"
+  end
+end

data/spec/factories/invoices.rb

@@ -0,0 +1,18 @@
+FactoryGirl.define do
+  factory :invoice, :class => Avalara::Request::Invoice do
+    customer_code 1
+    doc_date Time.now
+    company_code 83
+    # commit false
+    # customer_usage_type "customer_usage_type"
+    # discount "discount"
+    # doc_code "1234"
+    # purchase_order_no "purchase_order_no"
+    # exemption_no "exemption_no"
+    # detail_level 'Tax'
+    # doc_type "SalesInvoice"
+    lines { [FactoryGirl.build_via_new(:line)] }
+    addresses { [FactoryGirl.build_via_new(:invoice_address)] }
+    # reference_code "reference_code"
+  end
+end

data/spec/factories/lines.rb

@@ -0,0 +1,16 @@
+FactoryGirl.define do
+  factory :line, :class => Avalara::Request::Line do
+    line_no "1"
+    destination_code "1"
+    origin_code "1"
+    # item_code "item_code"
+    # tax_code "tax_code"
+    # customer_usage_type "customer_usage_type"
+    qty 1
+    amount 10.00
+    # discounted "discounted"
+    # tax_included "tax_included"
+    # ref_1 "ref_1"
+    # ref_2 "ref_2"
+  end
+end

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

@@ -0,0 +1,59 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://API_BASIC_AUTH@API_ENDPOINT/1.0/tax/cancel
+    body:
+      encoding: UTF-8
+      string: ! "{\n  \"CompanyCode\": 83,\n  \"DocType\": \"SalesInvoice\",\n
+        \ \"DocCode\": \"1234\",\n  \"CancelCode\": \"DocVoided\"\n}"
+    headers:
+      Accept:
+      - application/json
+      Content-Type:
+      - text/json
+      Date:
+      - Thu, 13 Jun 2013 15:16:45 GMT
+      User-Agent:
+      - avalara/0.0.2 (Rubygems; Ruby 1.9.3 x86_64-freebsd8.1)
+      Content-Length:
+      - '114'
+  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:
+      - Thu, 13 Jun 2013 15:16:45 GMT
+      Content-Length:
+      - '99'
+      Set-Cookie:
+      - TS6198e2=d40d1ce94b23b9e6506eccd96db341b0cb5341f860a07a5551b9e25e; Path=/
+      - TS6198e2_28=9a561136e47d2984b432bf0734724926cb5341f860a07a5500000000000000000051b9e25e84b5fba9ed3b7d38;
+        Path=/
+    body:
+      encoding: US-ASCII
+      string: ! '{
+
+        "CancelTaxResult": {
+
+        "DocId": "34279849",
+
+        "TransactionId": 431361022,
+
+        "ResultCode": "Success"}
+
+        }
+
+'
+    http_version: 
+  recorded_at: Thu, 13 Jun 2013 15:16:46 GMT
+recorded_with: VCR 2.5.0

data/spec/fixtures/net/Avalara/_cancel_tax/with_missing_doc_code/unsuccessful_response.yml

@@ -0,0 +1,75 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://API_BASIC_AUTH@API_ENDPOINT/1.0/tax/cancel
+    body:
+      encoding: UTF-8
+      string: ! "{\n  \"CompanyCode\": 83,\n  \"DocType\": \"SalesInvoice\",\n
+        \ \"DocCode\": null,\n  \"CancelCode\": \"DocVoided\"\n}"
+    headers:
+      Accept:
+      - application/json
+      Content-Type:
+      - text/json
+      Date:
+      - Thu, 13 Jun 2013 15:36:29 GMT
+      User-Agent:
+      - avalara/0.0.2 (Rubygems; Ruby 1.9.3 x86_64-freebsd8.1)
+      Content-Length:
+      - '112'
+  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:
+      - Thu, 13 Jun 2013 15:36:29 GMT
+      Content-Length:
+      - '256'
+      Set-Cookie:
+      - TS6198e2=50d7d6baf19fd161cb134b400fce18d4444b7183dbbfac4551b9e6fd; Path=/
+      - TS6198e2_28=80a3b3ce66ce069f077bb60ed98a73de444b7183dbbfac4500000000000000000051b9e6fc20fb4fdba28c2eb6;
+        Path=/
+    body:
+      encoding: US-ASCII
+      string: ! '{
+
+        "CancelTaxResult": {
+
+        "TransactionId": 431377420,
+
+        "ResultCode": "Error",
+
+        "Messages": [
+
+        {
+
+        "Summary": "DocCode is required.",
+
+        "RefersTo": "DocCode",
+
+        "Severity": "Error",
+
+        "Source": "Avalara.AvaTax.Services",
+
+        "Details": "This value must be specified."}
+
+        ]
+
+        }
+
+        }
+
+'
+    http_version: 
+  recorded_at: Thu, 13 Jun 2013 15:36:29 GMT
+recorded_with: VCR 2.5.0

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

@@ -0,0 +1,92 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://API_BASIC_AUTH@API_ENDPOINT/1.0/tax/47.627935,-122.51702/get?saleamount=100
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - application/json
+      Content-Type:
+      - text/json
+      Date:
+      - Tue, 11 Jun 2013 20:06:02 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 20:06:03 GMT
+      Content-Length:
+      - '356'
+      Set-Cookie:
+      - TS6198e2=f269f6ec01f43005c796a696d743adbab44110d473ce2a0751b7832b; Path=/
+      - TS6198e2_28=7dc6acf5dae9dc5790ffe92f50b06bc0b44110d473ce2a0700000000000000000051b7832b91f2ed2d3b9cab78;
+        Path=/
+    body:
+      encoding: US-ASCII
+      string: ! '{
+
+        "Rate": 0.086,
+
+        "Tax": 8.6,
+
+        "TaxDetails": [
+
+        {
+
+        "Country": "US",
+
+        "Region": "WA",
+
+        "JurisType": "State",
+
+        "Rate": 0.065,
+
+        "Tax": 6.5,
+
+        "JurisName": "WASHINGTON",
+
+        "TaxName": "WA STATE TAX"}
+
+        ,{
+
+        "Country": "US",
+
+        "Region": "WA",
+
+        "JurisType": "City",
+
+        "Rate": 0.021,
+
+        "Tax": 2.1,
+
+        "JurisName": "BAINBRIDGE ISLAND",
+
+        "TaxName": "WA CITY TAX"}
+
+        ]
+
+        ,
+
+        "ResultCode": "Success"}
+
+'
+    http_version: 
+  recorded_at: Tue, 11 Jun 2013 20:06:05 GMT
+recorded_with: VCR 2.5.0

data/spec/fixtures/net/Avalara/_geographical_tax/with_incomplete_address/unsuccessful_response.yml

@@ -0,0 +1,66 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://API_BASIC_AUTH@API_ENDPOINT/1.0/tax/47.627935,122.51702/get?saleamount=100
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - application/json
+      Content-Type:
+      - text/json
+      Date:
+      - Tue, 11 Jun 2013 20:06:05 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 20:06:05 GMT
+      Content-Length:
+      - '199'
+      Set-Cookie:
+      - TS6198e2=0fbc977705f174841c183156e45d6384a9fcff46f066e83251b7832e; Path=/
+      - TS6198e2_28=c97054c1ff46a2126a0bf4f1be5e95bda9fcff46f066e83200000000000000000051b7832d85aedc9eb7336aa4;
+        Path=/
+    body:
+      encoding: US-ASCII
+      string: ! '{
+
+        "ResultCode": "Error",
+
+        "Messages": [
+
+        {
+
+        "Summary": "Geocoding error Address is incomplete or invalid.",
+
+        "RefersTo": "Addresses[0]",
+
+        "Severity": "Error",
+
+        "Source": "Avalara.AvaTax.Services.Tax"}
+
+        ]
+
+        }
+
+'
+    http_version: 
+  recorded_at: Tue, 11 Jun 2013 20:06:06 GMT
+recorded_with: VCR 2.5.0

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

@@ -0,0 +1,151 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://API_BASIC_AUTH@API_ENDPOINT/1.0/tax/get
+    body:
+      encoding: UTF-8
+      string: ! "{\n  \"CustomerCode\": 1,\n  \"DocDate\": \"2012-01-01\",\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:34:23 GMT
+      User-Agent:
+      - avalara/0.0.2 (Rubygems; Ruby 1.9.3 x86_64-freebsd8.1)
+      Content-Length:
+      - '371'
+  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 14:34:22 GMT
+      Content-Length:
+      - '913'
+      Set-Cookie:
+      - TS6198e2=adc831970a86a132df47df6ed8f792d66572192cd45d204451b7356f; Path=/
+      - TS6198e2_28=a2af8f18ee62469c80989b4f0b1f20846572192cd45d204400000000000000000051b7356e3a5ef616b7cfc578;
+        Path=/
+    body:
+      encoding: US-ASCII
+      string: ! '{
+
+        "ResultCode": "Success",
+
+        "DocCode": "221f9d47-2717-446b-b805-cb6bc887cf22",
+
+        "DocDate": "2012-01-01",
+
+        "Timestamp": "2013-06-11T14:34:23.6768215Z",
+
+        "TotalAmount": "10",
+
+        "TotalDiscount": "0",
+
+        "TotalExemption": "10",
+
+        "TotalTaxable": "0",
+
+        "TotalTax": "0",
+
+        "TotalTaxCalculated": "0",
+
+        "TaxLines": [
+
+        {
+
+        "LineNo": "1",
+
+        "TaxCode": "P0000000",
+
+        "Taxability": "true",
+
+        "BoundaryLevel": "Address",
+
+        "Exemption": "10",
+
+        "Discount": "0",
+
+        "Taxable": "0",
+
+        "Rate": "0",
+
+        "Tax": "0",
+
+        "TaxCalculated": "0",
+
+        "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"}
+
+        ]
+
+        ,
+
+        "TaxDate": "2012-01-01"}
+
+'
+    http_version: 
+  recorded_at: Tue, 11 Jun 2013 14:34:23 GMT
+recorded_with: VCR 2.5.0