quickbooks-ruby-oauth2 0.6.1

data/lib/quickbooks/model/journal_entry.rb

@@ -0,0 +1,36 @@
+module Quickbooks
+  module Model
+    class JournalEntry < BaseModel
+      include HasLineItems
+
+      XML_COLLECTION_NODE = "JournalEntry"
+      XML_NODE = "JournalEntry"
+      REST_RESOURCE = 'journalentry'
+
+      xml_accessor :id, :from => 'Id'
+      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, :from => 'TotalAmt', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :home_total, :from => 'HomeTotalAmt', :as => BigDecimal, :to_xml => to_xml_big_decimal
+
+      #== This adds aliases for backwards compatability to old attributes names
+      alias_method :total_amount, :total
+      alias_method :total_amount=, :total=
+
+      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', :as => :text
+      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

@@ -0,0 +1,95 @@
+module Quickbooks
+  module Model
+    class Line < BaseModel
+      #== Constants
+      SALES_ITEM_LINE_DETAIL = 'SalesItemLineDetail'
+      SUB_TOTAL_LINE_DETAIL = 'SubTotalLineDetail'
+      PAYMENT_LINE_DETAIL = 'PaymentLineDetail'
+      DISCOUNT_LINE_DETAIL = 'DiscountLineDetail'
+      JOURNAL_ENTRY_LINE_DETAIL = 'JournalEntryLineDetail'
+
+      xml_accessor :id, :from => 'Id'
+      xml_accessor :line_num, :from => 'LineNum', :as => Integer
+      xml_accessor :description, :from => 'Description'
+      xml_accessor :amount, :from => 'Amount', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :detail_type, :from => 'DetailType'
+      xml_accessor :linked_transactions, :from => 'LinkedTxn', :as => [LinkedTransaction]
+      xml_accessor :line_extras, :from => 'LineEx', :as => LineEx
+
+      #== Various detail types
+      xml_accessor :sales_item_line_detail, :from => 'SalesItemLineDetail', :as => SalesItemLineDetail
+      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
+
+      def initialize(*args)
+        self.linked_transactions ||= []
+        super
+      end
+
+      def invoice_id=(id)
+        update_linked_transactions([id], 'Invoice')
+      end
+      alias_method :invoice_ids=, :invoice_id=
+
+      def credit_memo_id=(id)
+        update_linked_transactions([id], 'CreditMemo')
+      end
+      alias_method :credit_memo_ids=, :credit_memo_id=
+
+      def sales_item!
+        self.detail_type = SALES_ITEM_LINE_DETAIL
+        self.sales_item_line_detail = SalesItemLineDetail.new
+
+        yield self.sales_item_line_detail if block_given?
+      end
+
+      def sub_total!
+        self.detail_type = SUB_TOTAL_LINE_DETAIL
+        self.sub_total_line_detail = SubTotalLineDetail.new
+
+        yield self.sub_total_line_detail if block_given?
+      end
+
+      def payment!
+        self.detail_type = PAYMENT_LINE_DETAIL
+        self.payment_line_detail = PaymentLineDetail.new
+
+        yield self.payment_line_detail if block_given?
+      end
+
+      def discount!
+        self.detail_type = DISCOUNT_LINE_DETAIL
+        self.discount_line_detail = DiscountLineDetail.new
+
+        yield self.discount_line_detail if block_given?
+      end
+
+      def journal_entry!
+        self.detail_type = JOURNAL_ENTRY_LINE_DETAIL
+        self.journal_entry_line_detail = JournalEntryLineDetail.new
+
+        yield self.journal_entry_line_detail if block_given?
+      end
+
+      private
+
+      def update_linked_transactions(txn_ids, txn_type)
+        remove_linked_transactions(txn_type)
+        txn_ids.flatten.compact.each do |id|
+          add_linked_transaction(id, txn_type)
+        end
+      end
+
+      def remove_linked_transactions(txn_type)
+        self.linked_transactions.delete_if { |lt| lt.txn_type == txn_type }
+      end
+
+      def add_linked_transaction(txn_id, txn_type)
+        self.linked_transactions << LinkedTransaction.new(txn_id: txn_id,
+                                                          txn_type: txn_type)
+      end
+    end
+  end
+end

data/lib/quickbooks/model/line_ex.rb

