tulios-brcobranca-rails2 2.0.8

data/History.txt

@@ -0,0 +1,29 @@
+== 2.0.7 22-12-2010
+
+* Incluindo boleto para banco Caixa - Túlio Ornelas
+
+== 2.0.6 16-08-2009
+
+* Incluindo boleto para banco Santander Banespa - Diego Lucena
+
+== 2.0.4 04-05-2009
+
+* Solucionado problemas com refatoração do retorno.
+
+== 2.0.3 25-04-2009
+
+* Incluindo boleto para o banco Bradesco(Todas as Carteiras)
+* Incluindo boleto para o banco UNIBANCO(com e sem registro)
+
+== 2.0.2 21-04-2009
+
+* Incluindo boleto para o banco Real(com e sem registro)
+
+== 2.0.1 19-04-2009
+
+* Ajustes finais para lançamento
+
+== 2.0.0 06-04-2009
+
+* 1 acts_as_payment torna-se brcobranca:
+  * Release inicial com versão em 2.0.0

data/Manifest.txt

@@ -0,0 +1,54 @@
+History.txt
+Manifest.txt
+PostInstall.txt
+README.rdoc
+Rakefile
+brcobranca.gemspec
+lib/brcobranca.rb
+lib/brcobranca/arquivos/logos/banespa.jpg
+lib/brcobranca/arquivos/logos/bb.jpg
+lib/brcobranca/arquivos/logos/bradesco.jpg
+lib/brcobranca/arquivos/logos/hsbc.jpg
+lib/brcobranca/arquivos/logos/itau.jpg
+lib/brcobranca/arquivos/logos/real.jpg
+lib/brcobranca/arquivos/logos/unibanco.jpg
+lib/brcobranca/arquivos/logos/caixa.jpg
+lib/brcobranca/arquivos/templates/modelo_generico.eps
+lib/brcobranca/boleto/banco_banespa.rb
+lib/brcobranca/boleto/banco_bradesco.rb
+lib/brcobranca/boleto/banco_brasil.rb
+lib/brcobranca/boleto/banco_hsbc.rb
+lib/brcobranca/boleto/banco_itau.rb
+lib/brcobranca/boleto/banco_real.rb
+lib/brcobranca/boleto/banco_unibanco.rb
+lib/brcobranca/boleto/banco_caixa.rb
+lib/brcobranca/boleto/base.rb
+lib/brcobranca/boleto/template/rghost.rb
+lib/brcobranca/boleto/template/util.rb
+lib/brcobranca/config.rb
+lib/brcobranca/core_ext.rb
+lib/brcobranca/currency.rb
+lib/brcobranca/retorno/base.rb
+lib/brcobranca/retorno/retorno_cbr643.rb
+spec/arquivos/CBR64310.RET
+spec/brcobranca/banco_banespa_spec.rb
+spec/brcobranca/banco_bradesco_spec.rb
+spec/brcobranca/banco_brasil_spec.rb
+spec/brcobranca/banco_hsbc_spec.rb
+spec/brcobranca/banco_itau_spec.rb
+spec/brcobranca/banco_real_spec.rb
+spec/brcobranca/banco_unibanco_spec.rb
+spec/brcobranca/banco_caixa_spec.rb
+spec/brcobranca/base_spec.rb
+spec/brcobranca/core_ext_spec.rb
+spec/brcobranca/currency_spec.rb
+spec/brcobranca/retorno_cbr643_spec.rb
+spec/brcobranca/rghost_spec.rb
+spec/brcobranca/template/rghost_spec.rb
+spec/brcobranca/template/util_spec.rb
+spec/brcobranca_spec.rb
+spec/rcov.opts
+spec/spec.opts
+spec/spec_helper.rb
+tasks/rcov.rake
+tasks/rspec.rake

data/PostInstall.txt

@@ -0,0 +1,4 @@
+
+Para maiores informações veja http://brcobranca.rubyforge.org
+
+Para exemplos de como usar veja http://www.boletorails.com.br

data/README.rdoc

