twinfieldrb 0.3.0

data/spec/twinfield/sales_invoice_spec.rb

@@ -0,0 +1,253 @@
+require "spec_helper"
+
+describe Twinfield::SalesInvoice do
+  include SessionStubs
+  include ProcessxmlStubs
+
+  describe Twinfield::SalesInvoice::Line do
+    describe "class methods" do
+      describe ".new" do
+        it "should keep decials intact" do
+          expect(Twinfield::SalesInvoice::Line.new(quantity: 1.5, article: "A").quantity).to match(1.5)
+        end
+      end
+    end
+
+    describe "#to_xml" do
+      it "renders xml" do
+        expect(Twinfield::SalesInvoice::Line.new(article: "A").to_xml(1)).to match("<line id=\"1\">")
+        expect(Twinfield::SalesInvoice::Line.new(article: "A", id: 2).to_xml).to match("<line id=\"2\">")
+      end
+      it "formats dates correctly" do
+        expect(Twinfield::SalesInvoice::Line.new(article: "A", performancedate: Date.new(2020, 12, 23)).to_xml(1)).to match("20201223")
+      end
+    end
+
+    describe "#invoice" do
+      it "returns the containers invoice" do
+        invoice = Twinfield::SalesInvoice.new(duedate: Time.now, customer: "1001", invoicetype: "VERKOOP")
+        invoice.lines = [Twinfield::SalesInvoice::Line.new(article: "A")]
+        expect(invoice.associated_lines.first.invoice).to eq(invoice)
+      end
+    end
+  end
+
+  describe "class methods" do
+    before do
+      stub_create_session
+      stub_cluster_session_wsdl
+      stub_select_company
+    end
+
+    describe ".find" do
+      it "returns a sales invoice" do
+        stub_request(:post, "https://accounting.twinfield.com/webservices/processxml.asmx")
+          .with(body: /<read>\s*<type>salesinvoice<\/type>/)
+          .to_return(body: File.read(File.expand_path("../../fixtures/cluster/processxml/invoice/read_success.xml", __FILE__)))
+        invoice = Twinfield::SalesInvoice.find(13, invoicetype: "VERKOOP")
+        expect(invoice).to be_a(Twinfield::SalesInvoice)
+        expect(invoice.invoicenumber).to eq("13")
+        expect(invoice.financials.number).to eq("202100006")
+        expect(invoice.lines.first).to be_a(Twinfield::SalesInvoice::Line)
+        expect(invoice.lines[2].description).to eq("Custom article")
+        expect(invoice.vat_lines[0].vatname).to eq("BTW 21%")
+      end
+
+      it "returns nil when empty result" do
+        stub_request(:post, "https://accounting.twinfield.com/webservices/processxml.asmx")
+          .with(body: /<read>\s*<type>salesinvoice<\/type>/)
+          .to_return(body: File.read(File.expand_path("../../fixtures/cluster/processxml/invoice/read_not_found.xml", __FILE__)))
+        invoice = Twinfield::SalesInvoice.find(13, invoicetype: "VERKOOP")
+        expect(invoice).to eq(nil)
+      end
+    end
+
+    describe ".new" do
+      it "initializes from a hash" do
+        hash = {lines: [{id: "1", article: "HUUR", subarticle: "1", quantity: 1, units: 1, allowdiscountorpremium: "true", description: "Huur", unitspriceexcl: 7.23, unitspriceinc: nil, valueinc: 8.75, freetext1: nil, freetext2: nil, freetext3: nil, dim1: "8000", vatcode: "VH", performancetype: nil, performancedate: nil}, {id: "2", article: "-", subarticle: nil, quantity: nil, units: nil, allowdiscountorpremium: nil, description: "Beschrijving", unitspriceexcl: nil, unitspriceinc: nil, freetext1: nil, freetext2: nil, freetext3: nil, dim1: nil, vatcode: nil, performancetype: nil, performancedate: nil}], vat_lines: [{vatcode: "VH", vatvalue: 1.73, performancetype: "", performancedate: "", vatname: "BTW 21%"}], invoicetype: "FACTUUR", invoicedate: "2022-06-24", duedate: "2022-07-24", performancedate: nil, bank: "BNK", invoiceaddressnumber: 1, deliveraddressnumber: 1, customer_code: 2321, period: "2022/6", currency: "EUR", status: "final", paymentmethod: "bank", headertext: "", footertext: "Footer", office: "NL123", invoicenumber: "1622"}
+        invoice = Twinfield::SalesInvoice.new(**hash)
+        expect(invoice.invoicedate).to eq(Date.new(2022, 6, 24))
+        expect(invoice.invoicedate).not_to eq("2022-06-24")
+      end
+    end
+  end
+
+  describe "instance methods" do
+    describe "#final?" do
+      it "returns false by default" do
+        invoice = Twinfield::SalesInvoice.new(invoicetype: "F", customer_code: 12)
+        expect(invoice.final?).to be_falsey
+      end
+
+      it "returns true when status == final" do
+        invoice = Twinfield::SalesInvoice.new(invoicetype: "F", customer_code: 12, status: :final)
+        expect(invoice.final?).to be_truthy
+      end
+    end
+
+    describe "#transaction" do
+      it "retuns no transaction when no financials info" do
+        stub_create_session
+        stub_cluster_session_wsdl
+        stub_select_company
+
+        invoice = Twinfield::SalesInvoice.new(duedate: Time.now, customer: "1001", invoicetype: "VERKOOP", invoicenumber: "2021-0812")
+        invoice.transaction
+        expect(invoice.transaction).to be_nil
+      end
+
+      it "returns a transaction" do
+        invoice = Twinfield::SalesInvoice.new(duedate: Time.now, customer: "1001", invoicetype: "VERKOOP", invoicenumber: "2021-0812")
+        invoice.financials = Twinfield::SalesInvoice::Financials.new(code: "VRK", number: "20210812")
+
+        expect(Twinfield::Browse::Transaction::Customer).to receive(:find).with(code: "VRK", number: "20210812")
+        invoice.transaction
+      end
+
+      it "returns a transaction" do
+        stub_create_session
+        stub_cluster_session_wsdl
+        stub_select_company
+
+        stub_request(:post, "https://accounting.twinfield.com/webservices/processxml.asmx")
+          .with(body: /20210812/)
+          .to_return(body: File.read(File.expand_path("../../fixtures/cluster/processxml/columns/sales_transactions.xml", __FILE__)))
+
+        invoice = Twinfield::SalesInvoice.new(duedate: Time.now, customer: "1001", invoicetype: "VERKOOP", invoicenumber: "2021-0812")
+        invoice.financials = Twinfield::SalesInvoice::Financials.new(code: "VRK", number: "20210812")
+
+        invoice.transaction
+        expect(invoice.transaction).to be_a(Twinfield::Browse::Transaction::Customer)
+      end
+    end
+    describe "#to_xml" do
+      it "renders xml" do
+        invoice = Twinfield::SalesInvoice.new(duedate: Time.now, customer: "1001", invoicetype: "VERKOOP")
+        invoice.lines = [Twinfield::SalesInvoice::Line.new(article: "A")]
+        expect(invoice.to_xml).to match("<lines>\n    <line id=\"1\">")
+        expect(invoice.to_xml).not_to match("<invoicenumber")
+      end
+
+      it "renders xml with invoicenumber when given (updating)" do
+        invoice = Twinfield::SalesInvoice.new(duedate: Time.now, customer: "1001", invoicetype: "VERKOOP", invoicenumber: "12")
+        invoice.lines = [Twinfield::SalesInvoice::Line.new(article: "A")]
+        expect(invoice.to_xml).to match("<invoicenumber>12</invoicenumber>")
+      end
+    end
+
+    describe "#to_h" do
+      let(:invoice) {
+        invoice = Twinfield::SalesInvoice.new(duedate: Time.now, customer: "1001", invoicetype: "VERKOOP")
+        invoice.lines = [Twinfield::SalesInvoice::Line.new(article: "A")]
+        invoice
+      }
+      it "renders a hash" do
+        expect(invoice.to_h).to be_a Hash
+        expect(invoice.to_h[:customer_code]).to eq(1001)
+        expect(invoice.to_h[:lines][0][:article]).to eq("A")
+      end
+
+      it "enables a roundtrip" do
+        invoice2 = Twinfield::SalesInvoice.new(**invoice.to_h)
+        expect(invoice2.duedate).to eq(invoice.duedate)
+        expect(invoice2.lines.first.article).to eq("A")
+      end
+    end
+
+    describe ":financials" do
+      before do
+        stub_create_session
+        stub_cluster_session_wsdl
+        stub_select_company
+      end
+
+      it "survives a roundtrip" do
+        stub_request(:post, "https://accounting.twinfield.com/webservices/processxml.asmx")
+          .with(body: /<read>\s*<type>salesinvoice<\/type>/)
+          .to_return(body: File.read(File.expand_path("../../fixtures/cluster/processxml/invoice/read_success.xml", __FILE__)))
+        invoice = Twinfield::SalesInvoice.find(13, invoicetype: "VERKOOP")
+        expect(invoice.financials).to be_a Twinfield::SalesInvoice::Financials
+        financials_number = "202100006"
+
+        expect(invoice.financials.number).to eq financials_number
+        expect(invoice.to_h[:financials][:number]).to eq financials_number
+
+        Twinfield::SalesInvoice.new(**invoice.to_h)
+        expect(invoice.financials.number).to eq financials_number
+      end
+    end
+
+    describe "#save" do
+      before do
+        stub_create_session
+        stub_cluster_session_wsdl
+        stub_select_company
+      end
+
+      it "reports errors" do
+        stub_request(:post, "https://accounting.twinfield.com/webservices/processxml.asmx")
+          .with(body: /<customer>1001<\/customer>/)
+          .to_return(body: File.read(File.expand_path("../../fixtures/cluster/processxml/invoice/create_error.xml", __FILE__)))
+        invoice = Twinfield::SalesInvoice.new(duedate: Time.now, customer: "1001", invoicetype: "VERKOOP")
+        expect { invoice.save }.to raise_error(Twinfield::Create::Error)
+        invoice = Twinfield::SalesInvoice.new(duedate: Time.now, customer: "1001", invoicetype: "VERKOOP")
+        expect { invoice.save }.to raise_error(Twinfield::Create::EmptyInvoice)
+      end
+
+      it "reports errors when fixed because finalized" do
+        stub_request(:post, "https://accounting.twinfield.com/webservices/processxml.asmx")
+          .with(body: /<customer>1001<\/customer>/)
+          .to_return(body: File.read(File.expand_path("../../fixtures/cluster/processxml/invoice/create_final_error.xml", __FILE__)))
+        invoice = Twinfield::SalesInvoice.new(duedate: Time.now, customer: "1001", invoicetype: "VERKOOP")
+        expect { invoice.save }.to raise_error(Twinfield::Create::Error)
+        invoice = Twinfield::SalesInvoice.new(duedate: Time.now, customer: "1001", invoicetype: "VERKOOP")
+        expect { invoice.save }.to raise_error(Twinfield::Create::Finalized)
+      end
+
+      it "succeeds" do
+        stub_request(:post, "https://accounting.twinfield.com/webservices/processxml.asmx")
+          .with(body: /<customer>1001<\/customer>/)
+          .to_return(body: File.read(File.expand_path("../../fixtures/cluster/processxml/invoice/create_success.xml", __FILE__)))
+        invoice = Twinfield::SalesInvoice.new(duedate: Time.now, customer: "1001", invoicetype: "VERKOOP")
+        saved_invoice = invoice.save
+        expect(saved_invoice.invoicenumber).to eq("3")
+      end
+    end
+
+    describe "totals" do
+      before do
+        stub_create_session
+        stub_cluster_session_wsdl
+        stub_select_company
+        stub_request(:post, "https://accounting.twinfield.com/webservices/processxml.asmx")
+          .with(body: /<read>\s*<type>salesinvoice<\/type>/)
+          .to_return(body: File.read(File.expand_path("../../fixtures/cluster/processxml/invoice/read_success.xml", __FILE__)))
+        @invoice = Twinfield::SalesInvoice.find(13, invoicetype: "VERKOOP")
+      end
+
+      describe "#total" do
+        it "0 on an empty invoice" do
+          expect(Twinfield::SalesInvoice.new(invoicetype: "VERKOOP", customer: "1001").total).to eq(0)
+        end
+
+        it "sums lines perfectly" do
+          expect(@invoice.total).to eq(221.0)
+        end
+
+        it "defaults to total incl vat" do
+          expect(@invoice.totalinc).to eq(@invoice.total)
+        end
+      end
+
+      describe "#totalexcl" do
+        it "0 on an empty invoice" do
+          expect(Twinfield::SalesInvoice.new(invoicetype: "VERKOOP", customer: "1001").total).to eq(0)
+        end
+
+        it "sums lines perfectly" do
+          expect(@invoice.totalexcl).to eq(200.0)
+        end
+      end
+    end
+  end
+end

