boleto_bancario 0.0.1.beta → 1.0.0

data/lib/boleto_bancario/core/santander.rb

@@ -80,17 +80,6 @@ module BoletoBancario
         12
       end
 
-      # Tamanho máximo da carteira.
-      # O tamanho máximo é justamente 2 porque no código de barras só é permitido 2 posições para este campo.
-      #
-      # <b>Método criado justamente para ficar documentado o tamanho máximo aceito até a data corrente.</b>
-      #
-      # @return [Fixnum] 2
-      #
-      def self.tamanho_maximo_carteira
-        3
-      end
-
       # Tamanho máximo do código do cedente emitido no Boleto.
       # O tamanho máximo é justamente 7 porque no código de barras só é permitido 7 posições para este campo.
       #
@@ -102,14 +91,24 @@ module BoletoBancario
         7
       end
 
-      # Validações de tamanho para os campos abaixo:
+      # <b>Carteiras suportadas.</b>
+      #
+      # <b>Método criado para validar se a carteira informada é suportada.</b>
+      #
+      # @return [Array]
+      #
+      def self.carteiras_suportadas
+        %w[101 102 121]
+      end
+
+      # Validações para os campos abaixo:
       #
       # * Número do documento
       # * Conta Corrente
       # * Agencia
       # * Carteira
       #
-      # Se você quiser sobrescrever os tamanhos permitidos, <b>ficará a sua responsabilidade.</b>
+      # Se você quiser sobrescrever os metodos, <b>ficará a sua responsabilidade.</b>
       # Basta você sobrescrever os métodos de validação:
       #
       #    class Santander < BoletoBancario::Core::Santander
@@ -124,6 +123,10 @@ module BoletoBancario
       #       def self.tamanho_maximo_numero_documento
       #         9
       #       end
+      #
+      #       def self.carteiras_suportadas
+      #         %w[101 102 121]
+      #       end
       #    end
       #
       # Obs.: Mudar as regras de validação podem influenciar na emissão do boleto em si.
@@ -135,7 +138,8 @@ module BoletoBancario
       validates :agencia,          length: { maximum: tamanho_maximo_agencia          }, if: :deve_validar_agencia?
       validates :codigo_cedente,   length: { maximum: tamanho_maximo_codigo_cedente   }, if: :deve_validar_codigo_cedente?
       validates :numero_documento, length: { maximum: tamanho_maximo_numero_documento }, if: :deve_validar_numero_documento?
-      validates :carteira,         length: { maximum: tamanho_maximo_carteira         }, if: :deve_validar_carteira?
+
+      validates :carteira, inclusion: { in: ->(object) { object.class.carteiras_suportadas } }, if: :deve_validar_carteira?
 
       # @return [String] 4 caracteres
       #
@@ -155,12 +159,6 @@ module BoletoBancario
         @numero_documento.to_s.rjust(12, '0') if @numero_documento.present?
       end
 
-      # @return [String] 3 caracteres
-      #
-      def carteira
-        @carteira.to_s.rjust(3, '0') if @carteira.present?
-      end
-
       # Formata a carteira dependendo se ela é registrada ou não.
       #
       # Para cobrança COM registro usar: <b>COBRANCA SIMPLES ECR</b>
@@ -206,7 +204,7 @@ module BoletoBancario
       # @return [String]
       #
       def agencia_codigo_cedente
-        "#{agencia}-#{digito_agencia} / #{codigo_cedente}"
+        "#{agencia} / #{codigo_cedente}"
       end
 
       # Mostra o campo nosso número calculando o dígito verificador do nosso número.
@@ -260,7 +258,6 @@ module BoletoBancario
       #
       # Seguradoras (Se 7% informar 7. Limitado a 9%)
       # <b>Demais clientes usar 0 (zero)</b>
-      # O padrão é zero.
       #
       # @return [String]
       #

data/lib/boleto_bancario/core/sicoob.rb

