quickbooks-ruby-oauth2 0.6.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2c9c2d528c57e9e6d09996f5074a207f9ed11c52c8f41b1577d8a659e1b803bc
+  data.tar.gz: 900287d6e0a8d4a86065d89d657c32bb821dfc28503ac4203ffefd55f2fb1250
+SHA512:
+  metadata.gz: 11486f7112333779da49608738d6ce7affd6fc37aed76d8f0ffe3483c09f25d454b6b35a80b82d679e2c13cbc0cfa2f5e1038548369820ea8590821d2d61813a
+  data.tar.gz: 9b30b67dcc88b031a685abea47ac9b24883f012da7d75ab7b49e8c47c28b6bbb8115aead480f2fcc9cfd3951a0b6880322900b21273195ba669c5c0249e87e28

data/lib/quickbooks/faraday/middleware/gzip.rb

@@ -0,0 +1,72 @@
+# https://github.com/lostisland/faraday_middleware/blob/master/lib/faraday_middleware/gzip.rb
+
+require 'faraday'
+
+# Middleware to automatically decompress response bodies. If the
+# "Accept-Encoding" header wasn't set in the request, this sets it to
+# "gzip,deflate" and appropriately handles the compressed response from the
+# server. This resembles what Ruby 1.9+ does internally in Net::HTTP#get.
+#
+# This middleware is NOT necessary when these adapters are used:
+# - net_http on Ruby 1.9+
+# - net_http_persistent on Ruby 2.0+
+# - em_http
+class Gzip < Faraday::Middleware
+  dependency 'zlib'
+
+  ACCEPT_ENCODING = 'Accept-Encoding'.freeze
+  CONTENT_ENCODING = 'Content-Encoding'.freeze
+  CONTENT_LENGTH = 'Content-Length'.freeze
+  SUPPORTED_ENCODINGS = 'gzip,deflate,br'.freeze
+  RUBY_ENCODING = '1.9'.respond_to?(:force_encoding)
+
+  def call(env)
+    env[:request_headers][ACCEPT_ENCODING] ||= SUPPORTED_ENCODINGS
+    @app.call(env).on_complete do |response_env|
+      case response_env[:response_headers][CONTENT_ENCODING]
+      when 'gzip'
+        reset_body(response_env, &method(:uncompress_gzip))
+      when 'deflate'
+        reset_body(response_env, &method(:inflate))
+      when 'br'
+        reset_body(response_env, &method(:brotli_inflate))
+      end
+    end
+  end
+
+  def reset_body(env)
+    env[:body] = yield(env[:body])
+    env[:response_headers].delete(CONTENT_ENCODING)
+    env[:response_headers][CONTENT_LENGTH] = env[:body].length
+  end
+
+  def uncompress_gzip(body)
+    io = StringIO.new(body)
+    gzip_reader = if RUBY_ENCODING
+      Zlib::GzipReader.new(io, :encoding => 'ASCII-8BIT')
+    else
+      Zlib::GzipReader.new(io)
+    end
+    gzip_reader.read
+  end
+
+  def inflate(body)
+    # Inflate as a DEFLATE (RFC 1950+RFC 1951) stream
+    Zlib::Inflate.inflate(body)
+  rescue Zlib::DataError
+    # Fall back to inflating as a "raw" deflate stream which
+    # Microsoft servers return
+    inflate = Zlib::Inflate.new(-Zlib::MAX_WBITS)
+    begin
+      inflate.inflate(body)
+    ensure
+      inflate.close
+    end
+  end
+
+  def brotli_inflate(body)
+    self.class.dependency 'brotli'
+
+    Brotli.inflate(body)
+  end
+end

data/lib/quickbooks/model/access_token_response.rb

