invoicexpress 0.0.0

data/spec/fixtures/simplified_invoices.list.xml

@@ -0,0 +1,114 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<simplified_invoices>
+  <results>
+    <current_page>1</current_page>
+    <entries>2</entries>
+    <total_entries>2</total_entries>
+  </results>
+  <simplified_invoice>
+    <id>1425061</id>
+    <status>settled</status>
+    <archived>false</archived>
+    <type>SimplifiedInvoice</type>
+    <sequence_number>1/2013</sequence_number>
+    <date>01/05/2013</date>
+    <reference></reference>
+    <observations>Artigo 16&#186; n&#186; 6 do CIVA. </observations>
+    <retention></retention>
+    <permalink>http://www.invoicexpress.net/documents/9c21e2aa2fd5a9f999673bc993407a562177fecb</permalink>
+    <client>
+      <id>550611</id>
+      <name>Pedro Sousa</name>
+      <email>psousa@thinkorange.pt</email>
+      <address>Rua Luisa de Cam&#245;es 18</address>
+      <postal_code>1231-123</postal_code>
+      <country>Portugal</country>
+      <fiscal_id>210533382</fiscal_id>
+    </client>
+    <currency>Euro</currency>
+    <items type="array">
+      <item>
+        <name>Item 1</name>
+        <description></description>
+        <unit_price>60.0</unit_price>
+        <unit>unit</unit>
+        <quantity>2.0</quantity>
+        <tax>
+          <name></name>
+          <value>0.0</value>
+        </tax>
+        <discount>0.0</discount>
+      </item>
+      <item>
+        <name>Item 2</name>
+        <description></description>
+        <unit_price>50.0</unit_price>
+        <unit>unit</unit>
+        <quantity>1.0</quantity>
+        <tax>
+          <name></name>
+          <value>0.0</value>
+        </tax>
+        <discount>0.0</discount>
+      </item>
+    </items>
+    <sum>170.0</sum>
+    <discount>0.0</discount>
+    <before_taxes>170.0</before_taxes>
+    <taxes>0.0</taxes>
+    <total>170.0</total>
+  </simplified_invoice>
+  <simplified_invoice>
+    <id>1425061</id>
+    <status>settled</status>
+    <archived>false</archived>
+    <type>SimplifiedInvoice</type>
+    <sequence_number>1/2013</sequence_number>
+    <date>01/05/2013</date>
+    <reference></reference>
+    <observations>Artigo 16&#186; n&#186; 6 do CIVA. </observations>
+    <retention></retention>
+    <permalink>http://www.invoicexpress.net/documents/9c21e2aa2fd5a9f999673bc993407a562177fecb</permalink>
+    <client>
+      <id>550611</id>
+      <name>Pedro Sousa</name>
+      <email>psousa@thinkorange.pt</email>
+      <address>Rua Luisa de Cam&#245;es 18</address>
+      <postal_code>1231-123</postal_code>
+      <country>Portugal</country>
+      <fiscal_id>210533382</fiscal_id>
+    </client>
+    <currency>Euro</currency>
+    <items type="array">
+      <item>
+        <name>Item 1</name>
+        <description></description>
+        <unit_price>60.0</unit_price>
+        <unit>unit</unit>
+        <quantity>2.0</quantity>
+        <tax>
+          <name></name>
+          <value>0.0</value>
+        </tax>
+        <discount>0.0</discount>
+      </item>
+      <item>
+        <name>Item 2</name>
+        <description></description>
+        <unit_price>50.0</unit_price>
+        <unit>unit</unit>
+        <quantity>1.0</quantity>
+        <tax>
+          <name></name>
+          <value>0.0</value>
+        </tax>
+        <discount>0.0</discount>
+      </item>
+    </items>
+    <sum>170.0</sum>
+    <discount>0.0</discount>
+    <before_taxes>170.0</before_taxes>
+    <taxes>0.0</taxes>
+    <total>170.0</total>
+  </simplified_invoice>
+</simplified_invoices>

