brcobranca 2.0.6 → 3.0.0

data/lib/brcobranca/boleto/base.rb

@@ -1,9 +1,18 @@
+# -*- encoding: utf-8 -*-
+# @author Kivanio Barbosa
 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
+      extend Template::Base
+
+      # Configura gerador de arquivo de boleto e código de barras.
+      extend define_template(Brcobranca.configuration.gerador)
+      include define_template(Brcobranca.configuration.gerador)
+
+      # Validações do Rails 3
+      include ActiveModel::Validations
+
       # <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)
@@ -20,15 +29,15 @@ module Brcobranca
       attr_accessor :quantidade
       # <b>REQUERIDO</b>: Valor do boleto
       attr_accessor :valor
-      # <b>REQUERIDO</b>: Número da agencia
+      # <b>REQUERIDO</b>: Número da agencia sem <b>Digito Verificador</b>
       attr_accessor :agencia
-      # <b>REQUERIDO</b>: Número da conta corrente
+      # <b>REQUERIDO</b>: Número da conta corrente sem <b>Digito Verificador</b>
       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
+      # <b>OPCIONAL</b>: Número sequencial utilizado para identificar o boleto
       attr_accessor :numero_documento
       # <b>REQUERIDO</b>: Símbolo da moeda utilizada (R$ no brasil)
       attr_accessor :especie
@@ -63,92 +72,154 @@ module Brcobranca
       # <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.
+      # Validações
+      validates_presence_of :agencia, :conta_corrente, :moeda, :especie_documento, :especie, :aceite, :numero_documento, :message => "não pode estar em branco."
+      validates_numericality_of :convenio, :agencia, :conta_corrente, :numero_documento, :message => "não é um número.", :allow_nil => true
+
+      # Nova instancia da classe Base
+      # @param [Hash] campos
       def initialize(campos={})
