tulios-brcobranca-rails2 2.0.8

data/lib/brcobranca/boleto/base.rb

@@ -0,0 +1,154 @@
+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
+
+        # Campo usado apenas na exibição no boleto
+        #  Deverá ser sobreescrito para cada banco
+        def nosso_numero_boleto
+          "Sobreescreva este método na classe referente ao banco que você esta criando"
+        end
+
+        # Campo usado apenas na exibição no boleto
+        #  Deverá ser sobreescrito para cada banco
+        def agencia_conta_boleto
+          "Sobreescreva este método na classe referente ao banco que você esta criando"
+        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
+          return 0 unless self.quantidade.kind_of?(Numeric) && self.valor.kind_of?(Numeric)
+          self.quantidade * self.valor.to_f
+        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
+          return nil unless self.data_documento.kind_of?(Date) && self.dias_vencimento.kind_of?(Numeric)
+          (self.data_documento + self.dias_vencimento.to_i)
+        end
+
+        # Retorna uma String com 44 caracteres representando o codigo de barras do boleto
+        #   O código de barra para cobrança contém 44 posições dispostas da seguinte forma:
+        #   Posição Tamanho Conteúdo
+        #   01 a 03   3       Identificação do Banco
+        #   04 a 04   1       Código da Moeda (Real = 9, Outras=0)
+        #   05 a 05   1       Dígito verificador do Código de Barras
+        #   06 a 09   4       Fator de Vencimento (Vide Nota)
+        #   10 a 19   10      Valor
+        #   20 a 44   25      Campo Livre
+        #   As posições do campo livre ficam a critério de cada Banco arrecadador.
+        def codigo_barras
+          codigo = monta_codigo_43_digitos
+          return unless codigo
+          return 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

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