@@ -0,0 +1,9 @@
+
+module Quickbooks
+  module Model
+    class LineEx < BaseModel
+
+      xml_accessor :name_values, :from => "NameValue", :as => [NameValue]
+    end
+  end
+end

data/lib/quickbooks/model/linked_transaction.rb

@@ -0,0 +1,9 @@
+module Quickbooks
+  module Model
+    class LinkedTransaction < BaseModel
+      xml_accessor :txn_id, :from => 'TxnId'
+      xml_accessor :txn_type, :from => 'TxnType'
+      xml_accessor :txn_line_id, :from => 'TxnLineId'
+    end
+  end
+end

data/lib/quickbooks/model/markup_info.rb

@@ -0,0 +1,12 @@
+module Quickbooks
+  module Model
+    class MarkupInfo < BaseModel
+      xml_accessor :percent_based, :from => 'PercentBased'
+      xml_accessor :value, :from => 'Value', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :percent, :from => 'Percent', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :price_level_ref, :from => 'PriceLevelRef', :as => BaseReference
+
+      reference_setters :price_level_ref
+    end
+  end
+end

data/lib/quickbooks/model/meta_data.rb

@@ -0,0 +1,24 @@
+require 'time'
+
+module Quickbooks
+  module Model
+    class MetaData < BaseModel
+      xml_accessor :create_time, :from => 'CreateTime', :as => Time
+      xml_accessor :last_updated_time, :from => 'LastUpdatedTime', :as => Time
+
+      def to_xml(options = {})
+        xml = %Q{<MetaData>}
+        xml = "#{xml}<CreateTime>#{formatted_date(create_time)}</CreateTime>"
+        xml = "#{xml}<LastUpdatedTime>#{formatted_date(last_updated_time)}</LastUpdatedTime></MetaData>"
+        xml
+      end
+
+      private
+
+      def formatted_date(datetime)
+        datetime.strftime('%Y-%m-%dT%H:%M:%S%z')
+      end
+
+    end
+  end
+end

data/lib/quickbooks/model/name_value.rb

@@ -0,0 +1,8 @@
+module Quickbooks
+  module Model
+    class NameValue < BaseModel
+      xml_accessor :name, :from => "Name"
+      xml_accessor :value, :from => "Value"
+    end
+  end
+end

data/lib/quickbooks/model/other_contact_info.rb

@@ -0,0 +1,8 @@
+module Quickbooks
+  module Model
+    class OtherContactInfo < BaseModel
+      xml_accessor :type, :from => 'Type'
+      xml_accessor :telephone, :from => 'Telephone', :as => TelephoneNumber
+    end
+  end
+end

data/lib/quickbooks/model/payment.rb

@@ -0,0 +1,43 @@
+module Quickbooks
+  module Model
+    class Payment < BaseModel
+      include HasLineItems
+
+      XML_COLLECTION_NODE = "Payment"
+      XML_NODE = "Payment"
+      REST_RESOURCE = 'payment'
+
+      xml_accessor :id, :from => 'Id'
+      xml_accessor :sync_token, :from => 'SyncToken', :as => Integer
+      xml_accessor :meta_data, :from => 'MetaData', :as => MetaData
+      xml_accessor :txn_date, :from => 'TxnDate', :as => Date
+      xml_accessor :private_note, :from => 'PrivateNote'
+      xml_accessor :txn_status, :from => 'TxnStatus'
+      xml_accessor :line_items, :from => 'Line', :as => [Line]
+      xml_accessor :customer_ref, :from => 'CustomerRef', :as => BaseReference
+      xml_accessor :ar_account_ref, :from => 'ARAccountRef', :as => BaseReference
+      xml_accessor :deposit_to_account_ref, :from => 'DepositToAccountRef', :as => BaseReference
+      xml_accessor :payment_method_ref, :from => 'PaymentMethodRef', :as => BaseReference
+      xml_accessor :payment_ref_number, :from => 'PaymentRefNum'
+      xml_accessor :credit_card_payment, :from => 'CreditCardPayment', :as => CreditCardPayment
+      xml_accessor :total, :from => 'TotalAmt', :as => BigDecimal, :to_xml => :to_f.to_proc
+      xml_accessor :unapplied_amount, :from => 'UnappliedAmt', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :process_payment, :from => 'ProcessPayment'
+      xml_accessor :currency_ref, :from => 'CurrencyRef', :as => BaseReference
+      xml_accessor :exchange_rate, :from => 'ExchangeRate', :as => BigDecimal, :to_xml => to_xml_big_decimal
+
+      reference_setters :customer_ref, :ar_account_ref
+      reference_setters :payment_method_ref, :deposit_to_account_ref, :currency_ref
+
+      validate :existence_of_customer_ref
+
+      private
+
+      def existence_of_customer_ref
+        if customer_ref.nil? || (customer_ref && customer_ref.value == 0)
+          errors.add(:customer_ref, "CustomerRef is required and must be a non-zero value.")
+        end
+      end
+    end
+  end
+end

