tulios-brcobranca-rails2 2.0.8

data/lib/brcobranca/boleto/banco_caixa.rb

@@ -0,0 +1,118 @@
+# Banco Caixa
+class BancoCaixa < Brcobranca::Boleto::Base
+  
+  #validates_length_of :convenio, :is => 11, :message => "deve ser igual a 11 dígitos (operacao (3) + convênio (8))."
+
+  CARTEIRAS = {
+    14 => 'SR' # Cobranca sem Registro
+  }
+
+  # Nova instancia da CaixaEconomica
+  # @param (see Brcobranca::Boleto::Base#initialize)
+  def initialize(campos={})
+    campos = {:carteira => CARTEIRAS[14]}.merge!(campos)
+    super(campos)
+  end
+       
+  def fator_vencimento
+    self.data_vencimento.fator_vencimento.to_s.rjust(4,'0')
+  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
+
+  alias :valor_carteira :carteira
+  def carteira
+    # Em caso de número, formatar para sigla
+    return CARTEIRAS[self.valor_carteira] if self.valor_carteira.is_number?
+    self.valor_carteira
+  end
+
+  # Codigo do banco emissor (3 dígitos sempre)
+  #
+  # @return [String] 3 caracteres numéricos.
+  def banco
+    "104"
+  end
+
+  def banco_dv
+    self.banco.modulo10
+  end
+
+  # Número da agência/codigo_cedente do cliente para exibir no boleto.
+  # @return [String]
+  # @example
+  # boleto.agencia_conta_boleto #=> "2391/44335511-5"
+  def agencia_conta_boleto
+    "#{self.agencia}/#{self.conta_corrente}-#{self.conta_corrente_dv}"
+  end
+
+  # Número seqüencial utilizado para identificar o boleto.
+  # Carteira 14 - SR - Cobranca sem Registro:
+  # Fixo 2 mais 8 dígitos (ex: 8200000001)
+  # @raise [Brcobranca::NaoImplementado] Caso o tipo de convênio não seja suportado pelo Brcobranca.
+  #
+  def numero_documento
+    case self.carteira
+    when 'SR'
+      "82#{@numero_documento.to_s.rjust(8, '0')}"
+    else
+      raise Brcobranca::NaoImplementado.new("Tipo de convênio não implementado.")
+    end
+  end
+
+  # Dígito verificador do nosso número.
+  # @return [String] 1 caracteres numéricos.
+  # @see BancoBrasil#numero_documento
+  def nosso_numero_dv
+    self.numero_documento.modulo11_2to9
+  end
+
+  # Nosso número para exibir no boleto.
+  # (numero_documento + nosso_numero_dv)
+  # @return [String]
+  # @example
+  # boleto.nosso_numero_boleto #=> "12345678904"
+  def nosso_numero_boleto
+    "#{self.numero_documento}#{self.nosso_numero_dv}"
+  end
+                    
+  def monta_codigo_43_digitos
+    "#{codigo_barras_primeira_parte}#{codigo_barras_segunda_parte}"
+  end
+  
+  def codigo_barras
+    codigo = super()
+    raise Brcobranca::BoletoInvalido.new unless codigo 
+    codigo
+  end
+  
+  def codigo_barras_primeira_parte
+    "#{self.banco}#{self.moeda}#{self.fator_vencimento}#{valor_documento_formatado}"
+  end
+
+  def codigo_barras_segunda_parte
+    self.campo_livre
+  end
+
+  # Para as posições do Campo Livre, informar:
+  # - Se carteira Sem Registro: Nosso número com 10 posições e Código do Cedente, ambos
+  # sem o DV.
+  #
+  # Ex.: 82NNNNNNNN AAAA YYYXXXXXXXX
+  #
+  # Onde: 82 - Identificador da carteira Sem Registro
+  # NNNNNNNN - Nosso número do Cliente
+  # AAAA - CNPJ da Agência Cedente
+  # YYY - Operação Código
+  # XXXXXXXX - Código fornecido pela Agência
+  #
+  # Nota: A operação + o código fornecido pela agência = convênio
+  def campo_livre
+    "#{self.numero_documento}#{self.agencia}#{self.convenio}"
+  end
+
+end

data/lib/brcobranca/boleto/banco_hsbc.rb

