quickbooks-ruby 0.4.4 → 0.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 976ae1fc59078ac34b82246f9299a45ec007fe14
-  data.tar.gz: a8a01b38858e3238f9f4ccd4c24af576bc287978
+  metadata.gz: bd6ad957a89437617f1bcff71acf5d6a35ca2230
+  data.tar.gz: ff0d3df6b00727db3babf0066dd091f9cbf35b95
 SHA512:
-  metadata.gz: 45ba61f4650435a29b8b2a174801a7fcd0d6059773a3df2ce1b9ab364f3fcd28c771227ab78573c28fc44c147ef14130c650dec202034430f684ea03c3afd576
-  data.tar.gz: e52ff31f8823f7dff764263da73ab3c3c2c4dd47d159fb610ec126ca9ee9c70bdd7e1df071c938a7d4850a063815a72fafd67fd1cb02d9f7d880277bb3a95c42
+  metadata.gz: 4344907b9f25e64fedfdbf8e4ca9f8522fd9a46579f4438973c931aed7837571f58137b6a4492cf389761c6eb901205bbc3eaec62e8734fc0994d9cfdba4331b
+  data.tar.gz: f5ad837bc5dfa26b4c5c5607cf5073efe1323e93430daebfcc3d625088e13cda980870f88da2fa36471323d33c1d6a815e2042cc22249e8d7aa96551ed6b34b1

data/lib/quickbooks-ruby.rb

@@ -46,6 +46,8 @@ require 'quickbooks/model/entity'
 require 'quickbooks/model/journal_entry_line_detail'
 require 'quickbooks/model/line'
 require 'quickbooks/model/journal_entry'
+require 'quickbooks/model/item_group_line'
+require 'quickbooks/model/item_group_detail'
 require 'quickbooks/model/item'
 require 'quickbooks/model/budget_line_item'
 require 'quickbooks/model/budget'
@@ -61,6 +63,7 @@ require 'quickbooks/model/email_address'
 require 'quickbooks/model/web_site_address'
 require 'quickbooks/model/physical_address'
 require 'quickbooks/model/invoice_line_item'
+require 'quickbooks/model/invoice_group_line_detail'
 require 'quickbooks/model/name_value'
 require 'quickbooks/model/company_info'
 require 'quickbooks/model/customer'
@@ -76,6 +79,7 @@ require 'quickbooks/model/bill_payment_credit_card'
 require 'quickbooks/model/bill_payment'
 require 'quickbooks/model/vendor'
 require 'quickbooks/model/employee'
+require 'quickbooks/model/exchange_rate'
 require 'quickbooks/model/term'
 require 'quickbooks/model/markup_info'
 require 'quickbooks/model/group_line_detail'
@@ -97,10 +101,10 @@ require 'quickbooks/model/tax_agency'
 require 'quickbooks/model/tax_service'
 require 'quickbooks/model/tax_code'
 require 'quickbooks/model/fault'
+require 'quickbooks/model/refund_receipt'
 require 'quickbooks/model/batch_request'
 require 'quickbooks/model/batch_response'
 require 'quickbooks/model/preferences'
-require 'quickbooks/model/refund_receipt'
 require 'quickbooks/model/change_model'
 require 'quickbooks/model/invoice_change'
 require 'quickbooks/model/customer_change'
@@ -111,6 +115,7 @@ require 'quickbooks/model/credit_memo_change'
 require 'quickbooks/model/payment_change'
 require 'quickbooks/model/transfer'
 require 'quickbooks/model/change_data_capture'
+require 'quickbooks/model/refund_receipt_change'
 
 #== Services
 require 'quickbooks/service/service_crud'
@@ -125,6 +130,7 @@ require 'quickbooks/service/customer'
 require 'quickbooks/service/department'
 require 'quickbooks/service/invoice'
 require 'quickbooks/service/deposit'
+
 require 'quickbooks/service/item'
 require 'quickbooks/service/budget'
 require 'quickbooks/service/journal_entry'
@@ -136,6 +142,7 @@ require 'quickbooks/service/bill'
 require 'quickbooks/service/bill_payment'
 require 'quickbooks/service/vendor'
 require 'quickbooks/service/employee'
+require 'quickbooks/service/exchange_rate'
 require 'quickbooks/service/payment'
 require 'quickbooks/service/term'
 require 'quickbooks/service/time_activity'
@@ -162,6 +169,7 @@ require 'quickbooks/service/credit_memo_change'
 require 'quickbooks/service/payment_change'
 require 'quickbooks/service/transfer'
 require 'quickbooks/service/change_data_capture'
+require 'quickbooks/service/refund_receipt_change'
 
 module Quickbooks
   @@sandbox_mode = false
@@ -207,15 +215,16 @@ module Quickbooks
   end # << self
 
   class InvalidModelException < StandardError; end
