quickbooks-ruby-oauth2 0.6.1

data/lib/quickbooks/model/report.rb

@@ -0,0 +1,52 @@
+module Quickbooks
+  module Model
+    class Report < BaseModel
+
+      attr_accessor :xml
+
+      def all_rows
+        @all_rows ||= xml.css("ColData:first-child").map {|node| parse_row(node.parent) }
+      end
+
+      def columns
+        @columns ||= begin
+          nodes = xml.css('Column')
+          nodes.map do |node|
+            # There is also a ColType field, but it does not seem valuable to capture
+            node.at('ColTitle').content
+          end
+        end
+      end
+
+      def find_row(label)
+        all_rows.find {|r| r[0] == label }
+      end
+
+      private
+
+      # Parses the given row:
+      #   <Row type="Data">
+      #     <ColData value="Checking" id="35"/>
+      #     <ColData value="1201.00"/>
+      #     <ColData value="200.50"/>
+      #   </Row>
+      #
+      #  To:
+      #   ['Checking', BigDecimal(1201.00), BigDecimal(200.50)]
+      def parse_row(row_node)
+        row_node.elements.map.with_index do |el, i|
+          value = el.attr('value')
+
+          if i.zero? # Return the first column as a string, its the label.
+            value
+          elsif value.blank?
+            nil
+          else
+            BigDecimal(value)
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/quickbooks/model/sales_item_line_detail.rb

@@ -0,0 +1,16 @@
+module Quickbooks
+  module Model
+    class SalesItemLineDetail < 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 => Proc.new { |val| val.to_f }
+      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 :quantity, :from => 'Qty', :as => BigDecimal, :to_xml => Proc.new { |val| val.to_f }
+      xml_accessor :tax_code_ref, :from => 'TaxCodeRef', :as => BaseReference
+      xml_accessor :service_date, :from => 'ServiceDate', :as => Date
+
+      reference_setters :item_ref, :class_ref, :price_level_ref, :tax_code_ref
+    end
+  end
+end

data/lib/quickbooks/model/sales_receipt.rb

@@ -0,0 +1,65 @@
+module Quickbooks
+  module Model
+    class SalesReceipt < BaseModel
+      include DocumentNumbering
+      include GlobalTaxCalculation
+      include HasLineItems
+
+      XML_COLLECTION_NODE = "SalesReceipt"
+      XML_NODE = "SalesReceipt"
+      REST_RESOURCE = 'salesreceipt'
+
+      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 :txn_date, :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 :delivery_info, :from => 'DeliveryInfo', :as => DeliveryInfo
+      xml_accessor :ship_address, :from => 'ShipAddr', :as => PhysicalAddress
+      xml_accessor :po_number, :from => 'PONumber'
+      xml_accessor :ship_method_ref, :from => 'ShipMethodRef', :as => BaseReference
+      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 :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 :linked_transactions, :from => 'LinkedTxn', :as => [LinkedTransaction]
+      xml_accessor :email_status, :from => 'EmailStatus'
+      xml_accessor :exchange_rate, :from => 'ExchangeRate', :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
+
+      # backward-compatible alias
+      alias_attribute :placed_on, :txn_date
+
+      reference_setters
+
+      validate :line_item_size
+      validate :document_numbering
+
+      def billing_email_address=(email_address_string)
+        self.bill_email = EmailAddress.new(email_address_string)
+      end
+      alias_method :email=, :billing_email_address=  # backward backward compatibility to v0.4.6
+
+    end
+  end
+end

data/lib/quickbooks/model/sales_tax_rate_list.rb

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

data/lib/quickbooks/model/sub_total_line_detail.rb

@@ -0,0 +1,13 @@
+module Quickbooks
+  module Model
+    class SubTotalLineDetail < 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 => Proc.new { |val| val.to_f }
+      xml_accessor :quantity, :from => 'Qty', :as => BigDecimal, :to_xml => Proc.new { |val| val.to_f }
+      xml_accessor :tax_code_ref, :from => 'TaxCodeRef', :as => BaseReference
+
+      reference_setters :item_ref, :class_ref, :tax_code_ref
+    end
+  end
+end

data/lib/quickbooks/model/tax_agency.rb