data/spec/fixtures/simplified_invoices.update_state.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<simplified_invoice>
+  <id>1425061</id>
+  <type>SimplifiedInvoice</type>
+  <sequence_number>1/2013</sequence_number>
+  <state>settled</state>
+</simplified_invoice>

data/spec/fixtures/taxes.create.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<tax>
+  <name>IVA19</name>
+  <value>19.0</value>
+  <region>PT</region>
+  <default_tax>1</default_tax>
+</tax>

data/spec/fixtures/taxes.list.xml

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<taxes>
+ <tax>
+  <id>1</id>
+  <name>IVA20</name>
+  <value>20</value>
+  <region>PT</region>
+  <default_tax>1</default_tax>
+  <!-- default tax -->
+ </tax>
+ <tax>
+  <id>2</id>
+  <name>IVA21</name>
+  <value>21</value>
+  <region>PT</region>
+  <default_tax>0</default_tax>
+ </tax>
+</taxes>

data/spec/fixtures/taxes.update.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<tax>
+  <name>IVA23</name>
+  <value>23.0</value>
+  <region>PT</region>
+  <default_tax>1</default_tax>
+</tax>

data/spec/fixtures/users.accounts.xml

@@ -0,0 +1,12 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<accounts>
+  <account>
+    <id>13233</id>
+    <name>thinkorangeteste</name>
+    <url>https://thinkorangeteste.invoicexpress.net</url>
+    <api_key>xptoxpto</api_key>
+    <country>Portugal</country>
+    <state>active</state>
+    <blocked>false</blocked>
+  </account>
+</accounts>

data/spec/fixtures/users.login.xml

@@ -0,0 +1,11 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<accounts>
+  <account>
+    <id>13233</id>
+    <name>thinkorangeteste</name>
+    <url>https://thinkorangeteste.invoicexpress.net</url>
+    <api_key>xptoxpto</api_key>
+    <state>active</state>
+    <blocked>false</blocked>
+  </account>
+</accounts>

data/spec/helper.rb

@@ -0,0 +1,62 @@
+require 'simplecov'
+
+if ENV['COVERAGE']
+  SimpleCov.start do
+    add_filter "/spec"
+  end
+end
+
+require 'invoicexpress'
+require 'rspec'
+require 'webmock/rspec'
+
+def stub_get(url)
+  stub_request(:get, invoicexpress_url(url))
+end
+
+def stub_post(url)
+  stub_request(:post, invoicexpress_url(url))
+end
+
+def stub_put(url)
+  stub_request(:put, invoicexpress_url(url))
+end
+
+def stub_delete(url)
+  stub_request(:delete, invoicexpress_url(url))
+end
+
+def fixture_path
+  File.expand_path("../fixtures", __FILE__)
+end
+
+def fixture(file)
+  File.new(fixture_path + "/" + file)
+end
+
+def empty_xml_response
+  {
+    :body => "",
+    :headers => {
+      :content_type => "application/xml; charset=utf-8"
+    }
+  }
+end
+
+def xml_response(file)
+  {
+    :body => fixture(file),
+    :headers => {
+      :content_type => "application/xml; charset=utf-8"
+    }
+  }
+end
+
+def invoicexpress_url(url)
+  if url =~ /^http/
+    url
+  else
+    "https://thinkorangeteste.invoicexpress.net#{url}"
+  end
+end
+

data/spec/invoicexpress/client/charts_spec.rb