-
   class AuthorizationFailure < StandardError; end
   class Forbidden < StandardError; end
-
+  class ThrottleExceeded < Forbidden; end
+  class TooManyRequests < StandardError; end
   class ServiceUnavailable < StandardError; end
   class MissingRealmError < StandardError; end
 
   class IntuitRequestException < StandardError
     attr_accessor :message, :code, :detail, :type, :request_xml, :request_json
+
     def initialize(msg)
       self.message = msg
       super(msg)

data/lib/quickbooks/model/batch_request.rb

@@ -19,6 +19,7 @@ class Quickbooks::Model::BatchRequest < Quickbooks::Model::BaseModel
     xml_accessor :credit_memo, from: "CreditMemo", as: Quickbooks::Model::CreditMemo
     xml_accessor :payment, from: "Payment", as: Quickbooks::Model::Payment
     xml_accessor :time_activity, from: "TimeActivity", as: Quickbooks::Model::TimeActivity
+    xml_accessor :refund_receipt, from: "RefundReceipt", as: Quickbooks::Model::RefundReceipt
   end
 
   XML_COLLECTION_NODE = "IntuitBatchRequest"

data/lib/quickbooks/model/batch_response.rb

@@ -18,6 +18,7 @@ class Quickbooks::Model::BatchResponse < Quickbooks::Model::BaseModel
     xml_accessor :credit_memo, from: "CreditMemo", as: Quickbooks::Model::CreditMemo
     xml_accessor :payment, from: "Payment", as: Quickbooks::Model::Payment
     xml_accessor :time_activity, from: "TimeActivity", as: Quickbooks::Model::TimeActivity
+    xml_accessor :refund_receipt, from: "RefundReceipt", as: Quickbooks::Model::RefundReceipt
 
     def fault?
       fault

data/lib/quickbooks/model/exchange_rate.rb

@@ -0,0 +1,23 @@
+module Quickbooks
+  module Model
+    class ExchangeRate < BaseModel
+      XML_COLLECTION_NODE = "ExchangeRate"
+      XML_NODE = "ExchangeRate"
+      REST_RESOURCE = "exchangerate"
+
+      xml_accessor :id, :from => "Id"
+      xml_accessor :sync_token, :from => "SyncToken", :as => Integer
+      xml_accessor :meta_data, :from => "MetaData", :as => MetaData
+
+      xml_accessor :custom_fields, :from => 'CustomField', :as => [CustomField]
+      xml_accessor :source_currency_code, :from => 'SourceCurrencyCode'
+      xml_accessor :target_currency_code, :from => 'TargetCurrencyCode'
+      xml_accessor :rate, :from => 'Rate', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :as_of_date, :from => 'AsOfDate', :as => Date
+
+      validates_presence_of :source_currency_code, :rate, :as_of_date
+      validates_length_of :source_currency_code, :is => 3
+      validates_length_of :target_currency_code, :is => 3
+    end
+  end
+end

data/lib/quickbooks/model/invoice.rb

@@ -48,6 +48,7 @@ module Quickbooks
       xml_accessor :print_status, :from => 'PrintStatus'
       xml_accessor :email_status, :from => 'EmailStatus'
       xml_accessor :balance, :from => 'Balance', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :home_balance, :from => 'HomeBalance', :as => BigDecimal, :to_xml => to_xml_big_decimal
       xml_accessor :deposit, :from => 'Deposit', :as => BigDecimal, :to_xml => to_xml_big_decimal
       xml_accessor :department_ref, :from => 'DepartmentRef', :as => BaseReference
       xml_accessor :allow_ipn_payment?, :from => 'AllowIPNPayment'

data/lib/quickbooks/model/invoice_change.rb

@@ -1,6 +1,7 @@
 module Quickbooks
   module Model
-    # Refer to: https://developer.intuit.com/docs/0100_accounting/0300_developer_guides/change_data_capture
+    # Refer to:
+    # - https://developer.intuit.com/docs/0100_quickbooks_online/0200_dev_guides/accounting/change_data_capture
     class InvoiceChange < ChangeModel
       XML_NODE = "Invoice"
     end

data/lib/quickbooks/model/invoice_group_line_detail.rb

@@ -0,0 +1,14 @@
+module Quickbooks
+  module Model
+    class InvoiceGroupLineDetail < InvoiceLineItem
+      include HasLineItems
+
+      xml_accessor :id, :from => 'Id'
+      xml_accessor :group_item_ref, :from => 'GroupItemRef', :as => BaseReference
+      xml_accessor :quantity, :from => 'Quantity', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :line_items, :from => 'Line', :as => [InvoiceLineItem]
+
+      reference_setters :group_item_ref
+    end
+  end
+end

data/lib/quickbooks/model/invoice_line_item.rb

@@ -1,12 +1,14 @@
 module Quickbooks
   module Model
     class InvoiceLineItem < BaseModel