@@ -0,0 +1,29 @@
+module Quickbooks
+  module Model
+    class AccessTokenResponse < BaseModel
+      xml_convention :camelcase
+      xml_accessor :error_code, :from => 'ErrorCode'
+      xml_accessor :error_message, :from => 'ErrorMessage'
+      xml_accessor :token,  :from => 'OAuthToken'
+      xml_accessor :secret, :from => 'OAuthTokenSecret'
+      xml_accessor :server_time, :from => 'ServerTime', :as => Time
+
+      def error?
+        error_code.to_i != 0
+      end
+
+    end
+  end
+end
+
+=begin
+<?xml version="1.0"?>
+<ReconnectResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://platform.intuit.com/api/v1">
+  <ErrorMessage/>
+  <ErrorCode>0</ErrorCode>
+  <ServerTime>2012-01-04T19:21:21.0782072Z</ServerTime>
+  <OAuthToken>qye2eIdQ5H5yMyrlJflUWh712xfFXjyNnW1MfbC0rz04TfCP</OAuthToken>
+  <OAuthTokenSecret>cyDeUNQTkFzoR0KkDn7viN6uLQxWTobeEUKW7I79</OAuthTokenSecret>
+</ReconnectResponse>
+
+=end

data/lib/quickbooks/model/account.rb

@@ -0,0 +1,78 @@
+module Quickbooks
+  module Model
+    class Account < BaseModel
+      XML_COLLECTION_NODE = "Account"
+      XML_NODE = "Account"
+      REST_RESOURCE = 'account'
+
+      ASSET = 'Asset'
+      EQUITY = 'Equity'
+      EXPENSE = 'Expense'
+      LIABILITY = 'Liability'
+      REVENUE = 'Revenue'
+
+      ACCOUNT_CLASSIFICATION = [ASSET, EQUITY, EXPENSE, LIABILITY, REVENUE]
+
+      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 :has_attachment?, :from => 'HasAttachment'
+      xml_accessor :name, :from => 'Name'
+      xml_accessor :description, :from => 'Description'
+      xml_accessor :fully_qualified_name, :from => 'FullyQualifiedName' # ReadOnly
+
+      xml_accessor :sub_account?, :from => 'SubAccount'
+      xml_accessor :parent_ref, :from => 'ParentRef', :as => BaseReference
+
+      xml_accessor :active?, :from => 'Active'
+
+      xml_accessor :classification, :from => 'Classification'
+      xml_accessor :account_type, :from => 'AccountType'
+      xml_accessor :account_sub_type, :from => 'AccountSubType'
+
+      xml_accessor :acct_num, :from => 'AcctNum'
+      xml_accessor :bank_num, :from => 'BankNum'
+
+      xml_accessor :current_balance, :from => 'CurrentBalance', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :current_balance_with_sub_accounts, :from => 'CurrentBalanceWithSubAccounts', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :opening_balance, :from => 'OpeningBalance', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :opening_balance_date, :from => 'OpeningBalanceDate', :as => DateTime
+      xml_accessor :currency_ref, :from => 'CurrencyRef', :as => BaseReference
+      xml_accessor :tax_account?, :from => 'TaxAccount'
+      xml_accessor :tax_code_ref, :from => 'TaxCodeRef', :as => BaseReference
+
+      reference_setters :parent_ref, :currency_ref, :tax_code_ref
+
+      #== Validations
+      validates_inclusion_of :classification, :in => ACCOUNT_CLASSIFICATION
+      validates_length_of :name, :minimum => 1, :maximum => 100
+      validate :name_cannot_contain_invalid_characters
+
+      def name_cannot_contain_invalid_characters
+        if name && (name.index(':') || name.index('"'))
+          errors.add('name', ":#{name} cannot contain a colon (:) or double quotes (\").")
+        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/account_based_expense_line_detail.rb

@@ -0,0 +1,15 @@
+module Quickbooks
+  module Model
+    class AccountBasedExpenseLineDetail < BaseModel
+      xml_accessor :customer_ref, :from => 'CustomerRef', :as => BaseReference
+      xml_accessor :class_ref, :from => 'ClassRef', :as => BaseReference
+      xml_accessor :account_ref, :from => 'AccountRef', :as => BaseReference
+      xml_accessor :billable_status, :from => 'BillableStatus'
+      xml_accessor :tax_amount, :from => 'UnitPrice', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :tax_code_ref, :from => 'TaxCodeRef', :as => BaseReference
+
+      reference_setters :customer_ref, :class_ref, :account_ref, :tax_code_ref
+
+    end
+  end
+end

