boleto_bancario 0.0.1.beta → 1.0.0

data/lib/boleto_bancario/calculos/documento.rb

@@ -0,0 +1,191 @@
+# frozen_string_literal: true
+
+module BoletoBancario
+  module Calculos
+    # Classe responsável pela validação e formatação de documentos (CPF e CNPJ).
+    #
+    # === Validação de CPF
+    #
+    # O CPF possui 11 dígitos e é validado através de dois dígitos verificadores
+    # calculados pelo módulo 11.
+    #
+    # === Validação de CNPJ
+    #
+    # O CNPJ possui 14 dígitos e é validado através de dois dígitos verificadores
+    # calculados pelo módulo 11.
+    #
+    # @example Validação
+    #
+    #    Documento.valid?('111.444.777-35')
+    #    #=> true
+    #
+    #    Documento.valid?('11.222.333/0001-81')
+    #    #=> true
+    #
+    # @example Formatação
+    #
+    #    Documento.format('11144477735')
+    #    #=> '111.444.777-35'
+    #
+    #    Documento.format('11222333000181')
+    #    #=> '11.222.333/0001-81'
+    #
+    class Documento
+      CPF_SIZE = 11
+      CNPJ_SIZE = 14
+
+      # CPF weights for first digit calculation
+      CPF_WEIGHTS_FIRST = [10, 9, 8, 7, 6, 5, 4, 3, 2].freeze
+
+      # CPF weights for second digit calculation
+      CPF_WEIGHTS_SECOND = [11, 10, 9, 8, 7, 6, 5, 4, 3, 2].freeze
+
+      # CNPJ weights for first digit calculation
+      CNPJ_WEIGHTS_FIRST = [5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2].freeze
+
+      # CNPJ weights for second digit calculation
+      CNPJ_WEIGHTS_SECOND = [6, 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2].freeze
+
+      class << self
+        # Valida se o documento é um CPF ou CNPJ válido.
+        #
+        # @param [String] documento O documento a ser validado
+        # @return [Boolean] true se válido, false caso contrário
+        #
+        def valid?(documento)
+          return false if documento.blank?
+
+          digits = only_digits(documento)
+
+          case digits.size
+          when CPF_SIZE
+            valid_cpf?(digits)
+          when CNPJ_SIZE
+            valid_cnpj?(digits)
+          else
+            false
+          end
+        end
+
+        # Formata o documento com pontuação.
+        #
+        # @param [String] documento O documento a ser formatado
+        # @return [String] O documento formatado
+        #
+        def format(documento)
+          return documento if documento.blank?
+
+          digits = only_digits(documento)
+
+          case digits.size
+          when CPF_SIZE
+            format_cpf(digits)
+          when CNPJ_SIZE
+            format_cnpj(digits)
+          else
+            documento.to_s
+          end
+        end
+
+        # Verifica se o documento é um CPF.
+        #
+        # @param [String] documento O documento a ser verificado
+        # @return [Boolean]
+        #
+        def cpf?(documento)
+          only_digits(documento).size == CPF_SIZE
+        end
+
+        # Verifica se o documento é um CNPJ.
+        #
+        # @param [String] documento O documento a ser verificado
+        # @return [Boolean]
+        #
+        def cnpj?(documento)
+          only_digits(documento).size == CNPJ_SIZE
+        end
+
+        private
+
+        # Remove caracteres não numéricos.
+        #
+        # @param [String] value
+        # @return [String]
+        #
+        def only_digits(value)
+          value.to_s.gsub(/\D/, '')
+        end
+
+        # Valida um CPF.
+        #
+        # @param [String] digits Os 11 dígitos do CPF
+        # @return [Boolean]
+        #
+        def valid_cpf?(digits)
+          return false if invalid_sequence?(digits)
+
+          first_digit = calculate_digit(digits[0, 9], CPF_WEIGHTS_FIRST)
+          second_digit = calculate_digit(digits[0, 10], CPF_WEIGHTS_SECOND)
+
+          digits[9].to_i == first_digit && digits[10].to_i == second_digit
+        end
+
+        # Valida um CNPJ.
+        #
+        # @param [String] digits Os 14 dígitos do CNPJ
+        # @return [Boolean]
+        #
+        def valid_cnpj?(digits)
+          return false if invalid_sequence?(digits)
+
+          first_digit = calculate_digit(digits[0, 12], CNPJ_WEIGHTS_FIRST)
+          second_digit = calculate_digit(digits[0, 13], CNPJ_WEIGHTS_SECOND)
+
+          digits[12].to_i == first_digit && digits[13].to_i == second_digit
+        end
+
+        # Verifica se todos os dígitos são iguais (sequência inválida).
+        #
+        # @param [String] digits
+        # @return [Boolean]
+        #
+        def invalid_sequence?(digits)
+          digits.chars.uniq.size == 1
+        end
+
+        # Calcula um dígito verificador usando módulo 11.
+        #
+        # @param [String] digits Os dígitos base
+        # @param [Array<Integer>] weights Os pesos para multiplicação
+        # @return [Integer] O dígito calculado
+        #
+        def calculate_digit(digits, weights)
+          sum = digits.chars.each_with_index.sum do |digit, index|
+            digit.to_i * weights[index]
+          end
+
+          remainder = sum % 11
+          remainder < 2 ? 0 : 11 - remainder
+        end
+
+        # Formata CPF com pontuação.
+        #
+        # @param [String] digits
+        # @return [String]
+        #
+        def format_cpf(digits)
+          "#{digits[0, 3]}.#{digits[3, 3]}.#{digits[6, 3]}-#{digits[9, 2]}"
+        end
+
+        # Formata CNPJ com pontuação.
+        #
+        # @param [String] digits
+        # @return [String]
+        #
+        def format_cnpj(digits)
+          "#{digits[0, 2]}.#{digits[2, 3]}.#{digits[5, 3]}/#{digits[8, 4]}-#{digits[12, 2]}"
+        end
+      end
+    end
+  end
+end

