f2b 0.1.0

data/.gitignore

@@ -0,0 +1,3 @@
+*.gem
+.yardoc
+doc/

data/README.md

@@ -0,0 +1,69 @@
+F2b
+===
+
+Gem para integração com o serviço de pagamentos da [F2b](http://f2b.com.br).
+
+Instalação
+----------
+
+### RubyGems ###
+
+    sudo gem install f2b
+
+Depois insira o código de importação em algum lugar do seu projeto.
+
+    require 'rubygems'  
+    require 'f2b'
+
+### Bundler ###
+
+Se estiver usando o [Bundler](http://github.com/carlhuda/bundler) adicione a seguinte linha no seu Gemfile.
+
+    gem 'f2b'
+
+Como usar
+---------
+
+#### cobrancas_controller.rb (Rails) ####
+
+    def create
+      cobranca = F2b::Cobranca.new
+      cobranca.sacador = {:conta => "9023010001230123", :senha => "zero"}
+      # cobranca...
+      resposta = cobranca.submit!
+      # render stuff
+    end
+
+Exemplo
+-------
+
+    cobranca = F2b::Cobranca.new
+    cobranca.sacador = {:conta => "3127519739821794", :senha => "laszlo", :nome => "Pirate Laszlo the Bald"}
+    cobranca.cobranca = {:valor => 10.00}
+    cobranca.demonstrativo.concat ["Mensalidade"]
+    cobranca.agendamento = {:vencimento => (Date.today + 5).strftime, :periodos => 12, :titulo => "Mensalidade"}
+    cobranca.sacados.push({:nome => "Sheng Hou", :email => "teste@f2b.com.br", :envio => "e"})
+    @resposta = cobranca.submit!
+
+Licença
+-------
+
+Copyright (c) 2011 Rainer Borene
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/Rakefile

@@ -0,0 +1,20 @@
+$:.unshift File.expand_path('../lib', __FILE__)
+require 'rake'
+require 'spec/rake/spectask'
+require 'f2b'
+
+task :default => [:spec]
+
+desc "Generate a gemspec file"
+task :build do
+  system "gem build f2b.gemspec"
+end
+
+desc "Push gem to rubygems"
+task :release => :build do 
+  system "gem push f2b-#{F2b::VERSION}"
+end
+
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = Dir.glob('spec/*_spec.rb')
+end

data/f2b.gemspec

@@ -0,0 +1,25 @@
+# encoding: utf-8
+$:.unshift File.expand_path('../lib', __FILE__)
+require 'f2b'
+
+Gem::Specification.new do |s|
+  s.name = 'f2b'
+  s.version = F2b::VERSION
+  s.platform = Gem::Platform::RUBY
+  s.authors = ["Rainer Borene"]
+  s.email = "me@rainerborene.com"
+  s.homepage = "https://github.com/rainerborene/f2b"
+  s.summary = "F2b - Serviço de Cobranças"
+  s.description = "Integração com o serviço da F2b para envio e agendamento de cobranças."
+  s.required_ruby_version = ">= 1.8.6"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+
+  s.require_path = 'lib'
+  
+  s.add_dependency("curb", ">= 0.7.8")
+  s.add_dependency("nokogiri", ">= 0")
+  s.add_dependency("handsoap", ">= 1.1.7")
+end

data/lib/f2b.rb

@@ -0,0 +1,8 @@
+require 'cgi'
+require 'handsoap'
+require 'f2b/cobranca'
+require 'f2b/cobranca_status'
+
+module F2b
+  VERSION = '0.1.0'
+end

data/lib/f2b/cobranca.rb

@@ -0,0 +1,155 @@
+# encoding: utf-8
+module F2b
+  class Cobranca < Handsoap::Service
+    endpoint :uri => "https://www.f2b.com.br/WSBilling", :version => 1
+    
+    attr_accessor :numero
+    attr_accessor :sacador
+    attr_accessor :cobranca
+    attr_reader :demonstrativo
+    attr_accessor :desconto
+    attr_accessor :multa
+    attr_accessor :agendamento
+    attr_reader :sacados
+    
+    def initialize
+      @demonstrativo = []
+      @sacados = []
+    end
+    
+    def on_create_document(doc)
+      doc.alias 'wsb', 'http://www.f2b.com.br/soap/wsbilling.xsd'
+    end
+    
+    def on_response_document(doc)
+      doc.add_namespace 'm', 'http://www.f2b.com.br/soap/wsbilling.xsd'
+    end
+    
+    def submit!
+      response = invoke("wsb:F2bCobranca") do |message|
+        message.add "mensagem" do |m|
+          m.set_attr "data", Date.today.to_s
+          m.set_attr "numero", @numero unless @numero.nil?
+          m.set_attr "tipo_ws", "WebService"
+        end
+        
+        message.add "sacador" do |s|
+          s.set_attr "conta", @sacador.fetch(:conta)
+          s.set_attr "senha", @sacador.fetch(:senha)
+          s.set_value @sacador.fetch(:nome)
+        end
+        
+        if @cobranca
+          message.add "cobranca" do |c|
+            c.set_attr "valor", @cobranca.fetch(:valor)
+            c.set_attr "tipo_cobranca", @cobranca.fetch(:tipo_cobranca) if @cobranca.has_key? :tipo_cobranca
+            c.set_attr "num_document", @cobranca.fetch(:num_document) if @cobranca.has_key? :num_document
+            c.set_attr "cod_banco", @cobranca.fetch(:cod_banco) if @cobranca.has_key? :cod_banco
+            
+            @demonstrativo.each do |value|
+              c.add "demonstrativo", value
+            end
+            
+            if @desconto
+              c.add "desconto" do |d|
+                d.set_attr "valor", @desconto.fetch(:valor)
+                d.set_attr "tipo_desconto", @desconto.fetch(:tipo_desconto)
+                d.set_attr "antecedencia", @desconto.fetch(:antecedencia)
+              end
+            end
+            
+            if @multa
+              c.add "multa" do |m|
+                m.set_attr "valor", @multa.fetch(:valor)
+                m.set_attr "tipo_multa", @multa.fetch(:tipo_multa)
+                m.set_attr "valor_dia", @multa.fetch(:valor_dia)
+                m.set_attr "tipo_multa_dia", @multa.fetch(:tipo_multa_dia)
+                m.set_attr "atraso", @multa.fetch(:atraso)
+              end
+            end
+          end
+          
+          message.add "agendamento" do |a|
+            a.set_attr "vencimento", @agendamento.fetch(:vencimento)
+            a.set_attr "ultimo_dia", @agendamento.fetch(:ultimo_dia) if @agendamento.has_key? :ultimo_dia
+            a.set_attr "antecedencia", @agendamento.fetch(:antecedencia) if @agendamento.has_key? :antecedencia
+            a.set_attr "periodicidade", @agendamento.fetch(:periodicidade) if @agendamento.has_key? :periodicidade
+            a.set_attr "periodos", @agendamento.fetch(:periodos) if @agendamento.has_key? :periodos
+            a.set_attr "sem_vencimento", @agendamento.fetch(:sem_vencimento) if @agendamento.has_key? :sem_vencimento
+            a.set_value @agendamento.fetch(:titulo) if @agendamento.has_key? :titulo
+          end
+        end
+        
+        # 1 ou mais sacados
+        @sacados.each do |sacado|
+          message.add "sacado" do |s|
+            s.set_attr "grupo", sacado.fetch(:grupo) if sacado.has_key? :grupo
+            s.set_attr "codigo", sacado.fetch(:codigo) if sacado.has_key? :codigo
+            s.set_attr "envio", sacado.fetch(:envio) if sacado.has_key? :envio
+            s.set_attr "atualizar", sacado.fetch(:atualizar) if sacado.has_key? :atualizar
+            
+            s.add "nome", sacado.fetch(:nome)
+            s.add "email", sacado.fetch(:email)
+            
+            build_address!(s, sacado[:endereco]) if sacado.has_key? :endereco
+            build_phones!(s, sacado)
+            
+            s.add "cpf", sacado.fetch(:cpf) if sacado.has_key? :cpf
+            s.add "cnpj", sacado.fetch(:cnpj) if sacado.has_key? :cnpj
+            s.add "observacao", sacado.fetch(:observacao) if sacado.has_key? :observacao
+          end
+        end
+      end
+      
+      parse_response(response)
+    end
+    
+    private
+    
+    def parse_response(response)
+      cobrancas = []
+      message = CGI.unescapeHTML((response/"//log").to_s)
+      
+      if message.include? "ERRO"
+        raise message
+      else
+        (response/"//cobranca").each do |node|
+          cobranca = {}
+          cobranca[:nome] = node/"nome".to_s
+          cobranca[:email] = node/"email".to_s
+          cobranca[:url] = node/"url".to_s
+          cobrancas.push(cobranca)
+        end
+      end
+      
+      cobrancas.empty? ? message : cobrancas
+    end
+    
+    def build_address!(node, address)
+      node.add "endereco" do |e|
+        e.set_attr "logradouro", address.fetch(:logradouro)
+        e.set_attr "numero", address.fetch(:numero)
+        e.set_attr "complemento", address.fetch(:complemento) if address.has_key? :complemento
+        e.set_attr "bairro", address.fetch(:bairro) if address.has_key? :bairro
+        e.set_attr "cidade", address.fetch(:cidade)
+        e.set_attr "estado", address.fetch(:estado)
+        e.set_attr "cep", address.fetch(:cep)
+      end
+    end
+    
+    def build_phones!(node, source)
+      phones = source.select { |k, v| [:telefone, :telefone_com, :telefone_cel].include? k }
+      
+      phones.each do |key|
+        type = key.to_s.gsub("_\w+$").to_s
+        prefix = source[key][:ddd]
+        number = source[key][:numero]
+        
+        node.add(key.to_s) do |p|
+          p.set_attr "ddd#{type}", prefix
+          p.set_attr "numero#{type}", number
+        end
+      end
+    end
+  end
+end

data/lib/f2b/cobranca_status.rb

@@ -0,0 +1,81 @@
+# encoding: utf-8
+module F2b
+  class Cobranca::Status < Handsoap::Service
+    endpoint :uri => "https://www.f2b.com.br/WSBillingStatus", :version => 1
+    
+    attr_accessor :mensagem
+    attr_accessor :cliente
+    attr_accessor :cobranca
+    
+    def on_create_document(doc)
+      doc.alias 'wsb', 'http://www.f2b.com.br/soap/wsbillingstatus.xsd'
+    end
+    
+    def on_response_document(doc)
+      doc.add_namespace 'm', 'http://www.f2b.com.br/soap/wsbillingstatus.xsd'
+    end
+    
+    def submit!
+      response = invoke("wsb:F2bSituacaoCobranca") do |message|
+        message.add "mensagem" do |m|
+          m.set_attr "data", @mensagem.fetch(:data)
+          m.set_attr "numero", @mensagem.fetch(:numero)
+        end
+        
+        message.add "cliente" do |c|
+          c.set_attr "conta", @cliente.fetch(:conta)
+          c.set_attr "senha", @cliente.fetch(:senha)
+        end
+        
+        message.add "cobranca" do |c|
+          build_chooseable_attr! c, :numero, @cobranca
+          build_chooseable_attr! c, :registro, @cobranca
+          build_chooseable_attr! c, :vencimento, @cobranca
+          build_chooseable_attr! c, :processamento, @cobranca
+          build_chooseable_attr! c, :credito, @cobranca
+          
+          c.set_attr "cod_sacado", @cobranca.fetch(:cod_sacado) if @cobranca.has_key? :cod_sacado
+          c.set_attr "cod_grupo", @cobranca.fetch(:cod_grupo) if @cobranca.has_key? :cod_grupo
+          c.set_attr "tipo_pagamento", @cobranca.fetch(:tipo_pagamento) if @cobranca.has_key? :tipo_pagamento
+          c.set_attr "numero_documento", @cobranca.fetch(:numero_documento) if @cobranca.has_key? :numero_documento
+        end
+      end
+      
+      parse_response(response)
+    end
+    
+    private
+    
+    def build_chooseable_attr!(node, name, source)
+      other = "#{name.to_s}_final".to_sym
+      
+      if source.has_key? name
+        node.set_attr(name.to_s, source.fetch(name))
+      elsif source.has_key? other
+        node.set_attr(other.to_s, source.fetch(other))
+      end
+    end
+    
+    def parse_response(response)
+      cobranca = {}
+      message = CGI.unescapeHTML((response/"//log").to_s)
+      
+      if message.include? "ERRO"
+        raise message
+      else
+        (response/"//cobranca").each do |node|
+          node.attributes.each_pair do |key, value|
+            cobranca[key.to_sym] = value
+          end
+          
+          node.xpath("*").each do |n|
+            nodename = n.nodename.to_sym
+            cobranca[nodename] = n.to_s
+          end
+        end
+      end
+      
+      cobranca.empty? ? message : cobranca
+    end
+  end
+end

data/spec/cobranca_spec.rb

@@ -0,0 +1,22 @@
+# encoding: utf-8
+require 'spec'
+require 'f2b'
+
+describe "Cobranca" do
+  
+  before :all do
+    @cobranca = F2b::Cobranca.new
+    @cobranca.numero = "000000001"
+    @cobranca.sacador = {:conta => "5718973289173910", :senha => "morales", :nome => "Susan Morales"}
+    @cobranca.cobranca = {:valor => 10.00}
+    @cobranca.demonstrativo.concat ["Mensalidade"]
+    @cobranca.agendamento = {:vencimento => (Date.today + 5).to_s, :periodos => 12, :titulo => "Mensalidade"}
+    @cobranca.sacados.push({:nome => "Sheng Hou", :email => "teste@f2b.com.br", :envio => "e"})
+    @cobranca = @cobranca.submit!
+  end
+  
+  it "should be sent without any errors" do
+    @cobranca.should == "OK\r\nTESTE"
+  end
+  
+end

data/spec/status_spec.rb

@@ -0,0 +1,19 @@
+# encoding: utf-8
+require 'spec'
+require 'f2b'
+
+describe "Status" do
+  
+  before :all do
+    @situacao = F2b::Cobranca::Status.new
+    @situacao.mensagem = {:data => Date.today.to_s, :numero => "000000001"}
+    @situacao.cliente = {:conta => "3712897519713890", :senha => "morales"}
+    @situacao.cobranca = {:numero => "000000001", :registro => "", :vencimento => "", :processamento => "", :credito => ""}
+    @situacao = @situacao.submit!
+  end
+  
+  it "should be sent without any errors" do
+    @situacao.should == "OK\r\n"
+  end
+
+end

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification 
+name: f2b
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Rainer Borene
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-11 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: curb
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 0
+        - 7
+        - 8
+        version: 0.7.8
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: handsoap
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 29
+        segments: 
+        - 1
+        - 1
+        - 7
+        version: 1.1.7
+  type: :runtime
+  version_requirements: *id003
+description: "Integra\xC3\xA7\xC3\xA3o com o servi\xC3\xA7o da F2b para envio e agendamento de cobran\xC3\xA7as."
+email: me@rainerborene.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- README.md
+- Rakefile
+- f2b.gemspec
+- lib/f2b.rb
+- lib/f2b/cobranca.rb
+- lib/f2b/cobranca_status.rb
+- spec/cobranca_spec.rb
+- spec/status_spec.rb
+homepage: https://github.com/rainerborene/f2b
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 59
+      segments: 
+      - 1
+      - 8
+      - 6
+      version: 1.8.6
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.5
+signing_key: 
+specification_version: 3
+summary: "F2b - Servi\xC3\xA7o de Cobran\xC3\xA7as"
+test_files: 
+- spec/cobranca_spec.rb
+- spec/status_spec.rb