brcobranca 2.0.0

data/History.txt

@@ -0,0 +1,4 @@
+== 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,39 @@
+History.txt
+Manifest.txt
+README.rdoc
+Rakefile
+brcobranca.gemspec
+config/website.yml
+lib/brcobranca.rb
+lib/brcobranca/arquivos/logos/bb.jpg
+lib/brcobranca/arquivos/logos/hsbc.jpg
+lib/brcobranca/arquivos/logos/itau.jpg
+lib/brcobranca/arquivos/templates/modelo_generico.eps
+lib/brcobranca/boleto/banco_brasil.rb
+lib/brcobranca/boleto/banco_hsbc.rb
+lib/brcobranca/boleto/banco_itau.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/retorno_cbr643.rb
+script/console
+script/destroy
+script/generate
+script/txt2html
+test/arquivos/CBR64310.RET
+test/test_banco_brasil.rb
+test/test_banco_hsbc.rb
+test/test_banco_itau.rb
+test/test_base.rb
+test/test_core_ext.rb
+test/test_currency.rb
+test/test_helper.rb
+test/test_retorno_cbr643.rb
+website/index.html
+website/index.txt
+website/javascripts/rounded_corners_lite.inc.js
+website/stylesheets/screen.css
+website/template.html.erb

data/README.rdoc

@@ -0,0 +1,71 @@
+= 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
+  * Carteira 16
+    - Nosso Número de 11 dígitos(4 para convênio e 7 para número do documento)
+    - Nosso Número de 11 dígitos(6 para convênio e 5 para número do documento)
+    - Nosso Numero de 17 dígitos(7 para convênio e 10 para número do documento)
+    - Nosso Numero de 17 dígitos(convênio de 6 dígitos, porem usa-se 17 para número do documento)
+  * Carteira 17
+    - Nosso Numero de 11 dígitos(4 para convênio e 7 para número do documento)
+    - Nosso Numero de 11 dígitos(6 para convênio e 5 para número do documento)
+    - Nosso Numero de 17 dígitos(7 para convênio e 10 para número do documento)
+  * Carteira 18
+    - Nosso Numero de 11 dígitos(4 para convênio e 7 para número do documento)
+    - Nosso Numero de 11 dígitos(6 para convênio e 5 para número do documento)
+    - Nosso Numero de 17 dígitos(7 para convênio e 10 para número do documento)
+    - Nosso Numero de 17 dígitos(convênio de 6 dígitos, porem usa-se 17 para número do documento)
+
+* Itaú
+  * TODAS AS CARTEIRAS PRESENTES NA DOCUMENTAÇÃO
+
+* HSBC
+  * CNR
+
+
+== Esta perdido?
+
+Veja a documentação em http://brcobranca.rubyforge.org/rdoc
+
+== REQUISITOS
+
+* rghost
+* rghost_barcode
+* parseline
+
+== INSTALAÇÃO
+
+* sudo gem install brcobranca
+
+== FONTES
+
+* http://github.com/kivanio/brcobranca/tree/master
+
+== 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
+
+Este gem é licenciada pela licensa BSD
+
+De brasileiro para brasileiros.
+
+Copyleft 2009 Kivanio Barbosa

data/Rakefile