@@ -0,0 +1,77 @@
+# Banco HSBC
+class BancoHsbc < Brcobranca::Boleto::Base
+
+  # Responsável por definir dados iniciais quando se cria uma nova intância da classe BancoBrasil
+  def initialize(campos={})
+    padrao={:carteira => "CNR", :banco => "399"}
+    campos = padrao.merge!(campos)
+    super(campos)
+  end
+
+  # Número sequencial utilizado para distinguir os boletos na agência
+  def nosso_numero
+    if self.data_vencimento.kind_of?(Date)
+      self.codigo_servico = 4
+      dia = self.data_vencimento.day.to_s.zeros_esquerda(:tamanho => 2)
+      mes = self.data_vencimento.month.to_s.zeros_esquerda(:tamanho => 2)
+      ano = self.data_vencimento.year.to_s[2..3]
+      data = "#{dia}#{mes}#{ano}"
+
+      numero_documento = "#{self.numero_documento.to_s}#{self.numero_documento.to_s.modulo11_9to2_10_como_zero}#{self.codigo_servico.to_s}"
+      soma = numero_documento.to_i + self.conta_corrente.to_i + data.to_i
+      numero = "#{numero_documento}#{soma.to_s.modulo11_9to2_10_como_zero}"
+      numero
+    else
+      self.codigo_servico = 5
+      numero_documento = "#{self.numero_documento.to_s}#{self.numero_documento.to_s.modulo11_9to2_10_como_zero}#{self.codigo_servico.to_s}"
+      soma = numero_documento.to_i + self.conta_corrente.to_i
+      numero = "#{numero_documento}#{soma.to_s.modulo11_9to2_10_como_zero}"
+      numero
+    end
+  end
+  
+  # Campo usado apenas na exibição no boleto
+  #  Deverá ser sobreescrito para cada banco
+  def nosso_numero_boleto
+   "#{self.nosso_numero}"
+  end
+
+  # Campo usado apenas na exibição no boleto
+  #  Deverá ser sobreescrito para cada banco
+  def agencia_conta_boleto
+   "#{self.conta_corrente}"
+  end
+
+  # Responsável por montar uma String com 43 caracteres que será usado na criação do código de barras
+  def monta_codigo_43_digitos
+    banco = self.banco.zeros_esquerda(:tamanho => 3)
+    valor_documento = self.valor_documento.limpa_valor_moeda.zeros_esquerda(:tamanho => 10)
+    convenio = self.convenio.to_s
+    conta = self.conta_corrente.zeros_esquerda(:tamanho => 7)
+
+    # Montagem é baseada no tipo de carteira e na presença da data de vencimento
+    if self.carteira == "CNR"
+      if self.data_vencimento.kind_of?(Date)
+        raise "numero_documento pode ser de no máximo 13 caracteres." if (self.numero_documento.to_s.size > 13)
+        fator = self.data_vencimento.fator_vencimento
+        dias_julianos = self.data_vencimento.to_juliano
+        self.codigo_servico = 4
+        numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 13)
+        numero = "#{banco}#{self.moeda}#{fator}#{valor_documento}#{conta}#{numero_documento}#{dias_julianos}2"
+        numero.size == 43 ? numero : nil
+      else
+        # TODO
+        nil
+      end
+    else
+      # TODO
+      # raise "numero_documento pode ser de no máximo 6 caracteres." if (self.numero_documento.to_s.size > 6)
+      # numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 6)
+      # nosso_numero = self.nosso_numero.zeros_esquerda(:tamanho => 9)
+      # self.codigo_servico = 5
+      
+      nil
+    end
+  end
+
+end

data/lib/brcobranca/boleto/banco_itau.rb

