taxjar 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9a7f32540b7e3ebf9ea9395b6f8c1222cb41560c
-  data.tar.gz: 0f628c4661506f255eee7ad29be2087e9962b6d6
+  metadata.gz: 39a381c8762ddba45978205d3453a9fd223c987f
+  data.tar.gz: 6a7da0e3e52feb69d62866089c19ca7101bb9480
 SHA512:
-  metadata.gz: 64b6ad3c367c71885a720656877d4483e9018cc02221253435cf2d710a55f885c3237bcf0072af36ac5e5929d96da0d9975a99a9e0d58aef046ae1c2662ef756
-  data.tar.gz: 2bf57480e160a4bc1378e9a0c8dab12915fa9c3ae50320b93a76359f8e807f79bd812d4c17513a254777772ab68bc945681cc0d1b6555aa23b2b396eeddc4c81
+  metadata.gz: 5201dba0ccc0e1beb82005b959665c2ae2761076ff6df66754889763188b0775f25590da6c220e886642f53cc8c66b38e71dbec451061ea8c750e05682c6cadf
+  data.tar.gz: d0d08b35fac7190e4890992231f6f061fdf7da7653c03680a45e0b10c84c2afc507f57c52b20dfda67997a6b18239505d81989a3d01d0f24df3b84846615f78c

data/README.md

@@ -1,6 +1,6 @@
 # Taxjar
 
-Taxjar is a Ruby API wrapper for Taxjar's sales tax and tax rate API.
+Taxjar is a Ruby API wrapper for Taxjar's v1 and v2 API, supporting both Standard and Enhanced API tiers.
 
 ## Installation
 
@@ -20,17 +20,19 @@ Or install it yourself as:
 
 ## Usage
 