@@ -0,0 +1,75 @@
+= brcobranca
+
+* http://brcobranca.rubyforge.org
+
+== EXEMPLO
+
+* http://www.boletorails.com.br
+
+== DESCRIÇÃO
+
+Gem para emissão de bloquetos de cobrança para bancos brasileiros
+
+== Bancos Disponíveis
+
+* Banco do Brasil
+  * TODAS AS CARTEIRAS PRESENTES NA DOCUMENTAÇÃO
+
+* Banco Itaú
+  * TODAS AS CARTEIRAS PRESENTES NA DOCUMENTAÇÃO
+
+* Banco HSBC
+  * CNR
+
+* Banco Real
+  * Sem registro
+  * Com registro
+
+* Banco Bradesco
+  * TODAS AS CARTEIRAS PRESENTES NA DOCUMENTAÇÃO
+
+* Banco UNIBANCO
+  * Sem registro
+  * Com registro
+
+* Banco Caixa
+  * Sem registro
+
+== Esta perdido?
+
+Veja a documentação em http://brcobranca.rubyforge.org/rdoc
+
+== REQUISITOS
+
+* rghost
+* rghost_barcode
+* parseline
+* GhostScript > 8.0
+
+== INSTALAÇÃO
+
+* sudo gem install brcobranca
+
+== FONTES
+
+* http://github.com/kivanio/brcobranca/tree/master
+
+== WIKI
+
+* http://wiki.github.com/kivanio/brcobranca
+
+== PROBLEMAS? QUERENDO MAIS?
+
+Informe em http://github.com/kivanio/brcobranca/issues
+
+== Gostou?
+
+Recomende-nos no http://www.workingwithrails.com/recommendation/new/person/5679-kivanio-pereira-barbosa
+
+== LICENSA
+
+BSD
+
+De brasileiro para brasileiros.
+
+Copyleft 2009 Kivanio Barbosa

data/Rakefile