data/lib/quickbooks/model/attachable.rb

@@ -0,0 +1,33 @@
+require 'quickbooks/model/attachable_ref'
+
+module Quickbooks
+  module Model
+    class Attachable < BaseModel
+
+      XML_COLLECTION_NODE = "Attachable"
+      XML_NODE = "Attachable"
+      REST_RESOURCE = 'attachable'
+
+      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, :as => AttachableRef
+      xml_accessor :file_name
+      xml_accessor :file_access_uri
+      xml_accessor :temp_download_uri
+      xml_accessor :size
+      xml_accessor :content_type
+      xml_accessor :category
+      xml_accessor :lat
+      xml_accessor :long
+      xml_accessor :place_name
+      xml_accessor :note
+      xml_accessor :tag
+      xml_accessor :thumbnail_file_access_uri
+      xml_accessor :thumbnail_temp_download_uri
+
+      reference_setters :attachable_ref
+
+    end
+  end
+end

data/lib/quickbooks/model/attachable_ref.rb

@@ -0,0 +1,22 @@
+require 'quickbooks/model/entity_ref'
+require 'quickbooks/model/custom_field'
+
+module Quickbooks
+  module Model
+    class AttachableRef < BaseModel
+      xml_accessor :entity_ref, :as => BaseReference
+      xml_accessor :line_info
+      xml_accessor :include_on_send?
+      xml_accessor :inactive?
+      xml_accessor :no_ref_only?
+      xml_accessor :custom_fields, :as => [CustomField]
+
+      def initialize(an_entity_ref = nil)
+        if an_entity_ref
+          self.entity_ref = an_entity_ref
+        end
+      end
+
+    end
+  end
+end

data/lib/quickbooks/model/base_model.rb

@@ -0,0 +1,120 @@
+module Quickbooks
+  module Model
+    class BaseModel
+      include Definition
+      include ActiveModel::Validations
+      include Validator
+      include ROXML
+
+      xml_convention :camelcase
+
+      def initialize(attributes={})
+        attributes.each {|key, value| public_send("#{key}=", value) }
+      end
+
+      # ROXML doesnt insert the namespaces into generated XML so we need to do it ourselves
+      # insert the static namespaces in the first opening tag that matches the +model_name+
+      def to_xml_inject_ns(model_name, options = {})
+        s = StringIO.new
+        xml = to_xml(options).write_to(s, :indent => 0, :indent_text => '')
+        destination_name = options.fetch(:destination_name, nil)
+        destination_name ||= model_name
+
+        sparse = options.fetch(:sparse, false)
+        sparse_string = %{sparse="#{sparse}"}
+        step1 = s.string.sub("<#{model_name}>", "<#{destination_name} #{Quickbooks::Service::BaseService::XML_NS} #{sparse_string}>")
+        step2 = step1.sub("</#{model_name}>", "</#{destination_name}>")
+        step2
+      end
+
+      def as_json(options = nil)
+        options = {} if options.nil?
+        except_conditions = ["roxml_references"]
+        except_conditions << options[:except]
+        options[:except] = except_conditions.flatten.uniq.compact
+        super(options)
+      end
+
+      def to_xml_ns(options = {})
+        to_xml_inject_ns(self.class::XML_NODE, options)
+      end
+
+      delegate :[], :fetch, :to => :attributes
+
+      def attributes
+        attributes = self.class.attribute_names.map do |name|
+          value = public_send(name)
+          value = value.attributes if value.respond_to?(:attributes)
+          [name, value]
+        end
+
+        HashWithIndifferentAccess[attributes]
+      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 }
+        end
+
+        def attribute_names
+          roxml_attrs.map(&:accessor)
+        end
+
+        # These can be over-ridden in each model object as needed
+        def resource_for_collection
+          self::REST_RESOURCE
+        end
+
+        def resource_for_singular
+          self::REST_RESOURCE
+        end
+
+        # Automatically generate an ID setter.
+        # Example:
+        #   reference_setters :discount_ref
+        # Would generate a method like:
+        # def discount_id=(id)
+        #    self.discount_ref = BaseReference.new(id)
+        # end
+        def reference_setters(*args)
+          references = args.empty? ? reference_attrs : args
+
+          references.each do |attribute|
+            last_index = attribute.to_s.rindex('_ref')
+            field_name = !last_index.nil? ? attribute.to_s.slice(0, last_index) : attribute
+            method_name = "#{field_name}_id=".to_sym
+            unless instance_methods(false).include?(method_name)
+              method_definition = <<-METH
+              def #{method_name}(id)
+                self.#{attribute} = BaseReference.new(id)
+              end
+              METH
+              class_eval(method_definition)
+            end
+          end
+        end
+
+        def reference_attrs
+          matches = roxml_attrs.select{|attr| attr.sought_type == Quickbooks::Model::BaseReference}.map{|attr| attr.accessor}
+        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
+end