@@ -0,0 +1,153 @@
+begin
+  require 'rghost'
+rescue LoadError
+  require 'rubygems' unless ENV['NO_RUBYGEMS']
+  gem 'rghost'
+  require 'rghost'
+end
+
+begin
+  require 'rghost_barcode'
+rescue LoadError
+  require 'rubygems' unless ENV['NO_RUBYGEMS']
+  gem 'rghost_barcode'
+  require 'rghost_barcode'
+end
+
+module Brcobranca
+  module Boleto
+    module Template
+      # Templates para usar com Rghost
+      module Rghost
+        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)
+        end
+
+        # Responsável por setar os valores necessários no template genérico
+        # Retorna um stream pronto para gravaçào
+        #
+        # O tipo do arquivo gerado pode ser modificado incluindo a configuração a baixo dentro da sua aplicação:
+        #  Brcobranca::Config::OPCOES[:tipo] = 'pdf'
+        #
+        # Ou pode ser passado como paramentro:
+        #  :tipo => 'pdf'
+        def modelo_generico(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)
+
+          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
+
+          # Busca logo automaticamente
+          logo = monta_logo
+
+          #INICIO Primeira parte do BOLETO
+          # LOGOTIPO do BANCO
+          doc.image(logo, :x => '0.5 cm', :y => '23.85 cm', :zoom => 80) if logo
+          # Dados
+          doc.moveto :x => '5.2 cm' , :y => '23.85 cm'
+          doc.show "#{self.banco}-#{self.banco_dv}", :tag => :grande
+          doc.moveto :x => '7.5 cm' , :y => '23.85 cm'
+          doc.show self.codigo_barras.linha_digitavel, :tag => :grande
+          doc.moveto :x => '0.7 cm' , :y => '23 cm'
+          doc.show self.cedente
+          doc.moveto :x => '11 cm' , :y => '23 cm'
+          doc.show self.agencia_conta_boleto
+          doc.moveto :x => '14.2 cm' , :y => '23 cm'
+          doc.show self.especie
+          doc.moveto :x => '15.7 cm' , :y => '23 cm'
+          doc.show self.quantidade
+          doc.moveto :x => '0.7 cm' , :y => '22.2 cm'
+          doc.show self.numero_documento
+          doc.moveto :x => '7 cm' , :y => '22.2 cm'
+          doc.show "#{self.documento_cedente.formata_documento}"
+          doc.moveto :x => '12 cm' , :y => '22.2 cm'
+          doc.show self.data_vencimento.to_s_br
+          doc.moveto :x => '16.5 cm' , :y => '23 cm'
+          doc.show self.nosso_numero_boleto
+          doc.moveto :x => '16.5 cm' , :y => '22.2 cm'
+          doc.show self.valor_documento.to_currency
+          doc.moveto :x => '1.4 cm' , :y => '20.9 cm'
+          doc.show "#{self.sacado} - #{self.sacado_documento.formata_documento}"
+          doc.moveto :x => '1.4 cm' , :y => '20.6 cm'
+          doc.show "#{self.sacado_endereco}"
+          #FIM Primeira parte do 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.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.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.moveto :x => '0.7 cm' , :y => '16 cm'
+          doc.show self.local_pagamento if self.local_pagamento
+          doc.moveto :x => '16.5 cm' , :y => '16 cm'
+          doc.show self.data_vencimento.to_s_br if self.data_vencimento
+          doc.moveto :x => '0.7 cm' , :y => '15.2 cm'
+          doc.show self.cedente if self.cedente
+          doc.moveto :x => '16.5 cm' , :y => '15.2 cm'
+          doc.show self.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.moveto :x => '4.2 cm' , :y => '14.4 cm'
+          doc.show self.numero_documento if self.numero_documento
+          doc.moveto :x => '10 cm' , :y => '14.4 cm'
+          doc.show self.especie if self.especie
+          doc.moveto :x => '11.7 cm' , :y => '14.4 cm'
+          doc.show self.aceite if self.aceite
+          doc.moveto :x => '13 cm' , :y => '14.4 cm'
+          doc.show self.data_processamento.to_s_br if self.data_processamento
+          doc.moveto :x => '16.5 cm' , :y => '14.4 cm'
+          doc.show self.nosso_numero_boleto
+          doc.moveto :x => '4.4 cm' , :y => '13.5 cm'
+          doc.show self.carteira if self.carteira
+          doc.moveto :x => '6.4 cm' , :y => '13.5 cm'
+          doc.show self.moeda if self.moeda
+          doc.moveto :x => '8 cm' , :y => '13.5 cm'
+          doc.show self.quantidade if self.quantidade
+          doc.moveto :x => '11 cm' , :y => '13.5 cm'
+          doc.show self.valor.to_currency if self.valor
+          doc.moveto :x => '16.5 cm' , :y => '13.5 cm'
+          doc.show self.valor_documento.to_currency if self.valor_documento
+          doc.moveto :x => '0.7 cm' , :y => '12.7 cm'
+          doc.show self.instrucao1 if self.instrucao1
+          doc.moveto :x => '0.7 cm' , :y => '12.3 cm'
+          doc.show self.instrucao2 if self.instrucao2
+          doc.moveto :x => '0.7 cm' , :y => '11.9 cm'
+          doc.show self.instrucao3 if self.instrucao3
+          doc.moveto :x => '0.7 cm' , :y => '11.5 cm'
+          doc.show self.instrucao4 if self.instrucao4
+          doc.moveto :x => '0.7 cm' , :y => '11.1 cm'
+          doc.show self.instrucao5 if self.instrucao5
+          doc.moveto :x => '0.7 cm' , :y => '10.7 cm'
+          doc.show self.instrucao6 if self.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.moveto :x => '1.2 cm' , :y => '8.4 cm'
+          doc.show "#{self.sacado_endereco}" if self.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
+  end
+end

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

@@ -0,0 +1,34 @@
+module Brcobranca
+  module Boleto
+    module Template
+      # Métodos auxiliares de montagem de template
+      module Util
+        # Responsável por definir a logotipo usada no template genérico, 
+        # retorna o caminho para o <b>logotipo</b> ou <b>false</b> caso nao consiga encontrar o logotipo.
+        def monta_logo
+          case self.class.to_s
+          when "BancoBrasil"
+            imagem = 'bb.jpg'
+          when "BancoItau"
+            imagem = 'itau.jpg'
+          when "BancoHsbc"
+            imagem = 'hsbc.jpg'
+          when "BancoReal"
+            imagem = 'real.jpg'
+          when "BancoBradesco"
+            imagem = 'bradesco.jpg'
+          when "BancoUnibanco"
+            imagem = 'unibanco.jpg'
+          when "BancoBanespa"
+            imagem = 'banespa.jpg'
+          when "BancoCaixa"
+            imagem = 'caixa.jpg'
+          else
+            return false
+          end
+          File.join(File.dirname(__FILE__),'..','..','arquivos','logos',imagem)
+        end
+      end
+    end
+  end
+end

