avatax 17.8.1 → 17.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9ff123feb21d5c4095101de3bd2374dd451eb3dd
-  data.tar.gz: 8d30daf442c6dc18fa66195e305c128d83cdc6a2
+  metadata.gz: '0680587db1990a807285ce4440ee7ab4c2b6038c'
+  data.tar.gz: 8b57b3f6eab1e7ad9db997186e2ea8c890ad6149
 SHA512:
-  metadata.gz: 36a96bbe9fa0cddb55147de9f7be3a14cf911537e6ae6327dafe10451b0df9ed9aee082d7246951cbcb645909aa705b918f46f88bc868e515fc6b16c04e06a54
-  data.tar.gz: 6879d45e224836daddd1e4869bc2c6871e00e3926d924d8c84dfae254035687edaa4a7b959238a09bf0dd0d42df9f346c891d0785b97b8dcd554dbbc736a8dd6
+  metadata.gz: 64b065f5aecbc0d52212ce81ca68e4106e92e0f5ce9b702ad28b7bac6a8a6b7733b0c5721e9a499a976fcf0a405ea4e75898ff1f8d81afab0c334d4ea65fe14c
+  data.tar.gz: 1a21be078475e0781f14d183b2c79a7696c2c838a95f6da867df3642ccfb64955976441d87df713ebb14ce8d16ee7b2411e9238f89586ea642fad736a4c869ba

data/.gitignore

@@ -10,6 +10,7 @@
 /test/version_tmp/
 /tmp/
 /example/credentials.yaml
+/spec/credentials.yaml
 
 # Used by dotenv library to load environment variables.
 # .env

data/example/avatax.rb

@@ -4,11 +4,44 @@ require File.expand_path('../../lib/avatax', __FILE__)
 credentials = YAML.load_file(File.expand_path('../credentials.yaml', __FILE__))
 
 AvaTax.configure do |config|
-  config.endpoint = credentials['endpoint']
-  config.username = credentials['username']
-  config.password = credentials['password']
+  begin
+    credentials = YAML.load_file(File.expand_path('../credentials.yaml', __FILE__))
+    config.endpoint = credentials['endpoint']
+    config.username = credentials['username']
+    config.password = credentials['password']
+  rescue
+    config.endpoint = 'https://sandbox-rest.avatax.com'
+    config.username = ENV['SANDBOX_USERNAME']
+    config.password = ENV['SANDBOX_PASSWORD']
+  end
 end
 
 @client = AvaTax::Client.new(:logger => true)
 
-puts @client.query_companies
+#puts @client.query_companies
+
+createTransactionModel = {
+  type: 'SalesInvoice',
+  companyCode: 'DEFAULT',
+  date: '2017-06-05',
+  customerCode: 'ABC',
+  "addresses": {
+    "ShipFrom": {
+      "line1": "123 Main Street",
+      "city": "Irvine",
+      "region": "CA",
+      "country": "US",
+      "postalCode": "92615"
+    },
+    "ShipTo": {
+      "line1": "100 Market Street",
+      "city": "San Francisco",
+      "region": "CA",
+      "country": "US",
+      "postalCode": "94105"
+    }
+  },
+  lines: [{amount: 100}]
+}
+transaction = @client.create_transaction(createTransactionModel)
+puts transaction

data/lib/avatax/client/accounts.rb

@@ -6,8 +6,17 @@ module AvaTax
       # Reset this account's license key
       #
       # Resets the existing license key for this account to a new key.
+      #
       # To reset your account, you must specify the ID of the account you wish to reset and confirm the action.
+      #
+      # This API is only available to account administrators for the account in question, and may only be called after
+      # an account has been activated by reading and accepting Avalara's terms and conditions. To activate your account
+      # please log onto the AvaTax website or call the `ActivateAccount` API.
+      #
       # Resetting a license key cannot be undone. Any previous license keys will immediately cease to work when a new key is created.
+      #
+      # When you call this API, all account administrators for this account will receive an email with the newly updated license key.
+      # The email will specify which user reset the license key and it will contain the new key to use to update your connectors.
       # @param id [Integer] The ID of the account you wish to update.
       # @param model [Object] A request confirming that you wish to reset the license key of this account.
       # @return [Object]
@@ -24,6 +33,9 @@ module AvaTax
       # This activation request can only be called by account administrators. You must indicate
       # that you have read and accepted Avalara's terms and conditions to call this API.
       #