data/spec/twinfield/session_spec.rb

@@ -0,0 +1,77 @@
+require "spec_helper"
+
+describe Twinfield::Api::Session do
+  include SessionStubs
+
+  after do
+    reset_config
+  end
+
+  describe "successful logon" do
+    before(:all) do
+      stub_create_session
+      stub_cluster_session_wsdl
+      stub_select_company
+      @session = Twinfield::Api::Session.new
+      @session.logon
+    end
+
+    it "should return successful message" do
+      expect(@session.status).to eq "Ok"
+    end
+
+    it "should return that the current session already is connected" do
+      expect(@session.logon).to eq "already connected"
+    end
+
+    it "should return that the current session already is connected" do
+      stub_create_session
+      stub_cluster_session_wsdl
+      stub_select_company
+      expect(@session.relog).to eq "Ok"
+    end
+
+    it "should have a session_id after successful logon" do
+      expect(@session.session_id).not_to eq nil
+    end
+
+    it "should have a cluster after successful logon" do
+      expect(@session.cluster).not_to eq nil
+    end
+
+    it "should return true for connected" do
+      expect(@session.connected?).to eq true
+    end
+  end
+
+  describe "invalid logon" do
+    before(:all) do
+      username = "not_valid_username"
+
+      stub_create_session username: username, response: "Invalid"
+
+      Twinfield.configure do |config|
+        config.username = username
+      end
+
+      @session = Twinfield::Api::Session.new
+      @session.logon
+    end
+
+    it "should return invalid message" do
+      expect(@session.status).to eq "Invalid"
+    end
+
+    it "should not have a session_id" do
+      expect(@session.session_id).to eq nil
+    end
+
+    it "should not have a cluster" do
+      expect(@session.cluster).to eq nil
+    end
+
+    it "should return false for connected" do
+      expect(@session.connected?).to eq false
+    end
+  end
+end

