bbrcobranca 0.0.1

data/lib/bbrcobranca/boleto/unicred.rb

@@ -0,0 +1,141 @@
+# -*- encoding: utf-8 -*-
+#
+module Bbrcobranca
+  module Boleto
+    class Unicred < Base # Banco Unicred
+      # <b>REQUERIDO</b>: Código do posto da cooperativa de crédito
+      attr_accessor :posto
+
+      # <b>REQUERIDO</b>: Byte de identificação do cedente do bloqueto utilizado para compor o nosso número.
+      attr_accessor :byte_idt
+
+      validates_length_of :agencia, maximum: 4, message: 'deve ser menor ou igual a 4 dígitos.'
+      validates_length_of :nosso_numero, maximum: 5, message: 'deve ser menor ou igual a 5 dígitos.'
+      validates_length_of :conta_corrente, maximum: 5, message: 'deve ser menor ou igual a 5 dígitos.'
+      # Carteira
+      # 1 – Com Registro
+      # 3 – Sem Registro
+      # Obs.: O Unicred não validará este campo.
+      validates_length_of :carteira, maximum: 1, message: 'deve ser menor ou igual a 1 dígitos.'
+      validates_length_of :posto, maximum: 2, message: 'deve ser menor ou igual a 2 dígitos.'
+      validates_length_of :byte_idt, is: 1, message: 'deve ser 1 se o numero foi gerado pela agencia ou 2-9 se foi gerado pelo beneficiário'
+      validates_length_of :convenio, maximum: 5, message: 'deve ser menor ou igual a 5 dígitos.'
+
+      # Nova instancia do Unicred
+      # @param (see Bbrcobranca::Boleto::Base#initialize)
+      def initialize(campos = {})
+        campos = { carteira: '3',
+          especie_documento: 'DM',
+          local_pagamento: 'PAGÁVEL PREFERENCIALMENTE NAS AGÊNCIAS DA UNICRED'
+        }.merge!(campos)
+        super(campos)
+      end
+
+      # Codigo do banco emissor (3 dígitos sempre)
+      #
+      # @return [String] 3 caracteres numéricos.
+      def banco
+        '748'
+      end
+
+      # Carteira
+      #
+      # @return [String] 2 caracteres numéricos.
+      def carteira=(valor)
+        @carteira = valor.to_s.rjust(1, '0') if valor
+      end
+
+      # Posto
+      #
+      # @return [String] 2 caracteres numéricos.
+      def posto=(valor)
+        @posto = valor.to_s.rjust(2, '0') if valor
+      end
+
+      # Número da conta corrente
+      # @return [String] 5 caracteres numéricos.
+      def conta_corrente=(valor)
+        @conta_corrente = valor.to_s.rjust(5, '0') if valor
+      end
+
+      # Código Beneficiário
+      # @return [String] 5 caracteres numéricos.
+      def convenio=(valor)
+        @convenio = valor.to_s.rjust(5, '0') if valor
+      end
+
+      # Dígito verificador do banco
+      # @return [String] 1 caractere.
+      def banco_dv
+        'X'
+      end
+
+      # Nosso número para exibir no boleto.
+      # O campo Nosso Número deve ser apresentado no formato AA/BXXXXX-D, onde:
+      # AA = Ano atual
+      # B = Byte que pode ser de 2 a 9. Somente será 1 se forem boletos pré-impressos.
+      # XXXXX = número sequencial
+      # D = dígito verificador calculado
+      # @return [String]
+      # @example
+      #  boleto.nosso_numero_boleto #=> "14/200022-5"
+      def nosso_numero_boleto
+        "#{nosso_numero_with_byte_idt[0..1]}/#{nosso_numero_with_byte_idt[2..-1]}-#{nosso_numero_dv}"
+      end
+
+      def nosso_numero_codigo_barra
+        nosso_numero_boleto.gsub(/\D/, '')
+      end
+
+      def nosso_numero_with_byte_idt
+        "#{data_processamento.strftime('%y')}#{byte_idt}#{nosso_numero}"
+      end
+
+      # Número seqüencial utilizado para identificar o boleto.
+      # @return [String] 5 caracteres numéricos.
+      def nosso_numero=(valor)
+        @nosso_numero = valor.to_s.rjust(5, '0') if valor
+      end
+
+      # Dígito verificador do nosso número
+      # @return [Integer] 1 caracteres numéricos.
+      def nosso_numero_dv
+        "#{agencia_posto_conta}#{nosso_numero_with_byte_idt}"
+          .modulo11(mapeamento: mapeamento_para_modulo_11)
+      end
+
+      def agencia_conta_boleto
+        "#{agencia}.#{posto}.#{convenio}"
+      end
+
+      def agencia_posto_conta
+        "#{agencia}#{posto}#{convenio}"
+      end
+
+      # Segunda parte do código de barras.
+      # Posição       Tamanho      Conteúdo
+      # 20 – 20       01      Código numérico correspondente ao tipo de cobrança: “1” – Com Registro “3 – Sem Registro”. Obs.: O SICREDI não validará este campo.
+      # 21 – 21       01      Código numérico correspondente ao tipo de carteira: “1” - carteira simples
+      # 22 – 30       09      Nosso número
+      # 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 (um) quando houver valor expresso no campo “valor do documento”
+      # 43 – 43      # 01      # Filler – zeros “0”
+      # 44 – 44      # 01      # DV do campo livre calculado por módulo 11 com aproveitamento total (resto igual a 0 ou 1 DV cai para 0)
+      def codigo_barras_segunda_parte
+        campo_livre = "#{carteira}1#{nosso_numero_codigo_barra}#{agencia_posto_conta}10"
+        campo_livre + campo_livre.modulo11(mapeamento: mapeamento_para_modulo_11).to_s
+      end
+
+      private
+
+      def mapeamento_para_modulo_11
+        {
+          10 => 0,
+          11 => 0
+        }
+      end
+    end
+  end
+end