data/lib/boleto_bancario/calculos/fator_vencimento.rb

@@ -1,33 +1,44 @@
-# encoding: utf-8
+# frozen_string_literal: true
+
 module BoletoBancario
   module Calculos
     # Classe responsável pelo cálculo de Fator de Vencimento do boleto bancário.
     #
-    # === Descricão
+    # === Descrição
     #
     # Conforme Carta-circular 002926 do Banco Central do Brasil, de 24/07/2000, recomenda-se a indicação do Fator de Vencimento no Código de Barras.
     # A partir de 02/04/2001, o Banco acolhedor/recebedor não será mais responsável por eventuais diferenças de recebimento de BOLETOs fora do prazo,
     # ou sem a indicação do fator de vencimento.
     #
+    # === Atualização FEBRABAN 2025
+    #
+    # Em 22/02/2025, o fator de vencimento atingiu o limite de 9999 (baseado em 07/10/1997).
+    # A partir desta data, o cálculo utiliza uma nova data base (29/05/2022) e reinicia em 1000.
+    #
     # === Forma para obtenção do Fator de Vencimento
     #
-    # Calcula-se <b>o número de dias corridos</b> entre a data base (<b>“Fixada” em 07/10/1997</b>) e a do vencimento desejado:
+    # Calcula-se <b>o número de dias corridos</b> entre a data base e a do vencimento desejado:
+    #
+    # Para datas anteriores a 22/02/2025:
+    #    Data base: 07/10/1997
+    #    Vencimento: 04/07/2000 => Fator: 1001
     #
-    #    Vencimento desejado:   04/07/2000
-    #    Data base          : - 07/10/1997
-    #    # => 1001
+    # Para datas a partir de 22/02/2025:
+    #    Data base: 29/05/2022
+    #    Fator inicial: 1000
+    #    Vencimento: 22/02/2025 => Fator: 1000
     #
     # === Atenção
     #
-    # Caso ocorra divergência entre a data impressa no campo “data de vencimento” e a constante no código de barras,
+    # Caso ocorra divergência entre a data impressa no campo "data de vencimento" e a constante no código de barras,
     # o recebimento se dará da seguinte forma:
     #
-    # * Quando pago por sistemas eletrônicos (Home-Banking, Auto-Atendimento, Internet, SISPAG, telefone, etc.), prevalecerá à representada no “código de barras”;
-    # * Quando quitado na rede de agências, diretamente no caixa, será considerada a data impressa no campo “vencimento” do BOLETO.
+    # * Quando pago por sistemas eletrônicos (Home-Banking, Auto-Atendimento, Internet, SISPAG, telefone, etc.), prevalecerá à representada no "código de barras";
+    # * Quando quitado na rede de agências, diretamente no caixa, será considerada a data impressa no campo "vencimento" do BOLETO.
     #
     # @return [String] retorna o resultado do cálculo. <b>Deve conter 4 dígitos</b>.
     #