@@ -0,0 +1,18 @@
+module Quickbooks
+  module Model
+    class TaxAgency < BaseModel
+      XML_COLLECTION_NODE = "TaxAgency"
+      XML_NODE = "TaxAgency"
+      REST_RESOURCE = "taxagency"
+
+      xml_accessor :id, :from => "Id"
+      xml_accessor :sync_token, :from => "SyncToken", :as => Integer
+      xml_accessor :meta_data, :from => "MetaData", :as => MetaData
+      xml_accessor :tax_tracked_on_purchases?, :from => "TaxTrackedOnPurchases"
+      xml_accessor :tax_tracked_on_sales?, :from => "TaxTrackedOnSales"
+      xml_accessor :display_name, :from => "DisplayName"
+
+      validates_presence_of :display_name
+    end
+  end
+end

data/lib/quickbooks/model/tax_code.rb

@@ -0,0 +1,21 @@
+module Quickbooks
+  module Model
+    class TaxCode < BaseModel
+      XML_COLLECTION_NODE = "TaxCode"
+      XML_NODE = "TaxCode"
+      REST_RESOURCE = "taxcode"
+
+      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 :description, :from => "Description"
+      xml_accessor :active?, :from => "Active"
+      xml_accessor :taxable?, :from => "Taxable"
+      xml_accessor :tax_group?, :from => "TaxGroup"
+      xml_accessor :sales_tax_rate_list, :from => "SalesTaxRateList", :as => SalesTaxRateList
+      xml_accessor :purchase_tax_rate_list, :from => "PurchaseTaxRateList", :as => PurchaseTaxRateList
+
+    end
+  end
+end

data/lib/quickbooks/model/tax_line.rb

@@ -0,0 +1,15 @@
+module Quickbooks
+  module Model
+    class TaxLine < BaseModel
+
+      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'
+
+      xml_accessor :tax_line_detail, :from => 'TaxLineDetail', :as => TaxLineDetail
+
+    end
+  end
+end

data/lib/quickbooks/model/tax_line_detail.rb

@@ -0,0 +1,16 @@
+module Quickbooks
+  module Model
+    class TaxLineDetail < BaseModel
+
+      xml_accessor :percent_based?, :from => 'PercentBased'
+      xml_accessor :net_amount_taxable, :from => 'NetAmountTaxable', :as => BigDecimal, :to_xml => Proc.new { |val| val.to_f }
+      xml_accessor :tax_inclusive_amount, :from => 'TaxInclusiveAmount', :as => BigDecimal, :to_xml => Proc.new { |val| val.to_f }
+      xml_accessor :override_delta_amount, :from => 'OverrideDeltaAmount', :as => BigDecimal, :to_xml => Proc.new { |val| val.to_f }
+      xml_accessor :tax_percent, :from => 'TaxPercent', :as => BigDecimal, :to_xml => Proc.new { |val| val.to_f }
+      xml_accessor :tax_rate_ref, :from => 'TaxRateRef', :as => BaseReference
+
+      reference_setters :tax_rate_ref
+      
+    end
+  end
+end

data/lib/quickbooks/model/tax_rate.rb

@@ -0,0 +1,28 @@
+module Quickbooks
+  module Model
+    class TaxRate < BaseModel
+      XML_COLLECTION_NODE = "TaxRate"
+      XML_NODE = "TaxRate"
+      REST_RESOURCE = "taxrate"
+
+      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 :description, :from => "Description"
+      xml_accessor :active?, :from => "Active"
+      xml_accessor :rate_value, :from => "RateValue", :as => BigDecimal, :to_xml => :to_f.to_proc
+      xml_accessor :agency_ref, :from => "AgencyRef", :as => BaseReference
+      xml_accessor :tax_return_line_ref, :from => "TaxReturnLineRef", :as => BaseReference
+      xml_accessor :special_tax_type, :from => "SpecialTaxType"
+      xml_accessor :display_type, :from => "DisplayType"
+      xml_accessor :effective_tax_rate, :from => "EffectiveTaxRate", :as => [EffectiveTaxRate]
+
+      validates_presence_of :name, :rate_value
+
+      reference_setters :agency_ref
+      reference_setters :tax_return_line_ref
+
+    end
+  end
+end

data/lib/quickbooks/model/tax_rate_detail.rb

@@ -0,0 +1,15 @@
+module Quickbooks
+  module Model
+    class TaxRateDetail < BaseModel
+      XML_COLLECTION_NODE = "TaxRateDetail"
+      XML_NODE = "TaxRateDetail"
+      REST_RESOURCE = "taxratedetail"
+
+      xml_accessor :tax_rate_ref, :from => "TaxRateRef", :as => BaseReference
+      xml_accessor :tax_type_applicable, :from => "TaxTypeApplicable"
+      xml_accessor :tax_order, :from => "TaxOrder"
+
+      reference_setters :tax_rate_ref
+    end
+  end
+end