+      require 'quickbooks/model/invoice_group_line_detail'
 
       #== Constants
       SALES_LINE_ITEM_DETAIL = 'SalesItemLineDetail'
       SUB_TOTAL_LINE_DETAIL = 'SubTotalLineDetail'
       PAYMENT_LINE_DETAIL = 'PaymentLineDetail'
       DISCOUNT_LINE_DETAIL = 'DiscountLineDetail'
+      INVOICE_GROUP_LINE_DETAIL = 'GroupLineDetail'
 
       xml_accessor :id, :from => 'Id'
       xml_accessor :line_num, :from => 'LineNum', :as => Integer
@@ -19,6 +21,11 @@ module Quickbooks
       xml_accessor :sub_total_line_detail, :from => 'SubTotalLineDetail', :as => SubTotalLineDetail
       xml_accessor :payment_line_detail, :from => 'PaymentLineDetail', :as => PaymentLineDetail
       xml_accessor :discount_line_detail, :from => 'DiscountLineDetail', :as => DiscountLineDetail
+      xml_accessor :group_line_detail, :from => INVOICE_GROUP_LINE_DETAIL, :as => InvoiceGroupLineDetail
+
+      def group_line_detail?
+        detail_type.to_s == INVOICE_GROUP_LINE_DETAIL
+      end
 
       def sales_item?
         detail_type.to_s == SALES_LINE_ITEM_DETAIL
@@ -39,6 +46,13 @@ module Quickbooks
         yield self.sales_line_item_detail if block_given?
       end
 
+      def group_line_detail!
+        self.detail_type = INVOICE_GROUP_LINE_DETAIL
+        self.group_line_detail = InvoiceGroupLineDetail.new
+
+        yield self.group_line_detail if block_given?
+      end
+
       def payment_item!
         self.detail_type = PAYMENT_LINE_DETAIL
         self.payment_line_detail = PaymentLineDetail.new
@@ -52,7 +66,6 @@ module Quickbooks
 
         yield self.discount_line_detail if block_given?
       end
-
     end
   end
 end

data/lib/quickbooks/model/item.rb

@@ -49,6 +49,10 @@ module Quickbooks
       xml_accessor :purchase_tax_code_ref, :from => 'PurchaseTaxCodeRef', :as => BaseReference
       xml_accessor :inv_start_date, :from => 'InvStartDate', :as => Date
 
+      xml_accessor :print_grouped_items?, :from => 'PrintGroupedItems'
+
+      xml_accessor :item_group_details, :from => 'ItemGroupDetail', :as => ItemGroupDetail
+
       reference_setters :parent_ref, :income_account_ref, :expense_account_ref
       reference_setters :asset_account_ref, :sales_tax_code_ref, :purchase_tax_code_ref
 
@@ -78,7 +82,6 @@ module Quickbooks
         end
         errors.empty?
       end
-
     end
   end
 end

data/lib/quickbooks/model/item_group_detail.rb

@@ -0,0 +1,9 @@
+module Quickbooks
+  module Model
+    class ItemGroupDetail < BaseModel
+      include HasLineItems
+
+      xml_accessor :line_items, :from => 'ItemGroupLine', :as => [ItemGroupLine]
+    end
+  end
+end

data/lib/quickbooks/model/item_group_line.rb

@@ -0,0 +1,20 @@
+module Quickbooks
+  module Model
+    class ItemGroupLine < BaseModel
+      xml_accessor :item_ref, :from => 'ItemRef', :as => BaseReference
+      xml_accessor :quantity, :from => 'Qty'
+
+      def id
+        item_ref.value.to_i
+      end
+
+      def name
+        item_ref.name
+      end
+
+      def type
+        item_ref.type
+      end
+    end
+  end
+end

data/lib/quickbooks/model/refund_receipt_change.rb

@@ -0,0 +1,8 @@
+module Quickbooks
+  module Model
+    # Refer to: https://developer.intuit.com/docs/0100_accounting/0300_developer_guides/change_data_capture
+    class RefundReceiptChange < ChangeModel
+      XML_NODE = "RefundReceipt"
+    end
+  end
+end

data/lib/quickbooks/service/base_service.rb

@@ -268,9 +268,16 @@ module Quickbooks
         when 401
           raise Quickbooks::AuthorizationFailure
         when 403
-          raise Quickbooks::Forbidden
+          message = parse_intuit_error[:message]
+          if message.include?('ThrottleExceeded')
+            raise Quickbooks::ThrottleExceeded, message
+          end
+          raise Quickbooks::Forbidden, message
         when 400, 500
           parse_and_raise_exception(options)
+        when 429
+          message = parse_intuit_error[:message]
+          raise Quickbooks::TooManyRequests, message
         when 503, 504
           raise Quickbooks::ServiceUnavailable
         else