data/lib/quickbooks/model/payment_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 PaymentChange < ChangeModel
+      XML_NODE = "Payment"
+    end
+  end
+end

data/lib/quickbooks/model/payment_line_detail.rb

@@ -0,0 +1,12 @@
+module Quickbooks
+  module Model
+    class PaymentLineDetail < BaseModel
+      xml_accessor :item_ref, :from => 'ItemRef', :as => BaseReference
+      xml_accessor :class_ref, :from => 'ClassRef', :as => BaseReference
+      xml_accessor :balance, :from => 'Balance', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :discount, :from => 'Discount', :as => DiscountOverride
+
+      reference_setters :item_ref, :class_ref
+    end
+  end
+end

data/lib/quickbooks/model/payment_method.rb

@@ -0,0 +1,25 @@
+module Quickbooks
+  module Model
+    class PaymentMethod < BaseModel
+      REST_RESOURCE = 'paymentmethod'
+      XML_COLLECTION_NODE = "PaymentMethod"
+      XML_NODE = "PaymentMethod"
+      include NameEntity::PermitAlterations
+
+      CREDIT_CARD = "CREDIT_CARD"
+      NON_CREDIT_CARD = "NON_CREDIT_CARD"
+
+      PAYMENT_METHOD_TYPES = [CREDIT_CARD, NON_CREDIT_CARD]
+
+      xml_accessor :id, :from => 'Id'
+      xml_accessor :sync_token, :from => 'SyncToken', :as => Integer
+      xml_accessor :meta_data, :from => 'MetaData', :as => MetaData
+      xml_accessor :name, :from => 'Name'
+      xml_accessor :type, :from => 'Type'
+      xml_accessor :active?, :from => 'Active'
+      xml_accessor :amount, :from => 'Amount', :as => BigDecimal, :to_xml => to_xml_big_decimal
+
+      validates_inclusion_of :type, :in => PAYMENT_METHOD_TYPES, :allow_nil => true
+    end
+  end
+end

data/lib/quickbooks/model/physical_address.rb

@@ -0,0 +1,40 @@
+module Quickbooks
+  module Model
+    class PhysicalAddress < BaseModel
+      xml_accessor :id, :from => 'Id'
+      xml_accessor :line1, :from => 'Line1'
+      xml_accessor :line2, :from => 'Line2'
+      xml_accessor :line3, :from => 'Line3'
+      xml_accessor :line4, :from => 'Line4'
+      xml_accessor :line5, :from => 'Line5'
+      xml_accessor :city, :from => 'City'
+      xml_accessor :country, :from => 'Country'
+      xml_accessor :country_sub_division_code, :from => 'CountrySubDivisionCode'
+      xml_accessor :postal_code, :from => 'PostalCode'
+      xml_accessor :note, :from => 'Note'
+      xml_accessor :lat, :from => 'Lat'
+      xml_accessor :lon, :from => 'Long'
+
+      def zip
+        postal_code
+      end
+
+      def lat_to_f
+        BigDecimal.new(lat)
+      end
+
+      def lon_to_f
+        BigDecimal.new(lon)
+      end
+
+      def have_lat?
+        lat.to_s != "INVALID"
+      end
+
+      def have_lon?
+        lon.to_s != "INVALID"
+      end
+
+    end
+  end
+end

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/purchase.rb