-Please reference the Taxjar [API Documentation](http://www.taxjar.com/api/docs/)
+Please reference the Taxjar [API Documentation](http://developers.taxjar.com/api/)
+
+### Configuration
 
-Configuration:
 ```ruby
 Taxjar.configure do |config|
   config.auth_token = "authtokenstring"
+  config.api_version = 2 # use 1 for legacy v1 API
+  config.api_tier = 'enhanced' # use 'standard' for standard API
 end
 ```
 
-
-Sales tax:
+### Sales tax
 
 ```ruby
 options = {
@@ -46,10 +48,10 @@ options = {
   from_zip: "07446"
 }
 response = Taxjar.client.sales_tax(options)
-#  => {"amount_to_collect"=>0.84, "rate"=>0.07, "has_nexus"=>true, "freight_taxable"=>true, "tax_source"=>"destination"}
+#  => {"tax":{"taxable_amount":"12.0","amount_to_collect":0.84,"rate":0.07,"has_nexus":true,"freight_taxable":true,"tax_source":"destination"}}
 ```
 
-Tax rate lookup:
+### Tax rate lookup
 
 ```ruby
 options = {
@@ -58,7 +60,100 @@ options = {
   country: "US"
 }
 response = Taxjar.client.tax_rate(options)
-#  {"location"=>{"state"=>"NJ", "zip"=>"07446", "state_rate"=>"0.07", "city"=>"RAMSEY", "city_rate"=>"0.0", "county"=>"BERGEN", "county_rate"=>"0.0", "combined_district_rate"=>"0.0", "combined_rate"=>"0.07"}}
+#  => {"rate":{"zip":"07446","state":"NJ","state_rate":"0.07","county":"BERGEN","county_rate":"0.0","city":"RAMSEY","city_rate":"0.0","combined_district_rate":"0.0","combined_rate":"0.07"}}
+```
+
+### List tax categories
+(Enhanced API tier)
+
+```ruby
+response = Taxjar.client.list_categories()
+#  => {"categories":[{"name":"Other Exempt","product_tax_code":"99999","description":"item is exempt"}, ... ]}
+```
+
+### Create order transaction
+(Enhanced API tier)
+
+```ruby
+options = {
+  transaction_id: "123456",
+  transaction_date: "2015/06/26",
+  amount: 10,
+  shipping: 2,
+  sales_tax: 0.84,
+  to_country: "US",
+  to_state: "NJ",
+  to_city: "Freehold",
+  to_zip: "07728",
+  from_country: "US",
+  from_state: "CA",
+  from_city: "Camarillo",
+  from_zip: "93010",
+  line_items: [
+    {
+      id: 123456,
+      unit_price: 20,
+      quantity: 1
+    }
+  ]
+}
+response = Taxjar.client.create_order_transaction(options)
+#  => {"order":{"transaction_id":"123456","user_id":440,"transaction_date":"2015-06-26T00:00:00Z","from_country":"US","from_zip":"93010","from_state":"CA","from_city":"CAMARILLO","from_street":null,"to_country":"US","to_zip":"07728","to_state":"NJ","to_city":"FREEHOLD","to_street":null,"amount":"10.0","shipping":"2.0","sales_tax":"0.84","line_items":[{"id":1,"quantity":1,"product_identifier":null,"product_tax_code":null,"description":null,"unit_price":"20.0","discount":"0.0","sales_tax":"0.0"}]}}
+```
+
+### Update order transaction
+(Enhanced API tier)
+
+```ruby
+options = {
+  transaction_id: "123456",
+  sales_tax: 0.94,
+}
+response = Taxjar.client.update_order_transaction(options)
+#  => {"order":{"transaction_id":"123456","user_id":440,"transaction_date":"2015-06-26T00:00:00Z","from_country":"US","from_zip":"93010","from_state":"CA","from_city":"CAMARILLO","from_street":null,"to_country":"US","to_zip":"07728","to_state":"NJ","to_city":"FREEHOLD","to_street":null,"amount":"10.0","shipping":"2.0","sales_tax":"0.94","line_items":[{"id":1,"quantity":1,"product_identifier":null,"product_tax_code":null,"description":null,"unit_price":"20.0","discount":"0.0","sales_tax":"0.0"}]}}
+```
+
+### Create refund transaction
+(Enhanced API tier)
+
+```ruby
+options = {
+  transaction_id: "REFUND_123456",
+  transaction_date: "2015/06/26",
+  transaction_reference_id: "123456",
+  amount: 10,
+  shipping: 2,
+  sales_tax: 0.84,
+  to_country: "US",
+  to_state: "NJ",
+  to_city: "Freehold",
+  to_zip: "07728",
+  from_country: "US",
+  from_state: "CA",
+  from_city: "Camarillo",
+  from_zip: "93010",
+  line_items: [
+    {
+      id: 123456,
+      unit_price: 20,
+      quantity: 1
+    }
+  ]
+}
+response = Taxjar.client.create_refund_transaction(options)
+#  => {"refund":{"transaction_id":"REFUND_123456","user_id":440,"transaction_date":"2015-06-26T00:00:00Z","transaction_reference_id":"123456","from_country":"US","from_zip":"93010","from_state":"CA","from_city":"CAMARILLO","from_street":null,"to_country":"US","to_zip":"07728","to_state":"NJ","to_city":"FREEHOLD","to_street":null,"amount":"10.0","shipping":"2.0","sales_tax":"0.84","line_items":[{"id":1,"quantity":1,"product_identifier":null,"product_tax_code":null,"description":null,"unit_price":"20.0","discount":"0.0","sales_tax":"0.0"}]}}
+```
+
+### Update refund transaction
+(Enhanced API tier)
+
+```ruby
+options = {
+  transaction_id: "REFUND_123456",
+  sales_tax: 0.94,
+}
+response = Taxjar.client.update_refund_transaction(options)
+#  => {"order":{"transaction_id":"123456","user_id":440,"transaction_date":"2015-06-26T00:00:00Z","from_country":"US","from_zip":"93010","from_state":"CA","from_city":"CAMARILLO","from_street":null,"to_country":"US","to_zip":"07728","to_state":"NJ","to_city":"FREEHOLD","to_street":null,"amount":"10.0","shipping":"2.0","sales_tax":"0.94","line_items":[{"id":1,"quantity":1,"product_identifier":null,"product_tax_code":null,"description":null,"unit_price":"20.0","discount":"0.0","sales_tax":"0.0"}]}}
 ```
 
 ## Contributing

data/lib/faraday/raise_http_exception.rb

@@ -10,10 +10,24 @@ module FaradayMiddleware
           raise Taxjar::BadRequest, error_message_400(response)
         when 401
           raise Taxjar::NotAuthorized, error_message_400(response)
+        when 403
+          raise Taxjar::Forbidden, error_message_400(response)
         when 404
           raise Taxjar::NotFound, error_message_400(response)
+        when 405
+          raise Taxjar::MethodNotAllowed, error_message_400(response)
+        when 406
+          raise Taxjar::NotAcceptable, error_message_400(response)
+        when 410
+          raise Taxjar::Gone, error_message_400(response)
+        when 422
+          raise Taxjar::UnprocessableEntity, error_message_400(response)
+        when 429
+          raise Taxjar::TooManyRequests, error_message_400(response)
         when 500
           raise Taxjar::InternalServerError, error_message_500(response, "Something is technically wrong.")
+        when 503
+          raise Taxjar::ServiceUnavailable, error_message_500(response, "Service is temporarily down for maintenance.")
         when 504
           raise Taxjar::GatewayTimeout, error_message_500(response, "504 Gateway Time-out")
         end

data/lib/taxjar/client.rb

@@ -15,16 +15,57 @@ module Taxjar
         send("#{key}=", options[key])
       end
 
+      check_configuration
       setup_conn
     end
 
     def sales_tax(options={})
-      response = @conn.get "/sales_tax", options
+      case api_version
+      when 1
+        response = @conn.get api_path('sales_tax'), options
+      when 2
+        response = @conn.post api_path('taxes'), options
+      end
       response.body
     end
 
     def tax_rate(options={})
-      response = @conn.get "/locations/#{options.delete(:zip)}", options
+      case api_version
+      when 1
+        response = @conn.get "/locations/#{options.delete(:zip)}", options
+      when 2
+        response = @conn.get api_path('rates', options.delete(:zip)), options
+      end
+      response.body
+    end
+
+    def list_categories()
+      check_availability(method_api_version: 2, method_api_tier: 'enhanced')
+      response = @conn.get api_path('categories')
+      response.body
+    end
+
+    def create_order_transaction(options={})
+      check_availability(method_api_version: 2, method_api_tier: 'enhanced')
+      response = @conn.post api_path('transactions', 'orders'), options
+      response.body
+    end
+
+    def update_order_transaction(options={})
+      check_availability(method_api_version: 2, method_api_tier: 'enhanced')
+      response = @conn.put api_path('transactions', 'orders', options.delete(:transaction_id)), options
+      response.body
+    end
+
+    def create_refund_transaction(options={})
+      check_availability(method_api_version: 2, method_api_tier: 'enhanced')
+      response = @conn.post api_path('transactions', 'refunds'), options
+      response.body
+    end
+
+    def update_refund_transaction(options={})
+      check_availability(method_api_version: 2, method_api_tier: 'enhanced')
+      response = @conn.put api_path('transactions', 'refunds', options.delete(:transaction_id)), options
       response.body
     end
 
@@ -38,6 +79,7 @@ module Taxjar
       }.merge(connection_options)
 
       @conn = Faraday::Connection.new(options) do |c|
+        c.request :url_encoded
         c.token_auth self.auth_token
         c.use FaradayMiddleware::ParseJson
         c.use FaradayMiddleware::RaiseHttpException
@@ -45,5 +87,30 @@ module Taxjar
       end
 
     end
+
+    # checks correct client configuration
+    def check_configuration
+      case api_version
+      when 1
+        raise Taxjar::BadConfiguration, "Configuration error - API v1 does not support API tiers" unless api_tier.nil?
+      when 2
+        raise Taxjar::BadConfiguration, "Configuration error - API tier #{api_tier} is invalid" unless ['standard','enhanced'].include?(api_tier)
+      end
+    end
+
+    # checks whether the requested method is available for the current configuration
+    def check_availability(method_api_version: 1, method_api_tier: nil)
+      raise Taxjar::NotAvailable, "Method not available for API v#{api_version}" if (method_api_version != api_version)
+      raise Taxjar::NotAvailable, "Method not available for #{api_tier} API tier" if (method_api_tier != api_tier)
+    end
+
+    # returns path for TaxJar API endpoint
+    #
+    # examples:
+    # API v1: /v1/sales_tax
+    # API v2: /v2/enhanced/transactions/orders/123
+    def api_path(*args)
+      "/v#{api_version}/#{args.unshift(api_tier).compact.join('/')}"
+    end
   end
 end

data/lib/taxjar/configuration.rb

@@ -9,7 +9,9 @@ module Taxjar
       :format,
       :proxy,
       :user_agent,
-      :connection_options ]
+      :connection_options,
+      :api_version,
+      :api_tier ]
 
     DEFAULT_ADAPTER = Faraday.default_adapter
     DEFAULT_AUTH_TOKEN = "dae79dc5154ccabd7cb169f616d605e7"
