quickbooks-ruby 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8d86d02f5ca0f37bb54251f62fad6ac5f2e6c3ba
-  data.tar.gz: 90261ad5a8722a50537537a8bb22d6e63056a9db
+  metadata.gz: 5e0e5a4d254a49ea8f633ba0b70a4b20c11a7a29
+  data.tar.gz: bb4b11ecdaf0d0b98b9074102b175a0954c3b386
 SHA512:
-  metadata.gz: 7af4121f20483c55b7ff788c10766c511980cf7aa12fde117257b571955c4a60d672062e736e196e061e476debac0f654d0eab4e5112631dd78ea0d4929ebcad
-  data.tar.gz: 2cba0c3f044de53f4f85678f4a9fa24e489c4f662e2533b01fde4d92172e226c7a95813db1e2dcfd3f0c4a409767af96a6f8924fd3792b9aca525a0b9c3f124e
+  metadata.gz: 78b84c571e4b68904be22000788b7240ad9ca6154cd49cd30af99e30b31a953a4250a7cd74a9ad30a770b943707b643a4b5dc82ce46b0e1d59c8120f51b9c994
+  data.tar.gz: b759d252cffacd0466c4d9d98adecf900e262814fd3ec697423e899291fd0685a4ba1f5f7f4c8077b7cf570cee551e778636b5edfe48f367fcb4d1939e560492

data/lib/quickbooks-ruby.rb

@@ -7,12 +7,14 @@ require 'uri'
 require 'date'
 require 'forwardable'
 require 'oauth'
+require 'quickbooks/util/collection'
 require 'quickbooks/util/logging'
 require 'quickbooks/util/http_encoding_helper'
 require 'quickbooks/util/name_entity'
 require 'quickbooks/util/query_builder'
 
 #== Models
+require 'quickbooks/model/validator'
 require 'quickbooks/model/base_model'
 require 'quickbooks/model/base_reference'
 require 'quickbooks/model/document_numbering'
@@ -27,8 +29,15 @@ require 'quickbooks/model/discount_line_detail'
 require 'quickbooks/model/discount_override'
 require 'quickbooks/model/payment_line_detail'
 require 'quickbooks/model/account_based_expense_line_detail'
+require 'quickbooks/model/item_based_expense_line_detail'
 require 'quickbooks/model/linked_transaction'
+require 'quickbooks/model/tax_line_detail'
+require 'quickbooks/model/tax_line'
+require 'quickbooks/model/transaction_tax_detail'
+require 'quickbooks/model/entity'
+require 'quickbooks/model/journal_entry_line_detail'
 require 'quickbooks/model/line'
+require 'quickbooks/model/journal_entry'
 require 'quickbooks/model/item'
 require 'quickbooks/model/account'
 require 'quickbooks/model/check_payment'
@@ -57,10 +66,7 @@ require 'quickbooks/model/term'
 require 'quickbooks/model/markup_info'
 require 'quickbooks/model/group_line_detail'
 require 'quickbooks/model/item_based_expense_line_detail'
-require 'quickbooks/model/tax_line_detail'
-require 'quickbooks/model/tax_line'
 require 'quickbooks/model/time_activity'
-require 'quickbooks/model/transaction_tax_detail'
 require 'quickbooks/model/purchase_line_item'
 require 'quickbooks/model/purchase'
 require 'quickbooks/model/purchase_order'
@@ -74,6 +80,8 @@ require 'quickbooks/model/tax_code'
 require 'quickbooks/model/fault'
 require 'quickbooks/model/batch_request'
 require 'quickbooks/model/batch_response'
+require 'quickbooks/model/preferences'
+require 'quickbooks/model/refund_receipt'
 
 #== Services
 require 'quickbooks/service/service_crud'
@@ -85,6 +93,7 @@ require 'quickbooks/service/customer'
 require 'quickbooks/service/department'
 require 'quickbooks/service/invoice'
 require 'quickbooks/service/item'
+require 'quickbooks/service/journal_entry'
 require 'quickbooks/service/sales_receipt'
 require 'quickbooks/service/account'
 require 'quickbooks/service/payment_method'
