taxjar-ruby 1.0.0

data/lib/taxjar/breakdown.rb

@@ -0,0 +1,16 @@
+require 'taxjar/base'
+require 'taxjar/shipping'
+
+module Taxjar
+  class Breakdown < Taxjar::Base
+    attr_reader :state_taxable_amount, :state_tax_collectable, :county_taxable_amount,
+      :county_tax_collectable, :city_tax_collectable, 
+      :special_district_taxable_amount, :special_district_tax_collectable
+
+    object_attr_reader Taxjar::Shipping, :shipping
+
+    def line_items
+      @line_items ||= map_collection(Taxjar::BreakdownLineItem, :line_items)
+    end
+  end
+end

data/lib/taxjar/breakdown_line_item.rb

@@ -0,0 +1,10 @@
+require 'taxjar/base'
+
+module Taxjar
+  class BreakdownLineItem < Taxjar::Base
+    attr_reader :id, :state_taxable_amount, :state_sales_tax_rate, :county_taxable_amount,
+    :county_tax_rate, :city_taxable_amount, :city_tax_rate, :special_district_taxable_amount
+    :special_tax_rate
+
+  end
+end

data/lib/taxjar/category.rb

@@ -0,0 +1,7 @@
+require 'taxjar/base'
+
+module Taxjar
+  class Category < Taxjar::Base
+    attr_reader :name, :product_tax_code, :description
+  end
+end

data/lib/taxjar/client.rb

@@ -0,0 +1,25 @@
+require 'taxjar/api/api'
+require 'taxjar/error'
+require 'taxjar/api/request'
+require 'taxjar/api/utils'
+module Taxjar
+  class Client
+    include Taxjar::API
+    attr_accessor :api_key
+
+    def initialize(options = {})
+      options.each do |key, value|
+        instance_variable_set("@#{key}", value)
+      end
+      yield(self) if block_given?
+    end
+
+    def api_key?
+      !!@api_key
+    end
+
+    def user_agent
+      "TaxjarRubyGem/#{Taxjar::Version}"
+    end
+  end
+end

data/lib/taxjar/error.rb

@@ -0,0 +1,74 @@
+module Taxjar
+  class Error < StandardError
+    attr_reader :code
+
+    ClientError = Class.new(self)
+
+    ServerError = Class.new(self)
+
+    # Raised when Taxjar endpoint returns the HTTP status code 400
+    BadRequest = Class.new(ClientError)
+
+    # Raised when Taxjar endpoint returns the HTTP status code 401
+    Unauthorized = Class.new(ClientError)
+
+    # Raised when Taxjar endpoint returns the HTTP status code 403
+    Forbidden = Class.new(ClientError)
+
+    # Raised when Taxjar endpoint returns the HTTP status code 404
+    NotFound = Class.new(ClientError)
+
+    # Raised when Taxjar endpoint returns the HTTP status code 405
+    MethodNotAllowed = Class.new(ClientError)
+
+    # Raised when Taxjar endpoint returns the HTTP status code 406
+    NotAcceptable = Class.new(ClientError)
+
+    # Raised when Taxjar endpoint returns the HTTP status code 410
+    Gone = Class.new(ClientError)
+
+    # Raised when Taxjar endpoint returns the HTTP status code 422
+    UnprocessableEntity = Class.new(ClientError)
+
+    # Raised when Taxjar endpoint returns the HTTP status code 429
+    TooManyRequests = Class.new(ClientError)
+
+    # Raised when Taxjar endpoint returns the HTTP status code 500
+    InternalServerError = Class.new(ServerError)
+
+    # Raised when Taxjar endpoint returns the HTTP status code 503
+    ServiceUnavailable = Class.new(ServerError)
+
+    ERRORS = {
+      400 => Taxjar::Error::BadRequest,
+      401 => Taxjar::Error::Unauthorized,
+      403 => Taxjar::Error::Forbidden,
+      404 => Taxjar::Error::NotFound,
+      405 => Taxjar::Error::MethodNotAllowed,
+      406 => Taxjar::Error::NotAcceptable,
+      410 => Taxjar::Error::Gone,
+      422 => Taxjar::Error::UnprocessableEntity,
+      429 => Taxjar::Error::TooManyRequests,
+      500 => Taxjar::Error::InternalServerError,
+      503 => Taxjar::Error::ServiceUnavailable
+    }
+
+    class << self
+
+      def from_response(body)
+        code = body[:status]
+        message = body[:detail]
+        new(message, code)
+      end
+
+    end
+
+    def initialize(message = '', code = nil)
+      super(message)
+      @code = code
+    end
+
+    ConfigurationError = Class.new(::ArgumentError)
+
+  end
+end

