quickbooks-ruby-oauth2 0.6.1

data/lib/quickbooks/model/document_numbering.rb

@@ -0,0 +1,18 @@
+module DocumentNumbering
+
+  # Convenience method for proper AutoDocNumber tag
+  # construction, which should be blank if auto
+  # document numbering is desired.
+  def auto_doc_number!
+    self.auto_doc_number = ''
+  end
+
+  private
+
+  def document_numbering
+    if !auto_doc_number.nil? && !doc_number.nil?
+      errors.add(:doc_number, "DocumentNumber should not be specified if AutoDocNumber is.")
+    end
+  end
+
+end

data/lib/quickbooks/model/effective_tax_rate.rb

@@ -0,0 +1,15 @@
+require 'time'
+
+module Quickbooks
+  module Model
+    class EffectiveTaxRate < BaseModel
+      XML_COLLECTION_NODE = "EffectiveTaxRate"
+      XML_NODE = "EffectiveTaxRate"
+      REST_RESOURCE = "effectivetaxrate"
+
+      xml_accessor :rate_value, :from => 'RateValue'
+      xml_accessor :effective_date, :from => 'EffectiveDate', :as => Time
+      xml_accessor :end_date, :from => 'EndDate', :as => Time
+    end
+  end
+end

data/lib/quickbooks/model/email_address.rb

@@ -0,0 +1,19 @@
+module Quickbooks
+  module Model
+    class EmailAddress < BaseModel
+      xml_accessor :address, :from => 'Address'
+
+      def to_xml(options = {})
+        return "" if address.to_s.empty?
+        super
+      end
+
+      def initialize(email_address = nil)
+        unless email_address.nil?
+          self.address = email_address
+        end
+      end
+
+    end
+  end
+end

data/lib/quickbooks/model/employee.rb

@@ -0,0 +1,47 @@
+# == Business Rules
+# * DisplayName, GivenName, MiddleName, FamilyName, and PrintOnCheckName must not contain a colon (":")
+# * DisplayName must be unique across all other customers, employees, vendors, and other names.
+
+module Quickbooks
+  module Model
+    class Employee < BaseModel
+      XML_COLLECTION_NODE = "Employee"
+      XML_NODE = "Employee"
+      REST_RESOURCE = 'employee'
+      include NameEntity::Quality
+      include NameEntity::PermitAlterations
+
+      xml_name XML_NODE
+      xml_accessor :id, :from => 'Id'
+      xml_accessor :sync_token, :from => 'SyncToken', :as => Integer
+      xml_accessor :meta_data, :from => 'MetaData', :as => MetaData
+      xml_accessor :organization?, :from => 'Organization'
+      xml_accessor :title, :from => 'Title'
+      xml_accessor :given_name, :from => 'GivenName'
+      xml_accessor :middle_name, :from => 'MiddleName'
+      xml_accessor :family_name, :from => 'FamilyName'
+      xml_accessor :suffix, :from => 'Suffix'
+      xml_accessor :display_name, :from => 'DisplayName'
+      xml_accessor :print_on_check_name, :from => 'PrintOnCheckName'
+      xml_accessor :active?, :from => 'Active'
+      xml_accessor :primary_phone, :from => 'PrimaryPhone', :as => TelephoneNumber
+      xml_accessor :mobile_phone, :from => 'Mobile', :as => TelephoneNumber
+      xml_accessor :primary_email_address, :from => 'PrimaryEmailAddr', :as => EmailAddress
+      xml_accessor :number, :from => 'EmployeeNumber'
+      xml_accessor :ssn, :from => 'SSN'
+      xml_accessor :address, :from => 'PrimaryAddr', :as => PhysicalAddress
+      xml_accessor :billable?, :from => 'BillableTime'
+      xml_accessor :billable_rate, :from => 'BillRate', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :birth_date, :from => 'BirthDate', :as => Date
+      xml_accessor :gender, :from => 'Gender'
+      xml_accessor :hired_date, :from => 'HiredDate', :as => Date
+      xml_accessor :released_date, :from => 'ReleasedDate', :as => Date
+
+      #== Validations
+      validate :names_cannot_contain_invalid_characters
+      validate :email_address_is_valid
+
+
+    end
+  end
+end

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, :as => BaseReference
+
+      reference_setters :entity_ref
+
+      #== Validations
+      validate :entity_type_is_valid
+
+    end
+  end
+end