data/lib/quickbooks/model/tax_rate_detail_line.rb

@@ -0,0 +1,23 @@
+module Quickbooks
+  module Model
+    class TaxRateDetailLine < BaseModel
+
+      xml_accessor :tax_rate_id, :from => "TaxRateId"
+      xml_accessor :tax_rate_name, :from => "TaxRateName"
+      xml_accessor :rate_value, :from => "RateValue"
+      xml_accessor :tax_agency_id, :from => "TaxAgencyId"
+      xml_accessor :tax_applicable_on, :from => 'TaxApplicableOn', :as => :text
+
+      validates :tax_rate_name, presence: true, length: { maximum: 100 }, if: Proc.new {|line| line.tax_rate_id.blank?}
+      validates :tax_agency_id, presence: true, numericality: {greater_than: 0}, if: Proc.new {|line| line.tax_rate_id.blank?}
+      validates :rate_value, presence: true, numericality: {less_than_or_equal_to: 100},  if: Proc.new {|line| line.tax_rate_id.blank?}
+      validates :tax_rate_id, numericality: true, if: Proc.new {|line| line.tax_rate_name.blank? && tax_agency_id.blank? && rate_value.blank? }
+
+      validates :tax_applicable_on, inclusion: {in: %w(Sales Purchase)}
+
+      def to_json
+        attributes.inject({}){|mem, item| mem[item.first.camelize] = item.last if item.last.present?; mem}
+      end
+    end
+  end
+end

data/lib/quickbooks/model/tax_service.rb

@@ -0,0 +1,52 @@
+module Quickbooks
+  module Model
+    class TaxService < BaseModelJSON
+      REST_RESOURCE = "taxservice/taxcode"
+
+      xml_accessor :tax_code_id, :from => "TaxCodeId"
+      xml_accessor :tax_code, :from => "TaxCode"
+      xml_accessor :tax_rate_details, :from => 'TaxRateDetails', :as => [TaxRateDetailLine]
+
+      validates :tax_code, presence: true, length: { maximum: 100 }
+
+      validate :check_details_item
+
+      def initialize(options = {})
+        self.tax_rate_details = options['tax_rate_details'] || []
+        super
+      end
+
+      def self.from_json(response)
+        result = JSON.parse(response)
+        if result.present?
+          ts = Quickbooks::Model::TaxService.new
+          ts.tax_code = result['TaxCode']
+          ts.tax_code_id = result['TaxCodeId']
+          result['TaxRateDetails'].each do |item|
+            attrs = item.keys.inject({}){|mem, k| mem[k.underscore] = item[k]; mem}
+            ts.tax_rate_details << Quickbooks::Model::TaxRateDetailLine.new(attrs)
+          end
+          return ts
+        else
+          return nil
+        end
+      end
+
+      def check_details_item
+        if tax_rate_details.blank?
+          errors.add(:tax_rate_details, "must have at least one item")
+        else
+          tax_rate_details.each do |line|
+            unless line.valid?
+              errors.add(:base, line.errors.full_messages.join(', '))
+            end
+          end
+          names = tax_rate_details.map(&:tax_rate_name).uniq
+          if names.size < tax_rate_details.size
+            errors.add(:tax_rate_name, "Duplicate Tax Rate Name")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/quickbooks/model/telephone_number.rb

@@ -0,0 +1,13 @@
+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/term.rb

@@ -0,0 +1,28 @@
+module Quickbooks
+  module Model
+    class Term < BaseModel
+      XML_COLLECTION_NODE = "Term"
+      XML_NODE = "Term"
+      REST_RESOURCE = 'term'
+
+      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 :active?, :from => 'Active'
+      xml_accessor :type, :from => 'Type'
+      xml_accessor :discount_percent, :from => 'DiscountPercent', :as => BigDecimal
+      xml_accessor :due_days, :from => 'DueDays', :as => Integer
+      xml_accessor :discount_days, :from => 'DiscountDays', :as => Integer
+      xml_accessor :day_of_month_due, :from => 'DayOfMonthDue', :as => Integer
+      xml_accessor :due_next_month_days, :from => 'DueNextMonthDays', :as => Integer
+      xml_accessor :discount_day_of_month, :from => 'DiscountDayOfMonth', :as => Integer
+      xml_accessor :attachable_ref, :from => 'AttachableRef', :as => BaseReference
+
+      validates_presence_of :name
+
+      reference_setters :attachable_ref
+
+    end
+  end
+end