@@ -0,0 +1,57 @@
+# == General
+# This entity represents expenses, such as a purchase made from a vendor.
+# There are three types of Purchases: Cash, Check, and Credit Card.
+# * Cash Purchase contains information regarding a payment made in cash.
+# * Check Purchase contains information regarding a payment made by check.
+# * Credit Card Purchase contains information regarding a payment made by credit card.
+#
+# == Business Rules
+# * You must specify an AccountRef for all puchases.
+# * TotalAmt attribute must add up to sum of Line.Amount attributes
+
+module Quickbooks
+  module Model
+    class Purchase < BaseModel
+      include GlobalTaxCalculation
+      include HasLineItems
+
+      #== Constants
+      REST_RESOURCE = 'purchase'
+      XML_COLLECTION_NODE = "Purchase"
+      XML_NODE = "Purchase"
+
+      xml_accessor :id, :from => 'Id'
+      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 :private_note, :from => 'PrivateNote'
+
+      xml_accessor :line_items, :from => 'Line', :as => [PurchaseLineItem]
+      xml_accessor :account_ref, :from => 'AccountRef', :as => BaseReference
+      xml_accessor :txn_tax_detail, :from => 'TxnTaxDetail', :as => TransactionTaxDetail
+
+      xml_accessor :payment_type, :from => 'PaymentType'
+      xml_accessor :entity_ref, :from => 'EntityRef', :as => BaseReference
+      xml_accessor :remit_to_address, :from => 'RemitToAddr', :as => PhysicalAddress
+      xml_accessor :total, :from => 'TotalAmt', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :print_status, :from => 'PrintStatus'
+      xml_accessor :department_ref, :from => 'DepartmentRef', :as => BaseReference
+
+      xml_accessor :currency_ref, :from => 'CurrencyRef', :as => BaseReference
+      xml_accessor :exchange_rate, :from => 'ExchangeRate', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :linked_transactions, :from => 'LinkedTxn', :as => [LinkedTransaction]
+      xml_accessor :credit?, :from => 'Credit'
+
+      reference_setters
+
+      #== Validations
+      validate :line_item_size
+
+      #== This adds aliases for backwards compatability to old attributes names
+      alias_method :total_amount, :total
+      alias_method :total_amount=, :total=
+
+    end
+  end
+end

data/lib/quickbooks/model/purchase_line_item.rb

@@ -0,0 +1,44 @@
+module Quickbooks
+  module Model
+    class PurchaseLineItem < BaseModel
+
+      #== Constants
+      ITEM_BASED_EXPENSE_LINE_DETAIL = 'ItemBasedExpenseLineDetail'
+      ACCOUNT_BASED_EXPENSE_LINE_DETAIL = 'AccountBasedExpenseLineDetail'
+      GROUP_LINE_DETAIL = 'GroupLineDetail'
+
+      xml_accessor :id, :from => 'Id'
+      xml_accessor :line_num, :from => 'LineNum', :as => Integer
+      xml_accessor :description, :from => 'Description'
+      xml_accessor :amount, :from => 'Amount', :as => BigDecimal, :to_xml => Proc.new { |val| val.to_f }
+      xml_accessor :detail_type, :from => 'DetailType'
+
+      #== Various detail types
+      xml_accessor :account_based_expense_line_detail, :from => ACCOUNT_BASED_EXPENSE_LINE_DETAIL, :as => AccountBasedExpenseLineDetail
+      xml_accessor :item_based_expense_line_detail, :from => ITEM_BASED_EXPENSE_LINE_DETAIL, :as => ItemBasedExpenseLineDetail
+      xml_accessor :group_line_detail, :from => GROUP_LINE_DETAIL, :as => GroupLineDetail
+
+      def account_based?
+        detail_type.to_s == ACCOUNT_BASED_EXPENSE_LINE_DETAIL
+      end
+
+      def item_based?
+        detail_type.to_s == ITEM_BASED_EXPENSE_LINE_DETAIL
+      end
+
+      def account_based_expense!
+        self.detail_type = ACCOUNT_BASED_EXPENSE_LINE_DETAIL
+        self.account_based_expense_line_detail = AccountBasedExpenseLineDetail.new
+
+        yield self.account_based_expense_line_detail if block_given?
+      end
+
+      def item_based_expense!
+        self.detail_type = ITEM_BASED_EXPENSE_LINE_DETAIL
+        self.item_based_expense_line_detail = ItemBasedExpenseLineDetail.new
+
+        yield self.item_based_expense_line_detail if block_given?
+      end
+    end
+  end
+end

