Class: BrBoleto::Boleto::Itau

Inherits:
Base show all
Defined in:
lib/br_boleto/boleto/itau.rb

Overview

Implementação de emissão de boleto bancário pelo Banco Itau.

Documentação Implementada

A documentação na qual essa implementação foi baseada está localizada na pasta ‘documentacoes_dos_boletos/itau’ dentro dessa biblioteca.

Instance Attribute Summary

Attributes inherited from Base

#aceite, #codigo_moeda, #data_documento, #data_vencimento, #especie, #especie_documento, #instrucoes1, #instrucoes2, #instrucoes3, #instrucoes4, #instrucoes5, #instrucoes6, #local_pagamento, #logo, #numero_documento, #parcelas, #valor_documento

Instance Method Summary collapse

Methods inherited from Base

#aceite_formatado, #codigo_de_barras, #codigo_de_barras_padrao, #data_vencimento_deve_ser_uma_data, #digito_codigo_de_barras, #fator_de_vencimento, #linha_digitavel, #persisted?, #to_partial_path, #valid_valor_documento_tamanho_maximo, #valor_formatado_para_codigo_de_barras

Methods included from HavePagador

#pagador, #pagador=

Methods included from HaveConta

#conta, #conta=

Methods inherited from ActiveModelBase

#assign_attributes, #initialize

Constructor Details

This class inherits a constructor from BrBoleto::ActiveModelBase

Instance Method Details

#codigo_de_barras_do_banco ⇒ Object

As carteiras de cobrança 107, 122, 142, 143, 196 e 198 são carteiras especiais, sem registro, na qual são utilizadas 15 posições numéricas para identificação do título liquidado (8 do Nosso Número e 7 do Seu Número).

=== C

Para essas carteiras o formato do código de barras é o seguinte: 

 ___________________________________________________________________________________________________
| Posi

Demais Carteiras

Para as demais carteiras o formato do código de barras é o seguinte:

 _________________________________________________________________________________________
| Posi


107
108
109
110
111
112
113
114
115
116
 
# File 'lib/br_boleto/boleto/itau.rb', line 107

def codigo_de_barras_do_banco
   if conta.carteira.in?(conta.carteiras_especiais_codigo_barras)
     seu_numero = numero_documento.adjust_size_to(7)
    codigo = "#{conta.carteira}#{numero_documento}#{seu_numero}#{conta.codigo_cedente}"
    mod_10 = BrBoleto::Calculos::Modulo10.new(codigo)
    "#{codigo}#{mod_10}0"
  else
    "#{conta.carteira}#{numero_documento}#{digito_verificador_nosso_numero}#{conta.agencia}#{conta.conta_corrente}#{conta.conta_corrente_dv}000"
  end
end

#conta_class ⇒ Object 



11
12
13
 
# File 'lib/br_boleto/boleto/itau.rb', line 11

def conta_class
  BrBoleto::Conta::Itau
end

#default_values ⇒ Object

Conforme descrito na documentação, o valor que deve constar em local do pagamento é “PAGÁVEL EM QUALQUER BANCO OU CORRESPONDENTE ATÉ O VENCIMENTO.”



42
43
44
45
46
 
# File 'lib/br_boleto/boleto/itau.rb', line 42

def default_values
  super.merge({
    :local_pagamento   => "PAGÁVEL EM QUALQUER BANCO OU CORRESPONDENTE ATÉ O VENCIMENTO."
  })
end

#digito_verificador_nosso_numero ⇒ Object

Para a grande maioria das carteiras, são considerados para a obtenção do dígito do nosso número, os dados “AGÊNCIA / CONTA (sem dígito) / CARTEIRA / NOSSO NÚMERO”, calculado pelo critério do Módulo 10.

À exceção, estão as carteiras 126 - 131 - 146 - 150 e 168 cuja obtenção está baseada apenas nos dados “CARTEIRA/NOSSO NÚMERO” da operação.



66
67
68
69
70
71
72
 
# File 'lib/br_boleto/boleto/itau.rb', line 66

def digito_verificador_nosso_numero
  if conta.carteira.in?(conta.carteiras_especiais_nosso_numero_dv)
    BrBoleto::Calculos::Modulo10.new("#{conta.carteira}#{numero_documento}")
  else
    BrBoleto::Calculos::Modulo10.new("#{conta.agencia}#{conta.conta_corrente}#{conta.carteira}#{numero_documento}")
  end
end

#nosso_numero ⇒ Object

Nosso Número descrito na documentação (Pag. 50). Carteira com 3 caracteres / N.Número com 8 caracteres + digito. Exemplo: 999 / 99999999-D



51
52
53
 
# File 'lib/br_boleto/boleto/itau.rb', line 51

def nosso_numero
  "#{conta.carteira}/#{numero_documento}-#{digito_verificador_nosso_numero}"
end

#nosso_numero_retorno ⇒ Object

No arquivo de retorno a carteira não vem junto com o nosso núemro



57
58
59
 
# File 'lib/br_boleto/boleto/itau.rb', line 57

def nosso_numero_retorno
  "#{nosso_numero}".gsub(/[^\w\d]/i, '')[3..-1]
end

#valid_carteira_inclusion ⇒ Object 



20
21
22
 
# File 'lib/br_boleto/boleto/itau.rb', line 20

def valid_carteira_inclusion
  %w[104 105 107 108 109 112 113 116 117 119 121 122 126 131 134 135 136 142 143 146 147 150 168 169 174 175 180 191 196 198]
end

#valid_conta_corrente_maximum ⇒ Object

Tamanho máximo de uma conta corrente no Banco Itau



30
31
32
 
# File 'lib/br_boleto/boleto/itau.rb', line 30

def valid_conta_corrente_maximum 
  5
end

#valid_convenio_maximum ⇒ Object

Tamanho máximo para o codigo_cedente/Convênio



25
26
27
 
# File 'lib/br_boleto/boleto/itau.rb', line 25

def valid_convenio_maximum 
  5
end

#valid_convenio_required ⇒ Object

codigo_cedente/Convênio deve ser obrigatório



35
36
37
 
# File 'lib/br_boleto/boleto/itau.rb', line 35

def valid_convenio_required
  true
end

#valid_numero_documento_maximum ⇒ Object

VALIDAÇÕES DINÂMICAS #################



16
17
18
 
# File 'lib/br_boleto/boleto/itau.rb', line 16

def valid_numero_documento_maximum
  8
end