data/lib/quickbooks/model/time_activity.rb

@@ -0,0 +1,79 @@
+module Quickbooks
+  module Model
+    class TimeActivity < BaseModel
+      XML_COLLECTION_NODE = "TimeActivity"
+      XML_NODE = "TimeActivity"
+      REST_RESOURCE = 'timeactivity'
+
+      NAMEOF_OPTIONS = %w( Employee Vendor )
+
+      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 :txn_date, :from => 'TxnDate'
+      xml_accessor :name_of, :from => 'NameOf'
+
+      xml_accessor :employee_ref, :from => 'EmployeeRef', :as => BaseReference
+      xml_accessor :vendor_ref, :from => 'VendorRef', :as => BaseReference
+      xml_accessor :customer_ref, :from => 'CustomerRef', :as => BaseReference
+      xml_accessor :item_ref, :from => 'ItemRef', :as => BaseReference
+      xml_accessor :class_ref, :from => 'ClassRef', :as => BaseReference
+
+      xml_accessor :billable_status, :from => 'BillableStatus'
+      xml_accessor :taxable, :from => 'Taxable'
+      xml_accessor :hourly_rate, :from => 'HourlyRate'
+      xml_accessor :minutes, :from => 'Minutes', :as => Integer
+      xml_accessor :hours, :from => 'Hours', :as => Integer
+      xml_accessor :break_minutes, :from => 'BreakMinutes', :as => Integer
+      xml_accessor :break_hours, :from => 'BreakHours', :as => Integer
+      xml_accessor :description, :from => 'Description'
+
+      xml_accessor :attachable_ref, :from => 'AttachableRef', :as => BaseReference
+      xml_accessor :department_ref, :from => 'DepartmentRef', :as => BaseReference
+      xml_accessor :start_time, :from => 'StartTime', :as => DateTime
+      xml_accessor :end_time, :from => 'EndTime', :as => DateTime
+      xml_accessor :time_zone, :from => 'TimeZone'
+
+      reference_setters
+
+      # == Validations
+      validates_inclusion_of :name_of, :in => NAMEOF_OPTIONS
+      validate :existence_of_employee_ref, :if => Proc.new { |ta| ta.name_of == "Employee" }
+      validate :existence_of_vendor_ref, :if => Proc.new { |ta| ta.name_of == "Vendor" }
+      validates :description, length: { maximum: 4000 }
+
+      def existence_of_employee_ref
+        if employee_ref.nil? || (employee_ref && employee_ref.value == 0)
+          errors.add(:employee_ref, "EmployeeRef is required and must be a non-zero value.")
+        end
+      end
+
+      def existence_of_vendor_ref
+        if vendor_ref.nil? || (vendor_ref && vendor_ref.value == 0)
+          errors.add(:vendor_ref, "VendorRef is required and must be a non-zero value.")
+        end
+      end
+
+      def valid_for_update?
+        if sync_token.nil?
+          errors.add(:sync_token, "Missing required attribute SyncToken for update")
+        end
+        errors.empty?
+      end
+
+      def valid_for_create?
+        valid?
+        errors.empty?
+      end
+
+      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
+
+    end
+  end
+end

data/lib/quickbooks/model/transaction_tax_detail.rb

@@ -0,0 +1,12 @@
+module Quickbooks
+  module Model
+    class TransactionTaxDetail < BaseModel
+
+      xml_accessor :txn_tax_code_ref, :from => 'TxnTaxCodeRef', :as => BaseReference
+      xml_accessor :total_tax, :from => 'TotalTax', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :lines, :from => 'TaxLine', :as => [TaxLine]
+
+      reference_setters :txn_tax_code_ref
+    end
+  end
+end

data/lib/quickbooks/model/transfer.rb

@@ -0,0 +1,21 @@
+module Quickbooks
+  module Model
+    class Transfer < BaseModel
+      XML_COLLECTION_NODE = "Transfer"
+      XML_NODE = "Transfer"
+      REST_RESOURCE = 'transfer'
+
+      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 :currency_ref, :from => 'CurrencyRef', :as => BaseReference
+      xml_accessor :private_note, :from => 'PrivateNote'
+      xml_accessor :from_account_ref, :from => 'FromAccountRef', :as => BaseReference
+      xml_accessor :to_account_ref, :from => 'ToAccountRef', :as => BaseReference
+      xml_accessor :amount, :from => 'Amount', :as => BigDecimal, :to_xml => to_xml_big_decimal
+
+      reference_setters :currency_ref, :to_account_ref, :from_account_ref
+    end
+  end
+end