@@ -0,0 +1,115 @@
+# Banco Itaú
+class BancoItau < Brcobranca::Boleto::Base
+  # Usado somente em carteiras especiais com registro para complementar o número do cocumento
+  attr_accessor :seu_numero
+
+  # Responsável por definir dados iniciais quando se cria uma nova intancia da classe BancoItau
+  def initialize(campos={})
+    padrao={:carteira => "175", :banco => "341"}
+    campos = padrao.merge!(campos)
+    super(campos)
+  end
+
+  # Retorna dígito verificador do nosso número, calculado com modulo10.
+  # 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.
+  # A excecao, estão as carteiras 126, 131, 146, 150 e 168 cuja obtenção esta baseada apenas nos
+  # dados "CARTEIRA/NOSSO NUMERO".
+  def nosso_numero_dv
+    if %w(126 131 146 150 168).include?(self.carteira)
+      "#{self.carteira}#{self.numero_documento}".modulo10
+    else
+      numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 8)
+      "#{self.agencia}#{self.conta_corrente}#{self.carteira}#{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
+  
+  # Campo usado apenas na exibição no boleto
+  #  Deverá ser sobreescrito para cada banco
+  def nosso_numero_boleto
+   "#{self.carteira}/#{self.numero_documento}-#{self.nosso_numero_dv}"
+  end
+  
+  # Campo usado apenas na exibição no boleto
+  #  Deverá ser sobreescrito para cada banco
+  def agencia_conta_boleto
+   "#{self.agencia}-#{self.agencia_dv} / #{self.conta_corrente}-#{self.conta_corrente_dv}"
+  end
+
+  # Responsável por montar uma String com 43 caracteres que será usado na criação do código de barras.
+  def monta_codigo_43_digitos
+    valor_documento_formatado = self.valor_documento.limpa_valor_moeda.zeros_esquerda(:tamanho => 10)
+    fator_vencimento = self.data_vencimento.fator_vencimento
+    numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 8)
+    return nil if numero_documento.size != 8
+
+    # Monta a String baseado no tipo de carteira
+    case self.carteira.to_i
+    when 126, 131, 146, 150, 168
+      # CARTEIRAS 126 131 146 150 168
+      # 01 a 03 03 9(03) Código do Banco na Câmara de Compensação = '341'
+      # 04 a 04 01 9(01) Código da Moeda = '9'
+      # 05 a 05 01 9(01) DAC código de Barras MOD 11-2a9
+      # 06 a 09 04 9(04) Fator de Vencimento
+      # 10 a 19 10 9(08)V(2) Valor
+      # 20 a 22 03 9(03) Carteira
+      # 23 a 30 08 9(08) Nosso Número
+      # 31 a 31 01 9(01) DAC [Carteira/Nosso Número] MOD 10
+      # 32 a 35 04 9(04) N.º da Agência cedente
+      # 36 a 40 05 9(05) N.º da Conta Corrente
+      # 41 a 41 01 9(01) DAC [Agência/Conta Corrente] MOD 10
+      # 42 a 44 03 9(03) Zeros
+      codigo = "#{self.banco}#{self.moeda}#{fator_vencimento}#{valor_documento_formatado}#{self.carteira}"
+      codigo << "#{numero_documento}#{self.nosso_numero_dv}#{self.agencia}#{self.conta_corrente}#{self.agencia_conta_corrente_dv}000"
+      codigo
+      codigo.size == 43 ? codigo : nil
+    when 198, 106, 107, 122, 142, 143, 195, 196
+      # CARTEIRAS 198, 106, 107,122, 142, 143, 195 e 196
+      # 01 a 03 03 9(3) Código do Banco na Câmara de Compensação = ‘341’
+      # 04 a 04 01 9(1) Código da Moeda = '9'
+      # 05 a 05 01 9(1) DAC do Código de Barras MOD 11-2a9
+      # 06 a 09 04 9(04) Fator de Vencimento
+      # 10 a 19 10 9(08) V(2) Valor
+      # 20 a 22 03 9(3) Carteira
+      # 23 a 30 08 9(8) Nosso Número
+      # 31 a 37 07 9(7) Seu Número (Número do Documento)
+      # 38 a 42 05 9(5) Código do Cliente (fornecido pelo Banco)
+      # 43 a 43 01 9(1) DAC dos campos acima (posições 20 a 42) MOD 10
+      # 44 a 44 01 9(1) Zero
+      seu_numero = self.seu_numero.zeros_esquerda(:tamanho => 7)
+      return nil if seu_numero.size != 7
+      convenio = self.convenio.zeros_esquerda(:tamanho => 5)
+      return nil if convenio.size != 5
+      dv = "#{self.carteira}#{numero_documento}#{seu_numero}#{convenio}".modulo10
+
+      codigo = "#{self.banco}#{self.moeda}#{fator_vencimento}#{valor_documento_formatado}#{self.carteira}"
+      codigo << "#{numero_documento}#{seu_numero}#{convenio}#{dv}0"
+      codigo
+      codigo.size == 43 ? codigo : nil
+    else
+      # DEMAIS CARTEIRAS
+      # 01 a 03 03 9(03) Código do Banco na Câmara de Compensação = '341'
+      # 04 a 04 01 9(01) Código da Moeda = '9'
+      # 05 a 05 01 9(01) DAC código de Barras MOD 11-2a9
+      # 06 a 09 04 9(04) Fator de Vencimento
+      # 10 a 19 10 9(08)V(2) Valor
+      # 20 a 22 03 9(03) Carteira
+      # 23 a 30 08 9(08) Nosso Número
+      # 31 a 31 01 9(01) DAC [Agência /Conta/Carteira/Nosso Número] MOD 10
+      # 32 a 35 04 9(04) N.º da Agência cedente
+      # 36 a 40 05 9(05) N.º da Conta Corrente
+      # 41 a 41 01 9(01) DAC [Agência/Conta Corrente] MOD 10
+      # 42 a 44 03 9(03) Zeros
+      codigo = "#{self.banco}#{self.moeda}#{fator_vencimento}#{valor_documento_formatado}#{self.carteira}"
+      codigo << "#{numero_documento}#{self.nosso_numero_dv}#{self.agencia}#{self.conta_corrente}#{self.agencia_conta_corrente_dv}000"
+      codigo
+      codigo.size == 43 ? codigo : nil
+    end
+  end
+end