@@ -0,0 +1,32 @@
+%w[rubygems rake rake/clean fileutils newgem rubigen].each { |f| require f }
+require File.dirname(__FILE__) + '/lib/brcobranca'
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.new('brcobranca', Brcobranca::VERSION) do |p|
+  p.developer('Kivanio Barbosa', 'kivanio@gmail.com')
+  p.changes              = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  p.rubyforge_name       = p.name # TODO this is default value
+  p.extra_deps         = [
+    ['rghost','>= 0.8.3'],
+    ['rghost_barcode','>= 0.8'],
+    ['parseline','>= 1.0.2']
+  ]
+  p.extra_dev_deps = [
+    ['newgem', ">= #{::Newgem::VERSION}"]
+  ]
+  
+  p.rdoc_pattern = /rb$|rdoc$/
+  p.summary = 'Gem para emissão de bloquetos de cobrança de bancos brasileiros.'
+  p.description = p.summary
+  p.clean_globs |= %w[**/.DS_Store tmp *.log]
+  path = (p.rubyforge_name == p.name) ? p.rubyforge_name : "\#{p.rubyforge_name}/\#{p.name}"
+  p.remote_rdoc_dir = File.join(path.gsub(/^#{p.rubyforge_name}\/?/,''), 'rdoc')
+  p.rsync_args = '-av --delete --ignore-errors'
+end
+
+require 'newgem/tasks' # load /tasks/*.rake
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+# TODO - want other tests/tasks run by default? Add them to the list
+# task :default => [:spec, :features]

data/brcobranca.gemspec

@@ -0,0 +1,49 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{brcobranca}
+  s.version = "2.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Kivanio Barbosa"]
+  s.cert_chain = ["/Users/kivanio/.gem/gem-public_cert.pem"]
+  s.date = %q{2009-04-19}
+  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", "README.rdoc", "website/index.txt"]
+  s.files = ["History.txt", "Manifest.txt", "README.rdoc", "Rakefile", "brcobranca.gemspec", "config/website.yml", "lib/brcobranca.rb", "lib/brcobranca/arquivos/logos/bb.jpg", "lib/brcobranca/arquivos/logos/hsbc.jpg", "lib/brcobranca/arquivos/logos/itau.jpg", "lib/brcobranca/arquivos/templates/modelo_generico.eps", "lib/brcobranca/boleto/banco_brasil.rb", "lib/brcobranca/boleto/banco_hsbc.rb", "lib/brcobranca/boleto/banco_itau.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/retorno_cbr643.rb", "script/console", "script/destroy", "script/generate", "script/txt2html", "test/arquivos/CBR64310.RET", "test/test_banco_brasil.rb", "test/test_banco_hsbc.rb", "test/test_banco_itau.rb", "test/test_base.rb", "test/test_core_ext.rb", "test/test_currency.rb", "test/test_helper.rb", "test/test_retorno_cbr643.rb", "website/index.html", "website/index.txt", "website/javascripts/rounded_corners_lite.inc.js", "website/stylesheets/screen.css", "website/template.html.erb"]
+  s.has_rdoc = true
+  s.homepage = %q{http://brcobranca.rubyforge.org}
+  s.rdoc_options = ["--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{brcobranca}
+  s.rubygems_version = %q{1.3.2}
+  s.signing_key = %q{/Users/kivanio/.gem/gem-private_key.pem}
+  s.summary = %q{Gem para emissão de bloquetos de cobrança de bancos brasileiros.}
+  s.test_files = ["test/test_banco_brasil.rb", "test/test_banco_hsbc.rb", "test/test_banco_itau.rb", "test/test_base.rb", "test/test_core_ext.rb", "test/test_currency.rb", "test/test_helper.rb", "test/test_retorno_cbr643.rb"]
+
+  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.3"])
+      s.add_runtime_dependency(%q<rghost_barcode>, [">= 0.8"])
+      s.add_runtime_dependency(%q<parseline>, [">= 1.0.2"])
+      s.add_development_dependency(%q<newgem>, [">= 1.3.0"])
+      s.add_development_dependency(%q<hoe>, [">= 1.8.0"])
+    else
+      s.add_dependency(%q<rghost>, [">= 0.8.3"])
+      s.add_dependency(%q<rghost_barcode>, [">= 0.8"])
+      s.add_dependency(%q<parseline>, [">= 1.0.2"])
+      s.add_dependency(%q<newgem>, [">= 1.3.0"])
+      s.add_dependency(%q<hoe>, [">= 1.8.0"])
+    end
+  else
+    s.add_dependency(%q<rghost>, [">= 0.8.3"])
+    s.add_dependency(%q<rghost_barcode>, [">= 0.8"])
+    s.add_dependency(%q<parseline>, [">= 1.0.2"])
+    s.add_dependency(%q<newgem>, [">= 1.3.0"])
+    s.add_dependency(%q<hoe>, [">= 1.8.0"])
+  end
+end

data/config/website.yml

@@ -0,0 +1,2 @@
+host: kivanio@rubyforge.org
+remote_dir: /var/www/gforge-projects/brcobranca

data/lib/brcobranca/boleto/banco_brasil.rb

@@ -0,0 +1,79 @@
+# 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
+
+  # Número sequencial utilizado para distinguir os boletos na agência
+  def nosso_numero
+    "#{self.convenio}#{self.numero_documento}-#{self.nosso_numero_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
+      "#{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
+      "#{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)
+        "#{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))
+        "#{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)
+      "#{banco}#{self.moeda}#{fator}#{valor_documento}#{convenio}#{numero_documento}#{agencia}#{conta}#{self.carteira}"
+    else
+      return nil
+    end
+  end
+
+end

data/lib/brcobranca/boleto/banco_hsbc.rb

@@ -0,0 +1,63 @@
+# Banco HSBC
+class BancoHsbc < Brcobranca::Boleto::Base
+
+  # Responsável por definir dados iniciais quando se cria uma nova intância da classe BancoBrasil
+  def initialize(campos={})
+    padrao={:carteira => "CNR", :banco => "399"}
+    campos = padrao.merge!(campos)
+    super(campos)
+  end
+
+  # Número sequencial utilizado para distinguir os boletos na agência
+  def nosso_numero
+    if self.data_vencimento
+      self.codigo_servico = 4
+      dia = self.data_vencimento.day.to_s.zeros_esquerda(:tamanho => 2)
+      mes = self.data_vencimento.month.to_s.zeros_esquerda(:tamanho => 2)
+      ano = self.data_vencimento.year.to_s[2..3]
+      data = "#{dia}#{mes}#{ano}"
+
+      numero_documento = "#{self.numero_documento.to_s}#{self.numero_documento.to_s.modulo11_9to2_10_como_zero}#{self.codigo_servico.to_s}"
+      soma = numero_documento.to_i + self.conta_corrente.to_i + data.to_i
+      numero = "#{numero_documento}#{soma.to_s.modulo11_9to2_10_como_zero}"
+      numero
+    else
+      self.codigo_servico = 5
+      numero_documento = "#{self.numero_documento.to_s}#{self.numero_documento.to_s.modulo11_9to2_10_como_zero}#{self.codigo_servico.to_s}"
+      soma = numero_documento.to_i + self.conta_corrente.to_i
+      numero = "#{numero_documento}#{soma.to_s.modulo11_9to2_10_como_zero}"
+      numero
+    end
+  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)
+    valor_documento = self.valor_documento.limpa_valor_moeda.zeros_esquerda(:tamanho => 10)
+    convenio = self.convenio.to_s
+    conta = self.conta_corrente.zeros_esquerda(:tamanho => 7)
+
+    # Montagem é baseada no tipo de carteira e na presença da data de vencimento
+    if self.carteira == "CNR"
+      if self.data_vencimento
+        raise "numero_documento pode ser de no máximo 13 caracteres." if (self.numero_documento.to_s.size > 13)
+        fator = self.data_vencimento.fator_vencimento
+        dias_julianos = self.data_vencimento.to_juliano
+        self.codigo_servico = 4
+        numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 13)       
+        "#{banco}#{self.moeda}#{fator}#{valor_documento}#{conta}#{numero_documento}#{dias_julianos}2"
+      else
+        # TODO
+        nil
+      end
+    else
+      raise "numero_documento pode ser de no máximo 6 caracteres." if (self.numero_documento.to_s.size > 6)
+      numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 6)
+      nosso_numero = self.nosso_numero.zeros_esquerda(:tamanho => 9)
+      self.codigo_servico = 5
+      # TODO
+      nil
+    end
+  end
+
+end