@@ -0,0 +1,172 @@
+# encoding: utf-8
+module BoletoBancario
+  module Core
+    # Implementação de emissão de boleto bancário pelo Banco Sicoob.
+    #
+    # === Documentação Implementada
+    #
+    # A documentação na qual essa implementação foi baseada está localizada na pasta
+    # 'documentacoes_dos_boletos/sicoob' dentro dessa biblioteca.
+    #
+    # === Código da Carteira
+    #
+    #   '1' - Cobrança SEM registro
+    #   '9' - Cobrança COM registro
+    #
+    class Sicoob < Boleto
+      # Tamanho máximo de uma agência no Banco Sicoob.
+      # <b>Método criado justamente para ficar documentado o tamanho máximo aceito até a data corrente.</b>
+      #
+      # @return [Fixnum] 4
+      #
+      def self.tamanho_maximo_agencia
+        4
+      end
+
+      # Tamanho máximo do codigo cedente no Banco Sicoob.
+      # <b>Método criado justamente para ficar documentado o tamanho máximo aceito até a data corrente.</b>
+      #
+      # @return [Fixnum] 7
+      #
+      def self.tamanho_maximo_codigo_cedente
+        7
+      end
+
+      # Tamanho máximo do numero do documento no Boleto.
+      # <b>Método criado justamente para ficar documentado o tamanho máximo aceito até a data corrente.</b>
+      #
+      # @return [Fixnum] 6
+      #
+      def self.tamanho_maximo_numero_documento
+        6
+      end
+
+      # <b>Carteiras suportadas.</b>
+      #
+      # <b>Método criado para validar se a carteira informada é suportada.</b>
+      #
+      # @return [Array]
+      #
+      def self.carteiras_suportadas
+        %w[1 9]
+      end
+
+      # Validações para os campos abaixo:
+      #
+      # * Agencia
+      # * Codigo Cedente
+      # * Número do documento
+      #
+      # Se você quiser sobrescrever os metodos, <b>ficará a sua responsabilidade.</b>
+      # Basta você sobrescrever os métodos de validação:
+      #
+      #    class Sicoob < BoletoBancario::Core::Sicoob
+      #       def self.tamanho_maximo_agencia
+      #         6
+      #       end
+      #
+      #       def self.tamanho_maximo_codigo_cedente
+      #         9
+      #       end
+      #
+      #       def self.tamanho_maximo_numero_documento
+      #         10
+      #       end
+      #    end
+      #
+      # Obs.: Mudar as regras de validação podem influenciar na emissão do boleto em si.
+      # Talvez você precise analisar o efeito no #codigo_de_barras e na #linha_digitável (ambos podem ser
+      # sobreescritos também).
+      #
+      validates :agencia, :codigo_cedente, presence: true
+
+      validates :agencia,          length: { maximum: tamanho_maximo_agencia          }, if: :deve_validar_agencia?
+      validates :codigo_cedente,   length: { maximum: tamanho_maximo_codigo_cedente   }, if: :deve_validar_codigo_cedente?
+      validates :numero_documento, length: { maximum: tamanho_maximo_numero_documento }, if: :deve_validar_numero_documento?
+
+      validates :carteira, inclusion: { in: ->(object) { object.class.carteiras_suportadas } }, if: :deve_validar_carteira?
+
+      # @return [String] 4 caracteres
+      #
+      def agencia
+        @agencia.to_s.rjust(4, '0') if @agencia.present?
+      end
+
+      # @return [String] 7 caracteres
+      #
+      def codigo_cedente
+        @codigo_cedente.to_s.rjust(7, '0') if @codigo_cedente.present?
+      end
+
+      # @return [String] 6 caracteres
+      #
+      def numero_documento
+        @numero_documento.to_s.rjust(6, '0') if @numero_documento.present?
+      end
+
+      # @return [String] Código do Banco descrito na documentação.
+      #
+      def codigo_banco
+        '756'
+      end
+
+      # @return [String] Dígito do código do banco descrito na documentação.
+      #
+      def digito_codigo_banco
+        '0'
+      end
+
+      # Campo Agência / Código do Cedente
+      #
+      # @return [String]
+      #
+      def agencia_codigo_cedente
+        "#{agencia} / #{codigo_cedente}"
+      end
+
+      # O nosso número descrino na documentação é formado pelo dois ultimos digitos do ano autal e
+      # por outros 6 digitos que o clinte usara para numerar os documentos, assim sendo composto por 8 dígitos.
+      #
+      # @return [String]
+      #
+      def nosso_numero
+        "#{ano}#{numero_documento}"
+      end
+
+      # Ano atual usado para os calculos
+      #
+      # @return [String]
+      #
+      def ano
+        Date.today.strftime('%y')
+      end
+
+      #  === Código de barras do banco
+      #
+      #     ___________________________________________________________
+      #    | Posição | Tamanho | Descrição                             |
+      #    |---------|---------|---------------------------------------|
+      #    | 20 - 20 |    01   | Código da carteira                    |
+      #    | 21 - 24 |    04   | Código da agência                     |
+      #    | 25 - 26 |    02   | Código da modalidade de cobrança (01) |
+      #    | 27 - 33 |    07   | Código do Cedente                     |
+      #    | 34 - 41 |    08   | Nosso Número do título                |
+      #    | 42 - 44 |    03   | Número da Parcela do Título (001)     |
+      #    |___________________________________________________________|
+      #
+      # @return [String]
+      #
+      def codigo_de_barras_do_banco
+        "#{carteira}#{agencia}#{modalidade_cobranca}#{codigo_cedente}#{nosso_numero}#{parcelas}"
+      end
+
+      def modalidade_cobranca
+        '01'
+      end
+
+      def parcelas
+        '001'
+      end
+    end
+  end
+end