+      # Once you have activated your account, use the `AccountResetLicenseKey` API to generate
+      # a license key for your account.
+      #
       # If you have not read or accepted the terms and conditions, this API call will return the
       # unchanged account model.
       # @param id [Integer] The ID of the account to activate

data/lib/avatax/client/companies.rb

@@ -40,6 +40,7 @@ module AvaTax
       #
       # This API only provides a limited subset of functionality compared to the 'Create Company' API call.
       # If you need additional features or options not present in this 'Quick Setup' API call, please use the full 'Create Company' call instead.
+      # Please allow 1 minute before making transactions using the company.
       # @param model [Object] Information about the company you wish to create.
       # @return [Object]
       def company_initialize(model)

data/lib/avatax/client/filingcalendars.rb

@@ -48,6 +48,19 @@ module AvaTax
       end
 
 
+      # Create a filing calendar
+      #
+      # This API is available by invitation only and only available for users with Compliance access
+      # A "filing request" represents information that compliance uses to file a return
+      # @param companyId [Integer] The unique ID of the company that will add the new filing calendar
+      # @param model [FilingCalendarModel[]] Filing calendars that will be added
+      # @return [Object]
+      def create_filing_calendars(companyId, model)
+        path = "/api/v2/companies/#{companyId}/filingcalendars"
+        post(path, model)
+      end
+
+
       # Create a new filing request to create a filing calendar
       #
       # This API is available by invitation only.
@@ -255,11 +268,9 @@ module AvaTax
       end
 
 
-      # Edit existing Filing Calendar's Notes
+      # Edit existing Filing Calendar
       #
       # This API is available by invitation only.
-      # This API only allows updating of internal notes and company filing instructions.
-      # All other updates must go through a filing request at this time.
       # @param companyId [Integer] The unique ID of the company that owns the filing request object
       # @param id [Integer] The unique ID of the filing calendar object
       # @param model [Object] The filing calendar model you are wishing to update with.

data/lib/avatax/client/filings.rb

@@ -388,7 +388,7 @@ module AvaTax
 
       # Rebuild a set of filings for the specified company in the given filing period, country and region.
       #
-      # This API is available by invitation only.
+      # This API is available by invitation only.audit.CheckAuthorizationReturns(null, companyId);
       # Rebuilding a return means re-creating or updating the amounts to be filed for a filing.
       # Rebuilding has to be done whenever a customer adds transactions to a filing.
       # A "filing period" is the year and month of the date of the latest customer transaction allowed to be reported on a filing,

data/lib/avatax/client/nexus.rb

@@ -13,6 +13,7 @@ module AvaTax
       # Note that not all fields within a nexus can be updated; Avalara publishes a list of all defined nexus at the
       # '/api/v2/definitions/nexus' endpoint.
       # You may only define nexus matching the official list of declared nexus.
+      # Please allow 1 minute before start using the created Nexus in your transactions.
       # @param companyId [Integer] The ID of the company that owns this nexus.
       # @param model [NexusModel[]] The nexus you wish to create.
       # @return [NexusModel[]]
@@ -25,6 +26,7 @@ module AvaTax
       # Delete a single nexus
       #
       # Marks the existing nexus object at this URL as deleted.
+      # Please allow 1 minute to stop collecting tax in your transaction on the deleted Nexus.
       # @param companyId [Integer] The ID of the company that owns this nexus.
       # @param id [Integer] The ID of the nexus you wish to delete.
       # @return [ErrorDetail[]]
@@ -129,6 +131,7 @@ module AvaTax
       # You may only define nexus matching the official list of declared nexus.
       # All data from the existing object will be replaced with data in the object you PUT.
       # To set a field's value to null, you may either set its value to null or omit that field from the object you post.
+      # Please allow 1 minute to start seeing your updated Nexus taking effect on your transactions.
       # @param companyId [Integer] The ID of the company that this nexus belongs to.
       # @param id [Integer] The ID of the nexus you wish to update
       # @param model [Object] The nexus object you wish to update.

data/lib/avatax/client/onboarding.rb

@@ -18,7 +18,7 @@ module AvaTax
       # terms and conditions. If they do so, they can receive a license key as part of this API and their
       # API will be created in `Active` status. If the customer has not yet read and accepted these terms and
       # conditions, the account will be created in `New` status and they can receive a license key by logging
-      # onto AvaTax and reviewing terms and conditions online.
+      # onto the AvaTax website and reviewing terms and conditions online.
       # @param model [Object] Information about the account you wish to create and the selected product offerings.
       # @return [Object]
       def request_new_account(model)

data/lib/avatax/client/registrar.rb

@@ -191,4 +191,4 @@ module AvaTax
 
     end
   end
-end
+end

data/lib/avatax/client/reports.rb

@@ -3,17 +3,111 @@ module AvaTax
     module Reports 
 
 
-      # Export a report accurate to the line level
+      # Download a report
       #
-      # 
-      # @param companyId [Integer] 
-      # @param model [Object] 
+      # This API downloads the file associated with a report.
+      #
+      # If the report is not yet complete, you will receive a `ReportNotFinished` error. To check if a report is complete,
+      # use the `GetReport` API.
+      #
+      # Reports are run as asynchronous report tasks on the server. When complete, the report file will be available for download
+      # for up to 30 days after completion. To run an asynchronous report, you should follow these steps:
+      #
+      # * Begin a report by calling the report's Initiate API. There is a separate initiate API call for each report type.
+      # * In the result of the Initiate API, you receive back a report's `id` value.
+      # * Check the status of a report by calling `GetReport` and passing in the report's `id` value.
+      # * When a report's status is `Completed`, call `DownloadReport` to retrieve the file.
+      #
+      # This API works for all report types.
+      # @param id [Integer] The unique ID number of this report
+      # @return [Object]
+      def download_report(id)
+        path = "/api/v2/reports/#{id}/attachment"
+        get(path)
+      end
+
+
+      # Intiate and download an ExportDocumentLine report
+      #
+      # This API is deprecated.
+      #
+      # Please use the asynchronous reports APIs:
+      #
+      # * Begin a report by calling the report's Initiate API. There is a separate initiate API call for each report type.
+      # * In the result of the Initiate API, you receive back a report's `id` value.
+      # * Check the status of a report by calling `GetReport` and passing in the report's `id` value.
+      # * When a report's status is `Completed`, call `DownloadReport` to retrieve the file.
+      # @param companyId [Integer] The unique ID number of the company to report on.
+      # @param model [Object] Options that may be configured to customize the report.
       # @return [Object]
       def export_document_line(companyId, model)
         path = "/api/v2/companies/#{companyId}/reports/exportdocumentline"
         post(path, model)
       end
 
+
+      # Retrieve a single report
+      #
+      # Retrieve a single report by its unique ID number.
+      #
+      # Reports are run as asynchronous report tasks on the server. When complete, the report file will be available for download
+      # for up to 30 days after completion. To run an asynchronous report, you should follow these steps:
+      #
+      # * Begin a report by calling the report's Initiate API. There is a separate initiate API call for each report type.
+      # * In the result of the Initiate API, you receive back a report's `id` value.
+      # * Check the status of a report by calling `GetReport` and passing in the report's `id` value.
+      # * When a report's status is `Completed`, call `DownloadReport` to retrieve the file.
+      #
+      # This API call returns information about any report type.
+      # @param id [Integer] The unique ID number of the report to retrieve
+      # @return [Object]
+      def get_report(id)
+        path = "/api/v2/reports/#{id}"
+        get(path)
+      end
+
+
+      # Initiate an ExportDocumentLine report task
+      #
+      # Begins running an `ExportDocumentLine` report task and returns the identity of the report.
+      #
+      # Reports are run as asynchronous report tasks on the server. When complete, the report file will be available for download
+      # for up to 30 days after completion. To run an asynchronous report, you should follow these steps:
+      #
+      # * Begin a report by calling the report's Initiate API. There is a separate initiate API call for each report type.
+      # * In the result of the Initiate API, you receive back a report's `id` value.
+      # * Check the status of a report by calling `GetReport` and passing in the report's `id` value.
+      # * When a report's status is `Completed`, call `DownloadReport` to retrieve the file.
+      #
+      # The `ExportDocumentLine` report produces information about invoice lines recorded within your account.
+      # @param companyId [Integer] The unique ID number of the company to report on.
+      # @param model [Object] Options that may be configured to customize the report.
+      # @return [Object]
+      def initiate_export_document_line_report(companyId, model)
+        path = "/api/v2/companies/#{companyId}/reports/exportdocumentline/initiate"
+        post(path, model)
+      end
+
+
+      # List all report tasks for account
+      #
+      # List all report tasks for your account.
+      #
+      # Reports are run as asynchronous report tasks on the server. When complete, the report file will be available for download
+      # for up to 30 days after completion. To run an asynchronous report, you should follow these steps:
+      #
+      # * Begin a report by calling the report's Initiate API. There is a separate initiate API call for each report type.
+      # * In the result of the Initiate API, you receive back a report's `id` value.
+      # * Check the status of a report by calling `GetReport` and passing in the report's `id` value.
+      # * When a report's status is `Completed`, call `DownloadReport` to retrieve the file.
+      #
+      # This API call returns information about all report types across your entire account.
+      # @return [FetchResult]
+      def list_reports()
+        path = "/api/v2/reports"
+        get(path)
+      end
+
     end
   end
 end