data/lib/brcobranca/boleto/banco_itau.rb

@@ -0,0 +1,105 @@
+# Banco Itaú
+class BancoItau < Brcobranca::Boleto::Base
+  # Usado somente em carteiras especiais com registro para complementar o número do cocumento
+  attr_accessor :seu_numero
+
+  # Responsável por definir dados iniciais quando se cria uma nova intancia da classe BancoItau
+  def initialize(campos={})
+    padrao={:carteira => "175", :banco => "341"}
+    campos = padrao.merge!(campos)
+    super(campos)
+  end
+
+  # Retorna dígito verificador do nosso número, calculado com modulo10. 
+  # Para a grande maioria das carteiras, são considerados para a obtenção do DAC/DV, os dados 
+  # "AGENCIA(sem DAC/DV)/CONTA(sem DAC/DV)/CARTEIRA/NOSSO NUMERO", calculado pelo criterio do Modulo 10. 
+  # A excecao, estão as carteiras 126, 131, 146, 150 e 168 cuja obtenção esta baseada apenas nos 
+  # dados "CARTEIRA/NOSSO NUMERO".
+  def nosso_numero_dv
+    if %w(126 131 146 150 168).include?(self.carteira)
+      "#{self.carteira}#{self.numero_documento}".modulo10
+    else
+      numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 8)
+      "#{self.agencia}#{self.conta_corrente}#{self.carteira}#{numero_documento}".modulo10
+    end
+  end
+
+  # Número sequencial utilizado para distinguir os boletos na agência
+  def nosso_numero
+    "#{self.carteira}/#{self.numero_documento}-#{self.nosso_numero_dv}"
+  end
+
+  # Calcula o dígito verificador para conta corrente do Itau. 
+  # Retorna apenas o dígito verificador da conta ou nil caso seja impossível calcular.
+  def agencia_conta_corrente_dv
+    "#{self.agencia}#{self.conta_corrente}".modulo10
+  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
+    valor_documento_formatado = self.valor_documento.limpa_valor_moeda.zeros_esquerda(:tamanho => 10)
+    fator_vencimento = self.data_vencimento.fator_vencimento
+    numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 8)
+    return nil if numero_documento.size != 8
+
+    # Monta a String baseado no tipo de carteira
+    case self.carteira.to_i
+    when 126, 131, 146, 150, 168
+      # CARTEIRAS 126 131 146 150 168
+      # 01 a 03 03 9(03) Código do Banco na Câmara de Compensação = '341'
+      # 04 a 04 01 9(01) Código da Moeda = '9'
+      # 05 a 05 01 9(01) DAC código de Barras MOD 11-2a9
+      # 06 a 09 04 9(04) Fator de Vencimento
+      # 10 a 19 10 9(08)V(2) Valor
+      # 20 a 22 03 9(03) Carteira
+      # 23 a 30 08 9(08) Nosso Número
+      # 31 a 31 01 9(01) DAC [Carteira/Nosso Número] MOD 10
+      # 32 a 35 04 9(04) N.º da Agência cedente
+      # 36 a 40 05 9(05) N.º da Conta Corrente
+      # 41 a 41 01 9(01) DAC [Agência/Conta Corrente] MOD 10
+      # 42 a 44 03 9(03) Zeros
+      codigo = "#{self.banco}#{self.moeda}#{fator_vencimento}#{valor_documento_formatado}#{self.carteira}"
+      codigo << "#{numero_documento}#{self.nosso_numero_dv}#{self.agencia}#{self.conta_corrente}#{self.agencia_conta_corrente_dv}000"
+      codigo
+    when 198, 106, 107, 122, 142, 143, 195, 196
+      # CARTEIRAS 198, 106, 107,122, 142, 143, 195 e 196
+      # 01 a 03 03 9(3) Código do Banco na Câmara de Compensação = ‘341’
+      # 04 a 04 01 9(1) Código da Moeda = '9'
+      # 05 a 05 01 9(1) DAC do Código de Barras MOD 11-2a9
+      # 06 a 09 04 9(04) Fator de Vencimento
+      # 10 a 19 10 9(08) V(2) Valor
+      # 20 a 22 03 9(3) Carteira
+      # 23 a 30 08 9(8) Nosso Número
+      # 31 a 37 07 9(7) Seu Número (Número do Documento)
+      # 38 a 42 05 9(5) Código do Cliente (fornecido pelo Banco)
+      # 43 a 43 01 9(1) DAC dos campos acima (posições 20 a 42) MOD 10
+      # 44 a 44 01 9(1) Zero
+      seu_numero = self.seu_numero.zeros_esquerda(:tamanho => 7)
+      return nil if seu_numero.size != 7
+      convenio = self.convenio.zeros_esquerda(:tamanho => 5)
+      return nil if convenio.size != 5
+      dv = "#{self.carteira}#{numero_documento}#{seu_numero}#{convenio}".modulo10
+
+      codigo = "#{self.banco}#{self.moeda}#{fator_vencimento}#{valor_documento_formatado}#{self.carteira}"
+      codigo << "#{numero_documento}#{seu_numero}#{convenio}#{dv}0"
+      codigo
+    else
+      # DEMAIS CARTEIRAS
+      # 01 a 03 03 9(03) Código do Banco na Câmara de Compensação = '341'
+      # 04 a 04 01 9(01) Código da Moeda = '9'
+      # 05 a 05 01 9(01) DAC código de Barras MOD 11-2a9
+      # 06 a 09 04 9(04) Fator de Vencimento
+      # 10 a 19 10 9(08)V(2) Valor
+      # 20 a 22 03 9(03) Carteira
+      # 23 a 30 08 9(08) Nosso Número
+      # 31 a 31 01 9(01) DAC [Agência /Conta/Carteira/Nosso Número] MOD 10
+      # 32 a 35 04 9(04) N.º da Agência cedente
+      # 36 a 40 05 9(05) N.º da Conta Corrente
+      # 41 a 41 01 9(01) DAC [Agência/Conta Corrente] MOD 10
+      # 42 a 44 03 9(03) Zeros
+      codigo = "#{self.banco}#{self.moeda}#{fator_vencimento}#{valor_documento_formatado}#{self.carteira}"
+      codigo << "#{numero_documento}#{self.nosso_numero_dv}#{self.agencia}#{self.conta_corrente}#{self.agencia_conta_corrente_dv}000"
+      codigo
+    end
+  end
+end

data/lib/brcobranca/boleto/base.rb

@@ -0,0 +1,142 @@
+module Brcobranca
+  module Boleto
+    # Classe base para todas as classes de boletos
+    class Base
+      # <b>REQUERIDO</b>: Codigo do banco emissor (3 dígitos sempre)
+      attr_accessor :banco
+      # <b>REQUERIDO</b>: Número do convênio/contrato do cliente junto ao banco emissor
+      attr_accessor :convenio
+      # <b>REQUERIDO</b>: Tipo de moeda utilizada (Real(R$) e igual a 9)
+      attr_accessor :moeda
+      # <b>REQUERIDO</b>: Carteira utilizada
+      attr_accessor :carteira
+      # <b>OPCIONAL</b>: Variacao da carteira(opcional para a maioria dos bancos)
+      attr_accessor :variacao
+      # <b>OPCIONAL</b>: Data de processamento do boleto, geralmente igual a data_documento
+      attr_accessor :data_processamento
+      # <b>REQUERIDO</b>: Número de dias a vencer
+      attr_accessor :dias_vencimento
+      # <b>REQUERIDO</b>: Quantidade de boleto(padrão = 1)
+      attr_accessor :quantidade
+      # <b>REQUERIDO</b>: Valor do boleto
+      attr_accessor :valor
+      # <b>REQUERIDO</b>: Número da agencia
+      attr_accessor :agencia
+      # <b>REQUERIDO</b>: Número da conta corrente
+      attr_accessor :conta_corrente
+      # <b>REQUERIDO</b>: Nome do proprietario da conta corrente
+      attr_accessor :cedente
+      # <b>REQUERIDO</b>: Documento do proprietario da conta corrente (CPF ou CNPJ)
+      attr_accessor :documento_cedente
+      # <b>OPCIONAL</b>: Número sequencial utilizado identificar o boleto
+      attr_accessor :numero_documento
+      # <b>REQUERIDO</b>: Símbolo da moeda utilizada (R$ no brasil)
+      attr_accessor :especie
+      # <b>REQUERIDO</b>: Tipo do documento (Geralmente DM que quer dizer Duplicata Mercantil)
+      attr_accessor :especie_documento
+      # <b>REQUERIDO</b>: Data em que foi emitido o boleto
+      attr_accessor :data_documento
+      # <b>OPCIONAL</b>: Código utilizado para identificar o tipo de serviço cobrado
+      attr_accessor :codigo_servico
+      # <b>OPCIONAL</b>: Utilizado para mostrar alguma informação ao sacado
+      attr_accessor :instrucao1
+      # <b>OPCIONAL</b>: Utilizado para mostrar alguma informação ao sacado
+      attr_accessor :instrucao2
+      # <b>OPCIONAL</b>: Utilizado para mostrar alguma informação ao sacado
+      attr_accessor :instrucao3
+      # <b>OPCIONAL</b>: Utilizado para mostrar alguma informação ao sacado
+      attr_accessor :instrucao4
+      # <b>OPCIONAL</b>: Utilizado para mostrar alguma informação ao sacado
+      attr_accessor :instrucao5
+      # <b>OPCIONAL</b>: Utilizado para mostrar alguma informação ao sacado
+      attr_accessor :instrucao6
+      # <b>OPCIONAL</b>: Utilizado para mostrar alguma informação ao sacado
+      attr_accessor :instrucao7
+      # <b>REQUERIDO</b>: Informação sobre onde o sacado podera efetuar o pagamento
+      attr_accessor :local_pagamento
+      # <b>REQUERIDO</b>: Informa se o banco deve aceitar o boleto após o vencimento ou não( S ou N, quase sempre S)
+      attr_accessor :aceite
+      # <b>REQUERIDO</b>: Nome da pessoa que receberá o boleto
+      attr_accessor :sacado
+      # <b>OPCIONAL</b>: Endereco da pessoa que receberá o boleto
+      attr_accessor :sacado_endereco
+      # <b>REQUERIDO</b>: Documento da pessoa que receberá o boleto
+      attr_accessor :sacado_documento
+
+      # Responsável por definir dados iniciais quando se cria uma nova intância da classe Base.
+      def initialize(campos={})
+        padrao = { :moeda => "9", :data_documento => Date.today, :dias_vencimento => 1, :quantidade => 1,
+          :especie_documento => "DM", :especie => "R$", :aceite => "S", :valor => 0.0, 
+          :local_pagamento => "QUALQUER BANCO ATÉ O VENCIMENTO"}
+
+          campos = padrao.merge!(campos)
+
+          campos.each do |campo, valor|
+            instance_variable_set "@#{campo}", valor if self.respond_to?(campo)
+          end
+
+        end
+
+        # Retorna dígito verificador do banco, calculado com modulo11 de 9 para 2
+        def banco_dv
+          self.banco.modulo11_9to2
+        end
+
+        # Retorna dígito verificador da agência, calculado com modulo11 de 9 para 2
+        def agencia_dv
+          self.agencia.modulo11_9to2
+        end
+
+        # Retorna dígito verificador da conta corrente, calculado com modulo11 de 9 para 2
+        def conta_corrente_dv
+          self.conta_corrente.modulo11_9to2
+        end
+
+        # Retorna dígito verificador do nosso número, calculado com modulo11 de 9 para 2
+        def nosso_numero_dv
+          self.numero_documento.modulo11_9to2
+        end
+
+        # Número sequencial utilizado para distinguir os boletos na agência
+        def nosso_numero
+          self.numero_documento
+        end
+
+        # Retorna o valor total do documento: <b>quantidate * valor</b> ou <b>zero(0)</b> caso não consiga efetuar o cálculo.
+        def valor_documento
+          begin
+            self.quantidade * self.valor.to_f
+          rescue
+            0
+          end
+        end
+
+        # Retorna data de vencimento baseado na <b>data_documento + dias_vencimento</b> ou <b>false</b> caso não consiga efetuar o cálculo.
+        def data_vencimento
+          begin
+            return false unless self.data_documento.kind_of?(Date)
+            (self.data_documento + self.dias_vencimento.to_i)
+          rescue
+            false
+          end
+        end
+
+        # Retorna uma String com 44 caracteres representando o codigo de barras do boleto
+        def codigo_barras
+          codigo = monta_codigo_43_digitos
+          return nil unless codigo
+          return nil if codigo.size != 43
+          codigo_dv = codigo.modulo11_2to9
+
+          "#{codigo[0..3]}#{codigo_dv}#{codigo[4..42]}"
+        end
+
+        # Responsável por montar uma String com 43 caracteres que será usado na criação do código de barras
+        #  Este metodo precisa ser reescrito para cada classe de boleto a ser criada. 
+        def monta_codigo_43_digitos
+          "Sobreescreva este método na classe referente ao banco que você esta criando"
+        end
+      end
+    end
+  end
+