quickeebooks 0.0.2

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

@@ -0,0 +1,107 @@
+require "spec_helper"
+require "fakeweb"
+require "oauth"
+require "quickeebooks"
+
+describe "Quickeebooks::Online::Service::Customer" 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 customers" do
+    xml = File.read(File.dirname(__FILE__) + "/../../../xml/online/customers.xml")
+    service = Quickeebooks::Online::Service::Customer.new(@oauth, @realm_id, @base_uri)
+    FakeWeb.register_uri(:post, service.url_for_resource("customers"), :status => ["200", "OK"], :body => xml)
+    accounts = service.list
+    accounts.current_page.should == 1
+    accounts.entries.count.should == 3
+    accounts.entries.first.name.should == "John Doe"
+  end
+
+  it "can fetch a list of customers with filters" do
+    xml = File.read(File.dirname(__FILE__) + "/../../../xml/online/customers.xml")
+    service = Quickeebooks::Online::Service::Customer.new(@oauth, @realm_id, @base_uri)
+    FakeWeb.register_uri(:post, service.url_for_resource("customers"), :status => ["200", "OK"], :body => xml)
+    accounts = service.list
+    accounts.current_page.should == 1
+    accounts.entries.count.should == 3
+    accounts.entries.first.name.should == "John Doe"
+  end
+  
+  it "can create a customer" do
+    xml = File.read(File.dirname(__FILE__) + "/../../../xml/online/customer.xml")
+    service = Quickeebooks::Online::Service::Customer.new(@oauth, @realm_id, @base_uri)
+    FakeWeb.register_uri(:post, service.url_for_resource("customer"), :status => ["200", "OK"], :body => xml)
+    customer = Quickeebooks::Online::Model::Customer.new
+    customer.name = "Billy Bob"
+    result = service.create(customer)
+    result.id.to_i.should > 0
+  end
+  
+  it "can delete a customer" do
+    service = Quickeebooks::Online::Service::Customer.new(@oauth, @realm_id, @base_uri)
+    url = "#{service.url_for_resource("customer")}/99?methodx=delete"
+    FakeWeb.register_uri(:post, url, :status => ["200", "OK"])
+    customer = Quickeebooks::Online::Model::Customer.new
+    customer.id = 99
+    customer.sync_token = 0
+    result = service.delete(customer)
+    result.should == true
+  end
+
+  it "cannot delete a customer with missing required fields for deletion" do
+    service = Quickeebooks::Online::Service::Customer.new(@oauth, @realm_id, @base_uri)
+    customer = Quickeebooks::Online::Model::Customer.new
+    lambda { service.delete(customer) }.should raise_error(InvalidModelException, "Missing required parameters for delete")
+  end
+
+  it "exception is raised when we try to create an invalid account" do
+    customer = Quickeebooks::Online::Model::Customer.new
+    service = Quickeebooks::Online::Service::Customer.new(@oauth, @realm_id, @base_uri)
+    lambda { service.create(customer) }.should raise_error(InvalidModelException)
+  end
+  
+  it "cannot update an invalid customer" do
+    customer = Quickeebooks::Online::Model::Customer.new
+    customer.name = "John Doe"
+    service = Quickeebooks::Online::Service::Customer.new(@oauth, @realm_id, @base_uri)
+    lambda { service.update(customer) }.should raise_error(InvalidModelException)
+  end
+  
+  it "can fetch an customer by id" do
+    xml = File.read(File.dirname(__FILE__) + "/../../../xml/online/customer.xml")
+    service = Quickeebooks::Online::Service::Customer.new(@oauth, @realm_id, @base_uri)
+    url = "#{service.url_for_resource("customer")}/99"
+    FakeWeb.register_uri(:get, url, :status => ["200", "OK"], :body => xml)
+    customer = service.fetch_by_id(99)
+    customer.name.should == "John Doe"
+  end
+
+  it "can update a customer" do
+    xml2 = File.read(File.dirname(__FILE__) + "/../../../xml/online/customer2.xml")
+    customer = Quickeebooks::Online::Model::Customer.new
+    customer.name = "John Doe"
+    customer.id = 1
+    customer.sync_token = 2
+    
+    service = Quickeebooks::Online::Service::Customer.new(@oauth, @realm_id, @base_uri)
+    url = "#{service.url_for_resource("customer")}/#{customer.id}"
+    FakeWeb.register_uri(:post, url, :status => ["200", "OK"], :body => xml2)
+    updated = service.update(customer)
+    updated.name.should == "Billy Bob"
+  end
+
+  
+end

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