data/lib/avatax/client/taxcontent.rb

@@ -16,6 +16,8 @@ module AvaTax
       #
       # This API builds the file on demand, and is limited to files with no more than 7500 scenarios. To build a tax content
       # file for a single location at a time, please use `BuildTaxContentFileForLocation`.
+      #
+      # NOTE: This API does not work for Tennessee tax holiday scenarios.
       # @param model [Object] Parameters about the desired file format and report format, specifying which company, locations and TaxCodes to include.
       # @return [Object]
       def build_tax_content_file(model)
@@ -37,6 +39,8 @@ module AvaTax
       #
       # This API builds the file on demand, and is limited to files with no more than 7500 scenarios. To build a tax content
       # file for a multiple locations in a single file, please use `BuildTaxContentFile`.
+      #
+      # NOTE: This API does not work for Tennessee tax holiday scenarios.
       # @param companyId [Integer] The ID number of the company that owns this location.
       # @param id [Integer] The ID number of the location to retrieve point-of-sale data.
       # @param date [DateTime] The date for which point-of-sale data would be calculated (today by default)

data/lib/avatax/client/transactions.rb

@@ -61,7 +61,7 @@ module AvaTax
       #
       # Retrieve audit information about a transaction stored in AvaTax.
       #
-      # The 'AuditTransaction' endpoint retrieves audit information related to a specific transaction. This audit
+      # The `AuditTransaction` API retrieves audit information related to a specific transaction. This audit
       # information includes the following:
       #
       # * The `CompanyId` of the company that created the transaction
@@ -87,7 +87,7 @@ module AvaTax
       #
       # Retrieve audit information about a transaction stored in AvaTax.
       #
-      # The 'AuditTransaction' endpoint retrieves audit information related to a specific transaction. This audit
+      # The `AuditTransaction` API retrieves audit information related to a specific transaction. This audit
       # information includes the following:
       #
       # * The `CompanyId` of the company that created the transaction
@@ -160,15 +160,22 @@ module AvaTax
       end
 
 
-      # Create a new transaction
+      # Create or adjust a transaction
+      #
+      # Records a new transaction or adjust an existing transaction in AvaTax.
+      #
+      # The `CreateOrAdjustTransaction` endpoint is used to create a new transaction or update an existing one. This API
+      # can help you create an idempotent service that creates transactions
+      # If there exists a transaction identified by code, the original transaction will be adjusted by using the meta data
+      # in the input transaction.
       #
-      # Records a new transaction or adjust an existing in AvaTax.
+      # The `CreateOrAdjustTransaction` API cannot modify any transaction that has been reported to a tax authority using
+      # the Avalara Managed Returns Service or any other tax filing service. If you call this API to attempt to modify
+      # a transaction that has been reported on a tax filing, you will receive the error `CannotModifyLockedTransaction`.
       #
-      # The `CreateOrAdjustTransaction` endpoint is used to create a new transaction if the input transaction does not exist
-      # or if there exists a transaction identified by code, the original transaction will be adjusted by using the meta data
-      # in the input transaction
+      # To generate a refund for a transaction, use the `RefundTransaction` API.
       #
-      # If you don't specify type in the provided data, a new transaction with type of SalesOrder will be recorded by default.
+      # If you don't specify the field `type` in your request, you will get an estimate of type `SalesOrder`, which will not be recorded in the database.
       #
       # A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like
       # sales, purchases, inventory transfer, and returns (also called refunds).