@@ -103,6 +112,8 @@ require 'quickbooks/service/estimate'
 require 'quickbooks/service/tax_rate'
 require 'quickbooks/service/tax_code'
 require 'quickbooks/service/batch'
+require 'quickbooks/service/preferences'
+require 'quickbooks/service/refund_receipt'
 
 module Quickbooks
   @@logger = nil
@@ -142,6 +153,7 @@ module Quickbooks
   class AuthorizationFailure < StandardError; end
 
   class ServiceUnavailable < StandardError; end
+  class MissingRealmError < StandardError; end
 
   class IntuitRequestException < StandardError
     attr_accessor :message, :code, :detail, :type, :request_xml
@@ -151,15 +163,4 @@ module Quickbooks
     end
   end
 
-
-  class Collection
-    attr_accessor :entries
-
-    # Legacy Attributes (v2)
-    attr_accessor :count, :current_page
-
-    # v3 Attributes
-    attr_accessor :start_position, :max_results, :total_count
-  end
-
 end

data/lib/quickbooks/model/base_model.rb

@@ -2,6 +2,7 @@ module Quickbooks
   module Model
     class BaseModel
       include ActiveModel::Validations
+      include Validator
       include ROXML
 
       xml_convention :camelcase
@@ -45,6 +46,12 @@ module Quickbooks
         self.line_items ||= []
       end
 
+      def inspect
+        # it would be nice if we could inspect all the children,
+        # but it's likely to blow the stack in some cases
+        "#<#{self.class} " + 
+        "#{attributes.map{|k,v| "#{k}: #{v.nil? ? 'nil' : v.to_s }"}.join ", "}>"
+      end
       class << self
         def to_xml_big_decimal
           Proc.new { |val| val.nil? ? nil : val.to_f }
@@ -84,6 +91,15 @@ module Quickbooks
           end
         end
 
+        def inspect
+          "#{super}(#{attrs_with_types.join " "})"
+        end
+        def attrs_with_types
+          roxml_attrs.map do |attr|
+            "#{attr.accessor}:" +
+              "#{attr.class.block_shorthands.invert[attr.blocks.last]}:#{attr.sought_type}"
+          end
+        end
       end
     end
   end

data/lib/quickbooks/model/bill.rb

@@ -29,7 +29,7 @@ module Quickbooks
       xml_accessor :reply_email, :from => 'ReplyEmail', :as => EmailAddress
       xml_accessor :total, :from => 'TotalAmt', :as => BigDecimal
 
-      validates_length_of :line_items, :minimum => 1
+      validate :line_item_size
 
       reference_setters :department_ref, :vendor_ref, :payer_ref, :sales_term_ref
     end

data/lib/quickbooks/model/bill_line_item.rb

@@ -4,6 +4,7 @@ module Quickbooks
 
       #== Constants
       ACCOUNT_BASED_EXPENSE_LINE_DETAIL = 'AccountBasedExpenseLineDetail'
+      ITEM_BASED_EXPENSE_LINE_DETAIL = 'ItemBasedExpenseLineDetail'
 
       xml_accessor :id, :from => 'Id', :as => Integer
       xml_accessor :line_num, :from => 'LineNum', :as => Integer
@@ -13,11 +14,16 @@ module Quickbooks
 
       #== Various detail types
       xml_accessor :account_based_expense_line_detail, :from => 'AccountBasedExpenseLineDetail', :as => AccountBasedExpenseLineDetail
+      xml_accessor :item_based_expense_line_detail, :from => 'ItemBasedExpenseLineDetail', :as => ItemBasedExpenseLineDetail
 
       def account_based_expense_item?
         detail_type.to_s == ACCOUNT_BASED_EXPENSE_LINE_DETAIL
       end
 
+      def item_based_expense_item?
+        detail_type.to_s == ITEM_BASED_EXPENSE_LINE_DETAIL
+      end
+
     end
   end
 end

data/lib/quickbooks/model/bill_payment.rb

@@ -25,7 +25,7 @@ module Quickbooks
 
       xml_accessor :total, :from => 'TotalAmt', :as => BigDecimal
 
-      validates_length_of :line_items, :minimum => 1
+      validate :line_item_size
 
       reference_setters :vendor_ref
     end

data/lib/quickbooks/model/credit_memo.rb