data/lib/brcobranca/config.rb

@@ -0,0 +1,9 @@
+module Brcobranca
+  # Módulo de configuração. 
+  module Config
+    # Opções disponíveis: 
+    #  Brcobranca::Config::OPCOES[:tipo] - Pode ser pdf, jpg e ps.
+    #  Brcobranca::Config::OPCOES[:gerador] - Somente rghost até o momento
+    OPCOES = {:tipo => 'pdf', :gerador => 'rghost'}
+  end
+end

data/lib/brcobranca/core_ext.rb

@@ -0,0 +1,287 @@
+module Brcobranca
+  # Métodos auxiliares de formatação
+  module Formatacao
+    # Formata como CPF
+    def to_br_cpf
+      (self.kind_of?(String) ? self : self.to_s).gsub(/^(.{3})(.{3})(.{3})(.{2})$/,'\1.\2.\3-\4')
+    end
+
+    # Formata como CEP
+    def to_br_cep
+      (self.kind_of?(String) ? self : self.to_s).gsub(/^(.{5})(.{3})$/,'\1-\2')
+    end
+
+    # Formata como CNPJ
+    def to_br_cnpj
+      (self.kind_of?(String) ? self : self.to_s).gsub(/^(.{2})(.{3})(.{3})(.{4})(.{2})$/,'\1.\2.\3/\4-\5')
+    end
+
+    # Gera formatação automatica do documento baseado no tamanho do campo.
+    def formata_documento      
+      case (self.kind_of?(String) ? self : self.to_s).size
+      when 8 then self.to_br_cep
+      when 11 then self.to_br_cpf
+      when 14 then self.to_br_cnpj
+      else
+        self
+      end
+    end
+
+    # Remove caracteres que não sejam numéricos do tipo MOEDA
+    def limpa_valor_moeda
+      return self unless self.kind_of?(String) && self.moeda?
+      self.somente_numeros
+    end
+
+    # Remove caracteres que não sejam numéricos
+    def somente_numeros
+      return self unless self.kind_of?(String)
+      self.gsub(/\D/,'')
+    end
+
+    # Completa zeros a esquerda.
+    #  Ex. numero="123" :tamanho=>3 | numero="123"
+    #  Ex. numero="123" :tamanho=>4 | numero="0123"
+    #  Ex. numero="123" :tamanho=>5 | numero="00123"
+    def zeros_esquerda(options={})
+      valor_inicial = self.kind_of?(String) ? self : self.to_s
+      return valor_inicial if (valor_inicial !~ /\S/)
+      digitos = options[:tamanho] || valor_inicial.size
+
+      diferenca = (digitos - valor_inicial.size)
+
+      return valor_inicial if (diferenca <= 0)
+      return (("0" * diferenca) + valor_inicial )
+    end
+
+    # Monta a linha digitável padrão para todos os bancos segundo a BACEN.
+    # Retorna + nil + para Codigo de Barras em branco,
+    # Codigo de Barras com tamanho diferente de 44 dígitos e
+    # Codigo de Barras que não tenham somente caracteres numéricos.
+    #   A linha digitável será composta por cinco campos:
+    #   1º campo
+    #   Composto pelo código de Banco, código da moeda, as cinco primeiras posições do campo livre
+    #   e o dígito verificador deste campo;
+    #   2º campo
+    #   Composto pelas posições 6ª a 15ª do campo livre e o dígito verificador deste campo;
+    #   3º campo
+    #   Composto pelas posições 16ª a 25ª do campo livre e o dígito verificador deste campo;
+    #   4º campo
+    #   Composto pelo dígito verificador do código de barras, ou seja, a 5ª posição do código de
+    #   barras;
+    #   5º campo
+    #   Composto pelo fator de vencimento com 4(quatro) caracteres e o valor do documento com
+    #   10(dez) caracteres, sem separadores e sem edição.
+    #   Entre cada campo deverá haver espaço equivalente a 2 (duas) posições, sendo a 1ª
+    #   interpretada por um ponto (.) e a 2ª por um espaço em branco.
+    def linha_digitavel
+      valor_inicial = self.kind_of?(String) ? self : self.to_s
+      raise ArgumentError, "Número em branco" if valor_inicial.nil?
+      raise ArgumentError, "Somente números" unless valor_inicial.numeric?
+      raise ArgumentError, "Precisa conter 44 caracteres e você passou um valor com #{valor_inicial.size} caracteres" if valor_inicial.size != 44
+
+      dv_1 = ("#{valor_inicial[0..3]}#{valor_inicial[19..23]}").modulo10
+      campo_1_dv = "#{valor_inicial[0..3]}#{valor_inicial[19..23]}#{dv_1}"
+      campo_linha_1 = "#{campo_1_dv[0..4]}.#{campo_1_dv[5..9]}"
+
+      dv_2 = "#{valor_inicial[24..33]}".modulo10
+      campo_2_dv = "#{valor_inicial[24..33]}#{dv_2}"
+      campo_linha_2 = "#{campo_2_dv[0..4]}.#{campo_2_dv[5..10]}"
+
+      dv_3 = "#{valor_inicial[34..43]}".modulo10
+      campo_3_dv = "#{valor_inicial[34..43]}#{dv_3}"
+      campo_linha_3 = "#{campo_3_dv[0..4]}.#{campo_3_dv[5..10]}"
+
+      campo_linha_4 = "#{valor_inicial[4..4]}"
+
+      campo_linha_5 = "#{valor_inicial[5..18]}"
+
+      "#{campo_linha_1} #{campo_linha_2} #{campo_linha_3} #{campo_linha_4} #{campo_linha_5}"
+    end
+  end
+
+  # métodos auxiliares de cálculos
+  module Calculo
+
+    # Verifica se String só contem caracteres numéricos.
+    #
+    # @return [Boolean]
+    def is_number?
+      self.to_s.empty? ? false : (self.to_s =~ (/\D/)).nil?
+    end
+        
+    # Método padrão para cálculo de módulo 10 segundo a BACEN.
+    def modulo10
+      valor_inicial = self.kind_of?(String) ? self : self.to_s
+      raise ArgumentError, "Somente números" unless valor_inicial.numeric?
+
+      total = 0
+      multiplicador = 2
+
+      valor_inicial.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
+
+    # Método padrão para cálculo de módulo 11 com multiplicaroes de 9 a 2 segundo a BACEN.
+    # Usado no DV do Nosso Numero, Agência e Cedente.
+    #  Retorna + nil + para todos os parametros que nao forem String
+    #  Retorna + nil + para String em branco
+    def modulo11_9to2
+      total = self.multiplicador([9,8,7,6,5,4,3,2])
+
+      return (total % 11 )
+    end
+
+    # Método padrão para cálculo de módulo 11 com multiplicaroes de 2 a 9 segundo a BACEN.
+    # Usado no DV do Código de Barras.
+    #  Retorna + nil + para todos os parametros que não forem String
+    #  Retorna + nil + para String em branco
+    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
+
+    def modulo_10_banespa
+      valor_inicial = self.kind_of?(String) ? self : self.to_s
+      raise ArgumentError, "Somente números" unless valor_inicial.numeric?
+
+      fatores = [7,3,1,9,7,3,1,9,7,3]
+      total = 0
+      posicao = 0
+      valor_inicial.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
+
+    # Retorna o dígito verificador de <b>modulo 11(9-2)</b> trocando retorno <b>10 por X</b>.
+    #  Usado por alguns bancos.
+    def modulo11_9to2_10_como_x
+      valor = self.modulo11_9to2
+      valor == 10 ? "X" : valor
+    end
+
+    # Retorna o dígito verificador de <b>modulo 11(9-2)</b> trocando retorno <b>10 por 0</b>.
+    #  Usado por alguns bancos.
+    def modulo11_9to2_10_como_zero
+      valor = self.modulo11_9to2
+      valor == 10 ? 0 : valor
+    end
+
+    # Soma números inteiros positivos com 2 dígitos ou mais
+    # Retorna <b>0(zero)</b> caso seja impossível.
+    #  Ex. 1 = 1
+    #  Ex. 11 = (1+1) = 2
+    #  Ex. 13 = (1+3) = 4
+    def soma_digitos
+      valor_inicial = self.kind_of?(Fixnum) ? self : self.to_i
+      return 0 if valor_inicial == 0
+      return valor_inicial if valor_inicial <= 9
+
+      valor_inicial = valor_inicial.to_s
+      total = 0
+
+      0.upto(valor_inicial.size-1) {|digito| total += valor_inicial[digito,1].to_i }
+
+      return total
+    end
+
+    def multiplicador(fatores)
+      valor_inicial = self.kind_of?(String) ? self : self.to_s
+      raise ArgumentError, "Somente números" unless valor_inicial.numeric?
+
+      total = 0
+      multiplicador_posicao = 0
+
+      valor_inicial.split(//).reverse!.each do |caracter|
+        total += (caracter.to_i * fatores[multiplicador_posicao])
+        multiplicador_posicao = (multiplicador_posicao < (fatores.size - 1)) ? (multiplicador_posicao + 1) : 0
+      end
+      total.to_i
+    end
+  end
+
+  # Métodos auxiliares de verificação e validação.
+  module Validacao
+    # Verifica se o valor é moeda.
+    #  Ex. +1.232.33
+    #  Ex. -1.232.33
+    #  Ex. 1.232.33
+    def moeda?
+      value = self.kind_of?(String) ? self : self.to_s
+      value =~ /^(\+|-)?\d+((\.|,)\d{3}*)*((\.|,)\d{2}*)$/ ? true : false
+    end
+  end
+
+  # Métodos auxiliares de limpeza.
+  module Limpeza
+    # Retorna uma String contendo exatamente o valor FLOAT
+    def limpa_valor_moeda
+      valor_inicial = self.to_s
+      (valor_inicial + ("0" * (2 - valor_inicial.split(/\./).last.size ))).somente_numeros
+    end
+  end
+
+  # Métodos auxiliares de cálculos envolvendo <b>Datas</b>.
+  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> desejado:
+    #  VENCIMENTO 04/07/2000
+    #  DATA BASE - 07/10/1997
+    #  FATOR DE VENCIMENTO 1001
+    def fator_vencimento
+      data_base = Date.parse "1997-10-07"
+      (self - data_base).to_i
+    end
+
+    # Mostra a data em formato <b>dia/mês/ano</b>
+    def to_s_br
+      self.strftime('%d/%m/%Y')
+    end
+    # Retorna string contendo 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.
+    #  Deve retornar string com 4 digitos.
+    #  Ex. Data atual = 11/02/2009
+    #     Data válida ano anterior = 31/12/2008
+    #     (Data atual - Data válida ano anterior) = 42
+    #     último algarismo do ano atual = 9
+    #     String atual 42+9 = 429
+    #     Completa zero esquerda para formar 4 digitos = "0429"
+    def to_juliano
+      ultima_data = Date.parse("#{self.year - 1}-12-31")
+      ultimo_digito_ano = self.to_s[3..3]
+      dias = (self - ultima_data)
+      (dias.to_s + ultimo_digito_ano).zeros_esquerda(:tamanho => 4)
+    end
+  end
+end
+
+# NEW AND COOL
+[ String, Numeric ].each do |klass|
+  klass.class_eval { include Brcobranca::Formatacao }
+end
+
+[ String, Numeric ].each do |klass|
+  klass.class_eval { include Brcobranca::Validacao }
+end
+
+[ String, Numeric ].each do |klass|
+  klass.class_eval { include Brcobranca::Calculo }
+end
+
+[ Float ].each do |klass|
+  klass.class_eval { include Brcobranca::Limpeza }
+end
+
+[ Date ].each do |klass|
+  klass.class_eval { include Brcobranca::CalculoData }
+end