@@ -0,0 +1,43 @@
+require "spec_helper"
+require "fakeweb"
+require "oauth"
+require "quickeebooks"
+
+describe "Quickeebooks::Online::Service::Filter" do
+  before(:all) do
+  end
+  
+  it "can generate a text filter" do
+    filter = Quickeebooks::Online::Service::Filter.new(:text, :field => "Name", :value => "Smith")
+    filter.to_s.should == "Name :EQUALS: Smith"
+  end
+
+  it "can generate a boolean filter" do
+    filter = Quickeebooks::Online::Service::Filter.new(:boolean, :field => "IncludeJobs", :value => false)
+    filter.to_s.should == "IncludeJobs :EQUALS: false"
+  end
+
+  it "can generate a date filter" do
+    date = Date.civil(2012, 2, 16)
+    filter = Quickeebooks::Online::Service::Filter.new(:datetime, :field => "CreateTime", :value => date)
+    filter.to_s.should == "CreateTime :EQUALS: #{date.strftime(Quickeebooks::Online::Service::Filter::DATE_FORMAT)}"
+  end
+
+  it "can generate a datetime filter" do
+    time = Time.mktime(2012, 1, 2, 8, 31, 44)
+    filter = Quickeebooks::Online::Service::Filter.new(:datetime, :field => "CreateTime", :after => time)
+    filter.to_s.should == "CreateTime :AFTER: #{time.strftime(Quickeebooks::Online::Service::Filter::DATE_TIME_FORMAT)}"
+  end
+
+  it "can generate a datetime filter with bounded dates" do
+    time1 = Time.mktime(2012, 1, 2, 1)
+    time2 = Time.mktime(2012, 1, 5, 8)
+    filter = Quickeebooks::Online::Service::Filter.new(:datetime, :field => "CreateTime", :after => time1, :before => time2)
+    # 'before' is checked before 'after' :)
+    text = "CreateTime :BEFORE: #{time2.strftime(Quickeebooks::Online::Service::Filter::DATE_TIME_FORMAT)}"
+    text = "#{text} :AND: CreateTime :AFTER: #{time1.strftime(Quickeebooks::Online::Service::Filter::DATE_TIME_FORMAT)}"
+    filter.to_s.should == text
+  end
+
+
+end

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