data/lib/quickbooks/service/batch.rb

@@ -3,7 +3,7 @@ module Quickbooks
     class Batch < BaseService
 
       def make_request(entity, options = {})
-        response = do_http_post(url_for_resource('batch'), valid_xml_document(entity.to_xml_ns))
+        response = do_http_post(url_for_resource('batch'), valid_xml_document(entity.to_xml_ns), options[:query])
         Quickbooks::Model::BatchResponse.from_xml(response.plain_body)
       end
     end

data/lib/quickbooks/service/exchange_rate.rb

@@ -0,0 +1,25 @@
+module Quickbooks
+  module Service
+    class ExchangeRate < BaseService
+
+      def fetch_by_currency(source_currency_code, as_of_date = nil)
+        url = url_for_resource(model::REST_RESOURCE)
+        params = { sourcecurrencycode: source_currency_code }
+        params[:asofdate] = as_of_date unless as_of_date.nil?
+
+        response = do_http_get(url, params)
+        if response.code.to_i == 200
+          model.from_xml(parse_singular_entity_response(model, response.plain_body))
+        else
+          nil
+        end
+      end
+
+      private
+
+      def model
+        Quickbooks::Model::ExchangeRate
+      end
+    end
+  end
+end

data/lib/quickbooks/service/refund_receipt_change.rb

@@ -0,0 +1,16 @@
+module Quickbooks
+  module Service
+    class RefundReceiptChange < ChangeService
+
+      private
+
+      def entity
+        "RefundReceipt"
+      end
+
+      def model
+        Quickbooks::Model::RefundReceiptChange
+      end
+    end
+  end
+end

data/lib/quickbooks/version.rb

@@ -1,5 +1,5 @@
 module Quickbooks
 
-  VERSION = "0.4.4"
+  VERSION = "0.4.6"
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: quickbooks-ruby
 version: !ruby/object:Gem::Version
-  version: 0.4.4
+  version: 0.4.6
 platform: ruby
 authors:
 - Cody Caughlan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-06-02 00:00:00.000000000 Z
+date: 2016-12-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: oauth
@@ -56,16 +56,16 @@ dependencies:
   name: activemodel
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - <
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 5.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - <
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 5.0.0
 - !ruby/object:Gem::Dependency
   name: multipart-post
   requirement: !ruby/object:Gem::Requirement
@@ -199,16 +199,20 @@ files:
 - lib/quickbooks/model/entity.rb
 - lib/quickbooks/model/entity_ref.rb
 - lib/quickbooks/model/estimate.rb
+- lib/quickbooks/model/exchange_rate.rb
 - lib/quickbooks/model/fault.rb
 - lib/quickbooks/model/global_tax_calculation.rb
 - lib/quickbooks/model/group_line_detail.rb
 - lib/quickbooks/model/has_line_items.rb
 - lib/quickbooks/model/invoice.rb
 - lib/quickbooks/model/invoice_change.rb
+- lib/quickbooks/model/invoice_group_line_detail.rb
 - lib/quickbooks/model/invoice_line_item.rb
 - lib/quickbooks/model/item.rb
 - lib/quickbooks/model/item_based_expense_line_detail.rb
 - lib/quickbooks/model/item_change.rb
+- lib/quickbooks/model/item_group_detail.rb
+- lib/quickbooks/model/item_group_line.rb
 - lib/quickbooks/model/journal_entry.rb
 - lib/quickbooks/model/journal_entry_line_detail.rb
 - lib/quickbooks/model/line.rb
@@ -228,6 +232,7 @@ files:
 - lib/quickbooks/model/purchase_order.rb
 - lib/quickbooks/model/purchase_tax_rate_list.rb
 - lib/quickbooks/model/refund_receipt.rb
+- lib/quickbooks/model/refund_receipt_change.rb
 - lib/quickbooks/model/report.rb
 - lib/quickbooks/model/sales_item_line_detail.rb
 - lib/quickbooks/model/sales_receipt.rb
@@ -273,6 +278,7 @@ files:
 - lib/quickbooks/service/deposit.rb
 - lib/quickbooks/service/employee.rb
 - lib/quickbooks/service/estimate.rb
+- lib/quickbooks/service/exchange_rate.rb
 - lib/quickbooks/service/invoice.rb
 - lib/quickbooks/service/invoice_change.rb
 - lib/quickbooks/service/item.rb
@@ -285,6 +291,7 @@ files:
 - lib/quickbooks/service/purchase.rb
 - lib/quickbooks/service/purchase_order.rb
 - lib/quickbooks/service/refund_receipt.rb
+- lib/quickbooks/service/refund_receipt_change.rb
 - lib/quickbooks/service/reports.rb
 - lib/quickbooks/service/sales_receipt.rb
 - lib/quickbooks/service/service_crud.rb