data/lib/quickbooks/model/entity_ref.rb

@@ -0,0 +1,8 @@
+module Quickbooks
+  module Model
+    class EntityRef < BaseModel
+      xml_accessor :type
+      xml_accessor :value
+    end
+  end
+end

data/lib/quickbooks/model/estimate.rb

@@ -0,0 +1,76 @@
+# == Business Rules
+# The Estimate object has the following business rules and validations:
+# * An Estimate must have at least one line that describes an item.
+# * An Estimate must have a reference to a customer.
+# * If shipping address and billing address are not provided, the customer address is used to fill those values.
+# * For US country, CustomSalesTax cannot be used as TaxCodeRef.
+
+module Quickbooks
+  module Model
+    class Estimate < BaseModel
+      include GlobalTaxCalculation
+      include HasLineItems
+
+      #== Constants
+      REST_RESOURCE = 'estimate'
+      XML_COLLECTION_NODE = "Estimate"
+      XML_NODE = "Estimate"
+
+      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 :doc_number, :from => 'DocNumber'
+      xml_accessor :txn_date, :from => 'TxnDate', :as => Date
+      xml_accessor :private_note, :from => 'PrivateNote'
+
+      xml_accessor :department_ref, :from => 'DepartmentRef', :as => BaseReference
+      xml_accessor :linked_transactions, :from => 'LinkedTxn', :as => [LinkedTransaction]
+      xml_accessor :line_items, :from => 'Line', :as => [InvoiceLineItem]
+      xml_accessor :txn_tax_detail, :from => 'TxnTaxDetail', :as => TransactionTaxDetail
+      xml_accessor :txn_status, :from => 'TxnStatus'
+
+      xml_accessor :customer_ref, :from => 'CustomerRef', :as => BaseReference
+      xml_accessor :customer_memo, :from => 'CustomerMemo'
+      xml_accessor :billing_address, :from => 'BillAddr', :as => PhysicalAddress
+      xml_accessor :shipping_address, :from => 'ShipAddr', :as => PhysicalAddress
+      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 => to_xml_big_decimal
+      xml_accessor :ship_method_ref, :from => 'ShipMethodRef', :as => BaseReference
+      xml_accessor :ship_date, :from => 'ShipDate', :as => Date
+
+      xml_accessor :currency_ref, :from => 'CurrencyRef', :as => BaseReference
+      xml_accessor :exchange_rate, :from => 'ExchangeRate', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :due_date, :from => 'DueDate', :as => Date
+      xml_accessor :deposit_to_account_ref, :from => 'DepositToAccountRef', :as => BaseReference
+
+      xml_accessor :apply_tax_after_discount?, :from => 'ApplyTaxAfterDiscount'
+      xml_accessor :print_status, :from => 'PrintStatus'
+      xml_accessor :email_status, :from => 'EmailStatus'
+      xml_accessor :bill_email, :from => 'BillEmail', :as => EmailAddress
+      xml_accessor :expiration_date, :from => 'ExpirationDate', :as => Date
+      xml_accessor :accepted_by, :from => 'AcceptedBy'
+      xml_accessor :accepted_date, :from => 'AcceptedDate', :as => Date
+
+      reference_setters
+
+      #== This adds aliases for backwards compatability to old attributes names
+      alias_method :total_amount, :total
+      alias_method :total_amount=, :total=
+
+      #== Validations
+      validate :line_item_size
+      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/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/fault.rb

@@ -0,0 +1,16 @@
+module Quickbooks
+  module Model
+    class Fault < BaseModel
+      class Error
+        include ROXML
+        xml_name 'Error'
+        xml_accessor :code, :from => "@code"
+        xml_accessor :element, :from => "@element"
+        xml_accessor :message, :from => "Message"
+        xml_accessor :detail, :from => "Detail"
+      end
+
+      xml_accessor :errors, :as => [Quickbooks::Model::Fault::Error]
+    end
+  end
+end

data/lib/quickbooks/model/global_tax_calculation.rb