data/lib/taxjar/line_item.rb

@@ -0,0 +1,9 @@
+require 'taxjar/base'
+
+module Taxjar
+  class LineItem < Taxjar::Base
+    attr_reader :quantity, :product_identifier, :description, :unit_price, :discount, 
+      :sales_tax
+
+  end
+end

data/lib/taxjar/order.rb

@@ -0,0 +1,13 @@
+require 'taxjar/base'
+
+module Taxjar
+  class Order < Taxjar::Base
+    attr_reader :transaction_id, :user_id, :transaction_date, :to_country, :to_zip,
+      :to_state, :to_city, :to_street, :amount, :shipping, :sales_tax
+
+    def line_items
+      @line_items ||= map_collection(Taxjar::LineItem, :line_items)
+    end
+
+  end
+end

data/lib/taxjar/rate.rb

@@ -0,0 +1,9 @@
+require 'taxjar/base'
+
+module Taxjar
+  class Rate < Taxjar::Base
+    attr_reader :zip, :state, :state_rate, :county, :city, :city_rate,
+      :combined_distric_rate, :combined_rate
+
+  end
+end

data/lib/taxjar/refund.rb

@@ -0,0 +1,13 @@
+require 'taxjar/base'
+
+module Taxjar
+  class Refund < Taxjar::Base
+
+    attr_reader :transaction_id, :user_id, :transaction_date, :transaction_reference_id, :to_country, :to_zip,
+      :to_state, :to_city, :to_street, :amount, :shipping, :sales_tax
+
+    def line_items
+      @line_items ||= map_collection(Taxjar::LineItem, :line_items)
+    end
+  end
+end

data/lib/taxjar/shipping.rb

@@ -0,0 +1,9 @@
+require 'taxjar/base'
+
+module Taxjar
+  class Shipping < Taxjar::Base
+    attr_reader :state_amount, :state_sales_tax_rate, :county_amount, :county_tax_rate,
+      :city_amount, :city_tax_rate, :special_district_amount, :special_tax_rate
+
+  end
+end

data/lib/taxjar/tax.rb

@@ -0,0 +1,11 @@
+require 'taxjar/base'
+
+module Taxjar
+  class Tax < Taxjar::Base
+    attr_reader :order_total_amount, :amount_to_collect, :has_nexus, 
+      :freight_taxable, :tax_source
+
+    object_attr_reader Taxjar::Breakdown, :brekdown
+
+  end
+end

data/lib/taxjar/version.rb

@@ -0,0 +1,38 @@
+module Taxjar
+  module Version
+  module_function
+
+    def major
+      1
+    end
+
+    def minor
+      0
+    end
+
+    def patch
+      0
+    end
+
+    def pre
+      nil
+    end
+
+    def to_h
+      {
+        major: major,
+        minor: minor,
+        patch: patch,
+        pre: pre,
+      }
+    end
+
+    def to_a
+      to_h.values.compact
+    end
+
+    def to_s
+      to_a.join('.')
+    end
+  end
+end

data/spec/fixtures/categories.json

@@ -0,0 +1,39 @@
+{
+  "categories": [
+    {
+      "name": "Digital Goods",
+      "product_tax_code": "31000",
+      "description": "Digital products transferred electronically, meaning obtained by the purchaser by means other than tangible storage media."
+    },
+    {
+      "name": "Clothing",
+      "product_tax_code": "20010",
+      "description": " All human wearing apparel suitable for general use"
+    },
+    {
+      "name": "Non-Prescription",
+      "product_tax_code": "51010",
+      "description": "Drugs for human use without a prescription"
+    },
+    {
+      "name": "Prescription",
+      "product_tax_code": "51020",
+      "description": "Drugs for human use with a prescription"
+    },
+    {
+      "name": "Food & Groceries",
+      "product_tax_code": "40030",
+      "description": "Food for humans consumption, unprepared"
+    },
+    {
+      "name": "Other Exempt",
+      "product_tax_code": "99999",
+      "description": "Item is exempt"
+    },
+    {
+      "name": "Software as a Service",
+      "product_tax_code": "30070",
+      "description": "Pre-written software, delivered electronically, but access remotely."
+    }
+  ]
+}

data/spec/fixtures/order.json