@@ -0,0 +1,69 @@
+require 'helper'
+
+describe Invoicexpress::Client::Charts do
+
+  before do
+    @client = Invoicexpress::Client.new(:screen_name => "thinkorangeteste")
+  end
+
+  describe ".invoicing_chart" do
+    it "Returns the invoicing chart data." do
+      stub_get("/api/charts/invoicing.xml").
+        to_return(xml_response("charts.invoicing.xml"))
+
+      chart = @client.invoicing_chart
+      chart.series.values.count.should == 6
+      chart.graphs.first.values.count.should == 6
+    end
+  end
+
+  describe ".treasury_chart" do
+    it "Returns the treasury chart data." do
+      stub_get("/api/charts/treasury.xml").
+        to_return(xml_response("charts.treasury.xml"))
+
+      chart = @client.treasury_chart
+      #all there
+      chart.series.values.count.should == 7
+      #4 graphs
+      chart.graphs.count.should ==4
+      #count values
+      chart.graphs.first.values.count.should ==7
+      
+    end
+  end
+  
+  describe ".top_clients" do
+    it "Returns the top 5 clients." do
+       stub_get("/api/charts/top-clients.xml").
+         to_return(xml_response("charts.top-clients.xml"))
+
+       chart = @client.top_clients
+       chart.clients.first.name.should =="Ruben Fonseca"
+       chart.clients.size.should ==1
+    end
+  end
+  
+  describe ".top_debtors" do
+    it "Returns the top 5 debtors." do
+       stub_get("/api/charts/top-debtors.xml").
+         to_return(xml_response("charts.top-debtors.xml"))
+
+       chart = @client.top_debtors
+       chart.clients.size.should ==1
+       chart.clients.first.name.should =="Ruben Fonseca"
+    end
+  end
+
+  describe ".quarterly_results" do
+    it "return all the quarterly results." do
+      stub_get("/api/charts/quarterly-results.xml?year=2010").
+        to_return(xml_response("charts.quarterly-results.xml"))
+
+      list = @client.quarterly_results(2010)
+      list.quarter01.invoicing.should ==60.0
+      list.year.should ==2010
+   end
+  end
+   
+end

data/spec/invoicexpress/client/clients_spec.rb

@@ -0,0 +1,108 @@
+require 'helper'
+
+describe Invoicexpress::Client::Clients do
+
+  before do
+    @client = Invoicexpress::Client.new(:screen_name => "thinkorangeteste")
+  end
+
+  describe ".clients" do
+    it "returns all the clients" do
+      stub_get("/clients.xml?per_page=30&page=1").
+        to_return(xml_response("clients.list.xml"))
+
+      list = @client.clients
+      list.count.should == 1
+      list.first.name.should == "Ruben Fonseca"
+      list.first.email.should == "fonseka@gmail.com"
+    end
+  end
+
+  describe ".create_client" do
+    it "creates a new client" do
+      stub_post("/clients.xml").
+        to_return(xml_response("clients.create.xml"))
+
+      model_client = Invoicexpress::Models::Client.new({
+        :name => "Ruben Fonseca",
+        :email => "fonseka@gmail.com"
+      })
+
+      new_client = @client.create_client(model_client)
+      new_client.name.should == "Ruben Fonseca"
+      new_client.email.should == "fonseka@gmail.com"
+    end
+
+    it "raises if no client is passed" do
+      expect {
+        @client.create_client(nil)
+      }.to raise_error(ArgumentError)
+    end
+
+    it "raises if the client has no name" do
+      expect {
+        @client.create_client(Invoicexpress::Models::Client.new)
+      }.to raise_error(ArgumentError)
+    end
+  end
+
+  describe ".update_client" do
+    it "updates the client" do
+      stub_put("/clients/123.xml").
+        to_return(xml_response("clients.update.xml"))
+
+      model = Invoicexpress::Models::Client.new(:id => 123)
+
+      expect { @client.update_client(model) }.to_not raise_error
+    end
+
+    it "raises if no client is passed" do
+      expect {
+        @client.update_client(nil)
+      }.to raise_error(ArgumentError)
+    end
+
+    it "raises if the client to update has no id" do
+      expect {
+        @client.update_client(Invoicexpress::Models::Client.new)
+      }.to raise_error(ArgumentError)
+    end
+  end
+
+  describe ".client" do
+    it "gets a client" do
+      stub_get("/clients/1.xml").
+        to_return(xml_response("clients.get.xml"))
+
+      c = @client.client(1)
+      c.name.should == "Bruce Norris"
+      c.code.should == 1337
+    end
+  end
+
+  describe ".client_invoices" do
+    it "gets the client's invoices" do
+      stub_post("/clients/1/invoices.xml").
+        to_return(xml_response("clients.invoices.xml"))
+
+      invoices = @client.client_invoices(1)
+      invoices.results.entries.should == 0
+      invoices.results.total_entries == 0
+    end
+
+    it "gets the client's invoices with filters" do
+      filter = Invoicexpress::Models::Filter.new({
+        :status   => [:draft, :final],
+        :by_type  => ["Receipt"],
+        :archived => [:non_archived]
+      })
+
+      stub_post("/clients/1/invoices.xml").
+        to_return(xml_response("clients.invoices.xml"))
+
+      invoices = @client.client_invoices(1, filter)
+      invoices.results.entries.should == 0
+    end
+  end
+
+end