@@ -0,0 +1,41 @@
+require 'rubygems'
+gem 'hoe', '>= 2.1.0'
+require 'hoe'
+require 'fileutils'
+require './lib/brcobranca'
+
+Hoe.plugin :newgem
+Hoe.plugin :website
+# Hoe.plugin :cucumberfeatures
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.spec 'tulios-brcobranca-rails2' do
+  self.developer 'Kivanio Barbosa', 'kivanio@gmail.com'
+  self.post_install_message = 'PostInstall.txt' # TODO remove if post-install message not required
+  self.rubyforge_name       = self.name # TODO this is default value
+  self.extra_deps         = [
+    ['rghost','>= 0.8.7'],
+    ['rghost_barcode','>= 0.8'],
+    ['parseline','>= 1.0.3']
+  ]
+
+  self.summary = %Q{Gem que permite trabalhar com bloquetos de cobrança para bancos brasileiros.
+    Fork de https://github.com/kivanio/brcobranca, tag 2.0.6 adicionando o banco Caixa.
+  }
+  self.description = %Q{Gem que permite trabalhar com bloquetos de cobrança para bancos brasileiros.
+    Fork de https://github.com/kivanio/brcobranca, tag 2.0.6 adicionando o banco Caixa.
+  }
+  self.clean_globs |= %w[**/.DS_Store tmp *.log]
+  # self.rdoc_pattern = /rb$|rdoc$/
+  path = (self.rubyforge_name == self.name) ? self.rubyforge_name : "\#{self.rubyforge_name}/\#{self.name}"
+  self.remote_rdoc_dir = File.join(path.gsub(/^#{self.rubyforge_name}\/?/,''), 'rdoc')
+  self.rsync_args = '-av --delete --ignore-errors'
+end
+
+require 'newgem/tasks'
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+# TODO - want other tests/tasks run by default? Add them to the list
+# remove_task :default
+# task :default => [:spec, :features]

data/brcobranca.gemspec

@@ -0,0 +1,43 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{brcobranca}
+  s.version = "2.0.6"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Kivanio Barbosa"]
+  s.date = %q{2009-08-17}
+  s.description = %q{Gem para emissão de bloquetos de cobrança de bancos brasileiros.}
+  s.email = ["kivanio@gmail.com"]
+  s.extra_rdoc_files = ["History.txt", "Manifest.txt", "PostInstall.txt"]
+  s.files = ["History.txt", "Manifest.txt", "PostInstall.txt", "README.rdoc", "Rakefile", "brcobranca.gemspec", "lib/brcobranca.rb", "lib/brcobranca/arquivos/logos/banespa.jpg", "lib/brcobranca/arquivos/logos/bb.jpg", "lib/brcobranca/arquivos/logos/bradesco.jpg", "lib/brcobranca/arquivos/logos/hsbc.jpg", "lib/brcobranca/arquivos/logos/itau.jpg", "lib/brcobranca/arquivos/logos/real.jpg", "lib/brcobranca/arquivos/logos/unibanco.jpg", "lib/brcobranca/arquivos/templates/modelo_generico.eps", "lib/brcobranca/boleto/banco_banespa.rb", "lib/brcobranca/boleto/banco_bradesco.rb", "lib/brcobranca/boleto/banco_brasil.rb", "lib/brcobranca/boleto/banco_hsbc.rb", "lib/brcobranca/boleto/banco_itau.rb", "lib/brcobranca/boleto/banco_real.rb", "lib/brcobranca/boleto/banco_unibanco.rb", "lib/brcobranca/boleto/base.rb", "lib/brcobranca/boleto/template/rghost.rb", "lib/brcobranca/boleto/template/util.rb", "lib/brcobranca/config.rb", "lib/brcobranca/core_ext.rb", "lib/brcobranca/currency.rb", "lib/brcobranca/retorno/base.rb", "lib/brcobranca/retorno/retorno_cbr643.rb", "spec/arquivos/CBR64310.RET", "spec/brcobranca/banco_banespa_spec.rb", "spec/brcobranca/banco_bradesco_spec.rb", "spec/brcobranca/banco_brasil_spec.rb", "spec/brcobranca/banco_hsbc_spec.rb", "spec/brcobranca/banco_itau_spec.rb", "spec/brcobranca/banco_real_spec.rb", "spec/brcobranca/banco_unibanco_spec.rb", "spec/brcobranca/base_spec.rb", "spec/brcobranca/core_ext_spec.rb", "spec/brcobranca/currency_spec.rb", "spec/brcobranca/retorno_cbr643_spec.rb", "spec/brcobranca/rghost_spec.rb", "spec/brcobranca/template/rghost_spec.rb", "spec/brcobranca/template/util_spec.rb", "spec/brcobranca_spec.rb", "spec/rcov.opts", "spec/spec.opts", "spec/spec_helper.rb", "tasks/rcov.rake", "tasks/rspec.rake"]
+  s.homepage = %q{http://brcobranca.rubyforge.org}
+  s.post_install_message = %q{PostInstall.txt}
+  s.rdoc_options = ["--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{brcobranca}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Gem que permite trabalhar com bloquetos de cobrança para bancos brasileiros.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rghost>, [">= 0.8.7"])
+      s.add_runtime_dependency(%q<rghost_barcode>, [">= 0.8"])
+      s.add_runtime_dependency(%q<parseline>, [">= 1.0.3"])
+      s.add_development_dependency(%q<hoe>, [">= 2.3.3"])
+    else
+      s.add_dependency(%q<rghost>, [">= 0.8.7"])
+      s.add_dependency(%q<rghost_barcode>, [">= 0.8"])
+      s.add_dependency(%q<parseline>, [">= 1.0.3"])
+      s.add_dependency(%q<hoe>, [">= 2.3.3"])
+    end
+  else
+    s.add_dependency(%q<rghost>, [">= 0.8.7"])
+    s.add_dependency(%q<rghost_barcode>, [">= 0.8"])
+    s.add_dependency(%q<parseline>, [">= 1.0.3"])
+    s.add_dependency(%q<hoe>, [">= 2.3.3"])
+  end
+end

data/lib/brcobranca/boleto/banco_banespa.rb

@@ -0,0 +1,85 @@
+# Banco BANESPA
+class BancoBanespa < Brcobranca::Boleto::Base
+
+  def initialize(campos={})
+    padrao = {:carteira => "COB", :banco => "033"}
+    campos = padrao.merge!(campos)
+    super(campos)
+  end
+
+  # Número sequencial utilizado para distinguir os boletos na agência
+  def nosso_numero
+    "#{self.agencia.zeros_esquerda(:tamanho => 3)}#{self.numero_documento.zeros_esquerda(:tamanho => 7)}"
+  end
+  
+  # Retorna dígito verificador do nosso número calculado como contas na documentação
+  def nosso_numero_dv
+    self.nosso_numero.zeros_esquerda(:tamanho => 10).modulo_10_banespa
+  end
+  
+  # Retorna nosso numero pronto para exibir no boleto
+  def nosso_numero_boleto
+    "#{self.nosso_numero[0..2]} #{self.nosso_numero[3..9]} #{self.nosso_numero_dv}"
+  end
+  
+  def agencia_conta_boleto
+    convenio = self.convenio.zeros_esquerda(:tamanho => 11)
+    "#{convenio[0..2]} #{convenio[3..4]} #{convenio[5..9]} #{convenio[10..10]}"
+  end
+
+  # Responsável por montar uma String com 43 caracteres que será usado na criação do código de barras.
+  def monta_codigo_43_digitos
+    banco = self.banco.zeros_esquerda(:tamanho => 3)
+    fator = self.data_vencimento.fator_vencimento.zeros_esquerda(:tamanho => 4)
+    valor_documento = self.valor_documento.limpa_valor_moeda.zeros_esquerda(:tamanho => 10)
+    numero = "#{banco}#{self.moeda}#{fator}#{valor_documento}#{self.campo_livre_com_dv1_e_dv2}"
+    numero.size == 43 ? numero : nil
+  end
+
+  # CAMPO LIVRE
+  #    Código do cedente                                                                            PIC  9  (011)
+  #    Nosso número                                                                                 PIC  9  (007)
+  #    Filler                                                                                       PIC  9  (002)   = 00
+  #    Código do banco cedente                                                                      PIC  9  (003)   = 033
+  #    Dígito verificador 1                                                                         PIC  9  (001)
+  #    Dígito verificador 2                                                                         PIC  9  (001)
+  def campo_livre
+    "#{self.convenio.zeros_esquerda(:tamanho => 11)}#{self.numero_documento.zeros_esquerda(:tamanho => 7)}00#{self.banco.zeros_esquerda(:tamanho => 3)}"
+  end
+                                                                  
+  #campo livre com os digitos verificadores como conta na documentação do banco
+  def campo_livre_com_dv1_e_dv2
+    dv1 = self.campo_livre.modulo10 #dv 1 inicial
+    dv2 = nil
+    multiplicadores = [2,3,4,5,6,7]
+    begin
+      recalcular_dv2 = false
+      valor_inicial = "#{self.campo_livre}#{dv1}"
+      total = 0
+      multiplicador_posicao = 0
+
+      valor_inicial.split(//).reverse!.each do |caracter|
+        multiplicador_posicao = 0 if (multiplicador_posicao == 6)
+        total += (caracter.to_i * multiplicadores[multiplicador_posicao])
+        multiplicador_posicao += 1
+      end
+
+      case total % 11
+      when 0 then
+        dv2 = 0
+      when 1 then
+        if dv1 == 9
+          dv1 = 0
+        else
+          dv1 += 1
+        end
+        recalcular_dv2 = true
+      else
+        dv2 = 11 - (total % 11)
+      end
+    end while(recalcular_dv2)
+
+    return "#{self.campo_livre}#{dv1}#{dv2}"
+  end
+
+end

data/lib/brcobranca/boleto/banco_bradesco.rb

@@ -0,0 +1,44 @@
+# Banco BRADESCO
+class BancoBradesco < Brcobranca::Boleto::Base
+  # Responsável por definir dados iniciais quando se cria uma nova intancia da classe BancoBradesco
+  def initialize(campos={})
+    padrao={:carteira => "06", :banco => "237"}
+    campos = padrao.merge!(campos)
+    super(campos)
+  end
+  
+  # Campo usado apenas na exibição no boleto
+  #  Deverá ser sobreescrito para cada banco
+  def nosso_numero_boleto
+   "#{self.carteira}/#{self.numero_documento.zeros_esquerda(:tamanho => 11)}-#{self.nosso_numero_dv}"
+  end
+
+  # Campo usado apenas na exibição no boleto
+  #  Deverá ser sobreescrito para cada banco
+  def agencia_conta_boleto
+   "#{self.agencia}-#{self.agencia_dv} / #{self.conta_corrente}-#{self.conta_corrente_dv}"
+  end
+
+  # Responsável por montar uma String com 43 caracteres que será usado na criação do código de barras
+  #   As posições do campo livre ficam a critério de cada Banco arrecadador, sendo que o
+  #   padrão do Bradesco é:
+  #   Posição Tamanho Conteúdo
+  #   20 a 23 4 Agência Cedente (Sem o digito verificador, completar com zeros a esquerda quando  necessário)
+  #   24 a 25 2 Carteira
+  #   26 a 36 11 Número do Nosso Número(Sem o digito verificador)
+  #   37 a 43 7 Conta do Cedente (Sem o digito verificador, completar com zeros a esquerda quando necessário)
+  #   44 a 44 1 Zero
+
+  def monta_codigo_43_digitos
+    banco = self.banco.zeros_esquerda(:tamanho => 3)
+    fator = self.data_vencimento.fator_vencimento
+    valor_documento = self.valor_documento.limpa_valor_moeda.zeros_esquerda(:tamanho => 10)
+    agencia = self.agencia.zeros_esquerda(:tamanho => 4)
+    carteira = self.carteira.zeros_esquerda(:tamanho => 2)
+    numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 11)
+    conta = self.conta_corrente.zeros_esquerda(:tamanho => 7)
+
+    numero = "#{banco}#{self.moeda}#{fator}#{valor_documento}#{agencia}#{carteira}#{numero_documento}#{conta}0"
+    numero.size == 43 ? numero : nil
+  end
+end

data/lib/brcobranca/boleto/banco_brasil.rb

@@ -0,0 +1,88 @@
+# Banco do Brasil
+class BancoBrasil < Brcobranca::Boleto::Base
+
+  # Responsável por definir dados iniciais quando se cria uma nova intância da classe BancoBrasil
+  def initialize(campos={})
+    padrao={:carteira => "18", :banco => "001", :codigo_servico => false}
+    campos = padrao.merge!(campos)
+    super(campos)
+  end
+
+  # Retorna digito verificador do banco, calculado com modulo11 de 9 para 2, porem em caso de resultado ser 10, usa-se 'X'
+  def banco_dv
+    self.banco.modulo11_9to2_10_como_x
+  end
+
+  # Retorna digito verificador da agencia, calculado com modulo11 de 9 para 2, porem em caso de resultado ser 10, usa-se 'X'
+  def agencia_dv
+    self.agencia.modulo11_9to2_10_como_x
+  end
+
+  # Retorna digito verificador da conta corrente, calculado com modulo11 de 9 para 2, porem em caso de resultado ser 10, usa-se 'X'
+  def conta_corrente_dv
+    self.conta_corrente.modulo11_9to2_10_como_x
+  end
+
+  # Retorna digito verificador do nosso numero, calculado com modulo11 de 9 para 2, porem em caso de resultado ser 10, usa-se 'X'
+  # Inclui ainda o numero do convenio no calculo
+  def nosso_numero_dv
+    "#{self.convenio}#{self.numero_documento}".modulo11_9to2_10_como_x
+  end
+  
+  # Campo usado apenas na exibição no boleto
+  #  Deverá ser sobreescrito para cada banco
+  def nosso_numero_boleto
+   "#{self.convenio}#{self.numero_documento}-#{self.nosso_numero_dv}"
+  end
+
+  # Campo usado apenas na exibição no boleto
+  #  Deverá ser sobreescrito para cada banco
+  def agencia_conta_boleto
+   "#{self.agencia}-#{self.agencia_dv} / #{self.conta_corrente}-#{self.conta_corrente_dv}"
+  end
+
+  # Responsavel por montar uma String com 43 caracteres que será usado na criacao do codigo de barras
+  def monta_codigo_43_digitos
+    banco = self.banco.zeros_esquerda(:tamanho => 3)
+    valor_documento = self.valor_documento.limpa_valor_moeda.zeros_esquerda(:tamanho => 10)
+    convenio = self.convenio.to_s
+    fator = self.data_vencimento.fator_vencimento
+    # A montagem é feita baseada na quantidade de dígitos do convênio.
+    case convenio.size
+    when 8 # Nosso Numero de 17 dígitos com Convenio de 8 dígitos e numero_documento de 9 dígitos
+      numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 9)
+      raise "Seu complemento está com #{numero_documento.size} dígitos. Com convênio de 8 dígitos, somente permite-se até 9 dígitos no numero_documento do nosso numero." if numero_documento.size > 9
+      numero = "#{banco}#{self.moeda}#{fator}#{valor_documento}000000#{convenio}#{numero_documento}#{self.carteira}"
+    when 7 # Nosso Numero de 17 dígitos com Convenio de 7 dígitos e numero_documento de 10 dígitos
+      numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 10)
+      raise "Seu complemento está com #{numero_documento.size} dígitos. Com convênio de 7 dígitos, somente permite-se até 10 dígitos no numero_documento do nosso numero." if numero_documento.size > 10
+      numero = "#{banco}#{self.moeda}#{fator}#{valor_documento}000000#{convenio}#{numero_documento}#{self.carteira}"
+    when 6 # Convenio de 6 dígitos
+      if self.codigo_servico == false
+        # Nosso Numero de 11 dígitos com Convenio de 6 dígitos e numero_documento de 5 digitos
+        numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 5)
+        raise "Seu numero_documento está com #{numero_documento.size} dígitos. Com convênio de 6 dígitos, somente permite-se até 5 dígitos no numero_documento do nosso numero. Para emitir boletos com nosso numero de 17 dígitos, coloque o atributo codigo_servico=true" if numero_documento.size > 5
+        agencia = self.agencia.zeros_esquerda(:tamanho => 4)
+        conta = self.conta_corrente.zeros_esquerda(:tamanho => 8)
+        numero = "#{banco}#{self.moeda}#{fator}#{valor_documento}#{convenio}#{numero_documento}#{agencia}#{conta}#{self.carteira}"
+      else
+        # Nosso Numero de 17 dígitos com Convenio de 6 dígitos e sem numero_documento, carteira 16 e 18
+        numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 17)
+        raise "Seu numero_documento está com #{numero_documento.size} dígitos. Com convênio de 6 dígitos, somente permite-se até 17 dígitos no numero_documento do nosso numero." if (numero_documento.size > 17)
+        raise "Só é permitido emitir boletos com nosso número de 17 dígitos com carteiras 16 ou 18. Sua carteira atual é #{self.carteira}" unless (["16","18"].include?(self.carteira))
+        numero = "#{banco}#{self.moeda}#{fator}#{valor_documento}#{convenio}#{numero_documento}21"
+      end
+    when 4 # Nosso Numero de 7 dígitos com Convenio de 4 dígitos e sem numero_documento
+      numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 7)
+      raise "Seu numero_documento está com #{numero_documento.size} dígitos. Com convênio de 4 dígitos, somente permite-se até 7 dígitos no numero_documento do nosso numero." if numero_documento.size > 7
+      agencia = self.agencia.zeros_esquerda(:tamanho => 4)
+      conta = self.conta_corrente.zeros_esquerda(:tamanho => 8)
+      numero = "#{banco}#{self.moeda}#{fator}#{valor_documento}#{convenio}#{numero_documento}#{agencia}#{conta}#{self.carteira}"
+    else
+      numero = ""
+    end
+
+    numero.size == 43 ? numero : nil
+  end
+
+end