@@ -1,6 +1,7 @@
 module Quickbooks
   module Model
     class CreditMemo < BaseModel
+      include DocumentNumbering
       XML_COLLECTION_NODE = "CreditMemo"
       XML_NODE = "CreditMemo"
       REST_RESOURCE = 'creditmemo'
@@ -8,13 +9,15 @@ module Quickbooks
       xml_accessor :id, :from => 'Id', :as => Integer
       xml_accessor :sync_token, :from => 'SyncToken', :as => Integer
       xml_accessor :meta_data, :from => 'MetaData', :as => MetaData
+      xml_accessor :auto_doc_number, :from => 'AutoDocNumber' # See auto_doc_number! method below for usage
       xml_accessor :doc_number, :from => 'DocNumber'
       #xml_accessor :txn_date, :from => 'TxnDate', :as => Date
       # TODO: Next major version 'placed_on' should be replaced by 'txn_date'
       xml_accessor :placed_on, :from => 'TxnDate', :as => Date
+      xml_accessor :department_ref, :from => 'DepartmentRef', :as => BaseReference
 
       xml_accessor :line_items, :from => 'Line', :as => [Line]
-
+      xml_accessor :txn_tax_detail, :from => 'TxnTaxDetail', :as => TransactionTaxDetail
       xml_accessor :private_note, :from => 'PrivateNote'
 
       xml_accessor :customer_ref, :from => 'CustomerRef', :as => BaseReference
@@ -28,9 +31,10 @@ module Quickbooks
       # readonly
       xml_accessor :total, :from => 'TotalAmt', :as => BigDecimal
 
-      validates_length_of :line_items, :minimum => 1
+      validate :line_item_size
+      validate :document_numbering
 
-      reference_setters :customer_ref, :sales_term_ref, :deposit_to_account_ref, :payment_method_ref
+      reference_setters :department_ref, :customer_ref, :sales_term_ref, :deposit_to_account_ref, :payment_method_ref
 
       def initialize(*args)
         ensure_line_items_initialization

data/lib/quickbooks/model/customer.rb

@@ -50,13 +50,15 @@ module Quickbooks
       xml_accessor :suffix, :from => 'Suffix'
       xml_accessor :fully_qualified_name, :from => 'FullyQualifiedName'
       xml_accessor :taxable, :from => 'Taxable'
+      xml_accessor :default_tax_code_ref, :from => 'DefaultTaxCodeRef', :as => BaseReference
       xml_accessor :notes, :from => 'Notes'
+      xml_accessor :currency_ref, :from => 'CurrencyRef', :as => BaseReference
 
       #== Validations
       validate :names_cannot_contain_invalid_characters
       validate :email_address_is_valid
 
-      reference_setters :parent_ref, :sales_term_ref, :payment_method_ref
+      reference_setters :parent_ref, :sales_term_ref, :payment_method_ref, :default_tax_code_ref, :currency_ref
 
       def job?
         job.to_s == 'true'

data/lib/quickbooks/model/entity.rb

@@ -0,0 +1,16 @@
+module Quickbooks
+  module Model
+    class Entity < BaseModel
+      include NameEntity::Quality
+
+      xml_accessor :type, :from => 'Type'
+      xml_accessor :entity_ref, :from => 'EntityRef'
+
+      reference_setters :entity_ref
+
+      #== Validations
+      validate :entity_type_is_valid
+
+    end
+  end
+end

data/lib/quickbooks/model/estimate.rb

@@ -49,7 +49,7 @@ module Quickbooks
       reference_setters :department_ref, :customer_ref, :class_ref, :sales_term_ref, :ship_method_ref
 
       #== Validations
-      validates_length_of :line_items, :minimum => 1
+      validate :line_item_size
       validate :existence_of_customer_ref
 
       def initialize(*args)

data/lib/quickbooks/model/invoice.rb

@@ -8,7 +8,7 @@
 module Quickbooks
   module Model
     class Invoice < BaseModel
-
+      include DocumentNumbering
       #== Constants
       REST_RESOURCE = 'invoice'
       XML_COLLECTION_NODE = "Invoice"
@@ -51,12 +51,11 @@ module Quickbooks
       xml_accessor :allow_online_credit_card_payment?, :from => 'AllowOnlineCreditCardPayment'
       xml_accessor :allow_online_ach_payment?, :from => 'AllowOnlineACHPayment'
 