@@ -0,0 +1,13 @@
+module GlobalTaxCalculation
+  extend ActiveSupport::Concern
+
+  TAX_INCLUSIVE = "TaxInclusive"
+  TAX_EXCLUDED = "TaxExcluded"
+  NOT_APPLICABLE = "NotApplicable"
+  GLOBAL_TAX_CALCULATION = [TAX_INCLUSIVE, TAX_EXCLUDED, NOT_APPLICABLE]
+
+  included do
+    xml_accessor :global_tax_calculation, :from => 'GlobalTaxCalculation'
+    validates_inclusion_of :global_tax_calculation, :in => GLOBAL_TAX_CALCULATION, allow_blank: true
+  end
+end

data/lib/quickbooks/model/group_line_detail.rb

@@ -0,0 +1,13 @@
+module Quickbooks
+  module Model
+    class GroupLineDetail < BaseModel
+      include HasLineItems
+
+      xml_accessor :group_item_ref, :from => 'CustomerRef', :as => BaseReference
+      xml_accessor :quantity, :from => 'Quantity', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :line_items, :from => 'Line', :as => [Line]
+
+      reference_setters :group_item_ref
+    end
+  end
+end

data/lib/quickbooks/model/has_line_items.rb

@@ -0,0 +1,14 @@
+module Quickbooks
+  module Model
+    module HasLineItems
+      def initialize(*args)
+        ensure_line_items_initialization
+        super
+      end
+
+      def ensure_line_items_initialization
+        self.line_items ||= []
+      end
+    end
+  end
+end

data/lib/quickbooks/model/invoice.rb

@@ -0,0 +1,107 @@
+# == Business Rules
+# * An invoice must have at least one Line that describes an item.
+# * An invoice must have CustomerRef populated.
+# * The DocNumber attribute is populated automatically by the data service if not supplied.
+# * If ShipAddr, BillAddr, or both are not provided, the appropriate customer address from Customer is used to fill those values.
+# * DocNumber, if supplied, must be unique.
+
+module Quickbooks
+  module Model
+    class Invoice < BaseModel
+      include DocumentNumbering
+      include GlobalTaxCalculation
+      include HasLineItems
+
+      #== Constants
+      REST_RESOURCE = 'invoice'
+      XML_COLLECTION_NODE = "Invoice"
+      XML_NODE = "Invoice"
+      EMAIL_STATUS_NEED_TO_SEND = 'NeedToSend'
+
+      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 :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
+      xml_accessor :currency_ref, :from => 'CurrencyRef', :as => BaseReference
+      xml_accessor :exchange_rate, :from => 'ExchangeRate', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :private_note, :from => 'PrivateNote'
+      xml_accessor :linked_transactions, :from => 'LinkedTxn', :as => [LinkedTransaction]
+      xml_accessor :line_items, :from => 'Line', :as => [InvoiceLineItem]
+      xml_accessor :txn_tax_detail, :from => 'TxnTaxDetail', :as => TransactionTaxDetail
+      xml_accessor :customer_ref, :from => 'CustomerRef', :as => BaseReference
+      xml_accessor :customer_memo, :from => 'CustomerMemo'
+      xml_accessor :billing_address, :from => 'BillAddr', :as => PhysicalAddress
+      xml_accessor :shipping_address, :from => 'ShipAddr', :as => PhysicalAddress
+      xml_accessor :class_ref, :from => 'ClassRef', :as => BaseReference
+      xml_accessor :sales_term_ref, :from => 'SalesTermRef', :as => BaseReference
+      xml_accessor :due_date, :from => 'DueDate', :as => Date
+      xml_accessor :ship_method_ref, :from => 'ShipMethodRef', :as => BaseReference
+      xml_accessor :ship_date, :from => 'ShipDate', :as => Date
+      xml_accessor :tracking_num, :from => 'TrackingNum'
+      xml_accessor :ar_account_ref, :from => 'ARAccountRef', :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
+      xml_accessor :apply_tax_after_discount?, :from => 'ApplyTaxAfterDiscount'
+      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'
+      xml_accessor :delivery_info, :from => 'DeliveryInfo', :as => DeliveryInfo
+      xml_accessor :bill_email, :from => 'BillEmail', :as => EmailAddress
+      xml_accessor :allow_online_payment?, :from => 'AllowOnlinePayment'
+      xml_accessor :allow_online_credit_card_payment?, :from => 'AllowOnlineCreditCardPayment'
+      xml_accessor :allow_online_ach_payment?, :from => 'AllowOnlineACHPayment'
+      xml_accessor :deposit_to_account_ref, :from => 'DepositToAccountRef', :as => BaseReference
+
+
+      reference_setters
+
+      #== This adds aliases for backwards compatability to old attributes names
+      alias_method :total_amount, :total
+      alias_method :total_amount=, :total=
+      alias_method :home_total_amount, :home_total
+      alias_method :home_total_amount=, :home_total=
+
+      #== Validations
+      validate :line_item_size
+      validate :existence_of_customer_ref
+      validate :required_bill_email_if_email_delivery
+      validate :document_numbering
+
+      def required_bill_email_if_email_delivery
+        return unless email_status_for_delivery?
+
+        if bill_email.nil?
+          errors.add(:bill_email, "BillEmail is required if EmailStatus=NeedToSend")
+        end
+      end
+
+      def billing_email_address=(email_address_string)
+        self.bill_email = EmailAddress.new(email_address_string)
+      end
+
+
+      def wants_billing_email_sent!
+        self.email_status = EMAIL_STATUS_NEED_TO_SEND
+      end
+
+      def email_status_for_delivery?
+        email_status == EMAIL_STATUS_NEED_TO_SEND
+      end
+
+
+      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/invoice_change.rb