data/lib/quickbooks/model/base_model_json.rb

@@ -0,0 +1,16 @@
+module Quickbooks
+  module Model
+    class BaseModelJSON < BaseModel
+
+      def to_json
+        params = {}
+        attributes.each_pair do |k, v|
+          next if v.blank?
+          params[k.camelize] = v.is_a?(Array) ? v.inject([]){|mem, item| mem << item.to_json; mem} : v
+        end
+        params.to_json
+      end
+
+    end
+  end
+end

data/lib/quickbooks/model/base_reference.rb

@@ -0,0 +1,23 @@
+module Quickbooks
+  module Model
+    class BaseReference < BaseModel
+      xml_convention :camelcase
+      xml_accessor :name, :from => '@name' # Attribute with name 'name'
+      xml_accessor :value, :from => :content
+      xml_accessor :type, :from => '@type' # Attribute with name 'type'
+
+      def initialize(value=nil, attributes={})
+        self.value = value
+        attributes.each {|key, value| public_send("#{key}=", value) }
+      end
+
+      def to_i
+        self.value.to_i
+      end
+
+      def to_s
+        self.value.to_s
+      end
+    end
+  end
+end

data/lib/quickbooks/model/batch_request.rb

@@ -0,0 +1,45 @@
+class Quickbooks::Model::BatchRequest < Quickbooks::Model::BaseModel
+  class BatchItemRequest
+    include ROXML
+    XML_NODE = "BatchItemRequest"
+    xml_name XML_NODE
+
+    xml_accessor :operation, :from => "@operation"
+    xml_accessor :bId, :from => "@bId"
+
+    # Supported Entities
+    xml_accessor :account, from: "Account", as: Quickbooks::Model::Account
+    xml_accessor :bill_payment, from: "BillPayment", as: Quickbooks::Model::BillPayment
+    xml_accessor :bill, from: "Bill", as: Quickbooks::Model::Bill
+    xml_accessor :credit_memo, from: "CreditMemo", as: Quickbooks::Model::CreditMemo
+    xml_accessor :customer, from: "Customer", as: Quickbooks::Model::Customer
+    xml_accessor :invoice, from: "Invoice", as: Quickbooks::Model::Invoice
+    xml_accessor :item, from: "Item", as: Quickbooks::Model::Item
+    xml_accessor :journal_entry, from: "JournalEntry", as: Quickbooks::Model::JournalEntry
+    xml_accessor :payment, from: "Payment", as: Quickbooks::Model::Payment
+    xml_accessor :purchase_order, from: "PurchaseOrder", as: Quickbooks::Model::PurchaseOrder
+    xml_accessor :purchase, from: "Purchase", as: Quickbooks::Model::Purchase
+    xml_accessor :refund_receipt, from: "RefundReceipt", as: Quickbooks::Model::RefundReceipt
+    xml_accessor :sales_receipt, from: "SalesReceipt", as: Quickbooks::Model::SalesReceipt
+    xml_accessor :time_activity, from: "TimeActivity", as: Quickbooks::Model::TimeActivity
+    xml_accessor :vendor, from: "Vendor", as: Quickbooks::Model::Vendor
+  end
+
+  XML_COLLECTION_NODE = "IntuitBatchRequest"
+  XML_NODE = "IntuitBatchRequest"
+  REST_RESOURCE = 'batch'
+  xml_name XML_NODE
+  xml_accessor :request_items, from: "BatchItemRequest", as: [Quickbooks::Model::BatchRequest::BatchItemRequest]
+
+  def initialize
+    self.request_items = []
+  end
+
+  def add(batch_item_id, batch_item, operation)
+    bir = Quickbooks::Model::BatchRequest::BatchItemRequest.new
+    bir.operation = operation
+    bir.bId = batch_item_id
+    bir.send("#{batch_item.class::XML_NODE.underscore}=", batch_item)
+    self.request_items << bir
+  end
+end