-        padrao = { :moeda => "9", :data_documento => Date.today, :dias_vencimento => 1, :quantidade => 1,
+        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"}
+          :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
+        campos = padrao.merge!(campos)
+        campos.each do |campo, valor|
+          send "#{campo}=", valor
         end
 
-        # Retorna dígito verificador do banco, calculado com modulo11 de 9 para 2
-        def banco_dv
-          self.banco.modulo11_9to2
-        end
+        yield self if block_given?
+      end
 
-        # Retorna dígito verificador da agência, calculado com modulo11 de 9 para 2
-        def agencia_dv
-          self.agencia.modulo11_9to2
-        end
+      # Logotipo do banco
+      # @return [Path] Caminho para o arquivo de logotipo do banco.
+      def logotipo
+        File.join(File.dirname(__FILE__),'..','arquivos','logos',"#{class_name}.jpg")
+      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
+      # Dígito verificador do banco
+      # @return [Integer] 1 caracteres numéricos.
+      def banco_dv
+        self.banco.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
+      # Código da agencia
+      # @return [String] 4 caracteres numéricos.
+      def agencia=(valor)
+        @agencia = valor.to_s.rjust(4,'0') unless valor.nil?
+      end
 
-        # Número sequencial utilizado para distinguir os boletos na agência
-        def nosso_numero
-          self.numero_documento
-        end
+      # Dígito verificador da agência
+      # @return [Integer] 1 caracteres numéricos.
+      def agencia_dv
+        self.agencia.modulo11_9to2
+      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
+      # Dígito verificador da conta corrente
+      # @return [Integer] 1 caracteres numéricos.
+      def conta_corrente_dv
+        self.conta_corrente.modulo11_9to2
+      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
+      # Dígito verificador do nosso número
+      # @return [Integer] 1 caracteres numéricos.
+      def nosso_numero_dv
+        self.numero_documento.modulo11_9to2
+      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
+      # @abstract Deverá ser sobreescrito para cada banco.
+      def nosso_numero_boleto
+        raise Brcobranca::NaoImplementado.new("Sobreescreva este método na classe referente ao banco que você esta criando")
+      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
+      # @abstract Deverá ser sobreescrito para cada banco.
+      def agencia_conta_boleto
+        raise Brcobranca::NaoImplementado.new("Sobreescreva este método na classe referente ao banco que você esta criando")
+      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
+      # Valor total do documento: <b>quantidate * valor</b>
+      # @return [Float]
+      def valor_documento
+        self.quantidade.to_f * self.valor.to_f
+      end
 
-          "#{codigo[0..3]}#{codigo_dv}#{codigo[4..42]}"
-        end
+      # Data de vencimento baseado na <b>data_documento + dias_vencimento</b>
+      #
+      # @return [Date]
+      # @raise [ArgumentError] Caso {#data_documento} esteja em branco.
+      def data_vencimento
+        raise ArgumentError, "data_documento não pode estar em branco." unless self.data_documento
+        return self.data_documento unless self.dias_vencimento
+        (self.data_documento + self.dias_vencimento.to_i)
+      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"
+      # Fator de vencimento calculado com base na data de vencimento do boleto.
+      # @return [String] 4 caracteres numéricos.
+      def fator_vencimento
+        self.data_vencimento.fator_vencimento
+      end
+
+      # Número da conta corrente
+      # @return [String] 7 caracteres numéricos.
+      def conta_corrente=(valor)
+        @conta_corrente = valor.to_s.rjust(7,'0') unless valor.nil?
+      end
+
+      # Codigo de barras do boleto
+      #
+      # O codigo de barra para cobrança contém 44 posições dispostas da seguinte forma:<br/>
+      # Posição |Tamanho |Conteúdo<br/>
+      # 01 a 03 | 3  | Identificação do Banco<br/>
+      # 04 a 04 | 1  | Código da Moeda (Real = 9, Outras=0)<br/>
+      # 05 a 05 | 1  |  Dígito verificador do Código de Barras<br/>
+      # 06 a 09 | 4  | Fator de Vencimento (Vide Nota)<br/>
+      # 10 a 19 | 10 |  Valor<br/>
+      # 20 a 44 | 25 |  Campo Livre - As posições do campo livre ficam a critério de cada Banco arrecadador.<br/>
+      #
+      # @raise [Brcobranca::BoletoInvalido] Caso as informações fornecidas não sejam suficientes ou sejam inválidas.
+      # @return [String] código de barras formado por 44 caracteres numéricos.
+      def codigo_barras
+        raise Brcobranca::BoletoInvalido.new(self) unless self.valid?
+        codigo = codigo_barras_primeira_parte #18 digitos
+        codigo << codigo_barras_segunda_parte #25 digitos
+        if codigo =~ /^(\d{4})(\d{39})$/
+          codigo_dv = codigo.modulo11_2to9
+          codigo = "#{$1}#{codigo_dv}#{$2}"
+          codigo
+        else
+          raise Brcobranca::BoletoInvalido.new(self)
         end
-        
       end
+
+      # Monta a segunda parte do código de barras, que é específico para cada banco.
+      #
+      # @abstract Deverá ser sobreescrito para cada banco.
+      def codigo_barras_segunda_parte
+        raise Brcobranca::NaoImplementado.new("Sobreescreva este método na classe referente ao banco que você esta criando")
+      end
+
+      private
+
+      # Monta a primeira parte do código de barras, que é a mesma para todos bancos.
+      # @return [String] 18 caracteres numéricos.
+      def codigo_barras_primeira_parte
+        "#{self.banco}#{self.moeda}#{self.fator_vencimento}#{valor_documento_formatado}"
+      end
+
+      # Valor total do documento
+      # @return [String] 10 caracteres numéricos.
+      def valor_documento_formatado
+        self.valor_documento.limpa_valor_moeda.to_s.rjust(10,'0')
+      end
+
+      # Nome da classe do boleto
+      # @return [String]
+      def class_name
+        self.class.to_s.split("::").last.downcase
+      end
+
     end
-  end
+  end
+end

data/lib/brcobranca/boleto/bradesco.rb

@@ -0,0 +1,69 @@
+# -*- encoding: utf-8 -*-
+module Brcobranca
+  module Boleto
+    class Bradesco < Base # Banco BRADESCO
+
+      validates_length_of :agencia, :maximum => 4, :message => "deve ser menor ou igual a 4 dígitos."
+      validates_length_of :numero_documento, :maximum => 11, :message => "deve ser menor ou igual a 11 dígitos."
+      validates_length_of :conta_corrente, :maximum => 7, :message => "deve ser menor ou igual a 7 dígitos."
+      validates_length_of :carteira, :maximum => 2, :message => "deve ser menor ou igual a 2 dígitos."
+
+      # Nova instancia do Bradesco
+      # @param (see Brcobranca::Boleto::Base#initialize)
+      def initialize(campos={})
+        campos = {:carteira => "06"}.merge!(campos)
+        super(campos)
+      end
+
+      # Codigo do banco emissor (3 dígitos sempre)
+      #
+      # @return [String] 3 caracteres numéricos.
+      def banco
+        "237"
+      end
+
+      # Carteira
+      #
+      # @return [String] 2 caracteres numéricos.
+      def carteira=(valor)
+        @carteira = valor.to_s.rjust(2,'0') unless valor.nil?
+      end
+
+      # Número seqüencial utilizado para identificar o boleto.
+       # @return [String] 11 caracteres numéricos.
+      def numero_documento=(valor)
+        @numero_documento = valor.to_s.rjust(11,'0') unless valor.nil?
+      end
+
+      # Nosso número para exibir no boleto.
+      # @return [String]
+      # @example
+      #  boleto.nosso_numero_boleto #=> ""06/00000004042-8"
+      def nosso_numero_boleto
+        "#{self.carteira}/#{self.numero_documento}-#{self.nosso_numero_dv}"
+      end
+
+      # Agência + conta corrente do cliente para exibir no boleto.
+      # @return [String]
+      # @example
+      #  boleto.agencia_conta_boleto #=> "0548-7 / 00001448-6"
+      def agencia_conta_boleto
+        "#{self.agencia}-#{self.agencia_dv} / #{self.conta_corrente}-#{self.conta_corrente_dv}"
+      end
+
+      # Segunda parte do código de barras.
+      #
+      # Posição | Tamanho | Conteúdo<br/>
+      # 20 a 23 | 4 |  Agência Cedente (Sem o digito verificador, completar com zeros a esquerda quando  necessário)<br/>
+      # 24 a 25 | 2 |  Carteira<br/>
+      # 26 a 36 | 11 |  Número do Nosso Número(Sem o digito verificador)<br/>
+      # 37 a 43 | 7 |  Conta do Cedente (Sem o digito verificador, completar com zeros a esquerda quando necessário)<br/>
+      # 44 a 44 | 1 |  Zero<br/>
+      #
+      # @return [String] 25 caracteres numéricos.
+      def codigo_barras_segunda_parte
+        "#{self.agencia}#{self.carteira}#{self.numero_documento}#{self.conta_corrente}0"
+      end
+    end
+  end
+end

data/lib/brcobranca/boleto/caixa.rb

@@ -0,0 +1,100 @@
+# -*- encoding: utf-8 -*-
+#
+# A Caixa tem dois padrões para a geração de boleto: SIGCB e SICOB.
+# O SICOB foi substiuido pelo SIGCB que é implementado por esta classe.
+# http://downloads.caixa.gov.br/_arquivos/cobranca_caixa_sigcb/manuais/CODIGO_BARRAS_SIGCB.PDF
+#
+module Brcobranca
+  module Boleto
+    class Caixa < Base # Caixa
+
+      MODALIDADE_COBRANCA = {
+        :registrada => '1',
+        :sem_registro => '2'
+      }
+
+      EMISSAO_BOLETO = {
+        :cedente => '4'
+      }
+
+      # Validações
+      validates_length_of :carteira, :is => 2, :message => 'deve possuir 2 dígitos.'
+      validates_length_of :convenio, :is => 6, :message => 'deve possuir 6 dígitos.'
+      validates_length_of :numero_documento, :is => 15, :message => 'deve possuir 15 dígitos.'
+
+      # Nova instância da CaixaEconomica
+      # @param (see Brcobranca::Boleto::Base#initialize)
+      def initialize campos = {} 
+        campos = {
+          :carteira => "#{MODALIDADE_COBRANCA[:sem_registro]}#{EMISSAO_BOLETO[:cedente]}" 
+        }.merge!(campos)
+
+        campos.merge!(:convenio => campos[:convenio].rjust(6, '0')) if campos[:convenio]
+        campos.merge!(:numero_documento => campos[:numero_documento].rjust(15, '0')) if campos[:numero_documento]
+
+        super(campos)
+      end
+
+      # Código do banco emissor
+      # @return [String]
+      def banco; '104' end
+
+      # Dígito verificador do código do banco em módulo 10
+      # Módulo 10 de 104 é 0
+      # @return [String]
+      def banco_dv; '0' end
+
+      # Nosso número, 17 dígitos
+      #  1 à 2: carteira
+      #  3 à 17: campo_livre
+      # @return [String]
+      def nosso_numero_boleto
+        "#{carteira}#{numero_documento}-#{nosso_numero_dv}"
+      end
+
+      # Dígito verificador do Nosso Número
+      # Utiliza-se o [-1..-1] para retornar o último caracter
+      # @return [String]
+      def nosso_numero_dv
+        "#{carteira}#{numero_documento}".modulo11_9to2.to_s[-1..-1]
+      end
+
+      # Número da agência/código cedente do cliente para exibir no boleto.
+      # @return [String]
+      # @example
+      #  boleto.agencia_conta_boleto #=> "1565/100000-4"
+      def agencia_conta_boleto            
+        "#{agencia}/#{convenio}-#{convenio_dv}"
+      end
+
+      # Dígito verificador do convênio ou código do cedente
+      # @return [String]
+      def convenio_dv
+        "#{convenio.modulo11_2to9}"
+      end
+
+      # Monta a segunda parte do código de barras.
+      #  1 à 6: código do cedente, também conhecido como convênio
+      #  7: dígito verificador do código do cedente
+      #  8 à 10: dígito 3 à 5 do nosso número
+      #  11: dígito 1 do nosso número (modalidade da cobrança)
+      #  12 à 14: dígito 6 à 8 do nosso número
+      #  15: dígito 2 do nosso número (emissão do boleto)
+      #  16 à 24: dígito 9 à 17 do nosso número
+      #  25: dígito verificador do campo livre
+      # @return [String]
+      def codigo_barras_segunda_parte
+        campo_livre = "#{convenio}" << 
+        "#{convenio_dv}" <<
+        "#{nosso_numero_boleto[2..4]}" <<
+        "#{nosso_numero_boleto[0..0]}" <<
+        "#{nosso_numero_boleto[5..7]}" <<
+        "#{nosso_numero_boleto[1..1]}" <<
+        "#{nosso_numero_boleto[8..16]}"
+        
+        "#{campo_livre}#{campo_livre.modulo11_2to9}"
+      end
+
+    end
+  end
+end

data/lib/brcobranca/boleto/hsbc.rb

@@ -0,0 +1,95 @@
+# -*- encoding: utf-8 -*-
+module Brcobranca
+  module Boleto
+    class Hsbc < Base # Banco HSBC
+
+      validates_inclusion_of :carteira, :in => %w( CNR ), :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 :numero_documento, :maximum => 13, :message => "deve ser menor ou igual a 13 dígitos."
+      validates_length_of :conta_corrente, :maximum => 7, :message => "deve ser menor ou igual a 7 dígitos."
+
+      # Nova instancia do Hsbc
+      # @param (see Brcobranca::Boleto::Base#initialize)
+      def initialize(campos={})
+        campos = {:carteira => "CNR"}.merge!(campos)
+        super(campos)
+      end
+
+      # Codigo do banco emissor (3 dígitos sempre)
+      #
+      # @return [String] 3 caracteres numéricos.
+      def banco
+        "399"
+      end
+
+      # Número seqüencial utilizado para identificar o boleto.
+      # @return [String] 13 caracteres numéricos.
+      def numero_documento=(valor)
+        @numero_documento = valor.to_s.rjust(13,'0') unless valor.nil?
+      end
+
+      # Número seqüencial utilizado para identificar o boleto.
+      #
+      # Montagem é baseada na presença da data de vencimento.<br/>
+      # <b>OBS:</b> Somente a carteira <b>CNR</b> está implementada.<br/>
+      #
+      # @return [String]
+      # @raise  [Brcobranca::NaoImplementado] Caso a carteira informada não for CNR.
+      def nosso_numero
+        if self.data_vencimento.kind_of?(Date)
+          self.codigo_servico = "4"
+          dia = self.data_vencimento.day.to_s.rjust(2,'0')
+          mes = self.data_vencimento.month.to_s.rjust(2,'0')
+          ano = self.data_vencimento.year.to_s[2..3]
+          data = "#{dia}#{mes}#{ano}"
+
+          parte_1 = "#{self.numero_documento}#{self.numero_documento.modulo11_9to2_10_como_zero}#{self.codigo_servico}"
+          soma = parte_1.to_i + self.conta_corrente.to_i + data.to_i
+          numero = "#{parte_1}#{soma.to_s.modulo11_9to2_10_como_zero}"
+          numero
+        else
+          raise Brcobranca::NaoImplementado.new("Tipo de carteira não implementado.")
+          # TODO - Verificar outras carteiras.
+          # self.codigo_servico = "5"
+          # parte_1 = "#{self.numero_documento}#{self.numero_documento.modulo11_9to2_10_como_zero}#{self.codigo_servico}"
+          # soma = parte_1.to_i + self.conta_corrente.to_i
+          # numero = "#{parte_1}#{soma.to_s.modulo11_9to2_10_como_zero}"
+          # numero
+        end
+      end
+
+      # Nosso número para exibir no boleto.
+      # @return [String]
+      # @example
+      #  boleto.nosso_numero_boleto #=> "0000000004042847"
+      def nosso_numero_boleto
+        self.nosso_numero
+      end
+
+      # Número do convênio/contrato do cliente para exibir no boleto.
+      # @return [String]
+      # @example
+      #  boleto.agencia_conta_boleto #=> "0061900"
+      def agencia_conta_boleto
+        self.conta_corrente
+      end
+
+      # Segunda parte do código de barras.
+      #
+      # Montagem é baseada no tipo de carteira e na presença da data de vencimento<br/>
+      # <b>OBS:</b> Somente a carteira <b>CNR</b> está implementada.<br/>
+      #
+      # @return [String] 25 caracteres numéricos.
+      # @raise  [Brcobranca::NaoImplementado] Caso a carteira informada não for CNR.
+      def codigo_barras_segunda_parte
+        if self.carteira == "CNR"
+          dias_julianos = self.data_vencimento.to_juliano
+          "#{self.conta_corrente}#{self.numero_documento}#{dias_julianos}2"
+        else
+          raise Brcobranca::NaoImplementado.new("Tipo de carteira não implementado.")
+        end
+      end
+
+    end
+  end
+end

data/lib/brcobranca/boleto/itau.rb

@@ -0,0 +1,133 @@
+# -*- encoding: utf-8 -*-
+module Brcobranca
+  module Boleto
+    class Itau < Base # Banco Itaú
+
+      # Usado somente em carteiras especiais com registro para complementar o número do cocumento
+      attr_reader :seu_numero
+
+      validates_length_of :agencia, :maximum => 4, :message => "deve ser menor ou igual a 4 dígitos."
+      validates_length_of :convenio, :maximum => 5, :message => "deve ser menor ou igual a 5 dígitos."
+      validates_length_of :numero_documento, :maximum => 8, :message => "deve ser menor ou igual a 8 dígitos."
+      validates_length_of :conta_corrente, :maximum => 5, :message => "deve ser menor ou igual a 5 dígitos."
+      validates_length_of :seu_numero, :maximum => 7, :message => "deve ser menor ou igual a 7 dígitos."
+
+      # Nova instancia do Itau
+      # @param (see Brcobranca::Boleto::Base#initialize)
+      def initialize(campos={})
+        campos = {:carteira => "175"}.merge!(campos)
+        super(campos)
+      end
+
+      # Codigo do banco emissor (3 dígitos sempre)
+      #
+      # @return [String] 3 caracteres numéricos.
+      def banco
+        "341"
+      end
+
+      # Número do convênio/contrato do cliente junto ao banco.
+      # @return [String] 5 caracteres numéricos.
+      def convenio=(valor)
+        @convenio = valor.to_s.rjust(5,'0') unless valor.nil?
+      end
+
+      # Conta corrente
+      # @return [String] 5 caracteres numéricos.
+      def conta_corrente=(valor)
+        @conta_corrente = valor.to_s.rjust(5,'0') unless valor.nil?
+      end
+
+      # Número seqüencial utilizado para identificar o boleto.
+      # @return [String] 8 caracteres numéricos.
+      def numero_documento=(valor)
+        @numero_documento = valor.to_s.rjust(8,'0') unless valor.nil?
+      end
+
+      # Número seqüencial utilizado para identificar o boleto.
+      # @return [String] 7 caracteres numéricos.
+      def seu_numero=(valor)
+        @seu_numero = valor.to_s.rjust(7,'0') unless valor.nil?
+      end
+
+      # Dígito verificador do nosso número.
+      #
+      # 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.<br/>
+      # A excecao, estão as carteiras 112, 126, 131, 146, 150 e 168 cuja obtenção esta baseada apenas nos
+      # dados "CARTEIRA/NOSSO NUMERO".
+      #
+      # @return [String] 1 caracteres numéricos.
+      def nosso_numero_dv
+        if %w(112 126 131 146 150 168).include?(self.carteira)
+          "#{self.carteira}#{self.numero_documento}".modulo10
+        else
+          "#{self.agencia}#{self.conta_corrente}#{self.carteira}#{self.numero_documento}".modulo10
+        end
+      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
+
+      # Nosso número para exibir no boleto.
+      # @return [String]
+      # @example
+      #  boleto.nosso_numero_boleto #=> "175/12345678-4"
+      def nosso_numero_boleto
+        "#{self.carteira}/#{self.numero_documento}-#{self.nosso_numero_dv}"
+      end
+
+      # Agência + conta corrente do cliente para exibir no boleto.
+      # @return [String]
+      # @example
+      #  boleto.agencia_conta_boleto #=> "0811 / 53678-8"
+      def agencia_conta_boleto
+        "#{self.agencia} / #{self.conta_corrente}-#{self.agencia_conta_corrente_dv}"
+      end
+
+      # Segunda parte do código de barras.
+      #
+      # CARTEIRAS 198, 106, 107,122, 142, 143, 195 e 196<br/>
+      # 01 a 03 | 03 | 9(3) | Código do Banco na Câmara de Compensação = ‘341’<br/>
+      # 04 a 04 | 01 | 9(1) | Código da Moeda = '9'<br/>
+      # 05 a 05 | 01 | 9(1) | DAC do Código de Barras MOD 11-2a9<br/>
+      # 06 a 09 | 04 | 9(04) | Fator de Vencimento<br/>
+      # 10 a 19 | 10 | 9(08) | V(2) Valor<br/>
+      # 20 a 22 | 03 | 9(3) | Carteira<br/>
+      # 23 a 30 | 08 | 9(8) | Nosso Número<br/>
+      # 31 a 37 | 07 | 9(7) | Seu Número (Número do Documento)<br/>
+      # 38 a 42 | 05 | 9(5) | Código do Cliente (fornecido pelo Banco)<br/>
+      # 43 a 43 | 01 | 9(1) | DAC dos campos acima (posições 20 a 42) MOD 10<br/>
+      # 44 a 44 | 01 | 9(1) | Zero<br/>
+      #
+      # DEMAIS CARTEIRAS<br/>
+      # 01 a 03 | 03 | 9(03) | Código do Banco na Câmara de Compensação = '341'<br/>
+      # 04 a 04 | 01 | 9(01) | Código da Moeda = '9'<br/>
+      # 05 a 05 | 01 | 9(01) | DAC código de Barras MOD 11-2a9<br/>
+      # 06 a 09 | 04 | 9(04) | Fator de Vencimento<br/>
+      # 10 a 19 | 10 | 9(08)V(2) | Valor<br/>
+      # 20 a 22 | 03 | 9(03) | Carteira<br/>
+      # 23 a 30 | 08 | 9(08) | Nosso Número<br/>
+      # 31 a 31 | 01 | 9(01) | DAC [Agência /Conta/Carteira/Nosso Número] MOD 10<br/>
+      # 32 a 35 | 04 | 9(04) | N.º da Agência cedente<br/>
+      # 36 a 40 | 05 | 9(05) | N.º da Conta Corrente<br/>
+      # 41 a 41 | 01 | 9(01) | DAC [Agência/Conta Corrente] MOD 10<br/>
+      # 42 a 44 | 03 | 9(03) | Zeros<br/>
+      #
+      # @return [String] 25 caracteres numéricos.
+      def codigo_barras_segunda_parte
+        case self.carteira.to_i
+        when 198, 106, 107, 122, 142, 143, 195, 196
+          dv = "#{self.carteira}#{numero_documento}#{self.seu_numero}#{self.convenio}".modulo10
+          "#{self.carteira}#{self.numero_documento}#{self.seu_numero}#{self.convenio}#{dv}0"
+        else
+          "#{self.carteira}#{self.numero_documento}#{self.nosso_numero_dv}#{self.agencia}#{self.conta_corrente}#{self.agencia_conta_corrente_dv}000"
+        end
+      end
+
+    end
+  end
+end