@@ -19,6 +21,8 @@ module Taxjar
     DEFAULT_USER_AGENT = "Taxjar ruby Gem #{Taxjar::VERSION}".freeze
 
     DEFAULT_CONNECTION_OPTIONS = {}
+    DEFAULT_API_VERSION = 1
+    DEFAULT_API_TIER = nil
 
     attr_accessor *VALID_CONFIG_KEYS
 
@@ -44,6 +48,8 @@ module Taxjar
       self.proxy      = DEFAULT_PROXY
       self.user_agent = DEFAULT_USER_AGENT
       self.connection_options = DEFAULT_CONNECTION_OPTIONS
+      self.api_version = DEFAULT_API_VERSION
+      self.api_tier = DEFAULT_API_TIER
     end
 
   end # Configuration

data/lib/taxjar/error.rb

@@ -8,10 +8,39 @@ module Taxjar
   # Raised when Taxjar returns the HTTP status code 401
   class NotAuthorized < Error; end
 
+  # Raised when Taxjar returns the HTTP status code 403
+  class Forbidden < Error; end
+
   # Raised when Taxjar returns the HTTP status code 404
   class NotFound < Error; end
 
+  # Raised when Taxjar returns the HTTP status code 405
+  class MethodNotAllowed < Error; end
+
+  # Raised when Taxjar returns the HTTP status code 406
+  class NotAcceptable < Error; end
+
+  # Raised when Taxjar returns the HTTP status code 410
+  class Gone < Error; end
+
+  # Raised when Taxjar returns the HTTP status code 422
+  class UnprocessableEntity < Error; end
+
+  # Raised when Taxjar returns the HTTP status code 429
+  class TooManyRequests < Error; end
+
   # Raised when Taxjar returns the HTTP status code 500
   class InternalServerError < Error; end
 
+  # Raised when Taxjar returns the HTTP status code 503
+  class ServiceUnavailable < Error; end
+
+  # Raised when Taxjar returns the HTTP status code 504
+  class GatewayTimeout < Error; end
+
+  # Raised when the method is not available in the configured API version or tier
+  class NotAvailable < Error; end
+
+  # Raised when Taxjar configuration is invalid
+  class BadConfiguration < Error; end
 end

data/lib/taxjar/version.rb

@@ -1,3 +1,3 @@
 module Taxjar
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/taxjar.gemspec

@@ -6,8 +6,8 @@ require 'taxjar/version'
 Gem::Specification.new do |spec|
   spec.name          = "taxjar"
   spec.version       = Taxjar::VERSION