data/lib/quickbooks/model/batch_response.rb

@@ -0,0 +1,33 @@
+class Quickbooks::Model::BatchResponse < Quickbooks::Model::BaseModel
+  class BatchItemResponse
+    include ROXML
+    xml_name  "BatchItemResponse"
+
+    xml_accessor :bId, :from => "@bId"
+    xml_accessor :fault, :from => 'Fault', :as => Quickbooks::Model::Fault
+
+    # Supported Entities
+    xml_accessor :account, from: "Account", as: Quickbooks::Model::Account
+    xml_accessor :bill_payment, from: "BillPayment", as: Quickbooks::Model::BillPayment
+    xml_accessor :bill, from: "Bill", as: Quickbooks::Model::Bill
+    xml_accessor :credit_memo, from: "CreditMemo", as: Quickbooks::Model::CreditMemo
+    xml_accessor :customer, from: "Customer", as: Quickbooks::Model::Customer
+    xml_accessor :invoice, from: "Invoice", as: Quickbooks::Model::Invoice
+    xml_accessor :item, from: "Item", as: Quickbooks::Model::Item
+    xml_accessor :journal_entry, from: "JournalEntry", as: Quickbooks::Model::JournalEntry
+    xml_accessor :payment, from: "Payment", as: Quickbooks::Model::Payment
+    xml_accessor :purchase_order, from: "PurchaseOrder", as: Quickbooks::Model::PurchaseOrder
+    xml_accessor :purchase, from: "Purchase", as: Quickbooks::Model::Purchase
+    xml_accessor :refund_receipt, from: "RefundReceipt", as: Quickbooks::Model::RefundReceipt
+    xml_accessor :sales_receipt, from: "SalesReceipt", as: Quickbooks::Model::SalesReceipt
+    xml_accessor :time_activity, from: "TimeActivity", as: Quickbooks::Model::TimeActivity
+    xml_accessor :vendor, from: "Vendor", as: Quickbooks::Model::Vendor
+
+    def fault?
+      fault
+    end
+  end
+
+  xml_name  "IntuitResponse"
+  xml_accessor :response_items, :from => :BatchItemResponse, as: [Quickbooks::Model::BatchResponse::BatchItemResponse]
+end

data/lib/quickbooks/model/bill.rb