-      include DocumentNumbering
       reference_setters :customer_ref, :class_ref, :sales_term_ref, :ship_method_ref
       reference_setters :ar_account_ref, :department_ref, :ar_account_ref, :currency_ref
 
       #== Validations
-      validates_length_of :line_items, :minimum => 1
+      validate :line_item_size
       validate :existence_of_customer_ref
       validate :required_bill_email_if_email_delivery
       validate :document_numbering

data/lib/quickbooks/model/item_based_expense_line_detail.rb

@@ -1,3 +1,5 @@
+require 'quickbooks/model/markup_info'
+
 module Quickbooks
   module Model
     class ItemBasedExpenseLineDetail < BaseModel

data/lib/quickbooks/model/journal_entry.rb

@@ -0,0 +1,30 @@
+module Quickbooks
+  module Model
+    class JournalEntry < BaseModel
+      XML_COLLECTION_NODE = "JournalEntry"
+      XML_NODE = "JournalEntry"
+      REST_RESOURCE = 'journalentry'
+
+      xml_accessor :id, :from => 'Id', :as => Integer
+      xml_accessor :sync_token, :from => 'SyncToken', :as => Integer
+      xml_accessor :meta_data, :from => 'MetaData', :as => MetaData
+      xml_accessor :doc_number, :from => 'DocNumber'
+      xml_accessor :txn_date, :from => 'TxnDate', :as => Date
+      xml_accessor :exchange_rate, :from => 'ExchangeRate', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :private_note, :from => 'PrivateNote'
+      xml_accessor :line_items, :from => 'Line', :as => [Line]
+      xml_accessor :txn_tax_detail, :from => 'TxnTaxDetail', :as => TransactionTaxDetail
+
+      # Readonly
+      xml_accessor :currency_ref, :from => 'CurrencyRef', :as => BaseReference
+      xml_accessor :total_amount, :from => 'TotalAmt', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :home_total, :from => 'HomeTotalAmt', :as => BigDecimal, :to_xml => to_xml_big_decimal
+
+      xml_accessor :adjustment?, :from => 'Adjustment'
+
+      reference_setters :currency_ref
+
+      validates_length_of :private_note, :maximum => 4000
+    end
+  end
+end

data/lib/quickbooks/model/journal_entry_line_detail.rb

@@ -0,0 +1,27 @@
+module Quickbooks
+  module Model
+    class JournalEntryLineDetail < BaseModel
+      include NameEntity::Quality
+
+      xml_accessor :posting_type, :from => 'PostingType'
+      xml_accessor :entity, :from => 'Entity', :as => Entity
+      xml_accessor :account_ref, :from => 'AccountRef', :as => BaseReference
+      xml_accessor :class_ref, :from => 'ClassRef', :as => BaseReference
+      xml_accessor :department_ref, :from => 'DepartmentRef', :as => BaseReference
+
+      xml_accessor :tax_code_ref, :from => 'TaxCodeRef', :as => BaseReference
+      xml_accessor :tax_applicable_on, :from => 'TaxApplicableOn'
+      xml_accessor :tax_amount, :from => 'TaxAmount', :as => BigDecimal, :to_xml => to_xml_big_decimal
+
+      xml_accessor :billable_status, :from => 'BillableStatus'
+
+      reference_setters :account_ref, :class_ref, :department_ref, :tax_code_ref
+
+      validates_length_of :description, :maximum => 4000
+      validates_numericality_of :tax_amount, allow_nil: true, greater_than_or_equal_to:0.0, less_than_or_equal_to:999999999.0
+      validate :posting_type_is_valid
+      validate :billable_status_is_valid
+      validate :journal_line_entry_tax
+    end
+  end
+end

data/lib/quickbooks/model/line.rb

@@ -6,6 +6,7 @@ module Quickbooks
       SUB_TOTAL_LINE_DETAIL = 'SubTotalLineDetail'
       PAYMENT_LINE_DETAIL = 'PaymentLineDetail'
       DISCOUNT_LINE_DETAIL = 'DiscountLineDetail'