data/lib/boleto_bancario/core/sicredi.rb

@@ -0,0 +1,290 @@
+# encoding: utf-8
+module BoletoBancario
+  module Core
+    # Implementação de emissão de boleto bancário pela Cooperativa de Credito Sicredi.
+    #
+    # === Documentação Implementada
+    #
+    # A documentação na qual essa implementação foi baseada está localizada na pasta
+    # 'documentacoes_dos_boletos/sicredi' dentro dessa biblioteca.
+    # === Carteiras suportadas
+    #
+    # Segue abaixo as carteiras suportadas pelo Sicredi <b>seguindo a documentação</b>:
+    #
+    #      __________________________________________
+    #     | Carteira | Descrição                     |
+    #     |    03    | Cobrança Simples sem registro |
+    #     |    C     | Cobrança Simples sem registro |
+    #     |__________________________________________|
+    #
+    class Sicredi < Boleto
+      # Código do posto da cooperativa de crédito
+      attr_accessor :posto
+
+      # Byte de identificação do cedente do bloqueto utilizado para compor o nosso número.
+      attr_accessor :byte_id
+
+      # Tamanho máximo de uma agência no Sicredi.
+      # <b>Método criado justamente para ficar documentado o tamanho máximo aceito até a data corrente.</b>
+      #
+      # @return [Fixnum] 4
+      #
+      def self.tamanho_maximo_agencia
+        4
+      end
+
+      # Tamanho máximo da conta corrente no Boleto.
+      # <b>Método criado justamente para ficar documentado o tamanho máximo aceito até a data corrente.</b>
+      #
+      # @return [Fixnum] 5
+      #
+      def self.tamanho_maximo_conta_corrente
+        5
+      end
+
+      # Tamanho máximo do posto no Boleto.
+      # <b>Método criado justamente para ficar documentado o tamanho máximo aceito até a data corrente.</b>
+      #
+      # @return [Fixnum] 2
+      #
+      def self.tamanho_maximo_posto
+        2
+      end
+
+      # <b>Byte Identificadores suportados.</b>
+      # <b>Método criado para validar se o byte identificador informado é suportado.</b>
+      #
+      # @return [Array]
+      #
+      def self.byte_id_suportados
+        %w[2 3 4 5 6 7 8 9]
+      end
+
+      # <b>Carteiras suportadas.</b>
+      # <b>Método criado para validar se a carteira informada é suportada.</b>
+      #
+      # @return [Array]
+      #
+      def self.carteiras_suportadas
+        %w[03 C]
+      end
+
+      # Tamanho máximo do número do documento emitido no Boleto.
+      # <b>Método criado justamente para ficar documentado o tamanho máximo aceito até a data corrente.</b>
+      #
+      # @return [Fixnum] 5
+      #
+      def self.tamanho_maximo_numero_documento
+        5
+      end
+
+      # Validações para os campos abaixo:
+      #
+      # * Agencia
+      # * Conta Corrente
+      # * Posto
+      # * Byte Identificador
+      # * Carteira
+      # * Número do documento
+      #
+      # Se você quiser sobrescrever os metodos, <b>ficará a sua responsabilidade.</b>
+      # Basta você sobrescrever os métodos de validação:
+      #
+      #    class Sicredi < BoletoBancario::Core::Sicredi
+      #       def self.tamanho_maximo_agencia
+      #         5
+      #       end
+      #
+      #       def self.tamanho_maximo_conta_corrente
+      #         7
+      #       end
+      #
+      #       def self.tamanho_maximo_posto
+      #         2
+      #       end
+      #
+      #       def self.byte_id_suportados
+      #         %w[1 12 123]
+      #       end
+      #
+      #       def self.carteiras_suportadas
+      #         %w[45 89]
+      #       end
+      #
+      #       def self.tamanho_maximo_numero_documento
+      #         10
+      #       end
+      #    end
+      #
+      # Obs.: Mudar as regras de validação podem influenciar na emissão do boleto em si.
+      # Talvez você precise analisar o efeito no #codigo_de_barras e na #linha_digitável (ambos podem ser
+      # sobreescritos também).
+      #
+      validates :agencia, :conta_corrente, :posto, :byte_id, presence: true
+
+      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 :posto,            length: { maximum: tamanho_maximo_posto            }, if: :deve_validar_posto?
+      validates :numero_documento, length: { maximum: tamanho_maximo_numero_documento }, if: :deve_validar_numero_documento?
+
+      validates :carteira, inclusion: { in: ->(object) { object.class.carteiras_suportadas } }, if: :deve_validar_carteira?
+      validates :byte_id,  inclusion: { in: ->(object) { object.class.byte_id_suportados   } }, if: :deve_validar_byte_id?
+
+      # @return [String] 4 caracteres
+      #
+      def agencia
+        @agencia.to_s.rjust(4, '0') if @agencia.present?
+      end
+
+      # @return [String] 5 caracteres
+      #
+      def conta_corrente
+        @conta_corrente.to_s.rjust(5, '0') if @conta_corrente.present?
+      end
+
+      # @return [String] 2 caracteres
+      #
+      def posto
+        @posto.to_s.rjust(2, '0') if @posto.present?
+      end
+
+      # @return [String] 1 caracteres
+      #
+      def byte_id
+        @byte_id.to_s.rjust(1, '0') if @byte_id.present?
+      end
+
+      # @return [String] 5 caracteres
+      #
+      def numero_documento
+        @numero_documento.to_s.rjust(5, '0') if @numero_documento.present?
+      end
+
+      # A formatação da Carteira Simples é 1
+      #
+      # @return [String]
+      #
+      def carteira_formatada
+        tipo_carteira
+      end
+
+      # @return [String] Código do Banco descrito na documentação.
+      #
+      def codigo_banco
+        '748'
+      end
+
+      # @return [String] Dígito do código do banco descrito na documentação.
+      #
+      def digito_codigo_banco
+        'X'
+      end
+
+      # Campo Agência/Código Beneficiário (:conta_corrente) formatado
+      #
+      # @return [String] Campo descrito na documentação.
+      #
+      def agencia_codigo_cedente
+        "#{agencia}.#{posto}.#{conta_corrente}"
+      end
+
+      # @return [String] Código referente ao tipo de cobrança
+      #
+      def tipo_cobranca
+        "3" # Somente sem registro
+      end
+
+      # @return [String] Código referente ao tipo de carteira
+      #
+      def tipo_carteira
+        "1"
+      end
+
+      # Mostra o campo nosso número calculando o dígito verificador do nosso número. AA/BXXXXX-D onde:
+      #   AA = Ano atual, apenas os dois ultimos digitos.
+      #   B = Byte Identificador (2 a 9). 1 só poderá ser utilizado pela cooperativa.
+      #   XXXXX – Número do Documento.
+      #   D = Digito Verificador pelo módulo 11.
+      #
+      # EX: 13/200004-1
+      #
+      # @return [String]
+      #
+      def nosso_numero
+        "#{ano}/#{byte_id}#{numero_documento}-#{nosso_numero_dv}"
+      end
+
+      # Ano atual usado para os calculos
+      #
+      # @return [String]
+      #
+      def ano
+        Date.today.strftime('%y')
+      end
+
+      # Digito verificador do nosso número
+      # Calculado atravez do modulo 11 com peso de 2 a 9 da direta para a esquerda.
+      #  ____________________________________________________________________________
+      # |         | Agencia | Posto | Conta Corrente | Ano | Byte | Numero Documento |
+      # |---------|---------|-------|----------------|-----|------|------------------|
+      # | Tamanho |    04   |   02  |       05       |  02 |  01  |        05        |
+      # |_________|__________________________________________________________________|
+      #
+      # @return [String]
+      #
+      def nosso_numero_dv
+        Modulo11FatorDe2a9RestoZero.new("#{agencia}#{posto}#{conta_corrente}#{ano}#{byte_id}#{numero_documento}")
+      end
+
+      #  === Código de barras do banco
+      #     __________________________________________________________________________
+      #    | Posição | Tamanho | Descrição                                            |
+      #    |---------|---------|------------------------------------------------------|
+      #    | 20 – 21 |   02    | Carteira                                             |
+      #    | 22 – 30 |   09    | Nosso número com o digito identificador              |
+      #    | 31 – 34 |   04    | Cooperativa de crédito/agência beneficiária          |
+      #    | 35 – 36 |   02    | Posto da cooperativa de crédito/agência beneficiária |
+      #    | 37 – 41 |   05    | Código do beneficiário                               |
+      #    | 42 – 42 |   01    | Será 1 quando houver o valor do documento            |
+      #    | 43 – 43 |   01    | Fixo 0                                               |
+      #    | 44 – 44 |   01    | DV do campo livre                                    |
+      #    |__________________________________________________________________________|
+      #
+      # @return [String]
+      #
+      def codigo_de_barras_do_banco
+        codigo = "#{tipo_cobranca}#{tipo_carteira}#{nosso_numero_codigo_de_barras}#{agencia}#{posto}#{conta_corrente}#{valor_expresso}0"
+
+        codigo_dv = Modulo11FatorDe2a9RestoZero.new(codigo)
+
+        "#{codigo}#{codigo_dv}"
+      end
+
+      def nosso_numero_codigo_de_barras
+        "#{ano}#{byte_id}#{numero_documento}#{nosso_numero_dv}"
+      end
+
+      def valor_expresso
+        @valor_documento.present? ? '1' : '0'
+      end
+
+      # Método usado para verificar se deve realizar a validação de tamanho do campo 'posto'.
+      # <b>Sobrescreva esse método na subclasse, caso você mesmo queira fazer as validações</b>.
+      #
+      # @return [True]
+      #
+      def deve_validar_posto?
+        true
+      end
+
+      # Método usado para verificar se deve realizar a validação de tamanho do campo 'byte_id'.
+      # <b>Sobrescreva esse método na subclasse, caso você mesmo queira fazer as validações</b>.
+      #
+      # @return [True]
+      #
+      def deve_validar_byte_id?
+        true
+      end
+    end
+  end
+end