-    # @example
+    # @example Datas anteriores à transição
     #
     #    FatorVencimento.new(Date.parse("2012-12-02"))
     #    #=> "5535"
@@ -35,51 +46,87 @@ module BoletoBancario
     #    FatorVencimento.new(Date.parse("1997-10-08"))
     #    #=> "0001"
     #
-    #    FatorVencimento.new(Date.parse("2012-12-16"))
-    #    #=> "5549"
+    # @example Datas após a transição FEBRABAN 2025
     #
-    #    FatorVencimento.new(Date.parse("2014-12-15"))
-    #    #=> "6278"
+    #    FatorVencimento.new(Date.parse("2025-02-21"))
+    #    #=> "9999"
+    #
+    #    FatorVencimento.new(Date.parse("2025-02-22"))
+    #    #=> "1000"
+    #
+    #    FatorVencimento.new(Date.parse("2025-02-23"))
+    #    #=> "1001"
     #
     class FatorVencimento < String
+      # Data base original utilizada até 21/02/2025
+      OLD_BASE_DATE = Date.new(1997, 10, 7).freeze
+
+      # Nova data base utilizada a partir de 22/02/2025
+      NEW_BASE_DATE = Date.new(2022, 5, 29).freeze
+
+      # Data de transição para o novo cálculo
+      TRANSITION_DATE = Date.new(2025, 2, 22).freeze
+
+      # Fator inicial para a nova data base
+      NEW_BASE_FACTOR = 1000
+
       attr_reader :base_date
-      # @param [Date] expiration_date
-      # @param [Date] base_date
+
+      # @param [Date] expiration_date Data de vencimento do boleto
+      # @param [Date] base_date Data base para cálculo (opcional, determinado automaticamente)
       # @return [String] retorna o resultado do cálculo. <b>Deve conter 4 dígitos</b>.
-      # @example
-      #    FatorVencimento.new(Date.parse("2012-09-02"))
-      #    #=> "5444"
-      #
-      #    FatorVencimento.new(Date.parse("1999-10-01"))
-      #    #=> "0724"
       #
-      #    FatorVencimento.new(Date.parse("2022-12-16"))
-      #    #=> "9201"
+      # @example
+      #    FatorVencimento.new(Date.parse("2025-03-01"))
+      #    #=> "1007"
       #
-      def initialize(expiration_date, base_date = Date.new(1997, 10, 7))
-        @base_date       = base_date
+      def initialize(expiration_date, base_date = nil)
         @expiration_date = expiration_date
+        @base_date = base_date || determine_base_date
 
         if @expiration_date.present?
           super(calculate)
+        else
+          super()
         end
       end
 
       # Cálculo da data de vencimento com a data base.
+      # Para ambos os períodos, o fator é simplesmente o número de dias desde a data base.
+      # A nova data base (29/05/2022) foi escolhida para que 22/02/2025 resulte em fator 1000.
       #
       # @return [String] exatamente 4 dígitos
       #
       def calculate
-        expiration_date_minus_base_date.to_s.rjust(4, '0')
+        days_from_base.to_s.rjust(4, '0')
       end
 
-      # @api private
+      private
+
+      # Determina qual data base usar com base na data de vencimento
       #
-      # Cálculo da data de vencimento com a data base.
+      # @return [Date] a data base apropriada
+      #
+      def determine_base_date
+        return OLD_BASE_DATE unless @expiration_date
+
+        uses_new_calculation? ? NEW_BASE_DATE : OLD_BASE_DATE
+      end
+
+      # Verifica se deve usar o novo cálculo (pós-transição FEBRABAN)
+      #
+      # @return [Boolean]
+      #
+      def uses_new_calculation?
+        @expiration_date.is_a?(Date) && @expiration_date >= TRANSITION_DATE
+      end
+
+      # Calcula a diferença em dias entre a data de vencimento e a data base.
       # Chamando #to_i para não retornar um Float.
-      # @return [Integer] diff between this two dates.
       #
-      def expiration_date_minus_base_date
+      # @return [Integer] diferença em dias
+      #
+      def days_from_base
         (@expiration_date - @base_date).to_i
       end
     end

data/lib/boleto_bancario/calculos/modulo11_fator_de9a2.rb