+      JOURNAL_ENTRY_LINE_DETAIL = 'JournalEntryLineDetail'
 
       xml_accessor :id, :from => 'Id', :as => Integer
       xml_accessor :line_num, :from => 'LineNum', :as => Integer
@@ -19,6 +20,7 @@ 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 => DiscountOverride
+      xml_accessor :journal_entry_line_detail, :from => 'JournalEntryLineDetail', :as => JournalEntryLineDetail
       xml_accessor :linked_transaction, :from => 'LinkedTxn', :as => LinkedTransaction
 
       def invoice_id=(invoice_id)

data/lib/quickbooks/model/preferences.rb

@@ -0,0 +1,49 @@
+module Quickbooks
+  module Model
+    class Preferences < BaseModel
+      XML_COLLECTION_NODE = "Preferences"
+      XML_NODE            = "Preferences"
+      REST_RESOURCE       = 'preferences'
+
+      xml_name XML_NODE
+
+      def self.create_preference_class(*attrs, &block)
+        ::Class.new(BaseModel) do
+          attrs.each do |a|
+            xml_reader(a.underscore, :from => a.gsub("?", ""))
+          end
+          instance_eval(&block) if block_given?
+        end
+      end
+
+      PREFERENCE_SECTIONS = {
+        :accounting_info      => %w(TrackDepartments DepartmentTerminology ClassTrackingPerTxnLine? ClassTrackingPerTxn? CustomerTerminology),
+        :product_and_services => %w(ForSales? ForPurchase? QuantityWithPriceAndRate? QuantityOnHand?),
+        :sales_forms          => %w(CustomTxnNumbers? AllowDeposit? AllowDiscount? DefaultDiscountAccount? AllowEstimates? EstimateMessage? 
+                                                ETransactionEnabledStatus? ETransactionAttachPDF? ETransactionPaymentEnabled? IPNSupportEnabled? 
+                                                AllowServiceDate? AllowShipping? DefaultShippingAccount? DefaultTerms DefaultCustomerMessage),
+        :vendor_and_purchase  => %w(TrackingByCustomer? BillableExpenseTracking? DefaultTerms? DefaultMarkup? POCustomField),
+        :time_tracking        => %w(UseServices? BillCustomers? ShowBillRateToAll WorkWeekStartDate MarkTimeEntiresBillable?),
+        :tax                  => %w(UsingSalesTax?),
+        :currency             => %w(MultiCurrencyEnabled? HomeCurrency),
+        :report               => %w(ReportBasis)
+      }
+
+      PREFERENCE_SECTIONS.each do |section_name, fields|
+        xml_reader section_name, :from => "#{section_name}_prefs".camelize, :as => create_preference_class(*fields)
+      end
+
+      EmailMessage          = create_preference_class("Subject", "Message")
+      EmailMessageContainer = create_preference_class do
+        %w(InvoiceMessage EstimateMessage SalesReceiptMessage StatementMessage).each do |msg|
+          xml_reader msg.underscore, :from => msg, :as => EmailMessage
+        end
+      end
+
+      xml_reader :email_messages, :from => "EmailMessagesPrefs", as: EmailMessageContainer
+
+      xml_reader :other_prefs, :from => "OtherPrefs/NameValue", :as => { :key => "Name", :value => "Value" }
+    end
+
+  end
+end

data/lib/quickbooks/model/refund_receipt.rb