data/lib/boleto_bancario/locales/pt-BR.yml

@@ -0,0 +1,55 @@
+pt-BR:
+  boleto_bancario:
+    labels:
+      cedente: "Cedente"
+      sacado: "Sacado"
+      nosso_numero: "Nosso Número"
+      numero_documento: "Número do Documento"
+      data_vencimento: "Data de Vencimento"
+      valor_documento: "Valor do Documento"
+      agencia_cedente: "Agência/Código Cedente"
+      especie: "Espécie"
+      especie_documento: "Espécie Doc."
+      aceite: "Aceite"
+      data_documento: "Data do Documento"
+      carteira: "Carteira"
+      instrucoes: "Instruções"
+      local_pagamento: "Local de Pagamento"
+      linha_digitavel: "Linha Digitável"
+      codigo_banco: "Código do Banco"
+      documento_cedente: "CPF/CNPJ Cedente"
+      documento_sacado: "CPF/CNPJ Sacado"
+      endereco_cedente: "Endereço Cedente"
+      endereco_sacado: "Endereço Sacado"
+      conta_corrente: "Conta Corrente"
+      agencia: "Agência"
+      codigo_cedente: "Código do Cedente"
+
+    errors:
+      messages:
+        carteira_invalida: "carteira inválida"
+        agencia_invalida: "agência inválida"
+        conta_corrente_invalida: "conta corrente inválida"
+        valor_documento_invalido: "valor do documento inválido"
+        numero_documento_invalido: "número do documento inválido"
+        codigo_cedente_invalido: "código do cedente inválido"
+        documento_invalido: "documento inválido (CPF/CNPJ)"
+        data_vencimento_invalida: "data de vencimento inválida"
+
+    banks:
+      banco_brasil: "Banco do Brasil"
+      bradesco: "Bradesco"
+      itau: "Itaú"
+      santander: "Santander"
+      caixa: "Caixa Econômica Federal"
+      banrisul: "Banrisul"
+      sicoob: "Sicoob"
+      sicredi: "Sicredi"
+      nubank: "Nubank"
+      inter: "Banco Inter"
+      c6_bank: "C6 Bank"
+
+    defaults:
+      local_pagamento: "PAGÁVEL EM QUALQUER BANCO ATÉ O VENCIMENTO"
+      especie_documento: "DM"
+      especie: "R$"