@@ -0,0 +1,9 @@
+module Quickbooks
+  module Model
+    # Refer to:
+    # - https://developer.intuit.com/docs/0100_quickbooks_online/0200_dev_guides/accounting/change_data_capture
+    class InvoiceChange < ChangeModel
+      XML_NODE = "Invoice"
+    end
+  end
+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

@@ -0,0 +1,88 @@
+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'
+      DESCRIPTION_LINE_DETAIL = 'DescriptionLineDetail'
+      DESCRIPTION_DETAIL_TYPE = 'DescriptionOnly'
+
+      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'
+
+      #== Various detail types
+      xml_accessor :sales_line_item_detail, :from => SALES_LINE_ITEM_DETAIL, :as => SalesItemLineDetail
+      xml_accessor :sub_total_line_detail, :from => SUB_TOTAL_LINE_DETAIL, :as => SubTotalLineDetail
+      xml_accessor :payment_line_detail, :from => PAYMENT_LINE_DETAIL, :as => PaymentLineDetail
+      xml_accessor :discount_line_detail, :from => DISCOUNT_LINE_DETAIL, :as => DiscountLineDetail
+      xml_accessor :group_line_detail, :from => INVOICE_GROUP_LINE_DETAIL, :as => InvoiceGroupLineDetail
+      xml_accessor :description_line_detail, :from => DESCRIPTION_LINE_DETAIL, :as => DescriptionLineDetail
+
+      def group_line_detail?
+        detail_type.to_s == INVOICE_GROUP_LINE_DETAIL
+      end
+
+      def sales_item?
+        detail_type.to_s == SALES_LINE_ITEM_DETAIL
+      end
+
+      def sub_total_item?
+        detail_type.to_s == SUB_TOTAL_LINE_DETAIL
+      end
+
+      def discount_item?
+        detail_type.to_s == DISCOUNT_LINE_DETAIL
+      end
+
+      def description_only?
+        # The detail type for a description-only line detail differs slightly
+        # from the node name (DescriptionOnly vs DescriptionLineDetail)
+        detail_type.to_s == DESCRIPTION_DETAIL_TYPE
+      end
+
+      def sales_item!
+        self.detail_type = SALES_LINE_ITEM_DETAIL
+        self.sales_line_item_detail = SalesItemLineDetail.new
+
+        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
+
+        yield self.payment_line_detail if block_given?
+      end
+
+      def discount_item!
+        self.detail_type = DISCOUNT_LINE_DETAIL
+        self.discount_line_detail = DiscountLineDetail.new
+
+        yield self.discount_line_detail if block_given?
+      end
+
+      def description_only!
+        self.detail_type = DESCRIPTION_DETAIL_TYPE
+        self.description_line_detail = DescriptionLineDetail.new
+
+        yield self.description_line_detail if block_given?
+      end
+
+    end
+  end
+end

data/lib/quickbooks/model/item.rb