@@ -0,0 +1,65 @@
+module BoletoBancario
+  module Calculos
+    # === Módulo 11 Fator de 9 a 2
+    #
+    # === Passos
+    #
+    # 1) Tomando-se os algarismos multiplique-os, iniciando-se da direita para a esquerda,
+    # pela seqüência numérica de 9 a 2 (9, 8, 7, 6, 5, 4, 3, 2 ... e assim por diante).
+    #
+    # 2) Some o resultado de cada produto efetuado e determine o total como (N).
+    #
+    # 3) Divida o total (N) por 11 e determine o resto obtido da divisão como Mod 11(N).
+    #
+    # ==== Exemplo Normal
+    #
+    # Considerando o seguinte número: '89234560'.
+    #
+    # 1) Multiplicando a seqüência de multiplicadores:
+    #
+    #      8    9    2    3    4    5    6    0
+    #      *    *    *    *    *    *    *    *
+    #      2    3    4    5    6    7    8    9
+    #
+    # 2) Soma-se o resultado dos produtos obtidos no item “1” acima:
+    #
+    #      16 + 27 + 8 + 15 + 24 + 35 + 48 + 0
+    #      # => 173
+    #
+    # 3) Determina-se o resto da Divisão:
+    #
+    #      173 % 11
+    #      # => 8 =============> Resultado final retornado.
+    #
+    # @param [String]: Corresponde ao número a ser calculado o Módulo 11 no fator de 9 a 2.
+    # @return [String] Retorna o resultado do cálculo descrito acima.
+    #
+    # @example
+    #
+    #    BoletoBancario::Calculos::Modulo11FatorDe9a2.new('12345')
+    #    # => '5'
+    #
+    #    BoletoBancario::Calculos::Modulo11FatorDe9a2.new('246')
+    #    # => '1'
+    #
+    class Modulo11FatorDe9a2 < Modulo11
+      # Sequência numérica de 9 a 2 que será feito a multiplicação de cada dígito
+      # do número passado no #initialize.
+      #
+      # @return [Array] Sequência numérica
+      #
+      def fatores
+        [9, 8, 7, 6, 5, 4, 3, 2]
+      end
+
+      # Calcula o número pelos fatores de multiplicação de 9 a 2.
+      # Depois calcula o resto da divisão por 11.
+      #
+      # @return [Fixnum]
+      #
+      def calculate
+        mod_division
+      end
+    end
+  end
+end

data/lib/boleto_bancario/calculos/modulo11_fator_de9a2_resto_x.rb

@@ -1,37 +1,9 @@
 module BoletoBancario
   module Calculos
-    # === Módulo 11 Fator de 9 a 2 - Resto 10, sendo X
+    #  === Módulo 11 Fator de 9 a 2 - Resto 10, sendo X
+    # <b>Essa classe difere da outra com Modulo11FatorDe9a2, no momento de verificar o resto da divisão por 11.</b>
     #
-    # === Passos
-    #
-    # 1) Tomando-se os algarismos multiplique-os, iniciando-se da direita para a esquerda,
-    # pela seqüência numérica de 9 a 2 (9, 8, 7, 6, 5, 4, 3, 2 ... e assim por diante).
-    #
-    # 2) Some o resultado de cada produto efetuado e determine o total como (N).
-    #
-    # 3) Divida o total (N) por 11 e determine o resto obtido da divisão como Mod 11(N).
-    #
-    # <b>OBS.:</b> Se o resultado desta expressão for igual a 10, considere DAC = X.
-    #
-    # ==== Exemplo Normal
-    #
-    # Considerando o seguinte número: '89234560'.
-    #
-    # 1) Multiplicando a seqüência de multiplicadores:
-    #
-    #      8    9    2    3    4    5    6    0
-    #      *    *    *    *    *    *    *    *
-    #      2    3    4    5    6    7    8    9
-    #
-    # 2) Soma-se o resultado dos produtos obtidos no item “1” acima:
-    #
-    #      16 + 27 + 8 + 15 + 24 + 35 + 48 + 0
-    #      # => 173
-    #
-    # 3) Determina-se o resto da Divisão:
-    #
-    #      173 % 11
-    #      # => 8 =============> Resultado final retornado.
+    # <b>Para mais detalhes veja a classe Modulo11FatorDe9a2.</b>
     #
     # ==== Exemplo 10 como resto da divisão
     #
@@ -58,30 +30,12 @@ module BoletoBancario
     #     resultado == 10
     #     # => 'X' =============> Resultado final retornado.
     #