@@ -0,0 +1,59 @@
+module Quickbooks
+  module Model
+    class RefundReceipt < BaseModel
+      XML_COLLECTION_NODE = "RefundReceipt"
+      XML_NODE = "RefundReceipt"
+      REST_RESOURCE = 'refundreceipt'
+
+      xml_accessor :id, :from => 'Id', :as => Integer
+      xml_accessor :sync_token, :from => 'SyncToken', :as => Integer
+      xml_accessor :meta_data, :from => 'MetaData', :as => MetaData
+      xml_accessor :auto_doc_number, :from => 'AutoDocNumber' # See auto_doc_number! method below for usage
+      xml_accessor :doc_number, :from => 'DocNumber'
+      xml_accessor :placed_on, :from => 'TxnDate', :as => Time
+      xml_accessor :line_items, :from => 'Line', :as => [Line]
+      xml_accessor :customer_ref, :from => 'CustomerRef', :as => BaseReference
+      xml_accessor :department_ref, :from => 'DepartmentRef', :as => BaseReference
+      xml_accessor :bill_email, :from => 'BillEmail', :as => EmailAddress
+      xml_accessor :bill_address, :from => 'BillAddr', :as => PhysicalAddress
+      xml_accessor :ship_address, :from => 'ShipAddr', :as => PhysicalAddress
+      xml_accessor :po_number, :from => 'PONumber'
+      xml_accessor :ship_method_ref, :from => 'ShipMethodRef'
+      xml_accessor :ship_date, :from => 'ShipDate', :as => Time
+      xml_accessor :tracking_num, :from => 'TrackingNum'
+      xml_accessor :payment_method_ref, :from => 'PaymentMethodRef', :as => BaseReference
+      xml_accessor :payment_ref_number, :from => 'PaymentRefNum'
+      xml_accessor :deposit_to_account_ref, :from => 'DepositToAccountRef', :as => BaseReference
+      xml_accessor :customer_memo, :from => 'CustomerMemo'
+      xml_accessor :private_note, :from => 'PrivateNote'
+      xml_accessor :txn_tax_detail, :from => 'TxnTaxDetail', :as => TransactionTaxDetail
+      xml_accessor :txn_date, :from => 'TxnDate', :as => Date
+      xml_accessor :custom_fields, :from => 'CustomField', :as => [CustomField]
+      xml_accessor :currency_ref, :from => 'CurrencyRef', :as => BaseReference
+      xml_accessor :class_ref, :from => 'ClassRef', :as => BaseReference
+      xml_accessor :apply_tax_after_discount?, :from => 'ApplyTaxAfterDiscount'
+      xml_accessor :print_status, :from => 'PrintStatus'
+      xml_accessor :balance, :from => 'Balance', :as => BigDecimal, :to_xml => to_xml_big_decimal
+
+      # readonly
+      xml_accessor :total, :from => 'TotalAmt', :as => BigDecimal
+      xml_accessor :home_total, :from => 'HomeTotalAmt', :as => BigDecimal, :to_xml => to_xml_big_decimal
+
+      include DocumentNumbering
+      reference_setters :customer_ref, :payment_method_ref, :deposit_to_account_ref, :department_ref, :currency_ref, :class_ref
+
+      validate :line_item_size
+      validate :document_numbering
+
+      def initialize(*args)
+        ensure_line_items_initialization
+        super
+      end
+
+      def email=(email)
+        self.bill_email = EmailAddress.new(email)
+      end
+
+    end
+  end
+end

data/lib/quickbooks/model/sales_receipt.rb

@@ -1,6 +1,7 @@
 module Quickbooks
   module Model
     class SalesReceipt < BaseModel
+      include DocumentNumbering
       XML_COLLECTION_NODE = "SalesReceipt"
       XML_NODE = "SalesReceipt"
       REST_RESOURCE = 'salesreceipt'
@@ -29,10 +30,9 @@ module Quickbooks
       # readonly
       xml_accessor :total, :from => 'TotalAmt', :as => BigDecimal
 
-      include DocumentNumbering
       reference_setters :customer_ref, :payment_method_ref, :deposit_to_account_ref
 
-      validates_length_of :line_items, :minimum => 1
+      validate :line_item_size
       validate :document_numbering
 
       def initialize(*args)

data/lib/quickbooks/model/telephone_number.rb

@@ -2,6 +2,12 @@ module Quickbooks
   module Model
     class TelephoneNumber < BaseModel
       xml_accessor :free_form_number, :from => 'FreeFormNumber'
+
+      def initialize(number = nil)
+        unless number.nil?
+          self.free_form_number = number
+        end
+      end
     end
   end
 end

data/lib/quickbooks/model/validator.rb

@@ -0,0 +1,6 @@
+module Validator
+
+  def line_item_size
+    validates_length_of :line_items, :minimum => 1, :message => 'At least 1 line item is required'
+  end
+end

data/lib/quickbooks/service/base_service.rb

@@ -14,9 +14,10 @@ module Quickbooks
       HTTP_CONTENT_TYPE = 'application/xml'
       HTTP_ACCEPT = 'application/xml'
       HTTP_ACCEPT_ENCODING = 'gzip, deflate'