data/lib/brcobranca/boleto/banco_real.rb

@@ -0,0 +1,70 @@
+# Banco REAL
+class BancoReal < Brcobranca::Boleto::Base
+  # Responsável por definir dados iniciais quando se cria uma nova intancia da classe BancoReal
+  def initialize(campos={})
+    padrao={:carteira => "57", :banco => "356"}
+    campos = padrao.merge!(campos)
+    super(campos)
+  end
+  
+  # Campo usado apenas na exibição no boleto
+  #  Deverá ser sobreescrito para cada banco
+  def nosso_numero_boleto
+   "#{self.numero_documento}-#{self.nosso_numero_dv}"
+  end
+
+  # Campo usado apenas na exibição no boleto
+  #  Deverá ser sobreescrito para cada banco
+  def agencia_conta_boleto
+   "#{self.agencia}-#{self.agencia_dv} / #{self.conta_corrente}-#{self.conta_corrente_dv}"
+  end
+  
+  # CALCULO DO DIGITO:
+  #  APLICA-SE OS PESOS 2,1,2,1,.... AOS ALGARISMOS DO NUMERO COMPOSTO POR:
+  #  NUMERO DO BANCO : COM 7 DIGITOS P/ COBRANCA REGISTRADA
+  #                     ATE 15 DIGITOS P/ COBRANCA SEM REGISTRO
+  #  CODIGO DA AGENCIA: 4 DIGITOS
+  #  NUMERO DA CONTA : 7 DIGITOS
+  def agencia_conta_corrente_nosso_numero_dv
+    case self.carteira.to_i
+    when 57
+      #agencia é 4 digitos
+      agencia = self.agencia.zeros_esquerda(:tamanho => 4)
+      #conta é 7 digitos
+      conta = self.conta_corrente.zeros_esquerda(:tamanho => 7)
+      #nosso número com maximo de 13 digitos
+      numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 13)
+      "#{numero_documento}#{agencia}#{conta}".modulo10
+    else
+      #agencia é 4 digitos
+      agencia = self.agencia.zeros_esquerda(:tamanho => 4)
+      #conta é 7 digitos
+      conta = self.conta_corrente.zeros_esquerda(:tamanho => 7)
+      #nosso número com maximo de 13 digitos
+      numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 7)
+      "#{numero_documento}#{agencia}#{conta}".modulo10
+    end
+  end
+
+  # Responsável por montar uma String com 43 caracteres que será usado na criação do código de barras
+  def monta_codigo_43_digitos
+    banco = self.banco.zeros_esquerda(:tamanho => 3)
+    valor_documento = self.valor_documento.limpa_valor_moeda.zeros_esquerda(:tamanho => 10)
+    conta = self.conta_corrente.zeros_esquerda(:tamanho => 7)
+    agencia = self.agencia.zeros_esquerda(:tamanho => 4)
+    fator = self.data_vencimento.fator_vencimento
+    # Montagem é baseada no tipo de carteira, com registro e sem registro
+    case self.carteira.to_i
+      # Carteira sem registro
+    when 57
+      numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 13)
+      codigo = "#{banco}#{self.moeda}#{fator}#{valor_documento}#{agencia}#{conta}#{self.agencia_conta_corrente_nosso_numero_dv}#{numero_documento}"
+      codigo.size == 43 ? codigo : nil
+    else
+      # TODO verificar com o banco, pois não consta na documentação
+      numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 7)
+      codigo = "#{banco}#{self.moeda}#{fator}#{valor_documento}000000#{agencia}#{conta}#{self.agencia_conta_corrente_nosso_numero_dv}#{numero_documento}"
+      codigo.size == 43 ? codigo : nil
+    end
+  end
+end