-    # @param [String]: Corresponde ao número a ser calculado o Módulo 11 no fator de 9 a 2.
-    # @return [String] Retorna o resultado do cálculo descrito acima.
-    #
     # @example
     #
-    #    BoletoBancario::Calculos::Modulo11FatorDe9a2RestoX.new('12345')
-    #    # => '5'
-    #
-    #    BoletoBancario::Calculos::Modulo11FatorDe9a2RestoX.new('246')
-    #    # => '1'
-    #
-    #    BoletoBancario::Calculos::Modulo11FatorDe2a9.new('184122')
+    #    BoletoBancario::Calculos::Modulo11FatorDe9a2RestoX.new('184122')
     #    # => 'X'
     #
-    class Modulo11FatorDe9a2RestoX < Modulo11
-      # Sequência numérica de 9 a 2 que será feito a multiplicação de cada dígito
-      # do número passado no #initialize.
-      #
-      # @return [Array] Sequência numérica
-      #
-      def fatores
-        [9, 8, 7, 6, 5, 4, 3, 2]
-      end
-
+    class Modulo11FatorDe9a2RestoX < Modulo11FatorDe9a2
       # Calcula o número pelos fatores de multiplicação de 9 a 2.
       # Depois calcula o resto da divisão por 11.
       # Se o resultado desse cálculo for igual a 10, então o DAC = X.

data/lib/boleto_bancario/calculos/modulo_numero_de_controle.rb

@@ -0,0 +1,117 @@
+module BoletoBancario
+  module Calculos
+    # === Cálculo do Módulo do Número de Controle (2 dígitos)
+    #
+    # Tipo de cálculo usado pelo Banco Banrisul.
+    #
+    # === Cálculo do Primeiro Dígito
+    #
+    # 1) Multiplica-se cada algarismo do campo pela seqüência de multiplicadores <b>2, 1, 2, 1, 2, 1 ...</b>, posicionados da direita para a esquerda.
+    #
+    # 2) Some individualmente, os algarismos dos resultados dos produtos, obtendo-se o total (N).
+    #
+    # 3) Divida o total encontrado (N) por 10, e determine o resto da divisão como MOD 10 (N).
+    #
+    # 4) Encontre o DAC através da seguinte expressão:
+    #
+    #    DAC = 10 - Mod 10 (n)
+    #
+    # === Cálculo do segundo dígito
+    #
+    # # 1) Tomando-se os algarismos multiplique-os, iniciando-se da direita para a esquerda,
+    # pela seqüência numérica de 2 a 7 (2, 3, 4, 5, 6, 7 ... e assim por diante).
+    #
+    # 2) Some o resultado de cada produto efetuado e determine o total como (N).
+    #
+    # 3) Divida o total (N) por 11 e determine o resto obtido da divisão como Mod 11(N).
+    #
+    # 4) Calcule o dígito verificador (DAC) através da expressão:
+    #
+    #     DIGIT = 11 - Mod 11 (n)
+    #
+    # <b>Observações:</b>
+    #
+    # Caso o 'resto' obtido no cálculo do módulo '11' seja igual a '1', considera-se o DV inválido.
+    # Soma-se, então, "1" ao DV obtido do módulo "10" e refaz-se o cálculo do módulo “11”.
+    # Se o dígito obtido pelo módulo “10” era igual a "9", considera-se então (9+1=10) DV inválido.
+    # Neste caso, o DV do módulo "10" automaticamente será igual a "0" e procede-se assim
+    # novo cálculo pelo módulo "11".
+    #
+    # === Exemplo com Primeiro Dígito Inválido
+    #
+    # Dado o número '00009194':
+    #
+    # O somatório do primeiro cálculo é igual a '28' e o Resto é igual a '8'.
+    # Portanto, o primeiro DV é igual a 10 - 8 ou DV = 2.
+    #
+    # O somatório do segundo cálculo é igual a '111' e o Resto é, neste caso, igual a '1'.
+    # Portanto, o segundo DV é  inválido (11 - 1 = 10).
+    #
+    # Neste caso, soma-se '1' ao DV obtido do primeiro cálculo:
+    #
+    #      2 + 1
+    #      # ======> 3 # Primeiro dígito do número de controle
+    #
+    # Agora, efetua-se novo cálculo do módulo 11, agora com o novo número, ou seja, 000091943:
+    #
+    # A somatório do segundo cálculo é igual a '113' e o Resto igual a '3'.
+    # Portanto, o segundo DV é igual a:
+    #
+    #     11 - 3
+    #     # ====> 8 # Segundo dígito do número de controle
+    #
+    # Neste exemplo, o número de controle será '38'.
+    #
+    class ModuloNumeroDeControle < String
+      attr_reader :number, :first_digit, :second_digit
+
+      def initialize(number)
+        @number       = number
+        @first_digit  = calculate_first_digit
+        @second_digit = calculate_second_digit
+
+        super(calculate)
+      end
+
+      # Retorna 2 dígitos verificando o segundo dígito se é válido ou não.
+      #
+      # @return [String]
+      #
+      def calculate
+        if second_digit_result.equal?(10)
+          @first_digit  = first_digit.to_i + 1
+          @first_digit  = 0 if @first_digit.equal?(10)
+          @second_digit = calculate_second_digit
+        end
+
+        "#{first_digit}#{second_digit}"
+      end
+
+      # Retorna a subtração de 11 pelo resto da divisão por 11 do segundo dígito.
+      #
+      # @return [Integer]
+      #
+      def second_digit_result
+        11 - @second_digit.mod_division
+      end
+
+      # Calcula o primeiro dígito pelo módulo 10.
+      # Para mais detalhes veja a classe Modulo10.
+      #
+      # @return [String]
+      #
+      def calculate_first_digit
+        Modulo10.new(number)
+      end
+
+      # Calcula o segundo dígito pelo módulo 11 usando os fatores de 2 a 7.
+      # Para mais detalhes veja a classe Modulo11FatorDe2a7.
+      #
+      # @return [String]
+      #
+      def calculate_second_digit
+        Modulo11FatorDe2a7.new("#{number}#{first_digit}")
+      end
+    end
+  end
+end