@@ -0,0 +1,30 @@
+require "spec_helper"
+require "fakeweb"
+require "oauth"
+require "quickeebooks/online/service/service_base"
+
+describe "Quickeebooks::Online::Service::ServiceBase" do
+  before(:all) do
+    FakeWeb.allow_net_connect = false
+    qb_key = "key"
+    qb_secret = "secreet"
+
+    @realm_id = "9991111222"
+    @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"
+    })
+  end
+  
+  it "can determine base url" do
+    xml = File.read(File.dirname(__FILE__) + "/../../../xml/online/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(@oauth_consumer, @realm_id)
+    service.base_uri.should_not == nil
+    service.url_for_resource("customers").should == "https://qbo.intuit.com/qbo36/resource/customers/v2/#{@realm_id}"
+  end
+  
+end

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

@@ -0,0 +1,17 @@
+require "spec_helper"
+require "fakeweb"
+require "oauth"
+require "quickeebooks"
+
+describe "Quickeebooks::Online::Service::Sort" do
+  before(:all) do
+  end
+  
+  it "can generate a sorting parameter" do
+    filter = Quickeebooks::Online::Service::Sort.new("FirstName", "NewestToOldest")
+    filter.to_s.should == "FirstName NewestToOldest"
+  end
+
+
+
+end

data/spec/quickeebooks/windows/customer_spec.rb

@@ -0,0 +1,49 @@
+require "spec_helper"
+
+require "quickeebooks/windows/model/customer"
+
+describe "Quickeebooks::Windows::Model::Customer" do
+  
+  it "parse customer from XML" do
+    xml = File.read(File.dirname(__FILE__) + "/../../xml/windows/customer.xml")
+    customer = Quickeebooks::Windows::Model::Customer.from_xml(xml)
+    customer.sync_token.should == 1
+    customer.name.should == "Wine House"
+    
+    customer.dba_name.should == "Wine House"
+    
+    create_time = Date.civil(2012, 3, 24)
+    customer.meta_data.create_time.year.should == create_time.year
+    customer.addresses.count.should == 1
+    
+    customer.addresses.first.line1.should == "Wine House"
+    customer.addresses.first.line2.should == "2311 Maple Ave"
+    
+    customer.phones.size.should == 1
+    customer.phones.first.free_form_number.should == "415-555-1212"
+    
+    customer.email.address.should == "no-reply@winehouse.com"
+    
+    customer.notes.count.should == 1
+    customer.notes.first.content.should == "Likes chocolate and horses"
+
+    customer.custom_fields.count.should == 0
+
+    customer.open_balance.amount.should == 6200.0
+  end
+  
+  it "can assign an email address" do
+    customer = Quickeebooks::Windows::Model::Customer.new
+    the_email = "foo@example.org"
+    customer.email_address = the_email
+    customer.email.is_a?(Quickeebooks::Windows::Model::Email).should == true
+    customer.email.address.should == the_email
+  end
+  
+  it "cannot update an invalid model" do
+    customer = Quickeebooks::Windows::Model::Customer.new
+    customer.valid_for_update?.should == false
+    customer.errors.keys.include?(:sync_token).should == true
+  end
+  
+end

data/spec/quickeebooks_spec.rb

@@ -0,0 +1,11 @@
+require "spec_helper"
+require "quickeebooks"
+
+describe Quickeebooks do
+
+  describe "VERSION" do
+    subject { Quickeebooks::VERSION }
+    it { should be_a String }
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+require "rubygems"
+require "rspec"
+
+$:.unshift "lib"
+
+def mock_error(subject, message)
+  mock_exit do
+    mock(subject).puts("ERROR: #{message}")
+    yield
+  end
+end
+
+def mock_exit(&block)
+  block.should raise_error(SystemExit)
+end
+
+Rspec.configure do |config|
+  config.color_enabled = true
+  config.mock_with :rr
+end

data/spec/xml/online/account.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Account 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">
+	<Id idDomain="QBO">37</Id>
+	<SyncToken>0</SyncToken>
+	<MetaData>
+		<CreateTime>2012-02-18T15:50:17-08:00</CreateTime>
+		<LastUpdatedTime>2012-02-18T15:50:17-08:00</LastUpdatedTime>
+	</MetaData>
+	<Name>Billy Bob</Name>
+	<AccountParentId idDomain="QBO">36</AccountParentId>
+	<Subtype>AccountsPayable</Subtype>
+	<CurrentBalance>0.00</CurrentBalance>
+</Account>

data/spec/xml/online/accounts.xml

@@ -0,0 +1,108 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<qbo:SearchResults 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:CdmCollections xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Accounts">
+    <Account>
+      <Id idDomain="QBO">30</Id>
+      <SyncToken>0</SyncToken>
+      <MetaData>
+        <CreateTime>2012-01-22T20:28:58-08:00</CreateTime>
+        <LastUpdatedTime>2012-01-22T20:28:58-08:00</LastUpdatedTime>
+      </MetaData>
+      <Name>Accounts Receivable (A/R)</Name>
+      <Subtype>AccountsReceivable</Subtype>
+      <CurrentBalance>6200.00</CurrentBalance>
+    </Account>
+    <Account>
+      <Id idDomain="QBO">7</Id>
+      <SyncToken>0</SyncToken>
+      <MetaData>
+        <CreateTime>2011-09-29T15:42:38-07:00</CreateTime>
+        <LastUpdatedTime>2011-09-29T15:42:38-07:00</LastUpdatedTime>
+      </MetaData>
+      <Name>Advertising</Name>
+      <Subtype>AdvertisingPromotional</Subtype>
+    </Account>
+    <Account>
+      <Id idDomain="QBO">8</Id>
+      <SyncToken>0</SyncToken>
+      <MetaData>
+        <CreateTime>2011-09-29T15:42:38-07:00</CreateTime>
+        <LastUpdatedTime>2011-09-29T15:42:38-07:00</LastUpdatedTime>
+      </MetaData>
+      <Name>Bank Charges</Name>
+      <Subtype>BankCharges</Subtype>
+    </Account>
+    <Account>
+      <Id idDomain="QBO">9</Id>
+      <SyncToken>0</SyncToken>
+      <MetaData>
+        <CreateTime>2011-09-29T15:42:38-07:00</CreateTime>
+        <LastUpdatedTime>2011-09-29T15:42:38-07:00</LastUpdatedTime>
+      </MetaData>
+      <Name>Commissions &amp; Fees</Name>
+      <Subtype>OtherMiscellaneousServiceCost</Subtype>
+    </Account>
+    <Account>
+      <Id idDomain="QBO">32</Id>
+      <SyncToken>0</SyncToken>
+      <MetaData>
+        <CreateTime>2012-01-22T20:34:01-08:00</CreateTime>
+        <LastUpdatedTime>2012-01-22T20:34:01-08:00</LastUpdatedTime>
+      </MetaData>
+      <Name>Cost of Goods Sold</Name>
+      <Subtype>SuppliesMaterialsCogs</Subtype>
+    </Account>
+    <Account>
+      <Id idDomain="QBO">28</Id>
+      <SyncToken>0</SyncToken>
+      <MetaData>
+        <CreateTime>2011-09-29T15:45:43-07:00</CreateTime>
+        <LastUpdatedTime>2011-09-29T15:45:43-07:00</LastUpdatedTime>
+      </MetaData>
+      <Name>Discounts given</Name>
+      <Subtype>DiscountsRefundsGiven</Subtype>
+    </Account>
+    <Account>
+      <Id idDomain="QBO">10</Id>
+      <SyncToken>0</SyncToken>
+      <MetaData>
+        <CreateTime>2011-09-29T15:42:38-07:00</CreateTime>
+        <LastUpdatedTime>2011-09-29T15:42:38-07:00</LastUpdatedTime>
+      </MetaData>
+      <Name>Dues &amp; Subscriptions</Name>
+      <Subtype>DuesSubscriptions</Subtype>
+    </Account>
+    <Account>
+      <Id idDomain="QBO">5</Id>
+      <SyncToken>0</SyncToken>
+      <MetaData>
+        <CreateTime>2011-09-29T15:42:38-07:00</CreateTime>
+        <LastUpdatedTime>2011-09-29T15:42:38-07:00</LastUpdatedTime>
+      </MetaData>
+      <Name>Fees Billed</Name>
+      <Subtype>ServiceFeeIncome</Subtype>
+    </Account>
+    <Account>
+      <Id idDomain="QBO">11</Id>
+      <SyncToken>0</SyncToken>
+      <MetaData>
+        <CreateTime>2011-09-29T15:42:38-07:00</CreateTime>
+        <LastUpdatedTime>2011-09-29T15:42:38-07:00</LastUpdatedTime>
+      </MetaData>
+      <Name>Insurance</Name>
+      <Subtype>Insurance</Subtype>
+    </Account>
+    <Account>
+      <Id idDomain="QBO">25</Id>
+      <SyncToken>0</SyncToken>
+      <MetaData>
+        <CreateTime>2011-09-29T15:42:38-07:00</CreateTime>
+        <LastUpdatedTime>2011-09-29T15:42:38-07:00</LastUpdatedTime>
+      </MetaData>
+      <Name>Interest Earned</Name>
+      <Subtype>InterestEarned</Subtype>
+    </Account>
+  </qbo:CdmCollections>
+  <qbo:Count>10</qbo:Count>
+  <qbo:CurrentPage>1</qbo:CurrentPage>
+</qbo:SearchResults>

data/spec/xml/online/customer.xml

@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Customer>
+  <Id idDomain="QBO">1</Id>
+  <SyncToken>1</SyncToken>
+  <MetaData>
+    <CreateTime>2011-09-29T15:45:12-07:00</CreateTime>
+    <LastUpdatedTime>2012-01-22T20:35:57-08:00</LastUpdatedTime>
+  </MetaData>
+  <Name>John Doe</Name>
+  <Address>
+    <Line1>123 Main St.</Line1>
+    <Line2>Suite 400</Line2>
+    <City>San Diego</City>
+    <Country>USA</Country>
+    <CountrySubDivisionCode>CA</CountrySubDivisionCode>
+    <PostalCode>96009</PostalCode>
+    <Tag>Billing</Tag>
+  </Address>
+  <Address>
+    <Line1>123 Main St.</Line1>
+    <Line2>Suite 400</Line2>
+    <City>San Diego</City>
+    <Country>USA</Country>
+    <CountrySubDivisionCode>CA</CountrySubDivisionCode>
+    <PostalCode>96009</PostalCode>
+    <Tag>Shipping</Tag>
+  </Address>
+  <Phone>
+    <DeviceType>Primary</DeviceType>
+    <FreeFormNumber>(408) 555-1212</FreeFormNumber>
+  </Phone>
+  <Phone>
+    <DeviceType>Mobile</DeviceType>
+    <FreeFormNumber>(831) 334-0987</FreeFormNumber>
+  </Phone>
+  <WebSite/>
+  <Email>
+    <Address>johndoe@gmail.com</Address>
+  </Email>
+  <GivenName>John</GivenName>
+  <FamilyName>Doe</FamilyName>
+  <DBAName>John's Wine Shop</DBAName>
+  <Notes>
+    <Content>Likes chocolate and horses</Content>
+  </Notes>
+  <CustomField xsi:type="BooleanTypeCustomField">
+    <DefinitionId>Bill With Parent</DefinitionId>
+    <Value>false</Value>
+  </CustomField>
+  <CustomField xsi:type="StringTypeCustomField">
+    <DefinitionId>Resale Number</DefinitionId>
+    <Value>ABC-123</Value>
+  </CustomField>
+  <CustomField xsi:type="StringTypeCustomField">
+    <DefinitionId>Preferred Delivery Method</DefinitionId>
+    <Value>PRINT</Value>
+  </CustomField>
+  <SalesTermId idDomain="QBO">3</SalesTermId>
+  <PaymentMethodId idDomain="QBO">5</PaymentMethodId>
+  <OpenBalance>
+    <Amount>6200</Amount>
+  </OpenBalance>
+</Customer>