+      BASE_DOMAIN = 'quickbooks.api.intuit.com'
 
       def initialize(attributes = {})
-        @base_uri = 'https://qb.sbfinance.intuit.com/v3/company'
+        @base_uri = "https://#{BASE_DOMAIN}/v3/company"
         attributes.each {|key, value| public_send("#{key}=", value) }
       end
 
@@ -38,6 +39,7 @@ module Quickbooks
       end
 
       def url_for_base
+        raise MissingRealmError.new unless @company_id
         "#{@base_uri}/#{@company_id}"
       end
 

data/lib/quickbooks/service/credit_memo.rb

@@ -2,8 +2,12 @@ module Quickbooks
   module Service
     class CreditMemo < BaseService
 
+      def delete(credit_memo, options = {})
+        delete_by_query_string(credit_memo)
+      end
+
       private
-      
+
       def model
         Quickbooks::Model::CreditMemo
       end

data/lib/quickbooks/service/journal_entry.rb

@@ -0,0 +1,16 @@
+module Quickbooks
+  module Service
+    class JournalEntry < BaseService
+
+      def delete(entry, options = {})
+        delete_by_query_string(entry)
+      end
+
+      private
+
+      def model
+        Quickbooks::Model::JournalEntry
+      end
+    end
+  end
+end

data/lib/quickbooks/service/preferences.rb

@@ -0,0 +1,12 @@
+module Quickbooks
+  module Service
+    class Preferences < BaseService
+
+      private
+      
+      def model
+        Quickbooks::Model::Preferences
+      end
+    end
+  end
+end

data/lib/quickbooks/service/purchase_order.rb

@@ -2,8 +2,12 @@ module Quickbooks
   module Service
     class PurchaseOrder < BaseService
 
-      private
-      
+      def delete(purchase_order, options = {})
+        delete_by_query_string(purchase_order)
+      end
+
+    private
+
       def model
         Quickbooks::Model::PurchaseOrder
       end

data/lib/quickbooks/service/refund_receipt.rb

@@ -0,0 +1,12 @@
+module Quickbooks
+  module Service
+    class RefundReceipt < BaseService
+
+      private
+
+      def model
+        Quickbooks::Model::RefundReceipt
+      end
+    end
+  end
+end

data/lib/quickbooks/service/service_crud.rb

@@ -6,6 +6,16 @@ module Quickbooks
         fetch_collection(object_query, model, options)
       end
 
+      def query_in_batches(object_query=nil, options={})
+        page = 0
+        per_page = options.delete(:per_page) || 1_000
+        begin
+          page += 1
+          results = query(object_query, page: page, per_page: per_page)
+          yield results if results.count > 0
+        end until results.count < per_page
+      end
+
       def fetch_by_id(id, options = {})
         url = "#{url_for_resource(model.resource_for_singular)}/#{id}"
         fetch_object(model, url, options)
@@ -24,7 +34,7 @@ module Quickbooks
       alias :update :create
 
       def delete(entity)
-        raise "Not implemented for this Entity"
+        raise NotImplementedError
       end
 
       def delete_by_query_string(entity, options = {})

data/lib/quickbooks/util/collection.rb

@@ -0,0 +1,16 @@
+module Quickbooks
+  class Collection
+    include Enumerable
+    attr_accessor :entries
+
+    # Legacy Attributes (v2)
+    attr_accessor :count, :current_page
+
+    # v3 Attributes
+    attr_accessor :start_position, :max_results, :total_count
+
+    def each(*args, &block)
+      (entries|| []).each *args, &block
+    end
+  end
+end

data/lib/quickbooks/util/name_entity.rb

@@ -27,6 +27,38 @@ module NameEntity
         end
       end
     end
