quickeebooks 0.0.6 → 0.0.7

data/README.md

@@ -300,6 +300,13 @@ _Note:_ it is up to you the caller to remove or clean up the file when you are d
 
 Cody Caughlan
 
+## Credits
+
+Thank you for the contributions:
+
+* [Walter McGinnis](https://github.com/walter)
+* [Simon Wistow](https://github.com/simonwistow)
+
 ## License
 
 The MIT License

data/lib/quickeebooks.rb

@@ -51,6 +51,11 @@ module ROXML
   end
 end
 
+#== Shared
+
+# Services
+require 'quickeebooks/shared/service/filter'
+
 #== Online
 
 # Models
@@ -111,9 +116,17 @@ require 'quickeebooks/windows/model/external_key'
 require 'quickeebooks/windows/model/ship_method'
 require 'quickeebooks/windows/model/sales_tax'
 require 'quickeebooks/windows/model/customer_msg'
-
+require 'quickeebooks/windows/model/company_meta_data'
+require 'quickeebooks/windows/model/payment'
+require 'quickeebooks/windows/model/payment_header'
+require 'quickeebooks/windows/model/payment_line_item'
+require 'quickeebooks/windows/model/payment_detail'
+require 'quickeebooks/windows/model/credit_card'
+require 'quickeebooks/windows/model/credit_charge_info'
+require 'quickeebooks/windows/model/credit_charge_response'
 
 # Services
+require 'quickeebooks/windows/service/filter'
 require 'quickeebooks/windows/service/service_base'
 require 'quickeebooks/windows/service/account'
 require 'quickeebooks/windows/service/customer'
@@ -123,3 +136,5 @@ require 'quickeebooks/windows/service/sales_rep'
 require 'quickeebooks/windows/service/ship_method'
 require 'quickeebooks/windows/service/sales_tax'
 require 'quickeebooks/windows/service/customer_msg'
+require 'quickeebooks/windows/service/company_meta_data'
+require 'quickeebooks/windows/service/payment'

data/lib/quickeebooks/online/model/invoice.rb

@@ -26,7 +26,6 @@ module Quickeebooks
         xml_accessor :bill_email, :from => 'BillEmail'
         xml_accessor :ship_method_id, :from => 'ShipMethodId', :as => Quickeebooks::Online::Model::Id
         xml_accessor :ship_method_name, :from => 'ShipMethodName'
-        xml_accessor :balance, :from => 'Balance', :as => Float
         xml_accessor :discount_amount, :from => 'DiscountAmt', :as => Float
         xml_accessor :discount_rate, :from => 'DiscountRate', :as => Float
         xml_accessor :discount_taxable, :from => 'DiscountTaxable'
@@ -70,4 +69,4 @@ module Quickeebooks
     end
   end
 
-end
+end

data/lib/quickeebooks/online/model/invoice_header.rb

@@ -17,6 +17,7 @@ module Quickeebooks
         xml_accessor :sales_tax_code_name, :from => 'SalesTaxCodeName'
         xml_accessor :sub_total_amount, :from => 'SubTotalAmt', :as => Float
         xml_accessor :tax_rate, :from => 'TaxRate', :as => Float
+        xml_accessor :balance, :from => 'Balance', :as => Float
         xml_accessor :total_amount, :from => 'TotalAmt', :as => Float
         xml_accessor :due_date, :from => 'DueDate', :as => Time
         xml_accessor :bill_email, :from => 'BillEmail'
@@ -28,4 +29,4 @@ module Quickeebooks
     end
   end
 
-end
+end

data/lib/quickeebooks/online/service/filter.rb

@@ -1,96 +1,10 @@
+require 'quickeebooks/shared/service/filter'
+
 module Quickeebooks
   module Online
     module Service
-      class Filter
-
-        DATE_FORMAT = '%Y-%m-%d'
-        DATE_TIME_FORMAT = '%Y-%m-%dT%H:%M:%S%z'
-
-        attr_reader :type
-        attr_accessor :field, :value
-
-        # For Date/Time filtering
-        attr_accessor :before, :after
-
-        # For number comparisons
-        attr_accessor :gt, :lt, :eq
-
-        def initialize(type, *args)
-          @type = type
-          if args.first.is_a?(Hash)
-            args.first.each_pair do |key, value|
-              instance_variable_set("@#{key}", value)
-            end
-          end
-        end
-
-        def to_s
-          case @type.to_sym
-          when :date, :datetime
-            date_time_to_s
-          when :text
-            text_to_s
-          when :boolean
-            boolean_to_s
-          when :number
-            number_to_s
-          else
-            raise ArgumentError, "Don't know how to generate a Filter for type #{@type}"
-          end
-        end
-
-        private
-
-        def number_to_s
-          clauses = []
-          if @eq
-            clauses << "#{@field} :EQUALS: #{@value}"
-          end
-          if @gt
-            clauses << "#{@field} :GreaterThan: #{@value}"
-          end
-          if @lt
-            clauses << "#{@field} :LessThan: #{@value}"
-          end
-          clauses.join(" :AND: ")
-        end
-
-        def date_time_to_s
-          clauses = []
-          if @before
-            raise ':before is not a valid DateTime/Time object' unless (@before.is_a?(Time) || @before.is_a?(DateTime))
-            clauses << "#{@field} :BEFORE: #{formatted_time(@before)}"
-          end
-          if @after
-            raise ':after is not a valid DateTime/Time object' unless (@after.is_a?(Time) || @after.is_a?(DateTime))
-            clauses << "#{@field} :AFTER: #{formatted_time(@after)}"
-          end
-
-          if @before.nil? && @after.nil?
-            clauses << "#{@field} :EQUALS: #{formatted_time(@value)}"
-          end
-
-          clauses.join(" :AND: ")
-        end
-
-        def text_to_s
-          "#{@field} :EQUALS: #{@value}"
-        end
-
-        def boolean_to_s
-          "#{@field} :EQUALS: #{@value}"
-        end
-
-        def formatted_time(time)
-          if time.is_a?(Date)
-            time.strftime(DATE_FORMAT)
-          elsif time.is_a?(DateTime) || time.is_a?(Time)
-            time.strftime(DATE_TIME_FORMAT)
-          end
-        end
-
-
+      class Filter < Quickeebooks::Shared::Service::Filter
       end
     end
   end
-end
+end

data/lib/quickeebooks/online/service/service_base.rb

@@ -39,9 +39,9 @@ module Quickeebooks
         
         def realm_id=(realm_id)
           @realm_id = realm_id
-          determine_base_url
         end
         
+        # uri is of the form `https://qbo.intuit.com/qbo36`
         def base_url=(uri)
           @base_uri = uri
         end
@@ -55,19 +55,21 @@ module Quickeebooks
               element = base_doc.xpath("//qbo:QboUser/qbo:CurrentCompany/qbo:BaseURI")[0]
               if element
                 @base_uri = element.text
+              else
+                raise IntuitRequestException.new("Response error: Could not extract BaseURI from response. Invalid XML: #{service_response.body}")
               end
             else
-              raise IntuitRequestException.new("Response error: invalid code #{response.code}")
+              raise IntuitRequestException.new("Response error: invalid code #{service_response.code}")
             end
           end
         end
 
         def url_for_resource(resource)
           url_for_base("resource/#{resource}")
-          #{}"#{@base_uri}/resource/#{resource}/v2/#{@realm_id}"
         end
 
         def url_for_base(raw)
+          determine_base_url unless determined_base_url?
           "#{@base_uri}/#{raw}/v2/#{@realm_id}"
         end
 

data/lib/quickeebooks/shared/service/filter.rb

@@ -0,0 +1,96 @@
+module Quickeebooks
+  module Shared
+    module Service
+      class Filter
+
+        DATE_FORMAT = '%Y-%m-%d'
+        DATE_TIME_FORMAT = '%Y-%m-%dT%H:%M:%S%z'
+
+        attr_reader :type
+        attr_accessor :field, :value
+
+        # For Date/Time filtering
+        attr_accessor :before, :after
+
+        # For number comparisons
+        attr_accessor :gt, :lt, :eq
+
+        def initialize(type, *args)
+          @type = type
+          if args.first.is_a?(Hash)
+            args.first.each_pair do |key, value|
+              instance_variable_set("@#{key}", value)
+            end
+          end
+        end
+
+        def to_s
+          case @type.to_sym
+          when :date, :datetime
+            date_time_to_s
+          when :text
+            text_to_s
+          when :boolean
+            boolean_to_s
+          when :number
+            number_to_s
+          else
+            raise ArgumentError, "Don't know how to generate a Filter for type #{@type}"
+          end
+        end
+
+        private
+
+        def number_to_s
+          clauses = []
+          if @eq
+            clauses << "#{@field} :EQUALS: #{@value}"
+          end
+          if @gt
+            clauses << "#{@field} :GreaterThan: #{@value}"
+          end
+          if @lt
+            clauses << "#{@field} :LessThan: #{@value}"
+          end
+          clauses.join(" :AND: ")
+        end
+
+        def date_time_to_s
+          clauses = []
+          if @before
+            raise ':before is not a valid DateTime/Time object' unless (@before.is_a?(Time) || @before.is_a?(DateTime))
+            clauses << "#{@field} :BEFORE: #{formatted_time(@before)}"
+          end
+          if @after
+            raise ':after is not a valid DateTime/Time object' unless (@after.is_a?(Time) || @after.is_a?(DateTime))
+            clauses << "#{@field} :AFTER: #{formatted_time(@after)}"
+          end
+
+          if @before.nil? && @after.nil?
+            clauses << "#{@field} :EQUALS: #{formatted_time(@value)}"
+          end
+
+          clauses.join(" :AND: ")
+        end
+
+        def text_to_s
+          "#{@field} :EQUALS: #{@value}"
+        end
+
+        def boolean_to_s
+          "#{@field} :EQUALS: #{@value}"
+        end
+
+        def formatted_time(time)
+          if time.is_a?(Date)
+            time.strftime(DATE_FORMAT)
+          elsif time.is_a?(DateTime) || time.is_a?(Time)
+            time.strftime(DATE_TIME_FORMAT)
+          end
+        end
+
+
+      end
+    end
+  end
+end

data/lib/quickeebooks/version.rb

@@ -1,5 +1,5 @@
 module Quickeebooks
 
-  VERSION = "0.0.6"
+  VERSION = "0.0.7"
 
 end

data/lib/quickeebooks/windows/model/company_meta_data.rb

@@ -0,0 +1,29 @@
+# see https://ipp.developer.intuit.com/0010_Intuit_Partner_Platform/0050_Data_Services/0400_QuickBooks_Online/CompanyMetaData
+require "quickeebooks"
+require "quickeebooks/windows/model/address"
+require "quickeebooks/windows/model/phone"
+require "quickeebooks/windows/model/email"
+
+module Quickeebooks
+  module Windows
+    module Model
+      class CompanyMetaData < Quickeebooks::Windows::Model::IntuitType
+        include ActiveModel::Validations
+
+        XML_COLLECTION_NODE = 'CompaniesMetaData'
+        XML_NODE = 'CompanyMetaData'
+        
+        REST_RESOURCE = "company"
+
+        xml_convention :camelcase
+        xml_accessor :external_realm_id, :from => 'ExternalRealmId'
+        xml_accessor :registered_company_name, :from => 'QBNRegisteredCompanyName'
+        xml_accessor :industry_type, :from => 'IndustryType'
+        xml_accessor :addresses, :from => 'Address', :as => [Quickeebooks::Windows::Model::Address]
+        xml_accessor :legal_address, :from => 'LegalAddress', :as => Quickeebooks::Windows::Model::Address
+        xml_accessor :emails, :from => 'Email', :as => [Quickeebooks::Windows::Model::Email]
+        xml_accessor :phone, :from => 'Phone', :as => Quickeebooks::Windows::Model::Phone
+      end
+    end
+  end
+end

data/lib/quickeebooks/windows/model/credit_card.rb

@@ -0,0 +1,14 @@
+require 'quickeebooks/windows/model/credit_charge_info'
+require 'quickeebooks/windows/model/credit_charge_response'
+
+module Quickeebooks
+  module Windows
+    module Model
+      class CreditCard  < Quickeebooks::Windows::Model::IntuitType
+        xml_name 'CreditCard'
+        xml_accessor :credit_charge_info,     :from => 'CreditChargeInfo',     :as => Quickeebooks::Windows::Model::CreditChargeInfo
+        xml_accessor :credit_charge_response, :from => 'CreditChargeResponse', :as => Quickeebooks::Windows::Model::CreditChargeResponse
+      end
+    end
+  end
+end

data/lib/quickeebooks/windows/model/credit_charge_info.rb

@@ -0,0 +1,17 @@
+module Quickeebooks
+  module Windows
+    module Model
+      class CreditChargeInfo  < Quickeebooks::Windows::Model::IntuitType
+        xml_name 'CreditChargeInfo'
+        xml_accessor :number,                 :from => 'Number'
+        xml_accessor :type,                   :from => 'Type'
+        xml_accessor :name_on_acct,           :from => 'NameOnAcct'
+        xml_accessor :cc_expiration_month,    :from => 'CcExpireMn', :as => Integer
+        xml_accessor :cc_expiration_year,     :from => 'CcExpireYr', :as => Integer
+        xml_accessor :billing_address_street, :from => 'BillAddrStreet'
+        xml_accessor :zip_code,               :from => 'ZipCode'
+        xml_accessor :cvv,                    :from => 'Ccv'
+      end
+    end
+  end
+end

data/lib/quickeebooks/windows/model/credit_charge_response.rb

@@ -0,0 +1,13 @@
+module Quickeebooks
+  module Windows
+    module Model
+      class CreditChargeResponse  < Quickeebooks::Windows::Model::IntuitType
+        xml_name 'CreditChargeResponse'
+        xml_accessor :cc_transaction_id,      :from => 'CCTransId'
+        xml_accessor :status,                 :from => 'Status'
+        xml_accessor :auth_code,              :from => 'AuthCode'
+        xml_accessor :avs_street,             :from => 'AvsStreet'
+      end
+    end
+  end
+end

data/lib/quickeebooks/windows/model/customer.rb

@@ -73,7 +73,9 @@ module Quickeebooks
         xml_accessor :total_expense, :from => 'TotalExpense', :as => Quickeebooks::Windows::Model::Price
 
         validates_length_of :name, :minimum => 1
-        validate :has_required_attributes
+        validate :require_an_address
+        validate :name_cannot_contain_invalid_characters
+        validate :email_address_is_valid
         
         def active?
           active == 'true'
@@ -87,18 +89,20 @@ module Quickeebooks
           addresses.detect { |address| address.tag == "Shipping" }
         end
         
-        def has_required_attributes
-          if name.is_a?(String) && name.index(':') != nil
-            errors.add(:name, "Attribute :name cannot contain a colon")
-          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?
+          if type_of.nil?
+            errors.add(:type_of, "Missing required attribute TypeOf for Create")
+          end
+          errors.empty?
+        end
 
         def to_xml_ns(options = {})
           to_xml
@@ -107,12 +111,38 @@ module Quickeebooks
         def email_address=(email_address)
           self.email = Quickeebooks::Windows::Model::Email.new(email_address)
         end
+        
+        def address=(address)
+          self.addresses ||= []
+          self.addresses << address
+        end
 
         # To delete an account 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 name_cannot_contain_invalid_characters
+          if name.to_s.index(':')
+            errors.add(:name, "Name cannot contain a colon (:)")
+          end
+        end
+        
+        def email_address_is_valid
+          if email
+            address = email.address
+            unless address.index('@') && address.index('.')
+              errors.add(:email, "Email address must contain @ and . (dot)")
+            end
+          end
+        end
+        
+        def require_an_address
+          if addresses.nil? || (addresses.is_a?(Array) && addresses.empty?)
+            errors.add(:addresses, "Must provide at least one address for this Customer.")
+          end
+        end
 
       end
     end

data/lib/quickeebooks/windows/model/party_role_ref.rb

@@ -0,0 +1,12 @@
+module Quickeebooks
+  module Windows
+    module Model
+      class PartyRoleRef < Quickeebooks::Windows::Model::IntuitType
+        xml_convention :camelcase
+        xml_accessor :id, :as => Quickeebooks::Windows::Model::Id
+        xml_accessor :party_reference_id, :as => Quickeebooks::Windows::Model::Id
+        xml_accessor :last_updated_time, :as => Time
+      end
+    end
+  end
+end

data/lib/quickeebooks/windows/model/payment.rb

@@ -0,0 +1,41 @@
+require 'quickeebooks/windows/model/payment_header'
+require 'quickeebooks/windows/model/payment_line_item'
+require 'quickeebooks/windows/model/payment_detail'
+require 'quickeebooks/windows/model/credit_card'
+require 'quickeebooks/windows/model/credit_charge_info'
+require 'quickeebooks/windows/model/credit_charge_response'
+require 'quickeebooks/windows/model/meta_data'
+
+module Quickeebooks
+  module Windows
+    module Model
+      class Payment  < Quickeebooks::Windows::Model::IntuitType
+        include ActiveModel::Validations
+
+        XML_COLLECTION_NODE = 'Payments'
+        XML_NODE = "Payment"
+        REST_RESOURCE = "payment"
+
+        xml_convention :camelcase
+        xml_accessor :id,         :from => 'Id',        :as => Quickeebooks::Windows::Model::Id
+        xml_accessor :sync_token, :from => 'SyncToken', :as => Integer
+        xml_accessor :meta_data,  :from => 'MetaData',  :as => Quickeebooks::Windows::Model::MetaData
+        xml_accessor :header,     :from => 'Header',    :as => Quickeebooks::Windows::Model::PaymentHeader
+        xml_accessor :line_items, :from => 'Line',      :as => [Quickeebooks::Windows::Model::PaymentLineItem]
+
+        def initialize
+          ensure_line_items_initialization
+        end
+
+        private
+
+        def after_parse
+        end
+
+        def ensure_line_items_initialization
+          self.line_items ||= []
+        end
+      end
+    end
+  end
+end

data/lib/quickeebooks/windows/model/payment_detail.rb

@@ -0,0 +1,12 @@
+require 'quickeebooks/windows/model/credit_card'
+
+module Quickeebooks
+  module Windows
+    module Model
+      class PaymentDetail  < Quickeebooks::Windows::Model::IntuitType
+        xml_name 'Detail'
+        xml_accessor :credit_card, :from => 'CreditCard', :as => Quickeebooks::Windows::Model::CreditCard
+      end
+    end
+  end
+end

data/lib/quickeebooks/windows/model/payment_header.rb

@@ -0,0 +1,24 @@
+require 'time'
+require 'quickeebooks/windows/model/payment_detail'
+
+module Quickeebooks
+  module Windows
+    module Model
+      class PaymentHeader < Quickeebooks::Windows::Model::IntuitType
+        xml_name 'Header'
+        xml_accessor :doc_number,            :from => 'DocNumber'
+        xml_accessor :txn_date,              :from => 'TxnDate',            :as => Time
+        xml_accessor :note,                  :from => 'Note'
+        xml_accessor :status,                :from => 'Status'
+        xml_accessor :customer_id,           :from => 'CustomerId',         :as => Quickeebooks::Windows::Model::Id
+        xml_accessor :customer_name,         :from => 'CustomerName'
+        xml_accessor :deposit_to_account_id, :from => 'DepositToAccountId', :as => Quickeebooks::Windows::Model::Id
+        xml_accessor :payment_method_id,     :from => 'PaymentMethodId',    :as => Quickeebooks::Windows::Model::Id
+        xml_accessor :payment_method_name,   :from => 'PaymentMethodName'
+        xml_accessor :detail,                :from => 'Detail',             :as => Quickeebooks::Windows::Model::PaymentDetail
+        xml_accessor :total_amount,          :from => 'TotalAmt',           :as => Float
+        xml_accessor :process_payment,       :from => 'ProcessPayment'
+      end
+    end
+  end
+end

data/lib/quickeebooks/windows/model/payment_line_item.rb

@@ -0,0 +1,15 @@
+require 'quickeebooks/windows/model/id'
+
+module Quickeebooks 
+  module Windows 
+    module Model
+      class PaymentLineItem < Quickeebooks::Windows::Model::IntuitType
+        xml_name 'Line'
+        xml_accessor :id,         :from => 'Id',        :as => Integer
+        xml_accessor :amount,     :from => 'Amount',    :as => Float
+        xml_accessor :desc,       :from => 'Desc'
+        xml_accessor :txn_id,     :from => 'TxnId', :as => Quickeebooks::Windows::Model::Id
+      end
+    end
+  end
+end

data/lib/quickeebooks/windows/model/rest_response.rb

@@ -22,10 +22,11 @@ module Quickeebooks
           s = "#<RestResponse>: "
           if success?
             s += "Success[#{success.request_name}] @ #{success.processed_time} - "
-          else
+          elsif error?
             s += "Error[#{error.request_name}] @ #{error.processed_time} - "
             s += "Code: #{error.code}, Desc: #{error.desc}"
           end
+          s
         end
         
       end

data/lib/quickeebooks/windows/model/success.rb

@@ -1,4 +1,6 @@
 require "quickeebooks/windows/model/object_ref"
+require "quickeebooks/windows/model/party_role_ref"
+
 module Quickeebooks
   module Windows
     module Model
@@ -8,6 +10,7 @@ module Quickeebooks
         
         xml_accessor :request_id, :from => '@RequestId'
         xml_accessor :object_ref, :as => Quickeebooks::Windows::Model::ObjectRef
+        xml_accessor :party_role_ref, :as => Quickeebooks::Windows::Model::PartyRoleRef
         xml_accessor :request_name
         xml_accessor :processed_time, :as => Time
         

data/lib/quickeebooks/windows/service/company_meta_data.rb

@@ -0,0 +1,14 @@
+require 'quickeebooks/windows/service/service_base'
+
+module Quickeebooks
+  module Windows
+    module Service
+      class CompanyMetaData < Quickeebooks::Windows::Service::ServiceBase
+        def load
+          model = Quickeebooks::Windows::Model::CompanyMetaData
+          fetch_object(model, url_for_resource(model::REST_RESOURCE))
+        end
+      end
+    end
+  end
+end

data/lib/quickeebooks/windows/service/customer.rb

@@ -17,6 +17,23 @@ module Quickeebooks
           url = "#{url_for_resource(Quickeebooks::Windows::Model::Customer::REST_RESOURCE)}/#{id}"
           fetch_object(Quickeebooks::Windows::Model::Customer, url, {:idDomain => idDomain})
         end
+        
+        def create(customer)
+          raise InvalidModelException unless customer.valid_for_create?
+          
+          # XML is a wrapped 'object' where the type is specified as an attribute
+          #    <Object xsi:type="Invoice">
+          xml_node = customer.to_xml(:name => 'Object')
+          xml_node.set_attribute('xsi:type', 'Customer')
+          xml = <<-XML
+          <Add xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" RequestId="#{guid}" xmlns="http://www.intuit.com/sb/cdm/v2">
+          <ExternalRealmId>#{self.realm_id}</ExternalRealmId>
+          #{xml_node}
+          </Add>
+          XML
+          perform_write(Quickeebooks::Windows::Model::Customer, xml)
+          
+        end
 
       end
     end

data/lib/quickeebooks/windows/service/filter.rb

@@ -0,0 +1,10 @@
+require 'quickeebooks/shared/service/filter'
+
+module Quickeebooks
+  module Windows
+    module Service
+      class Filter < Quickeebooks::Shared::Service::Filter
+      end
+    end
+  end
+end

data/lib/quickeebooks/windows/service/payment.rb

@@ -0,0 +1,26 @@
+require 'quickeebooks/windows/service/service_base'
+require 'quickeebooks/windows/model/payment'
+require 'quickeebooks/windows/model/payment_header'
+require 'quickeebooks/windows/model/payment_line_item'
+require 'quickeebooks/windows/model/payment_detail'
+require 'quickeebooks/windows/model/credit_card'
+require 'quickeebooks/windows/model/credit_charge_info'
+require 'quickeebooks/windows/model/credit_charge_response'
+require 'nokogiri'
+
+module Quickeebooks
+  module Windows
+    module Service
+      class Payment < ServiceBase
+        def fetch_by_id(id, idDomain = 'QB', options = {})
+          url = "#{url_for_resource(Quickeebooks::Windows::Model::Payment::REST_RESOURCE)}/#{id}"
+          fetch_object(Quickeebooks::Windows::Model::Payment, url, { :idDomain => idDomain })
+        end
+
+        def list(filters = [], page = 1, per_page = 20, sort = nil, options = {})
+          fetch_collection(Quickeebooks::Windows::Model::Payment, nil, filters, page, per_page, sort, options)
+        end
+      end
+    end
+  end
+end

data/spec/quickeebooks/online/invoice_spec.rb

@@ -7,9 +7,10 @@ describe "Quickeebooks::Online::Model::Invoice" do
   describe "parse invoice from XML" do
     xml = File.read(File.dirname(__FILE__) + "/../../xml/online/invoice.xml")
     invoice = Quickeebooks::Online::Model::Invoice.from_xml(xml)
+    invoice.header.balance.should == 0
     invoice.id.value.should == "13"
     invoice.line_items.count.should == 1
     invoice.line_items.first.unit_price.should == 225
   end
   
-end
+end

data/spec/quickeebooks/online/services/service_base_spec.rb

@@ -37,4 +37,18 @@ describe "Quickeebooks::Online::Service::ServiceBase" do
   it "can determine login_name" do
     @service.login_name.should == 'foo@example.com'
   end
+  
+  it "throws exception when response XML is invalid when determining base url" do
+    xml = File.read(File.dirname(__FILE__) + "/../../../xml/online/invalid_user.xml")
+    user_url = Quickeebooks::Online::Service::ServiceBase::QB_BASE_URI + "/" + @realm_id
+    FakeWeb.register_uri(:get, user_url, :status => ["200", "OK"], :body => xml)
+    @service = Quickeebooks::Online::Service::ServiceBase.new
+    @service.access_token = @oauth
+    @service.instance_eval {
+      @realm_id = "9991111222"
+    }
+    lambda { @service.determine_base_url }.should raise_error(IntuitRequestException)
+    @service.base_uri.should == nil
+  end
+
 end

data/spec/quickeebooks/windows/services/company_meta_data_spec.rb

@@ -0,0 +1,34 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../spec_helper')
+require "fakeweb"
+require "oauth"
+require "quickeebooks"
+
+describe "Quickeebooks::Windows::Service::CompanyMetaData" do
+  before(:all) do
+    FakeWeb.allow_net_connect = false
+    qb_key = "key"
+    qb_secret = "secreet"
+
+    @realm_id = "9991111222"
+    @base_uri = "https://qbo.intuit.com/qbo36"
+    @oauth_consumer = OAuth::Consumer.new(qb_key, qb_key, {
+        :site                 => "https://oauth.intuit.com",
+        :request_token_path   => "/oauth/v1/get_request_token",
+        :authorize_path       => "/oauth/v1/get_access_token",
+        :access_token_path    => "/oauth/v1/get_access_token"
+    })
+    @oauth = OAuth::AccessToken.new(@oauth_consumer, "blah", "blah")
+  end
+  
+  it "can fetch the company meta data" do
+    xml = File.read(File.dirname(__FILE__) + "/../../../xml/windows/company_meta_data.xml")
+    model = Quickeebooks::Windows::Model::CompanyMetaData
+    service = Quickeebooks::Windows::Service::CompanyMetaData.new
+    service.access_token = @oauth
+    service.realm_id = @realm_id
+    FakeWeb.register_uri(:get, service.url_for_resource(model::REST_RESOURCE), :status => ["200", "OK"], :body => xml)
+    company_meta_data_response = service.load
+
+    company_meta_data_response.registered_company_name.should == "Castle Rock Construction"
+  end
+end

data/spec/quickeebooks/windows/services/customer_spec.rb

@@ -56,5 +56,103 @@ describe "Quickeebooks::Windows::Service::Customer" do
     customer = service.fetch_by_id(341)
     customer.name.should == "Wine Stop"
   end
+  
+  it "cannot create a customer without a name" do
+    customer = Quickeebooks::Windows::Model::Customer.new
+    service = Quickeebooks::Windows::Service::Customer.new
+    service.access_token = @oauth
+    service.realm_id = @realm_id
+    lambda do
+      service.create(customer)
+    end.should raise_error(InvalidModelException)
+    
+    customer.valid?.should == false
+    customer.errors.keys.include?(:name).should == true
+  end
+
+  it "cannot create a customer without a type_of attribute" do
+    customer = Quickeebooks::Windows::Model::Customer.new
+    service = Quickeebooks::Windows::Service::Customer.new
+    service.access_token = @oauth
+    service.realm_id = @realm_id
+    lambda do
+      service.create(customer)
+    end.should raise_error(InvalidModelException)
+    customer.errors.keys.include?(:type_of).should == true
+  end
+  
+  it "cannot create a customer with invalid name" do
+    customer = Quickeebooks::Windows::Model::Customer.new
+    service = Quickeebooks::Windows::Service::Customer.new
+    service.access_token = @oauth
+    service.realm_id = @realm_id
+    customer.name = "Bobs:Plumbing"
+    lambda do
+      service.create(customer)
+    end.should raise_error(InvalidModelException)
+    
+    customer.valid?.should == false
+    customer.errors.keys.include?(:name).should == true
+  end
+
+  it "cannot create a customer with no address" do
+    customer = Quickeebooks::Windows::Model::Customer.new
+    service = Quickeebooks::Windows::Service::Customer.new
+    service.access_token = @oauth
+    service.realm_id = @realm_id
+    customer.name = "Bobs Plumbing"
+    lambda do
+      service.create(customer)
+    end.should raise_error(InvalidModelException)
+    
+    customer.valid?.should == false
+    customer.errors.keys.include?(:addresses).should == true
+  end
+
+  it "cannot create a customer with an invalid email" do
+    customer = Quickeebooks::Windows::Model::Customer.new
+    service = Quickeebooks::Windows::Service::Customer.new
+    service.access_token = @oauth
+    service.realm_id = @realm_id
+    customer.name = "Bobs Plumbing"
+    customer.email_address = "foobar.com"
+    lambda do
+      service.create(customer)
+    end.should raise_error(InvalidModelException)
+    
+    customer.valid?.should == false
+    customer.errors.keys.include?(:email).should == true
+  end
+
+  it "can create a customer" do
+    xml = File.read(File.dirname(__FILE__) + "/../../../xml/windows/customer_create_success.xml")
+    service = Quickeebooks::Windows::Service::Customer.new
+    model = Quickeebooks::Windows::Model::Customer
+    customer = Quickeebooks::Windows::Model::Customer.new
+
+    service.access_token = @oauth
+    service.realm_id = @realm_id
+    FakeWeb.register_uri(:post, service.url_for_resource(model::REST_RESOURCE), :status => ["200", "OK"], :body => xml)
+
+    customer.type_of = "Person"
+    customer.name = "Bobs Plumbing"
+    email = Quickeebooks::Windows::Model::Email.new
+    email.address = "foo@bar.com"
+    email.tag = "Business"
+    customer.email = email
+    billing_address = Quickeebooks::Windows::Model::Address.new
+    billing_address.tag = "Billing"
+    billing_address.line1 = "123 Main St."
+    billing_address.city = "San Francisco"
+    billing_address.country_sub_division_code = "CA"
+    billing_address.postal_code = "94117"
+    billing_address.country = "USA"
+    customer.address = billing_address
+    create_response = service.create(customer)
+    create_response.success?.should == true
+    create_response.success.party_role_ref.id.value.should == "6762304"
+    create_response.success.request_name.should == "CustomerAdd"
+  end
+
 
 end

data/spec/quickeebooks/windows/services/payment_spec.rb

@@ -0,0 +1,48 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../spec_helper')
+require "fakeweb"
+require "oauth"
+require "quickeebooks"
+require "date"
+
+describe "Quickeebooks::Windows::Service::Payment" do
+  before(:all) do
+    FakeWeb.allow_net_connect = false
+    qb_key = "key"
+    qb_secret = "secreet"
+
+    @realm_id = "9991111222"
+    @base_uri = "https://qbo.intuit.com/qbo36"
+    @oauth_consumer = OAuth::Consumer.new(qb_key, qb_key, {
+        :site                 => "https://oauth.intuit.com",
+        :request_token_path   => "/oauth/v1/get_request_token",
+        :authorize_path       => "/oauth/v1/get_access_token",
+        :access_token_path    => "/oauth/v1/get_access_token"
+    })
+    @oauth = OAuth::AccessToken.new(@oauth_consumer, "blah", "blah")
+  end
+  
+  it "can fetch a list of payments" do
+    xml = File.read(File.dirname(__FILE__) + "/../../../xml/windows/payments.xml")
+    service = Quickeebooks::Windows::Service::Payment.new
+    service.access_token = @oauth
+    service.realm_id = @realm_id
+    
+    model = Quickeebooks::Windows::Model::Payment
+    FakeWeb.register_uri(:get,
+                         service.url_for_resource(model::REST_RESOURCE),
+                         :status => ["200", "OK"],
+                         :body => xml)
+    payments = service.list
+    payments.entries.count.should == 1
+    
+    payment = payments.entries.first
+    payment.id.value.should == "4"
+    payment.header.should_not be_nil
+    header = payment.header
+    header.customer_name.should == "Davis"
+        
+    line1 = payment.line_items.first
+    line1.should_not be_nil
+    line1.amount.should == header.total_amount
+  end
+end

data/spec/xml/online/invalid_user.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<qbo:QboUser xmlns="http://www.intuit.com/sb/cdm/v2" xmlns:qbp="http://www.intuit.com/sb/cdm/qbopayroll/v1" xmlns:qbo="http://www.intuit.com/sb/cdm/qbo">
+  <qbo:LoginName>foo@example.com</qbo:LoginName>
+  <qbo:Ticket>V1-162-alskdfasldkjfalsdkjf</qbo:Ticket>
+  <qbo:AgentId>9991111222</qbo:AgentId>
+  <qbo:Blah>Hello</qbo:Blah>
+</qbo:QboUser>

data/spec/xml/windows/company_meta_data.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--XML GENERATED by IntuitDataSyncEngine (IDS) using \\\\SBDomainServices\\CDM\\branches\\3.4.0-rel-1-->
+<RestResponse xmlns="http://www.intuit.com/sb/cdm/v2" xmlns:xdb="http://xmlns.oracle.com/xdb" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.intuit.com/sb/cdm/v2 ../common/RestDataFilter.xsd">
+  <CompaniesMetaData>
+    <CompanyMetaData>
+      <ExternalRealmId>202720551</ExternalRealmId>
+      <QBNRegisteredCompanyName>Castle Rock Construction</QBNRegisteredCompanyName>
+      <CompanySignUpDateTime>2011-03-28T17:33:34.0Z</CompanySignUpDateTime>
+      <LatestUploadDateTime>2011-03-28T18:52:19.0Z</LatestUploadDateTime>
+      <QBVersion>21 0 6 4</QBVersion>
+      <CompanyFileName>Quality-Built Construction</CompanyFileName>
+      <FlavorStratum>standard_stratum</FlavorStratum>
+      <SampleFile>false</SampleFile>
+      <QBNCompanyUserAdminIdNumber>118149998</QBNCompanyUserAdminIdNumber>
+      <SyncEnabled>true</SyncEnabled>
+      <Address>
+        <Line1>100 Mason St.</Line1>
+        <Line2>Woodcrest, CA 94327</Line2>
+      </Address>
+      <LegalAddress>
+        <Line1>100 Mason St.</Line1>
+        <City>Woodcrest</City>
+        <CountrySubDivisionCode>CA</CountrySubDivisionCode>
+        <PostalCode>94327</PostalCode>
+      </LegalAddress>
+      <FiscalYearStart>1</FiscalYearStart>
+      <IncomeTaxYearStart>1</IncomeTaxYearStart>
+    </CompanyMetaData>
+  </CompaniesMetaData>
+</RestResponse>

data/spec/xml/windows/customer_create_success.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0"?>
+<RestResponse xmlns="http://www.intuit.com/sb/cdm/v2">
+  <Success RequestId="48147b60b90e460893db27b32d9f2acf">
+    <PartyRoleRef>
+      <Id idDomain="NG">6762304</Id>
+      <SyncToken>1</SyncToken>
+      <LastUpdatedTime>2012-09-25T21:08:17Z</LastUpdatedTime>
+      <PartyReferenceId idDomain="NG">9270150</PartyReferenceId>
+    </PartyRoleRef>
+    <RequestName>CustomerAdd</RequestName>
+    <ProcessedTime>2012-09-25T21:08:17Z</ProcessedTime>
+  </Success>
+</RestResponse>

data/spec/xml/windows/payments.xml

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--XML GENERATED by IntuitDataSyncEngine (IDS) using \\\\SBDomainServices\\CDM\\branches\\3.9.0-rel-1-->
+<RestResponse xmlns="http://www.intuit.com/sb/cdm/v2"
+              xmlns:xdb          ="http://xmlns.oracle.com/xdb"
+              xmlns:xsi          ="http://www.w3.org/2001/XMLSchema-instance"
+              xsi:schemaLocation ="http://www.intuit.com/sb/cdm/v2 ../common/RestDataFilter.xsd"><Payments>
+  <Payment>
+    <Id idDomain="QB">4</Id>
+    <SyncToken>1</SyncToken>
+    <MetaData>
+      <CreatedBy>app</CreatedBy>
+      <CreateTime>2012-09-23T23:53:53.0Z</CreateTime>
+      <LastModifiedBy>app</LastModifiedBy>
+      <LastUpdatedTime>2012-09-23T23:53:53.0Z</LastUpdatedTime>
+    </MetaData>
+    <ExternalKey idDomain="QB">4</ExternalKey>
+    <Synchronized>true</Synchronized>
+    <Header>
+      <TxnDate>2012-09-23</TxnDate>
+      <Status>Paid</Status>
+      <CustomerId idDomain="QB">1</CustomerId>
+      <CustomerName>Davis</CustomerName>
+      <RemitToId idDomain="QB">1</RemitToId>
+      <RemitToName>Davis</RemitToName>
+      <ARAccountId idDomain="QB">33</ARAccountId>
+      <ARAccountName>Accounts Receivable</ARAccountName>
+      <DepositToAccountId idDomain="QB">34</DepositToAccountId>
+      <DepositToAccountName>Undeposited Funds</DepositToAccountName>
+      <PaymentMethodId idDomain="QB">1</PaymentMethodId>
+      <PaymentMethodName>Cash</PaymentMethodName>
+      <TotalAmt>100</TotalAmt>
+    </Header>
+    <Line>
+      <Amount>100</Amount>
+      <TxnId idDomain="QB">1</TxnId>
+      <TxnNum>1</TxnNum>
+    </Line>
+  </Payment>
+</Payments></RestResponse>

data/tmp/create_customer_windows.rb

@@ -0,0 +1,41 @@
+require 'rubygems'
+require 'oauth'
+$: << File.expand_path('./lib')
+require 'quickeebooks'
+
+consumer_key = 'qyprdL8NUDMYcCzwp8ea9KbIhaMSRk'
+consumer_secret = 'FcE5kihBYMVQGvX9UNYMxsrM8mP7bfuxc36PLhJB'
+qb_oauth_consumer = OAuth::Consumer.new(consumer_key, consumer_secret, {
+    :site                 => "https://oauth.intuit.com",
+    :request_token_path   => "/oauth/v1/get_request_token",
+    :authorize_path       => "/oauth/v1/get_access_token",
+    :access_token_path    => "/oauth/v1/get_access_token",
+    :proxy => 'http://127.0.0.1:8080'
+})
+realm_id = "524388660"
+access_token = "qyprdBzoHRYCVSZg0z5DrX970E2uebeaXSRNnoIjPQMqAXAY"
+access_secret = "W2oWdboxA9XqwEZrbSv7rNsatphhBs9Vi5byKBjT"
+oauth = OAuth::AccessToken.new(qb_oauth_consumer, access_token, access_secret)
+
+service = Quickeebooks::Windows::Service::Customer.new
+
+service.access_token = oauth
+service.realm_id = realm_id
+
+customer = Quickeebooks::Windows::Model::Customer.new
+customer.type_of = "Person"
+customer.name = "Cody Test-#{Time.now.to_i}"
+email = Quickeebooks::Windows::Model::Email.new
+email.address = "foo@bar.com"
+email.tag = "Business"
+customer.email = email
+billing_address = Quickeebooks::Windows::Model::Address.new
+billing_address.tag = "Billing"
+billing_address.line1 = "#{Time.now.to_i} Main St."
+billing_address.city = "San Francisco"
+billing_address.country_sub_division_code = "CA"
+billing_address.postal_code = "94117"
+billing_address.country = "USA"
+customer.address = billing_address
+result = service.create(customer)
+puts result.inspect

data/tmp/online.rb

@@ -0,0 +1,23 @@
+require 'rubygems'
+require 'oauth'
+$: << File.expand_path('./lib')
+require 'quickeebooks'
+
+consumer_key = 'qyprdZrwArlbUcJX7SlxresbflsXKY'
+consumer_secret = 'qhgNfrl9XX8JVztdu5z27idFHdNI5UOSHC5HcItt'
+qb_oauth_consumer = OAuth::Consumer.new(consumer_key, consumer_secret, {
+    :site                 => "https://oauth.intuit.com",
+    :request_token_path   => "/oauth/v1/get_request_token",
+    :authorize_path       => "/oauth/v1/get_access_token",
+    :access_token_path    => "/oauth/v1/get_access_token",
+    :proxy => 'http://127.0.0.1:8080'
+})
+realm_id = "214483939"
+access_token = "qyprdTrgSmjG8p8yAdBYJAZYEdGDlh5JyuNhBvKS3CSQUMjE"
+access_secret = "4lAHnUImKT7a69iIjA19xQuk7UNUvs8d6fLcbO6F"
+oauth = OAuth::AccessToken.new(qb_oauth_consumer, access_token, access_secret)
+
+service = Quickeebooks::Online::Service::Customer.new
+service.access_token = oauth
+service.realm_id = realm_id
+service.list([], 1, 2)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: quickeebooks
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-31 00:00:00.000000000 Z
+date: 2012-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: roxml
@@ -219,11 +219,16 @@ files:
 - lib/quickeebooks/online/service/payment.rb
 - lib/quickeebooks/online/service/service_base.rb
 - lib/quickeebooks/online/service/sort.rb
+- lib/quickeebooks/shared/service/filter.rb
 - lib/quickeebooks/version.rb
 - lib/quickeebooks/windows/model/account.rb
 - lib/quickeebooks/windows/model/account_detail_type.rb
 - lib/quickeebooks/windows/model/account_reference.rb
 - lib/quickeebooks/windows/model/address.rb
+- lib/quickeebooks/windows/model/company_meta_data.rb
+- lib/quickeebooks/windows/model/credit_card.rb
+- lib/quickeebooks/windows/model/credit_charge_info.rb
+- lib/quickeebooks/windows/model/credit_charge_response.rb
 - lib/quickeebooks/windows/model/custom_field.rb
 - lib/quickeebooks/windows/model/customer.rb
 - lib/quickeebooks/windows/model/customer_msg.rb
@@ -242,6 +247,11 @@ files:
 - lib/quickeebooks/windows/model/open_balance.rb
 - lib/quickeebooks/windows/model/other_name.rb
 - lib/quickeebooks/windows/model/other_name_id.rb
+- lib/quickeebooks/windows/model/party_role_ref.rb
+- lib/quickeebooks/windows/model/payment.rb
+- lib/quickeebooks/windows/model/payment_detail.rb
+- lib/quickeebooks/windows/model/payment_header.rb
+- lib/quickeebooks/windows/model/payment_line_item.rb
 - lib/quickeebooks/windows/model/phone.rb
 - lib/quickeebooks/windows/model/price.rb
 - lib/quickeebooks/windows/model/purchase_cost.rb
@@ -257,10 +267,13 @@ files:
 - lib/quickeebooks/windows/model/vendor_reference.rb
 - lib/quickeebooks/windows/model/web_site.rb
 - lib/quickeebooks/windows/service/account.rb
+- lib/quickeebooks/windows/service/company_meta_data.rb
 - lib/quickeebooks/windows/service/customer.rb
 - lib/quickeebooks/windows/service/customer_msg.rb
+- lib/quickeebooks/windows/service/filter.rb
 - lib/quickeebooks/windows/service/invoice.rb
 - lib/quickeebooks/windows/service/item.rb
+- lib/quickeebooks/windows/service/payment.rb
 - lib/quickeebooks/windows/service/sales_rep.rb
 - lib/quickeebooks/windows/service/sales_tax.rb
 - lib/quickeebooks/windows/service/service_base.rb
@@ -284,8 +297,10 @@ files:
 - spec/quickeebooks/online/services/service_base_spec.rb
 - spec/quickeebooks/online/services/sort_spec.rb
 - spec/quickeebooks/windows/customer_spec.rb
+- spec/quickeebooks/windows/services/company_meta_data_spec.rb
 - spec/quickeebooks/windows/services/customer_spec.rb
 - spec/quickeebooks/windows/services/invoice_spec.rb
+- spec/quickeebooks/windows/services/payment_spec.rb
 - spec/quickeebooks/windows/services/sales_rep_spec.rb
 - spec/quickeebooks/windows/services/sales_taxes_spec.rb
 - spec/quickeebooks/windows/services/ship_method_spec.rb
@@ -299,18 +314,24 @@ files:
 - spec/xml/online/customer2.xml
 - spec/xml/online/customers.xml
 - spec/xml/online/determine_base_url.xml
+- spec/xml/online/invalid_user.xml
 - spec/xml/online/invoice.xml
 - spec/xml/online/payment.xml
 - spec/xml/online/user.xml
+- spec/xml/windows/company_meta_data.xml
 - spec/xml/windows/customer.xml
+- spec/xml/windows/customer_create_success.xml
 - spec/xml/windows/customers.xml
 - spec/xml/windows/fetch_customer_by_id.xml
 - spec/xml/windows/http_401.xml
 - spec/xml/windows/invoice_success_create.xml
 - spec/xml/windows/invoices.xml
+- spec/xml/windows/payments.xml
 - spec/xml/windows/sales_reps.xml
 - spec/xml/windows/sales_taxes.xml
 - spec/xml/windows/ship_methods.xml
+- tmp/create_customer_windows.rb
+- tmp/online.rb
 homepage: http://github.com/ruckus/quickeebooks
 licenses: []
 post_install_message: