brcobranca 2.0.6 → 3.0.0

data/lib/brcobranca/boleto/real.rb

@@ -0,0 +1,74 @@
+# -*- encoding: utf-8 -*-
+module Brcobranca
+  module Boleto
+    class Real < Base # Banco REAL
+
+      validates_length_of :agencia, :maximum => 4, :message => "deve ser menor ou igual a 4 dígitos."
+      validates_length_of :conta_corrente, :maximum => 7, :message => "deve ser menor ou igual a 7 dígitos."
+
+      validates_each :numero_documento do |record, attr, value|
+        record.errors.add attr, 'deve ser menor ou igual a 13 dígitos.' if (value.to_s.size > 13) && (record.carteira.to_i == 57)
+        record.errors.add attr, 'deve ser menor ou igual a 7 dígitos.' if (value.to_s.size > 7) && (record.carteira.to_i != 57)
+      end
+
+      ## Nova instancia do Real
+      # @param (see Brcobranca::Boleto::Base#initialize)
+      def initialize(campos={})
+        campos = {:carteira => "57"}.merge!(campos)
+        super(campos)
+      end
+
+      # Codigo do banco emissor (3 dígitos sempre)
+      def banco
+        "356"
+      end
+
+      # Número seqüencial utilizado para identificar o boleto.
+      #
+      # NUMERO DO BANCO : COM 7 DIGITOS P/ COBRANCA REGISTRADA e ATE 13 DIGITOS P/ COBRANCA SEM REGISTRO
+      #
+      # @return [String] 7 ou 13 caracteres numéricos.
+      def numero_documento
+        quantidade = (self.carteira.to_i == 57) ? 13 : 7
+        @numero_documento.to_s.rjust(quantidade,'0')
+      end
+
+      # Nosso número para exibir no boleto.
+      # @return [String]
+      # @example
+      #  boleto.nosso_numero_boleto #=> "4000403005-6"
+      def nosso_numero_boleto
+        "#{self.numero_documento}-#{self.nosso_numero_dv}"
+      end
+
+      # Número do convênio/contrato do cliente para exibir no boleto.
+      # @return [String]
+      # @example
+      #  boleto.agencia_conta_boleto #=> "0548-7 / 0001448-6"
+      def agencia_conta_boleto
+        "#{self.agencia}-#{self.agencia_dv} / #{self.conta_corrente}-#{self.conta_corrente_dv}"
+      end
+
+      # Dígito verificador do nosso número.
+      # @return [String] 1 caracteres numéricos.
+      def agencia_conta_corrente_nosso_numero_dv
+        "#{self.numero_documento}#{self.agencia}#{self.conta_corrente}".modulo10
+      end
+
+      # Segunda parte do código de barras.
+      #
+      # Montagem é baseada no tipo de carteira, com registro e sem registro(57)
+      #
+      # @return [String] 25 caracteres numéricos.
+      def codigo_barras_segunda_parte
+        case self.carteira.to_i
+        when 57
+          "#{self.agencia}#{self.conta_corrente}#{self.agencia_conta_corrente_nosso_numero_dv}#{self.numero_documento}"
+        else
+          # TODO verificar com o banco, pois não consta na documentação
+          "000000#{self.agencia}#{self.conta_corrente}#{self.agencia_conta_corrente_nosso_numero_dv}#{self.numero_documento}"
+        end
+      end
+    end
+  end
+end

data/lib/brcobranca/boleto/template/base.rb

@@ -0,0 +1,13 @@
+module Brcobranca
+  module Boleto
+    module Template
+      module Base
+        extend self
+
+        def define_template(template)
+          (template == :rghost) ? Brcobranca::Boleto::Template::Rghost : Brcobranca::Boleto::Template::Rghost
+        end
+      end
+    end
+  end
+end

data/lib/brcobranca/boleto/template/rghost.rb

@@ -1,3 +1,5 @@
+# -*- encoding: utf-8 -*-
+
 begin
   require 'rghost'
 rescue LoadError
@@ -19,135 +21,207 @@ module Brcobranca
     module Template
       # Templates para usar com Rghost
       module Rghost
+        extend self
         include RGhost unless self.include?(RGhost)
 
         # Gera o boleto em usando o formato desejado [:pdf, :jpg, :tif, :png, :ps, :laserjet, ... etc]
-        #  Veja mais formatos na documentação do rghost: http://wiki.github.com/shairontoledo/rghost/supported-devices-drivers-and-formats
-        # TODO - Usar define_method para criar um metodo em tempo real to_{pdf,jpg}
-        def to(formato=Brcobranca::Config::OPCOES[:tipo])
-          modelo_generico(:tipo => formato)
+        #
+        # @return [Stream]
+        # @see http://wiki.github.com/shairontoledo/rghost/supported-devices-drivers-and-formats Veja mais formatos na documentação do rghost.
+        # @see Rghost#modelo_generico Recebe os mesmos parâmetros do Rghost#modelo_generico.
+        def to(formato, options={})
+          modelo_generico(self, options.merge!({:formato => formato}))
+        end
+
+        # Gera o boleto em usando o formato desejado [:pdf, :jpg, :tif, :png, :ps, :laserjet, ... etc]
+        #
+        # @return [Stream]
+        # @see http://wiki.github.com/shairontoledo/rghost/supported-devices-drivers-and-formats Veja mais formatos na documentação do rghost.
+        # @see Rghost#modelo_generico Recebe os mesmos parâmetros do Rghost#modelo_generico.
+        def lote(boletos, options={})
+          modelo_generico_multipage(boletos, options)
         end
 
-        # Responsável por setar os valores necessários no template genérico
-        # Retorna um stream pronto para gravaçào
+        #  Cria o métodos dinâmicos (to_pdf, to_gif e etc) com todos os fomátos válidos.
         #
-        # O tipo do arquivo gerado pode ser modificado incluindo a configuração a baixo dentro da sua aplicação:
-        #  Brcobranca::Config::OPCOES[:tipo] = 'pdf'
+        # @return [Stream]
+        # @see Rghost#modelo_generico Recebe os mesmos parâmetros do Rghost#modelo_generico.
+        # @example
+        #  @boleto.to_pdf #=> boleto gerado no formato pdf
+        def method_missing(m, *args)
+          method = m.to_s
+          if method.start_with?("to_")
+            modelo_generico(self, (args.first || {}).merge!({:formato => method[3..-1]}))
+          else
+            super
+          end
+        end
+
+        private
+
+        # Retorna um stream pronto para gravação em arquivo.
+        #
+        # @return [Stream]
+        # @param [Boleto] Instância de uma classe de boleto.
+        # @param [Hash] options Opção para a criação do boleto.
+        # @option options [Symbol] :resolucao Resolução em pixels.
+        # @option options [Symbol] :formato Formato desejado [:pdf, :jpg, :tif, :png, :ps, :laserjet, ... etc]
+        def modelo_generico(boleto, options={})
+          doc=Document.new :paper => :A4 # 210x297
+
+          template_path = File.join(File.dirname(__FILE__),'..','..','arquivos','templates','modelo_generico.eps')
+
+          raise "Não foi possível encontrar o template. Verifique o caminho" unless File.exist?(template_path)
+
+          modelo_generico_template(doc, boleto, template_path)
+          modelo_generico_cabecalho(doc, boleto)
+          modelo_generico_rodape(doc, boleto)
+
+          #Gerando codigo de barra com rghost_barcode
+          doc.barcode_interleaved2of5(boleto.codigo_barras, :width => '10.3 cm', :height => '1.3 cm', :x => '0.7 cm', :y => '5.8 cm' ) if boleto.codigo_barras
+
+          # Gerando stream
+          formato = (options.delete(:formato) || Brcobranca.configuration.formato)
+          resolucao = (options.delete(:resolucao) || Brcobranca.configuration.resolucao)
+          doc.render_stream(formato.to_sym, :resolution => resolucao)
+        end
+
+        # Retorna um stream para multiplos boletos pronto para gravação em arquivo.
         #
-        # Ou pode ser passado como paramentro:
-        #  :tipo => 'pdf'
-        def modelo_generico(options={})
+        # @return [Stream]
+        # @param [Array] Instâncias de classes de boleto.
+        # @param [Hash] options Opção para a criação do boleto.
+        # @option options [Symbol] :resolucao Resolução em pixels.
+        # @option options [Symbol] :formato Formato desejado [:pdf, :jpg, :tif, :png, :ps, :laserjet, ... etc]
+        def modelo_generico_multipage(boletos, options={})
           doc=Document.new :paper => :A4 # 210x297
 
           template_path = File.join(File.dirname(__FILE__),'..','..','arquivos','templates','modelo_generico.eps')
 
           raise "Não foi possível encontrar o template. Verifique o caminho" unless File.exist?(template_path)
 
+          boletos.each_with_index do |boleto, index|
+
+            modelo_generico_template(doc, boleto, template_path)
+            modelo_generico_cabecalho(doc, boleto)
+            modelo_generico_rodape(doc, boleto)
+
+            #Gerando codigo de barra com rghost_barcode
+            doc.barcode_interleaved2of5(boleto.codigo_barras, :width => '10.3 cm', :height => '1.3 cm', :x => '0.7 cm', :y => '5.8 cm' ) if boleto.codigo_barras
+            #Cria nova página se não for o último boleto
+            doc.next_page unless index == boletos.length-1
+
+          end
+          # Gerando stream
+          formato = (options.delete(:formato) || Brcobranca.configuration.formato)
+          resolucao = (options.delete(:resolucao) || Brcobranca.configuration.resolucao)
+          doc.render_stream(formato.to_sym, :resolution => resolucao)
+        end
+
+        # Define o template a ser usado no boleto
+        def modelo_generico_template(doc, boleto, template_path)
           doc.define_template(:template, template_path, :x => '0.3 cm', :y => "0 cm")
           doc.use_template :template
 
           doc.define_tags do
             tag :grande, :size => 13
           end
+        end
 
-          # Busca logo automaticamente
-          logo = monta_logo
-
+        # Monta o cabeçalho do layout do boleto
+        def modelo_generico_cabecalho(doc, boleto)
           #INICIO Primeira parte do BOLETO
           # LOGOTIPO do BANCO
-          doc.image(logo, :x => '0.5 cm', :y => '23.85 cm', :zoom => 80) if logo
+          doc.image(boleto.logotipo, :x => '0.5 cm', :y => '23.85 cm', :zoom => 80)
           # Dados
           doc.moveto :x => '5.2 cm' , :y => '23.85 cm'
-          doc.show "#{self.banco}-#{self.banco_dv}", :tag => :grande
+          doc.show "#{boleto.banco}-#{boleto.banco_dv}", :tag => :grande
           doc.moveto :x => '7.5 cm' , :y => '23.85 cm'
-          doc.show self.codigo_barras.linha_digitavel, :tag => :grande
+          doc.show boleto.codigo_barras.linha_digitavel, :tag => :grande
           doc.moveto :x => '0.7 cm' , :y => '23 cm'
-          doc.show self.cedente
+          doc.show boleto.cedente
           doc.moveto :x => '11 cm' , :y => '23 cm'
-          doc.show self.agencia_conta_boleto
+          doc.show boleto.agencia_conta_boleto
           doc.moveto :x => '14.2 cm' , :y => '23 cm'
-          doc.show self.especie
+          doc.show boleto.especie
           doc.moveto :x => '15.7 cm' , :y => '23 cm'
-          doc.show self.quantidade
+          doc.show boleto.quantidade
           doc.moveto :x => '0.7 cm' , :y => '22.2 cm'
-          doc.show self.numero_documento
+          doc.show boleto.numero_documento
           doc.moveto :x => '7 cm' , :y => '22.2 cm'
-          doc.show "#{self.documento_cedente.formata_documento}"
+          doc.show "#{boleto.documento_cedente.formata_documento}"
           doc.moveto :x => '12 cm' , :y => '22.2 cm'
-          doc.show self.data_vencimento.to_s_br
+          doc.show boleto.data_vencimento.to_s_br
           doc.moveto :x => '16.5 cm' , :y => '23 cm'
-          doc.show self.nosso_numero_boleto
+          doc.show boleto.nosso_numero_boleto
           doc.moveto :x => '16.5 cm' , :y => '22.2 cm'
-          doc.show self.valor_documento.to_currency
+          doc.show boleto.valor_documento.to_currency
           doc.moveto :x => '1.4 cm' , :y => '20.9 cm'
-          doc.show "#{self.sacado} - #{self.sacado_documento.formata_documento}"
+          doc.show "#{boleto.sacado} - #{boleto.sacado_documento.formata_documento}"
           doc.moveto :x => '1.4 cm' , :y => '20.6 cm'
-          doc.show "#{self.sacado_endereco}"
+          doc.show "#{boleto.sacado_endereco}"
           #FIM Primeira parte do BOLETO
+        end
 
+        # Monta o corpo e rodapé do layout do boleto
+        def modelo_generico_rodape(doc, boleto)
           #INICIO Segunda parte do BOLETO BB
           # LOGOTIPO do BANCO
-          doc.image(logo, :x => '0.5 cm', :y => '16.8 cm', :zoom => 80) if logo
+          doc.image(boleto.logotipo, :x => '0.5 cm', :y => '16.8 cm', :zoom => 80)
           doc.moveto :x => '5.2 cm' , :y => '16.8 cm'
-          doc.show "#{self.banco}-#{self.banco_dv}", :tag => :grande if self.banco && self.banco_dv
+          doc.show "#{boleto.banco}-#{boleto.banco_dv}", :tag => :grande
           doc.moveto :x => '7.5 cm' , :y => '16.8 cm'
-          doc.show self.codigo_barras.linha_digitavel, :tag => :grande if self.codigo_barras && self.codigo_barras.linha_digitavel
+          doc.show boleto.codigo_barras.linha_digitavel, :tag => :grande
           doc.moveto :x => '0.7 cm' , :y => '16 cm'
-          doc.show self.local_pagamento if self.local_pagamento
+          doc.show boleto.local_pagamento
           doc.moveto :x => '16.5 cm' , :y => '16 cm'
-          doc.show self.data_vencimento.to_s_br if self.data_vencimento
+          doc.show boleto.data_vencimento.to_s_br if boleto.data_vencimento
           doc.moveto :x => '0.7 cm' , :y => '15.2 cm'
-          doc.show self.cedente if self.cedente
+          doc.show boleto.cedente
           doc.moveto :x => '16.5 cm' , :y => '15.2 cm'
-          doc.show self.agencia_conta_boleto
+          doc.show boleto.agencia_conta_boleto
           doc.moveto :x => '0.7 cm' , :y => '14.4 cm'
-          doc.show self.data_documento.to_s_br if self.data_documento
+          doc.show boleto.data_documento.to_s_br if boleto.data_documento
           doc.moveto :x => '4.2 cm' , :y => '14.4 cm'
-          doc.show self.numero_documento if self.numero_documento
+          doc.show boleto.numero_documento
           doc.moveto :x => '10 cm' , :y => '14.4 cm'
-          doc.show self.especie if self.especie
+          doc.show boleto.especie
           doc.moveto :x => '11.7 cm' , :y => '14.4 cm'
-          doc.show self.aceite if self.aceite
+          doc.show boleto.aceite
           doc.moveto :x => '13 cm' , :y => '14.4 cm'
-          doc.show self.data_processamento.to_s_br if self.data_processamento
+          doc.show boleto.data_processamento.to_s_br if boleto.data_processamento
           doc.moveto :x => '16.5 cm' , :y => '14.4 cm'
-          doc.show self.nosso_numero_boleto
+          doc.show boleto.nosso_numero_boleto
           doc.moveto :x => '4.4 cm' , :y => '13.5 cm'
-          doc.show self.carteira if self.carteira
+          doc.show boleto.carteira
           doc.moveto :x => '6.4 cm' , :y => '13.5 cm'
-          doc.show self.moeda if self.moeda
+          doc.show boleto.moeda
           doc.moveto :x => '8 cm' , :y => '13.5 cm'
-          doc.show self.quantidade if self.quantidade
+          doc.show boleto.quantidade
           doc.moveto :x => '11 cm' , :y => '13.5 cm'
-          doc.show self.valor.to_currency if self.valor
+          doc.show boleto.valor.to_currency
           doc.moveto :x => '16.5 cm' , :y => '13.5 cm'
-          doc.show self.valor_documento.to_currency if self.valor_documento
+          doc.show boleto.valor_documento.to_currency
           doc.moveto :x => '0.7 cm' , :y => '12.7 cm'
-          doc.show self.instrucao1 if self.instrucao1
+          doc.show boleto.instrucao1
           doc.moveto :x => '0.7 cm' , :y => '12.3 cm'
-          doc.show self.instrucao2 if self.instrucao2
+          doc.show boleto.instrucao2
           doc.moveto :x => '0.7 cm' , :y => '11.9 cm'
-          doc.show self.instrucao3 if self.instrucao3
+          doc.show boleto.instrucao3
           doc.moveto :x => '0.7 cm' , :y => '11.5 cm'
-          doc.show self.instrucao4 if self.instrucao4
+          doc.show boleto.instrucao4
           doc.moveto :x => '0.7 cm' , :y => '11.1 cm'
-          doc.show self.instrucao5 if self.instrucao5
+          doc.show boleto.instrucao5
           doc.moveto :x => '0.7 cm' , :y => '10.7 cm'
-          doc.show self.instrucao6 if self.instrucao6
+          doc.show boleto.instrucao6
           doc.moveto :x => '1.2 cm' , :y => '8.8 cm'
-          doc.show "#{self.sacado} - #{self.sacado_documento.formata_documento}" if self.sacado && self.sacado_documento
+          doc.show "#{boleto.sacado} - #{boleto.sacado_documento.formata_documento}" if boleto.sacado && boleto.sacado_documento
           doc.moveto :x => '1.2 cm' , :y => '8.4 cm'
-          doc.show "#{self.sacado_endereco}" if self.sacado_endereco
+          doc.show "#{boleto.sacado_endereco}"
           #FIM Segunda parte do BOLETO
-
-          #Gerando codigo de barra com rghost_barcode
-          doc.barcode_interleaved2of5(self.codigo_barras, :width => '10.3 cm', :height => '1.3 cm', :x => '0.7 cm', :y => '5.8 cm' ) if self.codigo_barras
-
-          # Gerando stream
-          options[:tipo] = options[:tipo].to_sym unless options[:tipo].kind_of?(Symbol)
-          doc.render_stream(options[:tipo])
         end
-      end
+
+      end #Base
     end
   end
 end

data/lib/brcobranca/boleto/unibanco.rb

@@ -0,0 +1,115 @@
+# -*- encoding: utf-8 -*-
+module Brcobranca
+  module Boleto
+    class Unibanco < Base # Banco UNIBANCO
+
+      #  Com Registro 4
+      #  Sem Registro 5
+      validates_inclusion_of :carteira, :in => %w( 5 4 ), :message => "não existente para este banco."
+      validates_length_of :agencia, :maximum => 4, :message => "deve ser menor ou igual a 4 dígitos."
+      validates_length_of :convenio, :maximum => 7, :message => "deve ser menor ou igual a 7 dígitos."
+      validates_length_of :conta_corrente, :maximum => 7, :message => "deve ser menor ou igual a 7 dígitos."
+
+      validates_each :numero_documento do |record, attr, value|
+        record.errors.add attr, 'deve ser menor ou igual a 14 dígitos.' if (value.to_s.size > 14) && (record.carteira.to_i == 5)
+        record.errors.add attr, 'deve ser menor ou igual a 11 dígitos.' if (value.to_s.size > 11) && (record.carteira.to_i == 4)
+      end
+
+      # Nova instancia do Unibanco
+      # @param (see Brcobranca::Boleto::Base#initialize)
+      def initialize(campos={})
+        campos = {:carteira => "5"}.merge!(campos)
+        super(campos)
+      end
+
+      # Codigo do banco emissor (3 dígitos sempre)
+      #
+      # @return [String] 3 caracteres numéricos.
+      def banco
+        "409"
+      end
+
+      # Número do convênio/contrato do cliente junto ao banco.
+      # @return [String] 7 caracteres numéricos.
+      def convenio=(valor)
+        @convenio = valor.to_s.rjust(7,'0') unless valor.nil?
+      end
+
+      # Número seqüencial utilizado para identificar o boleto.
+      #
+      # Carteira 5 = 14 caracteres numéricos.<br/>
+      # Carteira 4 = 11 caracteres numéricos.
+      #
+      # @return [String]
+      def numero_documento
+        case self.carteira.to_i
+        when 5
+          @numero_documento.to_s.rjust(14,'0')
+        else #4
+          @numero_documento.to_s.rjust(11,'0')
+        end
+      end
+
+      # Dígito verificador do nosso número.
+      # @return [String] 1 caracteres numéricos.
+      def nosso_numero_dv
+        self.numero_documento.modulo11_2to9
+      end
+
+      # Nosso número para exibir no boleto.
+      # @return [String]
+      # @example
+      #  boleto.nosso_numero_boleto #=> "00085068014982-9"
+      def nosso_numero_boleto
+        "#{self.numero_documento}-#{self.nosso_numero_dv}"
+      end
+
+      # Número do convênio/contrato do cliente para exibir no boleto.
+      # @return [String]
+      # @example
+      #  boleto.agencia_conta_boleto #=> "0123 / 0100618-5"
+      def agencia_conta_boleto
+        "#{self.agencia} / #{self.conta_corrente}-#{self.conta_corrente_dv}"
+      end
+
+      # Segunda parte do código de barras.
+      #
+      # Cobrança sem registro (CÓDIGO DE BARRAS)<br/>
+      # Posição | Tamanho | Descrição<br/>
+      # 1 a 3 | 3 | número de identificação do Unibanco: 409 (número FIXO)<br/>
+      # 4 | 1 | código da moeda. Real (R$)=9 (número FIXO)<br/>
+      # 5 | 1 | dígito verificador do CÓDIGO DE BARRAS<br/>
+      # 6 a 9 | 4 | fator de vencimento<br/>
+      # 10 a 19 | 10 |  valor do título com zeros à esquerda<br/>
+      # 20 |  1 | código para transação CVT: 5 (número FIXO)(5=7744-5)<br/>
+      # 21 a 27 | 7 | número do cliente no CÓDIGO DE BARRAS + dígito verificador<br/>
+      # 28 a 29 | 2 | vago. Usar 00 (número FIXO)<br/>
+      # 30 a 43 | 14 |  Número de referência do cliente<br/>
+      # 44 |  1 | Dígito verificador<br/>
+      #
+      # Cobrança com registro (CÓDIGO DE BARRAS)<br/>
+      # Posição |  Tamanho | Descrição<br/>
+      # 1 a 3 |  3 | Número de identificação do Unibanco: 409 (número FIXO)<br/>
+      # 4 |  1 | Código da moeda. Real (R$)=9 (número FIXO)<br/>
+      # 5 |  1 | dígito verificador do CÓDIGO DE BARRAS<br/>
+      # 6 a 9 |  4 | fator de vencimento em 4 algarismos, conforme tabela da página 14<br/>
+      # 10 a 19 |  10 |  valor do título com zeros à esquerda<br/>
+      # 20 a 21 |  2 | Código para transação CVT: 04 (número FIXO) (04=5539-5)<br/>
+      # 22 a 27 |  6 | data de vencimento (AAMMDD)<br/>
+      # 28 a 32 |  5 | Código da agência + dígito verificador<br/>
+      # 33 a 43 |  11 |  “Nosso Número” (NNNNNNNNNNN)<br/>
+      # 44 | 1 Super dígito do “Nosso Número” (calculado com o MÓDULO 11 (de 2 a 9))<br/>
+      #
+      # @return [String] 25 caracteres numéricos.
+      def codigo_barras_segunda_parte
+        case self.carteira.to_i
+        when 5
+          "#{self.carteira}#{self.convenio}00#{self.numero_documento}#{self.nosso_numero_dv}"
+        else # 4
+          data = self.data_vencimento.strftime('%y%m%d')
+          "0#{self.carteira}#{data}#{self.agencia}#{self.agencia_dv}#{self.numero_documento}#{self.nosso_numero_dv}"
+        end
+      end
+    end
+  end
+end

data/lib/brcobranca/calculo.rb

@@ -0,0 +1,132 @@
+# -*- encoding: utf-8 -*-
+# @author Kivanio Barbosa
+module Brcobranca
+  # Métodos auxiliares de cálculos
+  module Calculo
+    # Calcula módulo 10 segundo a BACEN.
+    #
+    # @return [Integer]
+    # @raise  [ArgumentError] Caso não seja um número inteiro.
+    def modulo10
+      raise ArgumentError, "Número inválido" unless self.is_number?
+
+      total = 0
+      multiplicador = 2
+
+      self.to_s.split(//).reverse!.each do |caracter|
+        total += (caracter.to_i * multiplicador).soma_digitos
+        multiplicador = multiplicador == 2 ? 1 : 2
+      end
+
+      valor = (10 - (total % 10))
+      valor == 10 ? 0 : valor
+    end
+
+    # Calcula módulo 10 do Banespa.
+    #
+    # @return [Integer]
+    # @raise  [ArgumentError] Caso não seja um número inteiro.
+    def modulo_10_banespa
+      raise ArgumentError, "Número inválido" unless self.is_number?
+
+      fatores = [7,3,1,9,7,3,1,9,7,3]
+      total = 0
+      posicao = 0
+      self.to_s.split(//).each do |digito|
+        total += (digito.to_i * fatores[posicao]).to_s.split(//)[-1].to_i
+        posicao = (posicao < (fatores.size - 1)) ? (posicao + 1) : 0
+      end
+      dv = 10 - total.to_s.split(//)[-1].to_i
+      dv == 10 ? 0 : dv
+    end
+
+    # Calcula módulo 11 com multiplicaroes de 9 a 2 segundo a BACEN.
+    #
+    # @return [Integer]
+    def modulo11_9to2
+      total = self.multiplicador([9,8,7,6,5,4,3,2])
+
+      return (total % 11 )
+    end
+
+    # Calcula módulo 11 com multiplicaroes de 2 a 9 segundo a BACEN.
+    #
+    # @return [Integer]
+    def modulo11_2to9
+      total = self.multiplicador([2,3,4,5,6,7,8,9])
+
+      valor = (11 - (total % 11))
+      return [0,10,11].include?(valor) ? 1 : valor
+    end
+
+    # Calcula módulo 11 com multiplicaroes de 9 a 2 trocando retorno <b>10 por X</b>.
+    #
+    # @return [Integer, String] Caso resultado for 10, retorna X.
+    def modulo11_9to2_10_como_x
+      valor = self.modulo11_9to2
+      valor == 10 ? "X" : valor
+    end
+
+    # Calcula módulo 11 com multiplicaroes de 9 a 2 trocando retorno <b>10 por 0</b>.
+    #
+    # @return [Integer]
+    def modulo11_9to2_10_como_zero
+      valor = self.modulo11_9to2
+      valor == 10 ? 0 : valor
+    end
+
+    # Verifica se String só contem caracteres numéricos.
+    #
+    # @return [Boolean]
+    def is_number?
+      self.to_s.empty? ? false : (self.to_s =~ (/\D/)).nil?
+    end
+
+    # Soma dígitos de números inteiros positivos com 2 dígitos ou mais.
+    #
+    # @return [Integer]
+    # @example
+    #  1 #=> 1
+    #  11 (1+1) #=> 2
+    #  13 (1+3) #=> 4
+    def soma_digitos
+      total = case self.to_i
+      when (0..9)
+        self
+      else
+        numero = self.to_s
+        total = 0
+        0.upto(numero.size-1) {|digito| total += numero[digito,1].to_i }
+        total
+      end
+      total.to_i
+    end
+
+    # Faz a multiplicação de um número pelos fatores passados como parâmetro.
+    #
+    # @param  [Array]
+    # @return [Integer]
+    # @raise  [ArgumentError] Caso não seja um número inteiro.
+    def multiplicador(fatores, &block)
+      raise ArgumentError, "Número inválido" unless self.is_number?
+
+      total = 0
+      multiplicador_posicao = 0
+
+      self.to_s.split(//).reverse!.each do |caracter|
+        fator = fatores[multiplicador_posicao]
+        total += if block_given?
+          yield(caracter, fator)
+        else
+          (caracter.to_i * fator)
+        end
+        multiplicador_posicao = (multiplicador_posicao < (fatores.size - 1)) ? (multiplicador_posicao + 1) : 0
+      end
+      total
+    end
+  end
+end
+
+[ String, Numeric ].each do |klass|
+  klass.class_eval { include Brcobranca::Calculo }
+end

data/lib/brcobranca/calculo_data.rb

@@ -0,0 +1,42 @@
+# -*- encoding: utf-8 -*-
+# @author Kivanio Barbosa
+module Brcobranca
+  # Métodos auxiliares de cálculos envolvendo Datas.
+  module CalculoData
+    # Calcula o número de dias corridos entre a <b>data base ("Fixada" em 07.10.1997)</b> e a <b>data de vencimento</b> desejada.
+    # @return [String] Contendo 4 dígitos
+    # @example
+    #  Date.parse(2000-07-04).fator_vencimento #=> 1001
+    def fator_vencimento
+      data_base = Date.parse "1997-10-07"
+      Integer(self - data_base).to_s.rjust(4,'0')
+    end
+
+    # Mostra a data em formato <b>dia/mês/ano</b>
+    # @return [String]
+    # @example
+    #  Date.today.to_s_br #=> 20/01/2010
+    def to_s_br
+      self.strftime('%d/%m/%Y')
+    end
+    # Calcula número de dias julianos.
+    #
+    # O cálculo é feito subtraindo-se a data atual, pelo último dia válido do ano anterior,
+    # acrescentando-se o último algarismo do ano atual na quarta posição.
+    #
+    # @return [String] contendo 4 dígitos
+    #
+    # @example
+    #  Date.parse(2009-02-11).to_juliano #=> "0429"
+    def to_juliano
+      ultima_data = Date.parse("#{self.year - 1}-12-31")
+      ultimo_digito_ano = self.to_s[3..3]
+      dias = Integer(self - ultima_data)
+      (dias.to_s + ultimo_digito_ano).rjust(4,'0')
+    end
+  end
+end
+
+[ Date ].each do |klass|
+  klass.class_eval { include Brcobranca::CalculoData }
+end

data/lib/brcobranca/currency.rb

@@ -1,7 +1,8 @@
-# Implementação feita por Nando Vieira do http://simplesideias.com.br
-# post http://simplesideias.com.br/usando-number_to_currency-em-modelos-no-rails
+# @author Fernando Vieira do http://simplesideias.com.br
 module Brcobranca #:nodoc:[all]
   module Currency #:nodoc:[all]
+    # Implementação feita por Fernando Vieira do http://simplesideias.com.br
+    # post http://simplesideias.com.br/usando-number_to_currency-em-modelos-no-rails
     BRL = {:delimiter => ".", :separator => ",", :unit => "R$", :precision => 2, :position => "before"}
     USD = {:delimiter => ',', :separator => ".", :unit => "US$", :precision => 2, :position => "before"}
     DEFAULT = BRL.merge(:unit => "")
@@ -56,8 +57,6 @@ module Brcobranca #:nodoc:[all]
   end
 end
 
-# TODO - porque não incluir somente na Numeric?
-# [ Fixnum, Bignum, Float ].each do |klass|
 [ Numeric].each do |klass|
   klass.class_eval { include Brcobranca::Currency::Number }
 end