@@ -0,0 +1,26 @@
+{
+  "order": {
+    "transaction_id": "123",
+    "user_id": 10649,
+    "transaction_date": "2015-05-14T00:00:00Z",
+    "to_country": "US",
+    "to_zip": "90002",
+    "to_state": "CA",
+    "to_city": "LOS ANGELES",
+    "to_street": "123 Palm Grove Ln",
+    "amount": "17.45",
+    "shipping": "1.5",
+    "sales_tax": "0.95",
+    "line_items": [
+      {
+        "id": 1,
+        "quantity": 1,
+        "product_identifier": "12-34243-9",
+        "description": "Fuzzy Widget",
+        "unit_price": "15.0",
+        "discount": "0.0",
+        "sales_tax": "0.95"
+      }
+    ]
+  }
+}

data/spec/fixtures/rates.json

@@ -0,0 +1,13 @@
+{
+  "rate": {
+    "zip": "90002",
+    "state": "CA",
+    "state_rate": "0.065",
+    "county": "LOS ANGELES",
+    "county_rate": "0.01",
+    "city": "WATTS",
+    "city_rate": "0.0",
+    "combined_district_rate": "0.015",
+    "combined_rate": "0.09"
+  }
+}

data/spec/fixtures/refund.json

@@ -0,0 +1,27 @@
+{
+  "refund": {
+    "transaction_id": "321",
+    "user_id": 10649,
+    "transaction_date": "2015-05-14T00:00:00Z",
+    "transaction_reference_id": "123",
+    "to_country": "US",
+    "to_zip": "90002",
+    "to_state": "CA",
+    "to_city": "LOS ANGELES",
+    "to_street": "123 Palm Grove Ln",
+    "amount": "17.45",
+    "shipping": "1.5",
+    "sales_tax": "0.95",
+    "line_items": [
+      {
+        "id": 1,
+        "quantity": 1,
+        "product_identifier": "12-34243-9",
+        "description": "Fuzzy Widget",
+        "unit_price": "15.0",
+        "discount": "0.0",
+        "sales_tax": "0.95"
+      }
+    ]
+  }
+}

data/spec/fixtures/taxes.json

@@ -0,0 +1,42 @@
+{
+  "tax": {
+    "order_total_amount": 16.5,
+    "amount_to_collect": 1.16,
+    "has_nexus": true,
+    "freight_taxable": true,
+    "tax_source": "destination",
+    "breakdown": {
+      "shipping": {
+        "state_amount": 0.11,
+        "state_sales_tax_rate": 0.07,
+        "county_amount": 0,
+        "county_tax_rate": 0,
+        "city_amount": 0,
+        "city_tax_rate": 0,
+        "special_district_amount": 0,
+        "special_tax_rate": 0
+      },
+      "state_taxable_amount": 16.5,
+      "state_tax_collectable": 1.16,
+      "county_taxable_amount": 0,
+      "county_tax_collectable": 0,
+      "city_taxable_amount": 0,
+      "city_tax_collectable": 0,
+      "special_district_taxable_amount": 0,
+      "special_district_tax_collectable": 0,
+      "line_items": [
+        {
+          "id": "1",
+          "state_taxable_amount": 15,
+          "state_sales_tax_rate": 0.07,
+          "county_taxable_amount": 0,
+          "county_tax_rate": 0,
+          "city_taxable_amount": 0,
+          "city_tax_rate": 0,
+          "special_district_taxable_amount": 0,
+          "special_tax_rate": 0
+        }
+      ]
+    }
+  }
+}

data/spec/helper.rb

@@ -0,0 +1,45 @@
+require 'taxjar'
+require 'rspec'
+require 'webmock/rspec'
+
+WebMock.disable_net_connect!(allow: 'coveralls.io')
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end
+
+
+def a_get(path)
+  a_request(:get, Taxjar::API::Request::BASE_URL + path)
+end
+
+def a_post(path)
+  a_request(:post, Taxjar::API::Request::BASE_URL + path)
+end
+
+def a_put(path)
+  a_request(:put, Taxjar::API::Request::BASE_URL + path)
+end
+
+def stub_get(path)
+  stub_request(:get, Taxjar::API::Request::BASE_URL + path)
+end
+
+def stub_post(path)
+  stub_request(:post, Taxjar::API::Request::BASE_URL + path)
+end
+
+def stub_put(path)
+  stub_request(:put, Taxjar::API::Request::BASE_URL + path)
+end
+
+def fixture_path
+    File.expand_path('../fixtures', __FILE__)
+end
+
+def fixture(file)
+    File.new(fixture_path + '/' + file)
+end
+