data/spec/twinfield/transaction_spec.rb

@@ -0,0 +1,149 @@
+require "spec_helper"
+
+describe Twinfield::Transaction do
+  include SessionStubs
+  include ProcessxmlStubs
+
+  let(:today_string) do
+    Date.today.strftime("%Y%m%d")
+  end
+  let(:payment_transaction) do
+    trans = Twinfield::Transaction.new(code: "PIN", currency: "EUR", date: Date.new(2021, 1, 1))
+    trans.lines << Twinfield::Transaction::Line.new(type: :detail, balance_code: 1300, value: 60.5, debitcredit: :credit, customer_code: 1003, invoicenumber: 14)
+    trans.lines << Twinfield::Transaction::Line.new(type: :detail, balance_code: 1234, value: 60.5, debitcredit: :debit)
+    trans.lines << Twinfield::Transaction::Line.new(type: :total, balance_code: "1230", value: 0.0, debitcredit: :debit)
+    trans
+  end
+
+  describe Twinfield::Transaction::Line do
+    describe "#to_xml" do
+      it "converts a detail line to xml" do
+        expect(Twinfield::Transaction::Line.new(type: :detail, balance_code: 1055, value: 60.5, debitcredit: :debit).to_xml).to eq("<line type=\"detail\">\n  <dim1>1055</dim1>\n  <value>60.5</value>\n  <debitcredit>debit</debitcredit>\n  <currencydate>#{today_string}</currencydate>\n</line>")
+        expect(Twinfield::Transaction::Line.new(type: :detail, balance_code: 8020, value: 50, debitcredit: :credit, vatcode: "VH").to_xml).to eq("<line type=\"detail\">\n  <dim1>8020</dim1>\n  <value>50.0</value>\n  <debitcredit>credit</debitcredit>\n  <vatcode>VH</vatcode>\n  <currencydate>#{today_string}</currencydate>\n</line>")
+      end
+      it "converts a total line to xml" do
+        expect(Twinfield::Transaction::Line.new(type: :total, balance_code: "0000", value: 0.0, debitcredit: :debit).to_xml).to eq("<line type=\"total\">\n  <dim1>0000</dim1>\n  <value>0.0</value>\n  <debitcredit>debit</debitcredit>\n  <currencydate>#{today_string}</currencydate>\n</line>")
+      end
+    end
+  end
+
+  describe "#value" do
+    it "returns the negative value" do
+      expect(payment_transaction.value).to eq(-60.5)
+    end
+  end
+
+  describe "#to_xml" do
+    let(:expected_xml) {
+      "<transaction destiny=\"final\">
+  <header>
+    <office>company</office>
+    <code>PIN</code>
+    <currency>EUR</currency>
+    <date>20210101</date>
+    <period>2021/01</period>
+  </header>
+  <lines>
+    <line type=\"total\">
+  <dim1>1230</dim1>
+  <value>0.0</value>
+  <debitcredit>debit</debitcredit>
+  <currencydate>#{today_string}</currencydate>
+</line>
+    <line type=\"detail\">
+  <dim1>1300</dim1>
+  <dim2>1003</dim2>
+  <value>60.5</value>
+  <debitcredit>credit</debitcredit>
+  <invoicenumber>14</invoicenumber>
+  <currencydate>#{today_string}</currencydate>
+</line>
+    <line type=\"detail\">
+  <dim1>1234</dim1>
+  <value>60.5</value>
+  <debitcredit>debit</debitcredit>
+  <currencydate>#{today_string}</currencydate>
+</line>
+  </lines>
+</transaction>"
+    }
+
+    it "converts a PIN transaction to xml" do
+      expect(payment_transaction.to_xml).to eq(expected_xml)
+    end
+
+    context "with hash" do
+      let(:payment_transaction) do
+        trans_h = {
+          code: "PIN", currency: "EUR", date: Date.new(2021, 1, 1), lines: [
+            {type: :total, balance_code: "1230", value: 0.0, debitcredit: :debit},
+            {type: :detail, balance_code: 1300, value: 60.5, debitcredit: :credit, customer_code: 1003, invoicenumber: 14},
+            {type: :detail, balance_code: 1234, value: 60.5, debitcredit: :debit}
+          ]
+        }
+        Twinfield::Transaction.new(**trans_h)
+      end
+
+      it "converts a PIN transaction to xml" do
+        expect(payment_transaction.to_xml).to eq(expected_xml)
+      end
+    end
+  end
+
+  describe "#to_transaction_match_line_xml" do
+    it "returns a valid piece of xml" do
+      xml = Nokogiri::XML(Twinfield::Transaction.new(code: "PIN", number: "20210121").to_transaction_match_line_xml(2))
+      xml.css("line transcode").text
+      xml.css("line transnumber").text
+      xml.css("line transline").text == "1"
+    end
+  end
+
+  describe "#to_match_xml" do
+    it "doesn't work if values don't match" do
+      expect { payment_transaction.to_match_xml(Twinfield::Browse::Transaction::Customer.new(value: 20, code: "VRK")) }.to raise_error(Twinfield::TransactionMatchError)
+    end
+
+    it "returns xml if values match" do
+      matchdatestring = Date.today.strftime("%Y%m%d")
+      expect(payment_transaction.to_match_xml(Twinfield::Browse::Transaction::Customer.new(value: 60.5, code: "VRK"))).to eq("<match>
+          <set>
+            <matchcode>170</matchcode>
+            <office>company</office>
+            <matchdate>#{matchdatestring}</matchdate>
+            <lines>
+              <line><transcode>PIN</transcode><transnumber></transnumber><transline>1</transline></line>
+              <line><transcode>VRK</transcode><transnumber></transnumber><transline>2</transline></line>
+            </lines>
+          </set>
+        </match>")
+    end
+  end
+
+  describe "#match!" do
+    let(:error_body) { '<?xml version="1.0" encoding="utf-8"?><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><soap:Body><ProcessXmlStringResponse xmlns="http://www.twinfield.com/"><ProcessXmlStringResult>&lt;match result="0"&gt;&lt;set result="0"&gt;&lt;matchcode name="Debiteuren afletteren"&gt;170&lt;/matchcode&gt;&lt;office&gt;NLA002058&lt;/office&gt;&lt;matchdate&gt;20220203&lt;/matchdate&gt;&lt;lines result="0"&gt;&lt;line msgtype="error" msg="Boeking PIN 202200003 regel 1 is niet beschikbaar voor afletteren." result="0"&gt;&lt;transcode&gt;PIN&lt;/transcode&gt;&lt;transnumber&gt;202200003&lt;/transnumber&gt;&lt;transline&gt;1&lt;/transline&gt;&lt;origin&gt;import&lt;/origin&gt;&lt;status&gt;final&lt;/status&gt;&lt;/line&gt;&lt;line msgtype="error" msg="Boeking VRK 202100008 regel 2 is niet beschikbaar voor afletteren." result="0"&gt;&lt;transcode&gt;VRK&lt;/transcode&gt;&lt;transnumber&gt;202100008&lt;/transnumber&gt;&lt;transline&gt;2&lt;/transline&gt;&lt;origin&gt;invoice&lt;/origin&gt;&lt;status&gt;final&lt;/status&gt;&lt;/line&gt;&lt;/lines&gt;&lt;/set&gt;&lt;/match&gt;</ProcessXmlStringResult></ProcessXmlStringResponse></soap:Body></soap:Envelope>' }
+    let(:success_body) { '<?xml version="1.0" encoding="utf-8"?><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><soap:Body><ProcessXmlStringResponse xmlns="http://www.twinfield.com/"><ProcessXmlStringResult>&lt;match result="1"&gt;&lt;set result="1"&gt;&lt;matchcode name="Debiteuren afletteren"&gt;170&lt;/matchcode&gt;&lt;office&gt;NLA002058&lt;/office&gt;&lt;matchdate&gt;20220203&lt;/matchdate&gt;&lt;lines&gt;&lt;line result="1"&gt;&lt;transcode name="Verkoopfactuur" shortname="Verkoop"&gt;VRK&lt;/transcode&gt;&lt;transnumber&gt;202100008&lt;/transnumber&gt;&lt;transline&gt;1&lt;/transline&gt;&lt;origin&gt;invoice&lt;/origin&gt;&lt;status&gt;final&lt;/status&gt;&lt;dim1&gt;1300&lt;/dim1&gt;&lt;dim2&gt;1003&lt;/dim2&gt;&lt;matchlevel&gt;2&lt;/matchlevel&gt;&lt;basevalueopen&gt;221.00&lt;/basevalueopen&gt;&lt;repvalueopen&gt;221.00&lt;/repvalueopen&gt;&lt;valueopen&gt;221.00&lt;/valueopen&gt;&lt;matchvalue&gt;221.00&lt;/matchvalue&gt;&lt;matchvaluerep&gt;221.00&lt;/matchvaluerep&gt;&lt;matchvaluecur&gt;221.00&lt;/matchvaluecur&gt;&lt;/line&gt;&lt;line result="1"&gt;&lt;transcode name="Pintransacties" shortname="Pin"&gt;PIN&lt;/transcode&gt;&lt;transnumber&gt;202200004&lt;/transnumber&gt;&lt;transline&gt;2&lt;/transline&gt;&lt;origin&gt;import&lt;/origin&gt;&lt;status&gt;final&lt;/status&gt;&lt;dim1&gt;1300&lt;/dim1&gt;&lt;dim2&gt;1003&lt;/dim2&gt;&lt;matchlevel&gt;2&lt;/matchlevel&gt;&lt;basevalueopen&gt;-221.00&lt;/basevalueopen&gt;&lt;repvalueopen&gt;-221.00&lt;/repvalueopen&gt;&lt;valueopen&gt;-221.00&lt;/valueopen&gt;&lt;matchvalue&gt;-221.00&lt;/matchvalue&gt;&lt;matchvaluerep&gt;-221.00&lt;/matchvaluerep&gt;&lt;matchvaluecur&gt;-221.00&lt;/matchvaluecur&gt;&lt;/line&gt;&lt;/lines&gt;&lt;dimensions&gt;&lt;dimension level="2" matchnumber="2"&gt;1003&lt;/dimension&gt;&lt;/dimensions&gt;&lt;value&gt;0.00&lt;/value&gt;&lt;/set&gt;&lt;/match&gt;</ProcessXmlStringResult></ProcessXmlStringResponse></soap:Body></soap:Envelope>' }
+
+    before do
+      stub_create_session
+      stub_cluster_session_wsdl
+      stub_select_company
+    end
+
+    it "raises an error when they don't match" do
+      stub_request(:post, "https://accounting.twinfield.com/webservices/processxml.asmx")
+        .to_return(body: error_body)
+
+      expect { Twinfield::Browse::Transaction::Customer.new(value: 60.5, code: "VRK").match!(payment_transaction) }.to raise_error(Twinfield::TransactionMatchError)
+    end
+
+    it "returns the match when they match" do
+      stub_request(:post, "https://accounting.twinfield.com/webservices/processxml.asmx")
+        .to_return(body: success_body)
+
+      Twinfield::Browse::Transaction::Customer.new(value: 60.5, code: "VRK").match!(payment_transaction)
+
+      # nothing is really stored in the match it seems; but side effect is that the transactions change from available to matched
+    end
+  end
+end

data/twinfieldrb.gemspec

@@ -0,0 +1,24 @@
+$:.push File.expand_path("../lib", __FILE__)
+require "twinfield/version"
+
+Gem::Specification.new do |s|
+  s.name = "twinfieldrb"
+  s.version = Twinfield::Version::VERSION
+  s.authors = ["Ernst Rijsdijk", "Stephan van Diepen", "Joris Reijrink", "Maarten Brouwers"]
+  s.email = ["ernst.rijsdijk@holder.nl", "s.vandiepen@noxa.nl", "joris@sprintict.nl", "maarten@murb.nl"]
+  s.homepage = "https://github.com/murb/twinfield"
+  s.summary = "A simple client for the Twinfield SOAP-based API (continuation of the twinfield gem)"
+  s.description = "Twinfield is an international Web service for collaborative online accounting. The Twinfield gem is a simple client for their SOAP-based API."
+
+  # s.rubyforge_project = "twinfield"
+
+  s.files = `git ls-files`.split("\n")
+  s.executables = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency "savon", "~> 2.10"
+  s.add_runtime_dependency "nokogiri", "~> 1.6"
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "standard"
+  s.add_development_dependency "webmock"
+end