data/lib/bbrcobranca/calculo.rb

@@ -0,0 +1,115 @@
+# -*- encoding: utf-8 -*-
+#
+# @author Kivanio Barbosa
+module Bbrcobranca
+  # Métodos auxiliares de cálculos
+  module Calculo
+    # Calcula módulo 10 segundo a BACEN.
+    #
+    # @return [Integer]
+    # @raise  [ArgumentError] Caso não seja um número inteiro.
+    def modulo10
+      raise ArgumentError, 'Número inválido' unless is_number?
+
+      total = 0
+      multiplicador = 2
+
+      to_s.split(//).reverse!.each do |caracter|
+        total += (caracter.to_i * multiplicador).soma_digitos
+        multiplicador = multiplicador == 2 ? 1 : 2
+      end
+
+      valor = (10 - (total % 10))
+      valor == 10 ? 0 : valor
+    end
+
+    # Calcula o módulo 11 segundo a BACEN
+    #
+    # @return [Integer]
+    # @raise  [ArgumentError] Caso não seja um número inteiro.
+    # @param  [Hash] options Opções para o cálculo do módulo
+    # @option options [Hash] :mapeamento Mapeamento do valor final. Ex: { 10 => "X" }. Padrão: {}
+    # @option options [Array] :multiplicador Números a serem utilizados na multiplicação da direita para a esquerda. Padrão: [9 até 2]
+    def modulo11(options = {}, &_block)
+      options[:mapeamento] ||= {}
+      options[:multiplicador] ||= [9, 8, 7, 6, 5, 4, 3, 2]
+
+      total = multiplicador(fatores: options[:multiplicador], reverse: options[:reverse])
+      valor = block_given? ? yield(total) : (total % 11)
+
+      options[:mapeamento][valor] || valor
+    end
+
+    # Verifica se String só contem caracteres numéricos.
+    #
+    # @return [Boolean]
+    def is_number?
+      to_s.empty? ? false : (to_s =~ /\D/).nil?
+    end
+
+    # Soma dígitos de números inteiros positivos com 2 dígitos ou mais.
+    #
+    # @return [Integer]
+    # @example
+    #  1 #=> 1
+    #  11 (-9 ) #=> 2
+    #  13 (-9 ) #=> 4
+    #  18 (-9 ) #=> 9
+    def soma_digitos
+      total = self.to_i
+      total = total - 9 if total > 9
+      total
+    end
+
+    # Faz a multiplicação de um número pelos fatores passados como parâmetro.
+    #
+    # @param  [Array]
+    # @return [Integer]
+    # @raise  [ArgumentError] Caso não seja um número inteiro.
+    def multiplicador(options = {}, &_block)
+      raise ArgumentError, 'Número inválido' unless is_number?
+      raise ArgumentError, 'Fatores não podem estar em branco' unless options[:fatores]
+
+      total = 0
+      multiplicador_posicao = 0
+      fatores = options[:fatores]
+      numeros = options[:reverse].nil? ? to_s.split(//).reverse! : to_s.split(//)
+
+      numeros.each do |caracter|
+        fator = fatores[multiplicador_posicao]
+        total += block_given? ? yield(caracter, fator) : (caracter.to_i * fator)
+        multiplicador_posicao = multiplicador_posicao < (fatores.size - 1) ? (multiplicador_posicao + 1) : 0
+      end
+      total
+    end
+
+    # Calcula duplo dígito com modulo 10 e 11
+    #
+    # @return [String]
+    # @raise  [ArgumentError] Caso não seja um número inteiro.
+    def duplo_digito
+      raise ArgumentError, 'Número inválido' unless is_number?
+
+      digito_1 = modulo10
+      digito_2 = "#{self}#{digito_1}".modulo11(multiplicador: [2, 3, 4, 5, 6, 7]) { |total| (total < 11 ? total : total % 11) }
+
+      while digito_2 == 1
+        digito_1 = if digito_1 == 9
+                     0
+                   else
+                     digito_1 + 1
+                   end
+
+        digito_2 = "#{self}#{digito_1}".modulo11(multiplicador: [2, 3, 4, 5, 6, 7]) { |total| (total < 11 ? total : total % 11) }
+      end
+
+      digito_2 = 11 - digito_2 if digito_2 != 0
+
+      "#{digito_1}#{digito_2}"
+    end
+  end
+end
+
+[String, Numeric].each do |klass|
+  klass.class_eval { include Bbrcobranca::Calculo }
+end

data/lib/bbrcobranca/calculo_data.rb

@@ -0,0 +1,62 @@
+# -*- encoding: utf-8 -*-
+#
+# @author Kivanio Barbosa
+
+require 'date'
+
+module Bbrcobranca
+  # Métodos auxiliares de cálculos envolvendo Datas.
+  module CalculoData
+    # Calcula o número de dias corridos entre a <b>data base ("Fixada" em 07.10.1997)</b> e a <b>data de vencimento</b> desejada.
+    # A partir de 22.02.2025, o fator retorna para '1000' adicionando- se '1' a cada dia subsequente a este fator
+    # até que chegue a 9999 novamente onde deve ser usada nova data base começando de 1000.
+    #
+    # Somente serão considerados válidos para pagamento os boletos com 3.000 fatores de vencimento anteriores
+    # e 5.500 fatores futuros, ambos em relação a data atual.
+    # Boletos fora deste controle não serão considerados validos para pagamento na rede bancária.
+    # Ex. Hoje é 13/03/2014 (fator 6.001)
+    # Limite para emissão ou pagamento de boletos vencido: 24/12/2005 (fator 3.000)
+    # Limite para emissão ou pagamento de boletos à vencer: 03/04/2029 (fator 2.501)
+    #
+    # @return [String] Contendo 4 dígitos
+    # @example
+    #  Date.parse(2000-07-04).fator_vencimento #=> 1001
+    def fator_vencimento
+      data_base = Date.parse '1997-10-07'
+      fator_vencimento = Integer(self - data_base)
+      while fator_vencimento > 9999
+        data_base = data_base + 10000
+        fator_vencimento = Integer(self - data_base) + 1000
+      end
+      fator_vencimento.to_s
+    end
+
+    # Mostra a data em formato <b>dia/mês/ano</b>
+    # @return [String]
+    # @example
+    #  Date.current.to_s_br #=> 20/01/2010
+    def to_s_br
+      strftime('%d/%m/%Y')
+    end
+
+    # Calcula número de dias julianos.
+    #
+    # O cálculo é feito subtraindo-se a data atual, pelo último dia válido do ano anterior,
+    # acrescentando-se o último algarismo do ano atual na quarta posição.
+    #
+    # @return [String] contendo 4 dígitos
+    #
+    # @example
+    #  Date.parse(2009-02-11).to_juliano #=> "0429"
+    def to_juliano
+      ultima_data = Date.parse("#{year - 1}-12-31")
+      ultimo_digito_ano = to_s[3..3]
+      dias = Integer(self - ultima_data)
+      (dias.to_s + ultimo_digito_ano).rjust(4, '0')
+    end
+  end
+end
+
+[Date].each do |klass|
+  klass.class_eval { include Bbrcobranca::CalculoData }
+end

data/lib/bbrcobranca/currency.rb

@@ -0,0 +1,69 @@
+# -*- encoding: utf-8 -*-
+#
+
+# @author Fernando Vieira do http://simplesideias.com.br
+module Bbrcobranca #:nodoc:[all]
+  module Currency #:nodoc:[all]
+    # Implementação feita por Fernando Vieira do http://simplesideias.com.br
+    # post http://simplesideias.com.br/usando-number_to_currency-em-modelos-no-rails
+    BRL = { delimiter: '.', separator: ',', unit: 'R$', precision: 2, position: 'before' }.freeze
+    USD = { delimiter: ',', separator: '.', unit: 'US$', precision: 2, position: 'before' }.freeze
+    DEFAULT = BRL.merge(unit: '')
+
+    module String #:nodoc:[all]
+      def to_number(_options = {})
+        return tr(',', '.').to_f if numeric?
+        nil
+      end
+
+      def numeric?
+        self =~ /^(\+|-)?[0-9]+((\.|,)[0-9]+)?$/ ? true : false
+      end
+    end
+
+    module Number #:nodoc:[all]
+      def to_currency(options = {})
+        number = self
+        default   = Bbrcobranca::Currency::DEFAULT
+        options   = default.merge(options)
+        precision = options[:precision] || default[:precision]
+        unit      = options[:unit] || default[:unit]
+        position  = options[:position] || default[:position]
+        separator = precision > 0 ? options[:separator] || default[:separator] : ''
+        delimiter = options[:delimiter] || default[:delimiter]
+
+        begin
+          parts = number.with_precision(precision).split('.')
+          number = parts[0].to_i.with_delimiter(delimiter) + separator + parts[1].to_s
+          position == 'before' ? unit + number : number + unit
+        rescue
+          number
+        end
+      end
+
+      def with_delimiter(delimiter = ',', separator = '.')
+        number = self
+        begin
+          parts = number.to_s.split(separator)
+          parts[0].gsub!(/(\d)(?=(\d\d\d)+(?!\d))/, "\\1#{delimiter}")
+          parts.join separator
+        rescue
+          self
+        end
+      end
+
+      def with_precision(precision = 3)
+        number = self
+        "%01.#{precision}f" % number
+      end
+    end
+  end
+end
+
+[Numeric, String].each do |klass|
+  klass.class_eval { include Bbrcobranca::Currency::Number }
+end
+
+[String].each do |klass|
+  klass.class_eval { include Bbrcobranca::Currency::String }
+end

data/lib/bbrcobranca/formatacao.rb

@@ -0,0 +1,103 @@
+# -*- encoding: utf-8 -*-
+#
+# @author Kivanio Barbosa
+module Bbrcobranca
+  # Métodos auxiliares de formatação
+  module Formatacao
+    # Formata como CPF
+    #
+    # @return [String]
+    # @example
+    #  "12345678901".to_br_cpf #=> 123.456.789-01
+    def to_br_cpf
+      somente_numeros.gsub(/^(.{3})(.{3})(.{3})(.{2})$/, '\1.\2.\3-\4')
+    end
+
+    # Formata como CEP
+    #
+    # @return [String]
+    # @example
+    #   "85253100".to_br_cep #=> "85253-100"
+    #   85253100.to_br_cep #=> "85253-100"
+    def to_br_cep
+      somente_numeros.gsub(/^(.{5})(.{3})$/, '\1-\2')
+    end
+
+    # Formata como CNPJ
+    #
+    # @return [String]
+    # @example
+    #  "12345678000901".to_br_cnpj #=> 12.345.678/0009-01
+    def to_br_cnpj
+      somente_numeros.gsub(/^(.{2})(.{3})(.{3})(.{4})(.{2})$/, '\1.\2.\3/\4-\5')
+    end
+
+    # Gera formatação automática do documento baseado no tamanho do campo.
+    #
+    # @return [String] Retorna a mesma caso não encontre o formato adequado.
+    # @example
+    #  "12345678000901".formata_documento #=> 12.345.678/0009-01
+    #  "85253100".formata_documento #=> "85253-100"
+    #  "12345678901".formata_documento #=> 123.456.789-01
+    #  "12345".formata_documento #=> 12345
+    def formata_documento
+      case somente_numeros.size
+      when 8 then to_br_cep
+      when 11 then to_br_cpf
+      when 14 then to_br_cnpj
+      else
+        self
+      end
+    end
+
+    # Remove caracteres que não sejam numéricos.
+    #
+    # @return [String]
+    # @example
+    #   1a23e45+".somente_numeros #=> 12345
+    def somente_numeros
+      to_s.gsub(/\D/, '')
+    end
+
+    # Monta a linha digitável padrão para todos os bancos segundo a BACEN.
+    #
+    # A linha digitável será composta por cinco campos:<br/>
+    # <b>1º campo</b>: <br/>
+    # 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.<br/>
+    # <b>2º campo</b>: <br/>
+    # Composto pelas posições 6ª a 15ª do campo livre e o dígito verificador deste campo.<br/>
+    # <b>3º campo</b>: <br/>
+    # Composto pelas posições 16ª a 25ª do campo livre e o dígito verificador deste campo.<br/>
+    # <b>4º campo</b>: <br/>
+    # Composto pelo dígito verificador do código de barras, ou seja, a 5ª posição do código de barras.<br/>
+    # <b>5º campo</b>: <br/>
+    # Composto pelo fator de vencimento com 4(quatro) caracteres e o valor do documento com
+    # 10(dez) caracteres, sem separadores e sem edição.<br/>
+    #
+    # @return [String]
+    # @raise  [ArgumentError] Caso não seja um número de 44 dígitos.
+    # @example
+    #  "00192376900000135000000001238798777770016818".linha_digitavel #=> "00190.00009 01238.798779 77700.168188 2 37690000013500"
+    def linha_digitavel
+      if self =~ /^(\d{4})(\d{1})(\d{14})(\d{5})(\d{10})(\d{10})$/
+        linha = Regexp.last_match[1]
+        linha << Regexp.last_match[4]
+        linha << linha.modulo10.to_s
+        linha << Regexp.last_match[5]
+        linha << Regexp.last_match[5].modulo10.to_s
+        linha << Regexp.last_match[6]
+        linha << Regexp.last_match[6].modulo10.to_s
+        linha << Regexp.last_match[2]
+        linha << Regexp.last_match[3]
+        linha.gsub(/^(.{5})(.{5})(.{5})(.{6})(.{5})(.{6})(.{1})(.{14})$/, '\1.\2 \3.\4 \5.\6 \7 \8')
+      else
+        raise ArgumentError, "#{self} Precisa conter 44 caracteres numéricos."
+      end
+    end
+  end
+end
+
+[String, Numeric].each do |klass|
+  klass.class_eval { include Bbrcobranca::Formatacao }
+end