data/lib/boleto_bancario/core/banco_brasil.rb

@@ -116,16 +116,25 @@ module BoletoBancario
         17
       end
 
-      validates :codigo_cedente, :agencia, :digito_agencia, :conta_corrente, :digito_conta_corrente, presence: true
+      # <b>Carteiras suportadas.</b>
+      #
+      # <b>Método criado para validar se a carteira informada é suportada.</b>
+      #
+      # @return [Array]
+      #
+      def self.carteiras_suportadas
+        %w[12 16 17 18]
+      end
 
-      validates :digito_agencia,        length: { maximum: 1  }
-      validates :digito_conta_corrente, length: { maximum: 1  }
+      validates :codigo_cedente, :agencia, :digito_agencia, :conta_corrente, :digito_conta_corrente, presence: true
 
-      # Validações de Agencia e Conta corrente.
+      # Validações de Agencia, Conta corrente e Carteira.
       #
       validates :agencia,          length: { maximum: tamanho_maximo_agencia        }, if: :deve_validar_agencia?
       validates :conta_corrente,   length: { maximum: tamanho_maximo_conta_corrente }, if: :deve_validar_conta_corrente?
 
+      validates :carteira, inclusion: { in: ->(object) { object.class.carteiras_suportadas } }, if: :deve_validar_carteira?
+
       # Validações do número do documento.
       #
       # === Número do Documento e Código do Cedente.
@@ -182,7 +191,7 @@ module BoletoBancario
       # @return [String]
       #
       def numero_documento
-        if @numero_documento.present?
+        if @numero_documento.present? and numero_documento_esperado[tamanho_codigo_cedente].present?
           @numero_documento.to_s.rjust(numero_documento_esperado[tamanho_codigo_cedente], '0')
         else
           @numero_documento
@@ -214,6 +223,22 @@ module BoletoBancario
         '9'
       end
 
+      # Dígito do código da agência. Precisa mostrar esse dígito no boleto.
+      #
+      # @return [String] Dígito da agência calculado apartir do Modulo11FatorDe9a2RestoX.
+      #
+      def digito_agencia
+        Modulo11FatorDe9a2RestoX.new(agencia)
+      end
+
+      # Dígito da conta corrente. Precisa mostrar esse dígito no boleto.
+      #
+      # @return [String] Dígito da conta corrente calculado apartir do Modulo11FatorDe9a2RestoX.
+      #
+      def digito_conta_corrente
+        Modulo11FatorDe9a2RestoX.new(conta_corrente)
+      end
+
       # Campo Agencia / Código do Cedente
       # Retorna formatado a agência, digito da agência, número da conta corrente e dígito da conta.
       #