@@ -180,10 +187,11 @@ module AvaTax
       # * Addresses
       # * SummaryOnly (omit lines and details - reduces API response size)
       # * LinesOnly (omit details - reduces API response size)
+      # * ForceTimeout - Simulates a timeout. This adds a 30 second delay and error to your API call. This can be used to test your code to ensure it can respond correctly in the case of a dropped connection.
       #
       # If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`.
       # @param include [String] Specifies objects to include in the response after transaction is created
-      # @param model [Object] The transaction you wish to create
+      # @param model [Object] The transaction you wish to create or adjust
       # @return [Object]
       def create_or_adjust_transaction(model, options={})
         path = "/api/v2/transactions/createoradjust"
@@ -199,7 +207,13 @@ module AvaTax
       # and rates to apply to all line items in this transaction, and reports the total tax calculated by AvaTax based on your
       # company's configuration and the data provided in this API call.
       #
-      # If you don't specify type in the provided data, a new transaction with type of SalesOrder will be recorded by default.
+      # The `CreateTransaction` API will report an error if a committed transaction already exists with the same `code`. To
+      # avoid this error, use the `CreateOrAdjustTransaction` API - it will create the transaction if it does not exist, or
+      # update it if it does exist.
+      #
+      # To generate a refund for a transaction, use the `RefundTransaction` API.
+      #
+      # If you don't specify the field `type` in your request, you will get an estimate of type `SalesOrder`, which will not be recorded in the database.
       #
       # A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like
       # sales, purchases, inventory transfer, and returns (also called refunds).
@@ -211,6 +225,7 @@ module AvaTax
       # * Addresses
       # * SummaryOnly (omit lines and details - reduces API response size)
       # * LinesOnly (omit details - reduces API response size)
+      # * ForceTimeout - Simulates a timeout. This adds a 30 second delay and error to your API call. This can be used to test your code to ensure it can respond correctly in the case of a dropped connection.
       #
       # If you omit the `$include` parameter, the API will assume you want `Summary,Addresses`.
       # @param include [String] Specifies objects to include in the response after transaction is created
@@ -252,10 +267,14 @@ module AvaTax
 
       # Retrieve a single transaction by code
       #
-      # Get the current transaction identified by this URL.
+      # Get the current `SalesInvoice` transaction identified by this URL.
+      #
+      # To fetch other kinds of transactions, use `GetTransactionByCodeAndType`.
+      #
       # If this transaction was adjusted, the return value of this API will be the current transaction with this code, and previous revisions of
-      # the transaction will be attached to the 'history' data field.
-      # You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values:
+      # the transaction will be attached to the `history` data field.
+      #
+      # You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values:
       #
       # * Lines
       # * Details (implies lines)
@@ -276,9 +295,11 @@ module AvaTax
       # Retrieve a single transaction by code
       #
       # Get the current transaction identified by this URL.
+      #
       # If this transaction was adjusted, the return value of this API will be the current transaction with this code, and previous revisions of
-      # the transaction will be attached to the 'history' data field.
-      # You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values:
+      # the transaction will be attached to the `history` data field.
+      #
+      # You may specify one or more of the following values in the `$include` parameter to fetch additional nested data, using commas to separate multiple values:
       #
       # * Lines
       # * Details (implies lines)
@@ -380,8 +401,21 @@ module AvaTax
       # for a previously created `SalesInvoice` transaction. You can choose to create a full or partial refund, and
       # specify individual line items from the original sale for refund.
       #
-      # A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like
-      # sales, purchases, inventory transfer, and returns (also called refunds).
+      # The `RefundTransaction` API ensures that the tax amount you refund to the customer exactly matches the tax that
+      # was calculated during the original transaction, regardless of any changes to your company's configuration, rules,
+      # nexus, or any other setting.
+      #
+      # This API is intended to be a shortcut to allow you to quickly and accurately generate a refund for the following
+      # common refund scenarios:
+      #
+      # * A full refund of a previous sale
+      # * Refunding the tax that was charged on a previous sale, when the customer provides an exemption certificate after the purchase
+      # * Refunding one or more items (lines) from a previous sale
+      # * Granting a customer a percentage refund of a previous sale
+      #
+      # For more complex scenarios than the ones above, please use `CreateTransaction` with document type `ReturnInvoice` to
+      # create a custom refund transaction.
+      #
       # You may specify one or more of the following values in the '$include' parameter to fetch additional nested data, using commas to separate multiple values:
       #
       # * Lines