@@ -0,0 +1,45 @@
+module Quickbooks
+  module Model
+    class Bill < BaseModel
+      include GlobalTaxCalculation
+      include HasLineItems
+
+      XML_COLLECTION_NODE = "Bill"
+      XML_NODE = "Bill"
+      REST_RESOURCE = 'bill'
+
+      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 :department_ref, :from => 'DepartmentRef', :as => BaseReference
+
+      xml_accessor :line_items, :from => 'Line', :as => [BillLineItem]
+
+      xml_accessor :private_note, :from => 'PrivateNote'
+
+      xml_accessor :vendor_ref, :from => 'VendorRef', :as => BaseReference
+      xml_accessor :payer_ref, :from => 'PayerRef', :as => BaseReference
+      xml_accessor :sales_term_ref, :from => 'SalesTermRef', :as => BaseReference
+      xml_accessor :attachable_ref, :from => 'AttachableRef', :as => BaseReference
+      xml_accessor :ap_account_ref, :from => 'APAccountRef', :as => BaseReference
+
+      xml_accessor :due_date, :from => 'DueDate', :as => Date
+      xml_accessor :remit_to_address, :from => 'RemitToAddr', :as => PhysicalAddress
+      xml_accessor :ship_address, :from => 'ShipAddr', :as => PhysicalAddress
+      xml_accessor :exchange_rate, :from => 'ExchangeRate', :as => BigDecimal, :to_xml => to_xml_big_decimal
+      xml_accessor :balance, :from => 'Balance', :as => BigDecimal, :to_xml => to_xml_big_decimal
+
+      # readonly
+      xml_accessor :bill_email, :from => 'BillEmail', :as => EmailAddress
+      xml_accessor :reply_email, :from => 'ReplyEmail', :as => EmailAddress
+      xml_accessor :total, :from => 'TotalAmt', :as => BigDecimal
+      xml_accessor :currency_ref, :from => 'CurrencyRef', :as => BaseReference
+
+      validate :line_item_size
+
+      reference_setters :department_ref, :vendor_ref, :payer_ref, :sales_term_ref, :currency_ref, :attachable_ref, :ap_account_ref
+    end
+  end
+end

data/lib/quickbooks/model/bill_line_item.rb

@@ -0,0 +1,42 @@
+module Quickbooks
+  module Model
+    class BillLineItem < BaseModel
+
+      #== Constants
+      ACCOUNT_BASED_EXPENSE_LINE_DETAIL = 'AccountBasedExpenseLineDetail'
+      ITEM_BASED_EXPENSE_LINE_DETAIL = 'ItemBasedExpenseLineDetail'
+
+      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 :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
+
+      def account_based_expense_item!
+        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_item!
+        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/bill_payment.rb

@@ -0,0 +1,40 @@
+module Quickbooks
+  module Model
+    class BillPayment < BaseModel
+      include HasLineItems
+
+      XML_COLLECTION_NODE = "BillPayment"
+      XML_NODE = "BillPayment"
+      REST_RESOURCE = 'billpayment'
+
+      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 :line_items, :from => 'Line', :as => [BillPaymentLineItem]
+
+      xml_accessor :private_note, :from => 'PrivateNote'
+
+      xml_accessor :vendor_ref, :from => 'VendorRef', :as => BaseReference
+      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 :ap_account_ref, :from => 'APAccountRef', :as => BaseReference
+      xml_accessor :pay_type, :from => 'PayType'
+      xml_accessor :process_bill_payment?, :from => 'ProcessBillPayment'
+
+      ## Required if PayType is Check.
+      xml_accessor :check_payment, :from => 'CheckPayment', :as => BillPaymentCheck
+      ## Required if PayType is CreditCard.
+      xml_accessor :credit_card_payment, :from => 'CreditCardPayment', :as => BillPaymentCreditCard
+
+      xml_accessor :total, :from => 'TotalAmt', :as => BigDecimal
+
+      validate :line_item_size
+
+      reference_setters
+    end
+  end
+end

data/lib/quickbooks/model/bill_payment_check.rb

@@ -0,0 +1,12 @@
+module Quickbooks
+  module Model
+    class BillPaymentCheck < BaseModel
+      xml_accessor :bank_account_ref, :from => 'BankAccountRef', :as => BaseReference
+      xml_accessor :print_status, :from => 'PrintStatus'
+      xml_accessor :check_detail, :from => 'CheckDetail', :as => CheckPayment
+      xml_accessor :payee_address, :from => 'PayeeAddr', :as => PhysicalAddress
+
+      reference_setters :bank_account_ref
+    end
+  end
+end

data/lib/quickbooks/model/bill_payment_credit_card.rb

@@ -0,0 +1,10 @@
+module Quickbooks
+  module Model
+    class BillPaymentCreditCard < BaseModel
+      xml_accessor :cc_account_ref, :from => 'CCAccountRef', :as => BaseReference
+      xml_accessor :cc_detail, :from => 'CCDetail', :as => CreditCardPayment
+
+      reference_setters
+    end
+  end
+end