data/lib/quickbooks/model/upload.rb

@@ -0,0 +1,35 @@
+module Quickbooks
+  module Model
+    class Upload < BaseModel
+      xml_convention :camelcase
+
+      #xml_accessor :attache, :as => Attachable
+
+    end
+  end
+end
+
+=begin
+
+Response XML:
+
+<IntuitResponse xmlns="http://schema.intuit.com/finance/v3" time="2014-08-18T09:58:04.583-07:00">
+	<AttachableResponse>
+		<Attachable domain="QBO" sparse="false">
+			<Id>2700000000001439108</Id>
+			<SyncToken>0</SyncToken>
+			<MetaData>
+				<CreateTime>2014-08-18T09:58:06-07:00</CreateTime>
+				<LastUpdatedTime>2014-08-18T09:58:06-07:00</LastUpdatedTime>
+			</MetaData>
+			<FileName>monkey.jpg</FileName>
+			<FileAccessUri>/v3/company/1002341430/download/2700000000001439108</FileAccessUri>
+			<TempDownloadUri>https://intuit-qbo-prod-30.s3.amazonaws.com/1002341430%2Fattachments%2Fmonkey.jpg?Expires=1408381986&amp;AWSAccessKeyId=AKIAJEXDXKNYCBUNCCCQ&amp;Signature=WOVACYm6zi1rM5EGZRq3d3AMSM0%3D</TempDownloadUri>
+			<Size>105840</Size>
+			<ContentType>image/jpeg</ContentType>
+			<ThumbnailFileAccessUri>/v3/company/1002341430/attachable-thumbnail/2700000000001439108</ThumbnailFileAccessUri>
+		</Attachable>
+	</AttachableResponse>
+</IntuitResponse>
+
+=end

data/lib/quickbooks/model/validator.rb

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

data/lib/quickbooks/model/vendor.rb

@@ -0,0 +1,53 @@
+# == Business Rules
+# * The DisplayName, GivenName, MiddleName, FamilyName, and PrintOnCheckName attributes must not contain a colon,":".
+# * The DisplayName attribute must be unique across all other customers, employees, vendors, and other names.
+# * The PrimaryEmailAddress attribute must contain an at sign, "@," and dot, ".".
+# * Either the DisplayName attribute or at least one of Title, GivenName, MiddleName, FamilyName, Suffix, or FullyQualifiedName attributes are required during create.
+
+module Quickbooks
+  module Model
+    class Vendor < BaseModel
+      XML_COLLECTION_NODE = "Vendor"
+      XML_NODE = "Vendor"
+      REST_RESOURCE = 'vendor'
+      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 :attachable_ref, :from => 'AttachableRef', :as => BaseReference
+      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 :company_name, :from => 'CompanyName'
+      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 :alternate_phone, :from => 'AlternatePhone', :as => TelephoneNumber
+      xml_accessor :mobile_phone, :from => 'Mobile', :as => TelephoneNumber
+      xml_accessor :fax_phone, :from => 'Fax', :as => TelephoneNumber
+      xml_accessor :primary_email_address, :from => 'PrimaryEmailAddr', :as => EmailAddress
+      xml_accessor :web_site, :from => 'WebAddr', :as => WebSiteAddress
+      xml_accessor :billing_address, :from => 'BillAddr', :as => PhysicalAddress
+      xml_accessor :other_contact_info, :from => 'OtherContactInfo', :as => OtherContactInfo
+      xml_accessor :tax_identifier, :from => 'TaxIdentifier'
+      xml_accessor :term_ref, :from => 'TermRef', :as => BaseReference
+      xml_accessor :balance, :from => 'Balance', :as => BigDecimal, :to_xml => Proc.new { |val| val.to_f }
+      xml_accessor :account_number, :from => 'AcctNum'
+      xml_accessor :is_1099?, :from => 'Vendor1099'
+      xml_accessor :currency_ref, :from => 'CurrencyRef', :as => BaseReference
+
+      #== Validations
+      validate :names_cannot_contain_invalid_characters
+      validate :email_address_is_valid
+
+      reference_setters
+
+    end
+  end
+end

data/lib/quickbooks/model/vendor_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 VendorChange < ChangeModel
+      XML_NODE = "Vendor"
+    end
+  end
+end