@@ -450,4 +484,4 @@ module AvaTax
 
     end
   end
-end
+end

data/lib/avatax/request.rb

@@ -1,37 +1,39 @@
 require 'hashie'
+require 'json'
 
 module AvaTax
   module Request
 
     def get(path, options={})
-      request(:get, path, options)
+      request(:get, path, nil, options)
     end
 
-    def post(path, options={})
-      request(:post, path, options)
+    def post(path, model, options={})
+      request(:post, path, model, options)
     end
 
-    def put(path, options={})
-      request(:put, path, options)
+    def put(path, model, options={})
+      request(:put, path, model, options)
     end
 
     def delete(path, options={})
-      request(:delete, path, options)
+      request(:delete, path, nil, options)
     end
 
-    def request(method, path, options)
+    def request(method, path, model, options={})
       response = connection.send(method) do |request|
         case method
         when :get, :delete
-          request.url(URI.encode(path), options)
+          request.url("#{URI.encode(path)}?#{URI.encode_www_form(options)}")
         when :post, :put
-          request.path = URI.encode(path)
+          request.path = ("#{URI.encode(path)}?#{URI.encode_www_form(options)}")
           request.headers['Content-Type'] = 'application/json'
-          request.body = options.to_json unless options.empty?
+          request.body = model.to_json unless model.empty?
         end
       end
 
-      ::Hashie::Mash.new response.body
+      #::Hashie::Mash.new response.body
+      response.body
     end
 
   end

data/lib/avatax/version.rb

@@ -1,3 +1,3 @@
 module AvaTax
-  VERSION = '17.8.1'.freeze unless defined?(::AvaTax::VERSION)
+  VERSION = '17.9.1'.freeze unless defined?(::AvaTax::VERSION)
 end

data/spec/avatax/client/accounts_spec.rb

@@ -1,26 +1,13 @@
 require File.expand_path('../../../spec_helper', __FILE__)
 
 describe AvaTax::Client do
-  before do
-    @client = AvaTax::Client.new()
-  end
 
   describe ".accounts" do
-    before do
-      stub_get("/api/v2/accounts").
-        to_return(:body => fixture("accounts.json"), :headers => {:content_type => "application/json; charset=utf-8"})
-    end
-
-    it "should get the correct resource" do
-      @client.query_accounts()
-      expect(a_get("/api/v2/accounts")).to have_been_made
-    end
-
     it "should return an array of accounts" do
       accounts = @client.query_accounts
       expect(accounts).to be_a Object
-      expect(accounts['value'].first['id']).to equal 200000251
-      expect(accounts.value.first.id).to equal 200000251
+      expect(accounts['value'].first['id']).to be_a Integer
     end
   end
+
 end

data/spec/avatax/client/transactions_spec.rb

@@ -0,0 +1,40 @@
+require File.expand_path('../../../spec_helper', __FILE__)
+
+describe AvaTax::Client do
+
+  describe ".transactions" do
+    before do
+      @base_transaction = {
+        type: 'SalesInvoice',
+        companyCode: @company_code,
+        date: '2017-06-05',
+        customerCode: 'ABC',
+        addresses: {
+          ShipFrom: {
+            line1: "123 Main Street",
+            city: "Irvine",
+            region: "CA",
+            country: "US",
+            postalCode: "92615"
+          },
+          ShipTo: {
+            line1: "100 Market Street",
+            city: "San Francisco",
+            region: "CA",
+            country: "US",
+            postalCode: "94105"
+          }
+        },
+        lines: [{amount: 100}]
+      }
+    end
+
+    it "should create a transaction" do
+      transaction = @client.create_transaction(@base_transaction)
+      expect(transaction).to be_a Object
+      expect(transaction["id"]).to be_a Integer
+      expect(transaction["status"]).to eq "Saved"
+    end
+
+  end
+end

data/spec/avatax_spec.rb

@@ -1,27 +1,15 @@
 require File.expand_path('../spec_helper', __FILE__)
+begin
+  credentials = YAML.load_file(File.expand_path('../credentials.yaml', __FILE__))
+rescue
+  credentials = {
+    "endpoint" => 'https://sandbox-rest.avatax.com',
+    "username" => ENV['SANDBOX_USERNAME'],
+    "password" => ENV['SANDBOX_PASSWORD'],
+  }
+end
 
 describe AvaTax do