data/lib/quickbooks/model/purchase_order.rb

@@ -0,0 +1,50 @@
+module Quickbooks
+  module Model
+    class PurchaseOrder < BaseModel
+      include GlobalTaxCalculation
+      include HasLineItems
+
+      #== Constants
+      REST_RESOURCE = 'purchaseorder'
+      XML_COLLECTION_NODE = "PurchaseOrder"
+      XML_NODE = "PurchaseOrder"
+
+      xml_accessor :id, :from => 'Id'
+      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 :custom_fields, :from => 'CustomField', :as => [CustomField]
+      xml_accessor :private_note, :from => 'PrivateNote'
+      xml_accessor :memo, :from => 'Memo'
+
+      xml_accessor :linked_transactions, :from => 'LinkedTxn', :as => [LinkedTransaction]
+      xml_accessor :line_items, :from => 'Line', :as => [PurchaseLineItem]
+
+      xml_accessor :attachable_ref, :from => 'AttachableRef', :as => BaseReference
+      xml_accessor :vendor_ref, :from => 'VendorRef', :as => BaseReference
+      xml_accessor :ap_account_ref, :from => 'APAccountRef', :as => BaseReference
+      xml_accessor :class_ref, :from => 'ClassRef', :as => BaseReference
+      xml_accessor :sales_term_ref, :from => 'SalesTermRef', :as => BaseReference
+
+      xml_accessor :total, :from => 'TotalAmt', :as => BigDecimal, :to_xml => Proc.new { |val| val.to_f }
+      xml_accessor :due_date, :from => 'DueDate', :as => Date
+      xml_accessor :vendor_address, :from => 'VendorAddr', :as => PhysicalAddress
+      xml_accessor :ship_address, :from => 'ShipAddr', :as => PhysicalAddress
+      xml_accessor :ship_method_ref, :from => 'ShipMethodRef', :as => BaseReference
+      xml_accessor :po_status, :from => 'POStatus'
+      xml_accessor :txn_tax_detail, :from => 'TxnTaxDetail', :as => TransactionTaxDetail
+
+      xml_accessor :currency_ref, :from => 'CurrencyRef', :as => BaseReference
+      xml_accessor :exchange_rate, :from => 'ExchangeRate', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :tax_code_ref, :from => 'TaxCodeRef', :as => BaseReference
+
+      reference_setters
+
+      #== This adds aliases for backwards compatability to old attributes names
+      alias_method :total_amount, :total
+      alias_method :total_amount=, :total=
+
+    end
+  end
+end

data/lib/quickbooks/model/purchase_tax_rate_list.rb

@@ -0,0 +1,11 @@
+module Quickbooks
+  module Model
+    class PurchaseTaxRateList < BaseModel
+      XML_COLLECTION_NODE = "PurchaseTaxRateList"
+      XML_NODE = "PurchaseTaxRateList"
+      REST_RESOURCE = "purchasetaxratelist"
+
+      xml_accessor :tax_rate_detail, :from => "TaxRateDetail", :as => [TaxRateDetail]
+    end
+  end
+end

data/lib/quickbooks/model/refund_receipt.rb

@@ -0,0 +1,62 @@
+module Quickbooks
+  module Model
+    class RefundReceipt < BaseModel
+      include GlobalTaxCalculation
+      include HasLineItems
+
+      XML_COLLECTION_NODE = "RefundReceipt"
+      XML_NODE = "RefundReceipt"
+      REST_RESOURCE = 'refundreceipt'
+
+      xml_accessor :id, :from => 'Id'
+      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 :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
+
+      xml_accessor :exchange_rate, :from => 'ExchangeRate', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :linked_transactions, :from => 'LinkedTxn', :as => [LinkedTransaction]
+
+      # readonly
+      xml_accessor :total, :from => 'TotalAmt', :as => BigDecimal
+      xml_accessor :home_total, :from => 'HomeTotalAmt', :as => BigDecimal, :to_xml => to_xml_big_decimal
+
+      # backward-compatible alias
+      alias_attribute :placed_on, :txn_date
+
+      include DocumentNumbering
+      reference_setters
+
+      validate :line_item_size
+      validate :document_numbering
+
+      def email=(email)
+        self.bill_email = EmailAddress.new(email)
+      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