+
+    def posting_type_is_valid
+      if posting_type
+        unless %w(Debit Credit).include?(posting_type)
+          errors.add(:posting_type, "Posting Type must be either 'Debit' or 'Credit'")
+        end
+      end
+    end
+
+    def billable_status_is_valid
+      if billable_status
+        unless %w(Billable NotBillable HasBeenBilled).include?(billable_status)
+          errors.add(:posting_type, "Posting Type must be either 'Debit' or 'Credit'")
+        end
+      end
+    end
+
+    def entity_type_is_valid
+      if entity_type
+        unless %w(Customer Vendor).include?(entity_type)
+          errors.add(:entity_type, "Entity Type must be either 'Customer' or 'Vendor'")
+        end
+      end
+    end
+
+    def journal_line_entry_tax
+      if tax_code_ref
+        # tax_applicable_on must be set
+        errors.add(:tax_applicable_on, "TaxApplicableOn must be set when TaxCodeRef is set") if tax_applicable_on.nil?
+        errors.add(:tax_amount, "TaxAmount must be set when TaxCodeRef is set") if tax_amount.nil?
+      end
+    end
   end
 
   module PermitAlterations

data/lib/quickbooks/version.rb

@@ -1,5 +1,5 @@
 module Quickbooks
 
-  VERSION = "0.1.3"
+  VERSION = "0.1.4"
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: quickbooks-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Cody Caughlan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-05-13 00:00:00.000000000 Z
+date: 2014-07-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: oauth
@@ -196,6 +196,7 @@ files:
 - lib/quickbooks/model/document_numbering.rb
 - lib/quickbooks/model/email_address.rb
 - lib/quickbooks/model/employee.rb
+- lib/quickbooks/model/entity.rb
 - lib/quickbooks/model/estimate.rb
 - lib/quickbooks/model/fault.rb
 - lib/quickbooks/model/group_line_detail.rb
@@ -203,6 +204,8 @@ files:
 - lib/quickbooks/model/invoice_line_item.rb
 - lib/quickbooks/model/item.rb
 - lib/quickbooks/model/item_based_expense_line_detail.rb
+- lib/quickbooks/model/journal_entry.rb
+- lib/quickbooks/model/journal_entry_line_detail.rb
 - lib/quickbooks/model/line.rb
 - lib/quickbooks/model/linked_transaction.rb
 - lib/quickbooks/model/markup_info.rb
@@ -212,9 +215,11 @@ files:
 - lib/quickbooks/model/payment_line_detail.rb
 - lib/quickbooks/model/payment_method.rb
 - lib/quickbooks/model/physical_address.rb
+- lib/quickbooks/model/preferences.rb
 - lib/quickbooks/model/purchase.rb
 - lib/quickbooks/model/purchase_line_item.rb
 - lib/quickbooks/model/purchase_order.rb
+- lib/quickbooks/model/refund_receipt.rb
 - lib/quickbooks/model/sales_item_line_detail.rb
 - lib/quickbooks/model/sales_receipt.rb
 - lib/quickbooks/model/sales_tax_rate_list.rb
@@ -228,6 +233,7 @@ files:
 - lib/quickbooks/model/term.rb
 - lib/quickbooks/model/time_activity.rb
 - lib/quickbooks/model/transaction_tax_detail.rb
+- lib/quickbooks/model/validator.rb
 - lib/quickbooks/model/vendor.rb
 - lib/quickbooks/model/vendor_credit.rb
 - lib/quickbooks/model/web_site_address.rb
@@ -246,10 +252,13 @@ files:
 - lib/quickbooks/service/estimate.rb
 - lib/quickbooks/service/invoice.rb
 - lib/quickbooks/service/item.rb
+- lib/quickbooks/service/journal_entry.rb
 - lib/quickbooks/service/payment.rb
 - lib/quickbooks/service/payment_method.rb
+- lib/quickbooks/service/preferences.rb
 - lib/quickbooks/service/purchase.rb
 - lib/quickbooks/service/purchase_order.rb
+- lib/quickbooks/service/refund_receipt.rb
 - lib/quickbooks/service/sales_receipt.rb
 - lib/quickbooks/service/service_crud.rb
 - lib/quickbooks/service/tax_code.rb
@@ -258,6 +267,7 @@ files:
 - lib/quickbooks/service/time_activity.rb
 - lib/quickbooks/service/vendor.rb
 - lib/quickbooks/service/vendor_credit.rb
+- lib/quickbooks/util/collection.rb
 - lib/quickbooks/util/http_encoding_helper.rb
 - lib/quickbooks/util/logging.rb
 - lib/quickbooks/util/name_entity.rb