-  after do
-    AvaTax.reset
-  end
-
-  context "when delegating to a client" do
-
-     before do
-       stub_get("/api/v2/accounts").
-         to_return(:body => fixture("accounts.json"), :headers => {:content_type => "application/json; charset=utf-8"})
-     end
-
-     it "should get the correct resource" do
-       AvaTax.query_accounts()
-       expect(a_get("/api/v2/accounts")).to have_been_made
-     end
-
-     it "should return the same results as a client" do
-       expect(AvaTax.query_accounts()).to eq AvaTax::Client.new().query_accounts()
-     end
-
-   end
 
   describe ".client" do
     it "should be a AvaTax::Client" do
@@ -31,7 +19,7 @@ describe AvaTax do
 
   describe ".endpoint" do
     it "should return the default endpoint" do
-      expect(AvaTax.endpoint).to eq AvaTax::Configuration::DEFAULT_ENDPOINT
+      expect(AvaTax.endpoint).to eq credentials['endpoint']
     end
   end
 

data/spec/credentials.yaml.example

@@ -0,0 +1,4 @@
+---
+endpoint: https://sandbox-rest.avatax.com
+username: ---
+password: ---

data/spec/spec_helper.rb

@@ -1,47 +1,27 @@
 require File.expand_path('../../lib/avatax', __FILE__)
 require 'rspec'
-require 'webmock/rspec'
+require 'yaml'
 
-RSpec.configure do |config|
-  config.include WebMock::API
-end
-
-def a_delete(path)
-  a_request(:delete, AvaTax.endpoint + path)
-end
-
-def a_get(path)
-  a_request(:get, AvaTax.endpoint + path)
-end
-
-def a_post(path)
-  a_request(:post, AvaTax.endpoint + path)
-end
-
-def a_put(path)
-  a_request(:put, AvaTax.endpoint + path)
-end
 
-def stub_delete(path)
-  stub_request(:delete, AvaTax.endpoint + path)
+AvaTax.configure do |config|
+  begin
+    credentials = YAML.load_file(File.expand_path('../credentials.yaml', __FILE__))
+    config.endpoint = credentials['endpoint']
+    config.username = credentials['username']
+    config.password = credentials['password']
+  rescue
+    config.endpoint = 'https://sandbox-rest.avatax.com'
+    config.username = ENV['SANDBOX_USERNAME']
+    config.password = ENV['SANDBOX_PASSWORD']
+  end
 end
 
-def stub_get(path)
-  stub_request(:get, AvaTax.endpoint + path)
-end
+client = AvaTax::Client.new()
+companies = client.query_companies
 
-def stub_post(path)
-  stub_request(:post, AvaTax.endpoint + path)
-end
-
-def stub_put(path)
-  stub_request(:put, AvaTax.endpoint + path)
-end
-
-def fixture_path
-  File.expand_path("../fixtures", __FILE__)
-end
-
-def fixture(file)
-  File.new(fixture_path + '/' + file)
+RSpec.configure do |config|
+  config.before {
+    @client = client
+    @company_code = companies["value"][1]["companyCode"]
+  }
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: avatax
 version: !ruby/object:Gem::Version
-  version: 17.8.1
+  version: 17.9.1
 platform: ruby
 authors:
 - Marcus Vorwaller
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-09-21 00:00:00.000000000 Z
+date: 2017-10-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -179,7 +179,9 @@ files:
 - lib/avatax/request.rb
 - lib/avatax/version.rb
 - spec/avatax/client/accounts_spec.rb
+- spec/avatax/client/transactions_spec.rb
 - spec/avatax_spec.rb
+- spec/credentials.yaml.example
 - spec/fixtures/accounts.json
 - spec/spec_helper.rb
 homepage: https://github.com/avadev/AvaTax-REST-V2-Ruby-SDK
@@ -220,6 +222,8 @@ specification_version: 4
 summary: Ruby wrapper for the AvaTax API
 test_files:
 - spec/avatax/client/accounts_spec.rb
+- spec/avatax/client/transactions_spec.rb
 - spec/avatax_spec.rb
+- spec/credentials.yaml.example
 - spec/fixtures/accounts.json
 - spec/spec_helper.rb