@@ -0,0 +1,87 @@
+# Business Rules
+# * The item name must be unique.
+# * Service item types  must have IncomeAccountRef.
+# * Service item types must have ExpenseAccountRef.
+
+module Quickbooks
+  module Model
+    class Item < BaseModel
+
+      XML_COLLECTION_NODE = "Item"
+      XML_NODE = "Item"
+      REST_RESOURCE = 'item'
+      MINORVERSION = 4
+
+      INVENTORY_TYPE = 'Inventory'
+      NON_INVENTORY_TYPE = 'NonInventory'
+      SERVICE_TYPE = 'Service'
+      CATEGORY_TYPE = 'Category'
+      ITEM_TYPES = [INVENTORY_TYPE, NON_INVENTORY_TYPE, SERVICE_TYPE, CATEGORY_TYPE]
+
+      xml_name 'Item'
+      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 :sku, :from => 'Sku'
+      xml_accessor :description, :from => 'Description'
+      xml_accessor :active?, :from => 'Active'
+      xml_accessor :sub_item?, :from => 'SubItem'
+      xml_accessor :parent_ref, :from => 'ParentRef', :as => Integer
+      xml_accessor :level, :from => 'Level', :as => Integer
+
+      # read-only
+      xml_accessor :fully_qualified_name, :from => 'FullyQualifiedName'
+      xml_accessor :taxable?, :from => 'Taxable'
+      xml_accessor :sales_tax_included?, :from => 'SalesTaxIncluded'
+      xml_accessor :unit_price, :from => 'UnitPrice', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :rate_percent, :from => 'RatePercent', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :type, :from => 'Type'
+      xml_accessor :income_account_ref, :from => 'IncomeAccountRef', :as => BaseReference
+      xml_accessor :purchase_desc, :from => 'PurchaseDesc'
+      xml_accessor :purchase_tax_included?, :from => 'PurchaseTaxIncluded'
+      xml_accessor :purchase_cost, :from => 'PurchaseCost', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :expense_account_ref, :from => 'ExpenseAccountRef', :as => BaseReference
+      xml_accessor :asset_account_ref, :from => 'AssetAccountRef', :as => BaseReference
+      xml_accessor :track_quantity_on_hand?, :from => 'TrackQtyOnHand'
+      xml_accessor :quantity_on_hand, :from => 'QtyOnHand', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :sales_tax_code_ref, :from => 'SalesTaxCodeRef', :as => BaseReference
+      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
+
+      #== Validations
+      validates_length_of :name, :minimum => 1
+      validates_inclusion_of :type, :in => ITEM_TYPES
+
+      def initialize(*args)
+        self.type = INVENTORY_TYPE
+        super
+      end
+
+      def valid_for_create?
+        valid?
+        errors.empty?
+      end
+
+      # To delete an object Intuit requires we provide Id and SyncToken fields
+      def valid_for_deletion?
+        return false if(id.nil? || sync_token.nil?)
+        id.to_i > 0 && !sync_token.to_s.empty? && sync_token.to_i >= 0
+      end
+
+      def valid_for_update?
+        if sync_token.nil?
+          errors.add(:sync_token, "Missing required attribute SyncToken for update")
+        end
+        errors.empty?
+      end
+    end
+  end
+end

data/lib/quickbooks/model/item_based_expense_line_detail.rb

@@ -0,0 +1,20 @@
+require 'quickbooks/model/markup_info'
+
+module Quickbooks
+  module Model
+    class ItemBasedExpenseLineDetail < BaseModel
+      xml_accessor :item_ref, :from => 'ItemRef', :as => BaseReference
+      xml_accessor :class_ref, :from => 'ClassRef', :as => BaseReference
+      xml_accessor :unit_price, :from => 'UnitPrice', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :rate_percent, :from => 'RatePercent', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :price_level_ref, :from => 'PriceLevelRef', :as => BaseReference
+      xml_accessor :markup_info, :from => 'MarkupInfo', :as => MarkupInfo
+      xml_accessor :quantity, :from => 'Qty', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :tax_code_ref, :from => 'TaxCodeRef', :as => BaseReference
+      xml_accessor :customer_ref, :from => 'CustomerRef', :as => BaseReference
+      xml_accessor :billable_status, :from => 'BillableStatus'
+
+      reference_setters :item_ref, :class_ref, :price_level_ref, :customer_ref, :tax_code_ref
+    end
+  end
+end

data/lib/quickbooks/model/item_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 ItemChange < ChangeModel
+      XML_NODE = "Item"
+    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