-  spec.authors       = ["Darren Johnson"]
-  spec.email         = ["darrenbjohnson@gmail.com"]
+  spec.authors       = ["Darren Johnson, Ladislav Marsik"]
+  spec.email         = ["darrenbjohnson@gmail.com, laci.marsik@gmail.com"]
   spec.summary       = %q{A Ruby wrapper for the Taxjar API}
   spec.description   = %q{A Ruby wrapper for the Taxjar API's sales tax and tax rate endpoints}
   spec.homepage      = "http://github.com/djohnson/taxjar"

data/test/fixtures/{sales_tax.yml → v1/sales_tax.yml}

@@ -2,19 +2,19 @@
 http_interactions:
 - request:
     method: get
-    uri: https://api.taxjar.com/sales_tax?amount=10&from_city=Ramsey&from_country=US&from_state=NJ&from_zip=07446&shipping=2&to_city=Freehold&to_country=US&to_state=NJ&to_zip=07728
+    uri: https://api.taxjar.com/v1/sales_tax?amount=10&from_city=Ramsey&from_country=US&from_state=NJ&from_zip=07446&shipping=2&to_city=Freehold&to_country=US&to_state=NJ&to_zip=07728
     body:
       encoding: US-ASCII
       string: ''
     headers:
+      Accept:
+      - application/json; charset=utf-8
       User-Agent:
-      - Faraday v0.9.0
+      - Taxjar ruby Gem 0.1.0
       Authorization:
       - Token token="dae79dc5154ccabd7cb169f616d605e7"
       Accept-Encoding:
       - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
-      Accept:
-      - "*/*"
   response:
     status:
       code: 200
@@ -25,7 +25,7 @@ http_interactions:
       Connection:
       - close
       Date:
-      - Tue, 30 Dec 2014 19:59:20 GMT
+      - Thu, 25 Jun 2015 11:31:30 GMT
       Status:
       - 200 OK
       X-Frame-Options:
@@ -34,23 +34,23 @@ http_interactions:
       - 1; mode=block
       X-Content-Type-Options:
       - nosniff
-      X-Ua-Compatible:
-      - chrome=1
+      Warning:
+      - '299: "Deprecated API, respected until 2015-09-01" "2015-06-25T11:31:30.641"'
       Content-Type:
       - application/json; charset=utf-8
       Etag:
-      - '"a9ea7272ca4facfde21f8e196a21790a"'
+      - '"e5e58b860796403d1f1a3efa41b7fc30"'
       Cache-Control:
       - max-age=0, private, must-revalidate
       X-Request-Id:
-      - 49407c82-e7a6-4c7e-a1fa-3c0761c4ce42
+      - 81b4fa31-5fd5-426a-a324-5427dc5e3fcd
       X-Runtime:
-      - '0.023674'
+      - '0.026848'
       Via:
       - 1.1 vegur
     body:
       encoding: UTF-8
-      string: '{"amount_to_collect":0.84,"rate":0.07,"has_nexus":true,"freight_taxable":true,"tax_source":"destination"}'
+      string: '{"taxable_amount":12.0,"amount_to_collect":0.84,"rate":0.07,"has_nexus":true,"freight_taxable":true,"tax_source":"destination"}'
     http_version: 
-  recorded_at: Tue, 30 Dec 2014 19:59:20 GMT
+  recorded_at: Thu, 25 Jun 2015 11:31:39 GMT
 recorded_with: VCR 2.9.3

data/test/fixtures/{tax_rate.yml → v1/tax_rate.yml}

@@ -7,14 +7,14 @@ http_interactions:
       encoding: US-ASCII
       string: ''
     headers:
+      Accept:
+      - application/json; charset=utf-8
       User-Agent:
-      - Faraday v0.9.0
+      - Taxjar ruby Gem 0.1.0
       Authorization:
       - Token token="dae79dc5154ccabd7cb169f616d605e7"
       Accept-Encoding:
       - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
-      Accept:
-      - "*/*"
   response:
     status:
       code: 200
@@ -25,7 +25,7 @@ http_interactions:
       Connection:
       - close
       Date:
-      - Tue, 30 Dec 2014 20:42:38 GMT
+      - Thu, 25 Jun 2015 14:46:20 GMT
       Status:
       - 200 OK
       X-Frame-Options:
@@ -34,8 +34,8 @@ http_interactions:
       - 1; mode=block
       X-Content-Type-Options:
       - nosniff
-      X-Ua-Compatible:
-      - chrome=1
+      Warning:
+      - '299: "Deprecated API, respected until 2015-09-01" "2015-06-25T14:46:20.101"'
       Content-Type:
       - application/json; charset=utf-8
       Etag:
@@ -43,14 +43,14 @@ http_interactions:
       Cache-Control:
       - max-age=0, private, must-revalidate
       X-Request-Id:
-      - de103f0f-274a-4d4a-b064-6c58faa5adc5
+      - 6152b99c-908f-4880-9ac1-6227493d3c9b
       X-Runtime:
-      - '0.012139'
+      - '0.039630'
       Via:
       - 1.1 vegur
     body:
       encoding: UTF-8
       string: '{"location":{"state":"NJ","zip":"07446","state_rate":"0.07","city":"RAMSEY","city_rate":"0.0","county":"BERGEN","county_rate":"0.0","combined_district_rate":"0.0","combined_rate":"0.07"}}'
     http_version: 
-  recorded_at: Tue, 30 Dec 2014 20:42:38 GMT
+  recorded_at: Thu, 25 Jun 2015 14:46:29 GMT
 recorded_with: VCR 2.9.3

data/test/fixtures/v2/enhanced/create_order_transaction.yml

@@ -0,0 +1,52 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.taxjar.com/v2/enhanced/transactions/orders
+    body:
+      encoding: UTF-8
+      string: amount=10&from_city=Camarillo&from_country=US&from_state=CA&from_zip=93010&line_items%5B%5D%5Bid%5D=123456&line_items%5B%5D%5Bquantity%5D=1&line_items%5B%5D%5Bunit_price%5D=20&sales_tax=0.84&shipping=2&to_city=Freehold&to_country=US&to_state=NJ&to_zip=07728&transaction_date=2015%2F06%2F26&transaction_id=123456
+    headers:
+      Accept:
+      - application/json; charset=utf-8
+      User-Agent:
+      - Taxjar ruby Gem 0.1.0
+      Authorization:
+      - Token token="dae79dc5154ccabd7cb169f616d605e7"
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+  response:
+    status:
+      code: 201
+      message: Created
+    headers:
+      Server:
+      - Cowboy
+      Connection:
+      - keep-alive
+      Date:
+      - Fri, 26 Jun 2015 10:16:35 GMT
+      Status:
+      - 201 Created
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '495'
+      Etag:
+      - '"10809675205f5a521c954c042bb3ec53"'
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      X-Request-Id:
+      - 70e3c692-ed8e-4d92-824b-71fb3cef4ede
+      X-Runtime:
+      - '0.402656'
+      Via:
+      - 1.1 vegur
+    body:
+      encoding: UTF-8
+      string: '{"order":{"transaction_id":"123456","user_id":440,"transaction_date":"2015-06-26T00:00:00Z","from_country":"US","from_zip":"93010","from_state":"CA","from_city":"CAMARILLO","from_street":null,"to_country":"US","to_zip":"07728","to_state":"NJ","to_city":"FREEHOLD","to_street":null,"amount":"10.0","shipping":"2.0","sales_tax":"0.84","line_items":[{"id":1,"quantity":1,"product_identifier":null,"product_tax_code":null,"description":null,"unit_price":"20.0","discount":"0.0","sales_tax":"0.0"}]}}'
+    http_version: 
+  recorded_at: Fri, 26 Jun 2015 10:16:46 GMT
+recorded_with: VCR 2.9.3

data/test/fixtures/v2/enhanced/create_refund_transaction.yml

@@ -0,0 +1,52 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.taxjar.com/v2/enhanced/transactions/refunds
+    body:
+      encoding: UTF-8
+      string: amount=10&from_city=Camarillo&from_country=US&from_state=CA&from_zip=93010&line_items%5B%5D%5Bid%5D=123456&line_items%5B%5D%5Bquantity%5D=1&line_items%5B%5D%5Bunit_price%5D=20&sales_tax=0.84&shipping=2&to_city=Freehold&to_country=US&to_state=NJ&to_zip=07728&transaction_date=2015%2F06%2F26&transaction_id=REFUND_123456&transaction_reference_id=123456
+    headers:
+      Accept:
+      - application/json; charset=utf-8
+      User-Agent:
+      - Taxjar ruby Gem 0.1.0
+      Authorization:
+      - Token token="dae79dc5154ccabd7cb169f616d605e7"
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+  response:
+    status:
+      code: 201
+      message: Created
+    headers:
+      Server:
+      - Cowboy
+      Connection:
+      - keep-alive
+      Date:
+      - Fri, 26 Jun 2015 11:58:47 GMT
+      Status:
+      - 201 Created
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '539'
+      Etag:
+      - '"32c9d35f24aede17ea2a3831eb0b81c2"'
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      X-Request-Id:
+      - bb90af6e-f662-44b7-b4a4-0045a96327ca
+      X-Runtime:
+      - '0.629224'
+      Via:
+      - 1.1 vegur
+    body:
+      encoding: UTF-8
+      string: '{"refund":{"transaction_id":"REFUND_123456","user_id":440,"transaction_date":"2015-06-26T00:00:00Z","transaction_reference_id":"123456","from_country":"US","from_zip":"93010","from_state":"CA","from_city":"CAMARILLO","from_street":null,"to_country":"US","to_zip":"07728","to_state":"NJ","to_city":"FREEHOLD","to_street":null,"amount":"10.0","shipping":"2.0","sales_tax":"0.84","line_items":[{"id":1,"quantity":1,"product_identifier":null,"product_tax_code":null,"description":null,"unit_price":"20.0","discount":"0.0","sales_tax":"0.0"}]}}'
+    http_version: 
+  recorded_at: Fri, 26 Jun 2015 11:58:57 GMT
+recorded_with: VCR 2.9.3

data/test/fixtures/v2/enhanced/list_categories.yml

@@ -0,0 +1,58 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.taxjar.com/v2/enhanced/categories
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - application/json; charset=utf-8
+      User-Agent:
+      - Taxjar ruby Gem 0.1.0
+      Authorization:
+      - Token token="dae79dc5154ccabd7cb169f616d605e7"
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - Cowboy
+      Connection:
+      - keep-alive
+      Date:
+      - Fri, 26 Jun 2015 10:53:55 GMT
+      Status:
+      - 200 OK
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '777'
+      Etag:
+      - '"d806e22ec7ec1f585c2aa84ac769ee2c"'
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      X-Request-Id:
+      - 8ede27a6-dbff-4326-b114-1d9f91cfd093
+      X-Runtime:
+      - '0.024949'
+      Via:
+      - 1.1 vegur
+    body:
+      encoding: UTF-8
+      string: '{"categories":[{"name":"Other Exempt","product_tax_code":"99999","description":"item
+        is exempt"},{"name":"Clothing","product_tax_code":"20010","description":"normal
+        clothing"},{"name":"Food \u0026 Groceries","product_tax_code":"40030","description":"food
+        for humans not cooked"},{"name":"Non-Prescription","product_tax_code":"51010","description":"non
+        prescription drugs"},{"name":"Prescription","product_tax_code":"51020","description":"prescription
+        drugs"},{"name":"Digital Goods","product_tax_code":"31000","description":"digital
+        goods"},{"name":"Special Digital Products","product_tax_code":"32000","description":"special
+        digital products"},{"name":"Software as a Service","product_tax_code":"30050","description":"Pre-written
+        computer software delivered electronically"}]}'
+    http_version: 
+  recorded_at: Fri, 26 Jun 2015 10:54:05 GMT
+recorded_with: VCR 2.9.3

data/test/fixtures/v2/enhanced/update_order_transaction.yml

@@ -0,0 +1,52 @@
+---
+http_interactions:
+- request:
+    method: put
+    uri: https://api.taxjar.com/v2/enhanced/transactions/orders/123456
+    body:
+      encoding: UTF-8
+      string: amount=10&from_city=Camarillo&from_country=US&from_state=CA&from_zip=93010&line_items%5B%5D%5Bid%5D=123456&line_items%5B%5D%5Bquantity%5D=1&line_items%5B%5D%5Bunit_price%5D=20&sales_tax=0.84&shipping=2&to_city=Freehold&to_country=US&to_state=NJ&to_zip=07728&transaction_date=2015%2F06%2F26
+    headers:
+      Accept:
+      - application/json; charset=utf-8
+      User-Agent:
+      - Taxjar ruby Gem 0.1.0
+      Authorization:
+      - Token token="dae79dc5154ccabd7cb169f616d605e7"
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - Cowboy
+      Connection:
+      - keep-alive
+      Date:
+      - Fri, 26 Jun 2015 11:43:14 GMT
+      Status:
+      - 200 OK
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '495'
+      Etag:
+      - '"10809675205f5a521c954c042bb3ec53"'
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      X-Request-Id:
+      - 28be5d53-65e4-497d-aafd-984bdc0e763e
+      X-Runtime:
+      - '0.669167'
+      Via:
+      - 1.1 vegur
+    body:
+      encoding: UTF-8
+      string: '{"order":{"transaction_id":"123456","user_id":440,"transaction_date":"2015-06-26T00:00:00Z","from_country":"US","from_zip":"93010","from_state":"CA","from_city":"CAMARILLO","from_street":null,"to_country":"US","to_zip":"07728","to_state":"NJ","to_city":"FREEHOLD","to_street":null,"amount":"10.0","shipping":"2.0","sales_tax":"0.84","line_items":[{"id":1,"quantity":1,"product_identifier":null,"product_tax_code":null,"description":null,"unit_price":"20.0","discount":"0.0","sales_tax":"0.0"}]}}'
+    http_version: 
+  recorded_at: Fri, 26 Jun 2015 11:43:25 GMT
+recorded_with: VCR 2.9.3

data/test/fixtures/v2/enhanced/update_refund_transaction.yml

@@ -0,0 +1,52 @@
+---
+http_interactions:
+- request:
+    method: put
+    uri: https://api.taxjar.com/v2/enhanced/transactions/refunds/REFUND_123456
+    body:
+      encoding: UTF-8
+      string: amount=10&from_city=Camarillo&from_country=US&from_state=CA&from_zip=93010&line_items%5B%5D%5Bid%5D=123456&line_items%5B%5D%5Bquantity%5D=1&line_items%5B%5D%5Bunit_price%5D=20&sales_tax=0.84&shipping=2&to_city=Freehold&to_country=US&to_state=NJ&to_zip=07728&transaction_date=2015%2F06%2F26&transaction_reference_id=123456
+    headers:
+      Accept:
+      - application/json; charset=utf-8
+      User-Agent:
+      - Taxjar ruby Gem 0.1.0
+      Authorization:
+      - Token token="dae79dc5154ccabd7cb169f616d605e7"
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - Cowboy
+      Connection:
+      - keep-alive
+      Date:
+      - Fri, 26 Jun 2015 12:03:06 GMT
+      Status:
+      - 200 OK
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '539'
+      Etag:
+      - '"32c9d35f24aede17ea2a3831eb0b81c2"'
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      X-Request-Id:
+      - 4ef6e4b2-b27c-4807-90a5-52422758a3c4
+      X-Runtime:
+      - '0.339815'
+      Via:
+      - 1.1 vegur
+    body:
+      encoding: UTF-8
+      string: '{"refund":{"transaction_id":"REFUND_123456","user_id":440,"transaction_date":"2015-06-26T00:00:00Z","transaction_reference_id":"123456","from_country":"US","from_zip":"93010","from_state":"CA","from_city":"CAMARILLO","from_street":null,"to_country":"US","to_zip":"07728","to_state":"NJ","to_city":"FREEHOLD","to_street":null,"amount":"10.0","shipping":"2.0","sales_tax":"0.84","line_items":[{"id":1,"quantity":1,"product_identifier":null,"product_tax_code":null,"description":null,"unit_price":"20.0","discount":"0.0","sales_tax":"0.0"}]}}'
+    http_version: 
+  recorded_at: Fri, 26 Jun 2015 12:03:17 GMT
+recorded_with: VCR 2.9.3

data/test/fixtures/v2/standard/sales_tax.yml

@@ -0,0 +1,52 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.taxjar.com/v2/standard/taxes
+    body:
+      encoding: UTF-8
+      string: amount=10&from_city=Ramsey&from_country=US&from_state=NJ&from_zip=07446&shipping=2&to_city=Freehold&to_country=US&to_state=NJ&to_zip=07728
+    headers:
+      Accept:
+      - application/json; charset=utf-8
+      User-Agent:
+      - Taxjar ruby Gem 0.1.0
+      Authorization:
+      - Token token="dae79dc5154ccabd7cb169f616d605e7"
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - Cowboy
+      Connection:
+      - keep-alive
+      Date:
+      - Thu, 25 Jun 2015 12:30:57 GMT
+      Status:
+      - 200 OK
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '137'
+      Etag:
+      - '"f5fa2826a66a2b9ac360ed7be14f1679"'
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      X-Request-Id:
+      - dcc0bec5-4749-4b20-bfbe-1a50582abcf3
+      X-Runtime:
+      - '0.453908'
+      Via:
+      - 1.1 vegur
+    body:
+      encoding: UTF-8
+      string: '{"tax":{"taxable_amount":"12.0","amount_to_collect":0.84,"rate":0.07,"has_nexus":true,"freight_taxable":true,"tax_source":"destination"}}'
+    http_version: 
+  recorded_at: Thu, 25 Jun 2015 12:31:06 GMT
+recorded_with: VCR 2.9.3

data/test/fixtures/v2/standard/tax_rate.yml

@@ -0,0 +1,50 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.taxjar.com/v2/standard/rates/07446?city=Ramsey&country=US
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - application/json; charset=utf-8
+      User-Agent:
+      - Taxjar ruby Gem 0.1.0
+      Authorization:
+      - Token token="dae79dc5154ccabd7cb169f616d605e7"
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - Cowboy
+      Connection:
+      - keep-alive
+      Date:
+      - Thu, 25 Jun 2015 14:48:52 GMT
+      Status:
+      - 200 OK
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '183'
+      Etag:
+      - '"4d36d5fe8325a3598f7523580c88830a"'
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      X-Request-Id:
+      - 173d512a-3f80-49a6-a079-07b6509f8c4e
+      X-Runtime:
+      - '0.053635'
+      Via:
+      - 1.1 vegur
+    body:
+      encoding: UTF-8
+      string: '{"rate":{"zip":"07446","state":"NJ","state_rate":"0.07","county":"BERGEN","county_rate":"0.0","city":"RAMSEY","city_rate":"0.0","combined_district_rate":"0.0","combined_rate":"0.07"}}'
+    http_version: 
+  recorded_at: Thu, 25 Jun 2015 14:49:01 GMT
+recorded_with: VCR 2.9.3

data/test/taxjar/client_test.rb

@@ -2,46 +2,179 @@ require "test_helper"
 
 describe Taxjar::Client do
 
-  describe ".sales_tax" do
+  before do
+    @options_sales_tax = {
+      amount: 10,
+      shipping: 2,
+      to_country: "US",
+      to_state: "NJ",
+      to_city: "Freehold",
+      to_zip: "07728",
+      from_country: "US",
+      from_state: "NJ",
+      from_city: "Ramsey",
+      from_zip: "07446"
+    }
+
+    @options_tax_rate = {
+      zip: "07446",
+      city: "Ramsey",
+      country: "US"
+    }
+
+    @options_order_transaction = {
+      transaction_id: "123456",
+      transaction_date: "2015/06/26",
+      amount: 10,
+      shipping: 2,
+      sales_tax: 0.84,
+      to_country: "US",
+      to_state: "NJ",
+      to_city: "Freehold",
+      to_zip: "07728",
+      from_country: "US",
+      from_state: "CA",
+      from_city: "Camarillo",
+      from_zip: "93010",
+      line_items: [
+        {
+          id: 123456,
+          unit_price: 20,
+          quantity: 1
+        }
+      ]
+    }
+
+    @options_refund_transaction = {
+      transaction_id: "REFUND_123456",
+      transaction_date: "2015/06/26",
+      transaction_reference_id: "123456",
+      amount: 10,
+      shipping: 2,
+      sales_tax: 0.84,
+      to_country: "US",
+      to_state: "NJ",
+      to_city: "Freehold",
+      to_zip: "07728",
+      from_country: "US",
+      from_state: "CA",
+      from_city: "Camarillo",
+      from_zip: "93010",
+      line_items: [
+        {
+          id: 123456,
+          unit_price: 20,
+          quantity: 1
+        }
+      ]
+    }
+  end
+
+  describe "v1" do
     before do
-      @options = {
-        amount: 10,
-        shipping: 2,
-        to_country: "US",
-        to_state: "NJ",
-        to_city: "Freehold",
-        to_zip: "07728",
-        from_country: "US",
-        from_state: "NJ",
-        from_city: "Ramsey",
-        from_zip: "07446"
-      }
+      Taxjar.configure do |config|
+        config.api_version = 1
+        config.api_tier = nil
+      end
     end
 
-    it "should return a SalesTax" do
-      VCR.use_cassette("sales_tax") do
-        response = Taxjar::Client.new.sales_tax(@options)
-        response.must_be :hash
+    describe ".sales_tax" do
+      it "should return a SalesTax" do
+        VCR.use_cassette("v1/sales_tax") do
+          response = Taxjar::Client.new.sales_tax(@options_sales_tax)
+          response.must_be :hash
+        end
+      end
+    end
+
+    describe ".tax_rate" do
+      it "should return a TaxRate" do
+        VCR.use_cassette("v1/tax_rate") do
+          response = Taxjar::Client.new.tax_rate(@options_tax_rate)
+          response.must_be :hash
+        end
       end
     end
   end
 
-  describe ".tax_rate" do
+  describe "v2" do
     before do
-      @options = {
-        zip: "07446",
-        city: "Ramsey",
-        country: "US"
-      }
+      Taxjar.api_version = 2
     end
 
-    it "should return a TaxRate" do
-      VCR.use_cassette("tax_rate") do
-        response = Taxjar::Client.new.tax_rate(@options)
-        response.must_be :hash
+    describe "standard" do
+      before do
+        Taxjar.api_tier = 'standard'
+      end
+
+      describe ".sales_tax" do
+        it "should return a SalesTax" do
+          VCR.use_cassette("v2/standard/sales_tax") do
+            response = Taxjar::Client.new.sales_tax(@options_sales_tax)
+            response.must_be :hash
+          end
+        end
+      end
+
+      describe ".tax_rate" do
+        it "should return a TaxRate" do
+          VCR.use_cassette("v2/standard/tax_rate") do
+            response = Taxjar::Client.new.tax_rate(@options_tax_rate)
+            response.must_be :hash
+          end
+        end
       end
     end
-  end
 
+    describe "enhanced" do
+      before do
+        Taxjar.api_tier = 'enhanced'
+      end
+
+      describe ".list_categories" do
+        it "should list tax categories" do
+          VCR.use_cassette("v2/enhanced/list_categories") do
+            response = Taxjar::Client.new.list_categories()
+            response.must_be :hash
+          end
+        end
+      end
 
+      describe ".create_order_transaction" do
+        it "should create a new order transaction" do
+          VCR.use_cassette("v2/enhanced/create_order_transaction") do
+            response = Taxjar::Client.new.create_order_transaction(@options_order_transaction)
+            response.must_be :hash
+          end
+        end
+      end
+
+      describe ".update_order_transaction" do
+        it "should update order transaction" do
+          VCR.use_cassette("v2/enhanced/update_order_transaction") do
+            response = Taxjar::Client.new.update_order_transaction(@options_order_transaction)
+            response.must_be :hash
+          end
+        end
+      end
+
+      describe ".create_refund_transaction" do
+        it "should create a new refund transaction" do
+          VCR.use_cassette("v2/enhanced/create_refund_transaction") do
+            response = Taxjar::Client.new.create_refund_transaction(@options_refund_transaction)
+            response.must_be :hash
+          end
+        end
+      end
+
+      describe ".update_refund_transaction" do
+        it "should update refund transaction" do
+          VCR.use_cassette("v2/enhanced/update_refund_transaction") do
+            response = Taxjar::Client.new.update_refund_transaction(@options_refund_transaction)
+            response.must_be :hash
+          end
+        end
+      end
+    end
+  end
 end

data/test/taxjar/configuration_test.rb

@@ -2,7 +2,7 @@ require "./test/test_helper"
 
 describe "configuration" do
 
-  after do
+  before do
     Taxjar.reset
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: taxjar
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
-- Darren Johnson
+- Darren Johnson, Ladislav Marsik
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-31 00:00:00.000000000 Z
+date: 2015-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -154,7 +154,7 @@ dependencies:
         version: '1.0'
 description: A Ruby wrapper for the Taxjar API's sales tax and tax rate endpoints
 email:
-- darrenbjohnson@gmail.com
+- darrenbjohnson@gmail.com, laci.marsik@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -171,8 +171,15 @@ files:
 - lib/taxjar/error.rb
 - lib/taxjar/version.rb
 - taxjar.gemspec
-- test/fixtures/sales_tax.yml
-- test/fixtures/tax_rate.yml
+- test/fixtures/v1/sales_tax.yml
+- test/fixtures/v1/tax_rate.yml
+- test/fixtures/v2/enhanced/create_order_transaction.yml
+- test/fixtures/v2/enhanced/create_refund_transaction.yml
+- test/fixtures/v2/enhanced/list_categories.yml
+- test/fixtures/v2/enhanced/update_order_transaction.yml
+- test/fixtures/v2/enhanced/update_refund_transaction.yml
+- test/fixtures/v2/standard/sales_tax.yml
+- test/fixtures/v2/standard/tax_rate.yml
 - test/taxjar/client_test.rb
 - test/taxjar/configuration_test.rb
 - test/taxjar/taxjar_test.rb
@@ -197,13 +204,20 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.3
+rubygems_version: 2.4.6
 signing_key: 
 specification_version: 4
 summary: A Ruby wrapper for the Taxjar API
 test_files:
-- test/fixtures/sales_tax.yml
-- test/fixtures/tax_rate.yml
+- test/fixtures/v1/sales_tax.yml
+- test/fixtures/v1/tax_rate.yml
+- test/fixtures/v2/enhanced/create_order_transaction.yml
+- test/fixtures/v2/enhanced/create_refund_transaction.yml
+- test/fixtures/v2/enhanced/list_categories.yml
+- test/fixtures/v2/enhanced/update_order_transaction.yml
+- test/fixtures/v2/enhanced/update_refund_transaction.yml
+- test/fixtures/v2/standard/sales_tax.yml
+- test/fixtures/v2/standard/tax_rate.yml
 - test/taxjar/client_test.rb
 - test/taxjar/configuration_test.rb
 - test/taxjar/taxjar_test.rb