data/lib/brcobranca/boleto/banco_unibanco.rb

@@ -0,0 +1,79 @@
+# Banco UNIBANCO
+class BancoUnibanco < Brcobranca::Boleto::Base
+  # Responsável por definir dados iniciais quando se cria uma nova intancia da classe BancoUnibanco
+  #  Com Registro 4
+  #  Sem Registro 5
+  def initialize(campos={})
+    padrao={:carteira => "5", :banco => "409"}
+    campos = padrao.merge!(campos)
+    super(campos)
+  end
+
+  def nosso_numero_dv
+    self.numero_documento.modulo11_2to9
+  end
+  
+  # Campo usado apenas na exibição no boleto
+  #  Deverá ser sobreescrito para cada banco
+  def nosso_numero_boleto
+   "#{self.numero_documento.zeros_esquerda(:tamanho => 14)}-#{self.nosso_numero_dv}"
+  end
+
+  # Campo usado apenas na exibição no boleto
+  #  Deverá ser sobreescrito para cada banco
+  def agencia_conta_boleto
+   "#{self.agencia} / #{self.conta_corrente}-#{self.conta_corrente_dv}"
+  end
+
+  # Responsável por montar uma String com 43 caracteres que será usado na criação do código de barras
+  def monta_codigo_43_digitos
+    banco = self.banco.zeros_esquerda(:tamanho => 3)
+    fator = self.data_vencimento.fator_vencimento
+    valor_documento = self.valor_documento.limpa_valor_moeda.zeros_esquerda(:tamanho => 10)
+    carteira = self.carteira.zeros_esquerda(:tamanho => 1)
+
+    case carteira.to_i
+    when 5
+
+      # Cobrança sem registro (CÓDIGO DE BARRAS)
+      # Posição Tamanho Descrição
+      # 1 a 3 3 número de identificação do Unibanco: 409 (número FIXO)
+      # 4 1 código da moeda. Real (R$)=9 (número FIXO)
+      # 5 1 dígito verificador do CÓDIGO DE BARRAS
+      # 6 a 9 4 fator de vencimento
+      # 10 a 19 10  valor do título com zeros à esquerda
+      # 20  1 código para transação CVT: 5 (número FIXO)(5=7744-5)
+      # 21 a 27 7 número do cliente no CÓDIGO DE BARRAS + dígito verificador
+      # 28 a 29 2 vago. Usar 00 (número FIXO)
+      # 30 a 43 14  Número de referência do cliente
+      # 44  1 Dígito verificador
+
+      convenio = self.convenio.zeros_esquerda(:tamanho => 6)
+      numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 14)
+      codigo = "#{banco}#{self.moeda}#{fator}#{valor_documento}#{carteira}#{convenio}00#{numero_documento}#{self.nosso_numero_dv}"
+      codigo.size == 43 ? codigo : nil
+    when 4
+
+      # Cobrança com registro (CÓDIGO DE BARRAS)
+      #      Posição  Tamanho Descrição
+      #      1 a 3  3 Número de identificação do Unibanco: 409 (número FIXO)
+      #      4  1 Código da moeda. Real (R$)=9 (número FIXO)
+      #      5  1 dígito verificador do CÓDIGO DE BARRAS
+      #      6 a 9  4 fator de vencimento em 4 algarismos, conforme tabela da página 14
+      #      10 a 19  10  valor do título com zeros à esquerda
+      #      20 a 21  2 Código para transação CVT: 04 (número FIXO) (04=5539-5)
+      #      22 a 27  6 data de vencimento (AAMMDD)
+      #      28 a 32  5 Código da agência + dígito verificador
+      #      33 a 43  11  “Nosso Número” (NNNNNNNNNNN)
+      #      44 1 Super dígito do “Nosso Número” (calculado com o MÓDULO 11 (de 2 a 9))
+
+      data = self.data_vencimento.strftime('%y%m%d')
+      agencia = self.agencia.zeros_esquerda(:tamanho => 4)
+      numero_documento = self.numero_documento.zeros_esquerda(:tamanho => 11)
+      codigo = "#{banco}#{self.moeda}#{fator}#{valor_documento}0#{carteira}#{data}#{agencia}#{self.agencia_dv}#{numero_documento}#{self.nosso_numero_dv}"
+      codigo.size == 43 ? codigo : nil
+    else
+      nil
+    end
+  end
+end