data/spec/invoicexpress/client/credit_notes_spec.rb

@@ -0,0 +1,104 @@
+require 'helper'
+
+describe Invoicexpress::Client::CreditNotes do
+  before do
+    @client = Invoicexpress::Client.new(:screen_name => "thinkorangeteste")
+  end
+
+  describe ".credit_notes" do
+    it "Returns all the credit notes" do
+      stub_get("/credit_notes.xml?page=1").
+        to_return(xml_response("credit_notes.list.xml"))
+
+      credit_notes = @client.credit_notes
+      credit_notes.count.should == 2
+      credit_notes.first.id == 1415679
+    end
+  end
+
+  describe ".create_credit_note" do
+    it "creates a new credit note" do
+      stub_post("/credit_notes.xml").
+        to_return(xml_response("credit_notes.create.xml"))
+
+      
+      cnote = Invoicexpress::Models::CreditNote.new(
+        :date => Date.new(2013, 5, 1),
+        :due_date => Date.new(2013, 6, 1),
+        :tax_exemption => "M01",
+        :client => Invoicexpress::Models::Client.new(
+          :name => "Pedro Sousa"
+        ),
+        :items => [
+          Invoicexpress::Models::Item.new(
+            :name => "Item 1",
+            :unit_price => 60,
+            :quantity => 2,
+            :unit => "unit",
+          ),
+          Invoicexpress::Models::Item.new(
+            :name => "Item 2",
+            :unit_price => 50,
+            :quantity => 1,
+            :unit => "unit",
+          )
+        ]
+      )
+
+      cnote = @client.create_credit_note(cnote)
+      cnote.id.should        == 1423940
+      cnote.status           == "draft"
+    end
+  end
+
+  describe ".update_credit_note" do
+    it "updates the credit note" do
+      stub_put("/credit_notes/1423940.xml").
+        to_return(xml_response("ok.xml"))
+
+      model = Invoicexpress::Models::CreditNote.new(:id => 1423940)
+      expect { @client.update_credit_note(model) }.to_not raise_error
+    end
+    it "raises if no credit note is passed" do
+      expect {
+        @client.update_credit_note(nil)
+      }.to raise_error(ArgumentError)
+    end
+    it "raises if the credit_note to update has no id" do
+      stub_put("/credit_notes/.xml").
+        to_return(xml_response("ok.xml"))
+      expect {
+        @client.update_credit_note(Invoicexpress::Models::CreditNote.new)
+      }.to raise_error(ArgumentError)
+    end
+  end
+
+  describe ".update_credit_note_state" do
+    it "updates the state" do
+      stub_put("/credit_notes/1423940/change-state.xml").
+        to_return(xml_response("credit_notes.update_state.xml"))
+
+      state = Invoicexpress::Models::InvoiceState.new(
+        :state => "finalized"
+      )
+      expect { cnote = @client.update_credit_note_state(1423940, state) }.to_not raise_error
+    end
+  end
+ 
+  describe ".credit_note_mail" do
+    it "sends the credit note through email" do
+      stub_put("/credit_notes/1423940/email-document.xml").
+        to_return(xml_response("credit_notes.email_document.xml"))
+
+      message = Invoicexpress::Models::Message.new(
+        :subject => "Hello world",
+        :body => "Here is the invoice.",
+        :client => Invoicexpress::Models::Client.new(
+          :name => "Pedro Sousa",
+          :email=> 'psousa@thinkorange.pt'
+        )
+      )
+      expect { cnote = @client.credit_note_mail(1423940, message) }.to_not raise_error
+    end
+  end
+end