br_boleto 1.2.2 → 2.0.0

data/lib/br_boleto/conta/base.rb

@@ -0,0 +1,288 @@
+# encoding: utf-8
+module BrBoleto
+	module Conta
+		class Base < BrBoleto::ActiveModelBase
+			include BrBoleto::Calculos
+			include BrBoleto::Helper::DefaultCodes
+
+			#                ATRIBUTOS
+			# razao_social
+			# cpf_cnpj
+			# convenio OU codigo_cedente    OU codigo_beneficiario
+			# convenio OU codigo_cedente_dv OU codigo_beneficiario_dv
+			# endereco
+			# carteira
+			# agencia
+			# agencia_dv
+			# conta_corrente
+			# conta_corrente_dv
+			# nome_banco
+			# modalidade
+
+			# Nome/Razão social que aparece no campo 'Cedente' no boleto.
+			attr_accessor :razao_social
+
+			# Documento do Cedente (CPF ou CNPJ).
+			attr_accessor :cpf_cnpj
+
+			# Uma carteira de cobrança define o modo como o boleto é tratado pelo banco.
+			# Existem duas grandes divisões: carteiras não registradas e carteiras registradas.
+			#
+			# === Carteiras Não Registradas
+			#
+			# Significa que não há registro no banco sobre os boletos gerados, ou seja, você não precisa
+			# notificar o banco a cada boleto gerado.
+			# Neste caso a cobrança de taxa bancária é feita por boleto pago.
+			#
+			# === Carteiras Registradas
+			#
+			# Você precisa notificar o banco sobre todos os boletos gerados, em geral enviando um
+			# arquivo chamado "arquivo de remessa".
+			# Neste caso, normalmente existe uma taxa bancária por boleto gerado, independentemente de ele ser pago.
+			# Nestas carteiras também se encaixam serviços bancários adicionais, como protesto em caso de não pagamento.
+			#
+			# <b>Campo Obrigatório</b>
+			#
+			attr_accessor :carteira
+
+			# Modalidade da carteira
+			# Alguns bancos utilizam campos separados para definir a modalidade e a carteira
+			# porém normalmente é utilizado a nomenclatura "MODALIDADE DA CARTEIRA". Quando utilizado essa
+			# nomenclatura apenas, e não separa a carteira da modalidade, então deve se usar apenas a carteira
+			# 
+			attr_accessor :modalidade
+
+
+			# <b>Código do Convênio é o código do cliente, fornecido pelo banco.</b>
+			#
+			# Alguns bancos, dependendo do banco e da carteira, precisam desse campo preenchido.
+			# A nomenclatura para essa informação varia em cada banco, pode ser também:
+			# codigo_beneficiario OU codigo_cedente OU contrato
+			# Por isso foi criado um alias para que cada um utilize a nomenclatura que preferir.
+			attr_accessor :convenio
+			attr_accessor :convenio_dv
+			alias_attribute :codigo_cedente,         :convenio
+			alias_attribute :codigo_cedente_dv,      :convenio_dv
+			alias_attribute :codigo_beneficiario,    :convenio
+			alias_attribute :codigo_beneficiario_dv, :convenio_dv
+
+
+			# Deve ser informado o endereço completo do Cedente.
+			#
+			# <b>Campo Obrigatório</b>
+			attr_accessor :endereco			
+
+			# Número da agência. Campo auto explicativo.
+			#
+			attr_accessor :agencia
+			# Digito verificador da agência
+			attr_accessor :agencia_dv
+			
+			# Número da Conta corrente. Campo auto explicativo.
+			attr_accessor :conta_corrente
+			attr_accessor :conta_corrente_dv
+			
+
+			# Pode ser customizado o nome da conta.
+			# Se não passar nenhum valor irá pegar um nome padrão
+			# definido em cada banco
+			attr_accessor :nome_banco
+
+			###############################  VALIDAÇÕES DINÂMICAS ###############################
+				attr_accessor :valid_agencia_length
+				def valid_agencia_length; @valid_agencia_length ||= 4 end
+				validates :agencia, custom_length: {is: :valid_agencia_length}, if: :valid_agencia_length
+
+			# => Modalidade
+				attr_accessor :valid_modalidade_length
+				attr_accessor :valid_modalidade_minimum
+				attr_accessor :valid_modalidade_maximum
+				attr_accessor :valid_modalidade_required
+				attr_accessor :valid_modalidade_inclusion
+				validates :modalidade, custom_length: {is:      :valid_modalidade_length},  if: :valid_modalidade_length
+				validates :modalidade, custom_length: {minimum: :valid_modalidade_minimum}, if: :valid_modalidade_minimum
+				validates :modalidade, custom_length: {maximum: :valid_modalidade_maximum}, if: :valid_modalidade_maximum
+				validates :modalidade, presence: true, if: :valid_modalidade_required
+				validates :modalidade, custom_inclusion: {in: :valid_modalidade_inclusion}, if: :valid_modalidade_inclusion
+
+			# => CARTEIRA
+				attr_accessor :valid_carteira_length
+				attr_accessor :valid_carteira_minimum
+				attr_accessor :valid_carteira_maximum
+				attr_accessor :valid_carteira_required
+				attr_accessor :valid_carteira_inclusion
+				validates :carteira, custom_length: {is:      :valid_carteira_length},  if: :valid_carteira_length
+				validates :carteira, custom_length: {minimum: :valid_carteira_minimum}, if: :valid_carteira_minimum
+				validates :carteira, custom_length: {maximum: :valid_carteira_maximum}, if: :valid_carteira_maximum
+				validates :carteira, presence: true, if: :valid_carteira_required
+				validates :carteira, custom_inclusion: {in: :valid_carteira_inclusion}, if: :valid_carteira_inclusion
+			
+			# => CONTA CORRENTE
+				attr_accessor :valid_conta_corrente_length
+				attr_accessor :valid_conta_corrente_minimum
+				attr_accessor :valid_conta_corrente_maximum
+				attr_accessor :valid_conta_corrente_required
+				validates :conta_corrente, custom_length: {is:      :valid_conta_corrente_length},  if: :valid_conta_corrente_length
+				validates :conta_corrente, custom_length: {minimum: :valid_conta_corrente_minimum}, if: :valid_conta_corrente_minimum
+				validates :conta_corrente, custom_length: {maximum: :valid_conta_corrente_maximum}, if: :valid_conta_corrente_maximum
+				validates :conta_corrente, presence: true, if: :valid_conta_corrente_required
+
+			
+			# => CONVÊNIO / CODIGO CEDENTE / CONTRATO / CODIGO BENEFICIÁRIO
+				attr_accessor :valid_convenio_length
+				attr_accessor :valid_convenio_minimum
+				attr_accessor :valid_convenio_maximum
+				attr_accessor :valid_convenio_required
+				attr_accessor :valid_convenio_inclusion
+				alias_attribute :valid_codigo_beneficiario_length,    :valid_convenio_length
+				alias_attribute :valid_codigo_beneficiario_minimum,   :valid_convenio_minimum
+				alias_attribute :valid_codigo_beneficiario_maximum,   :valid_convenio_maximum
+				alias_attribute :valid_codigo_beneficiario_required,  :valid_convenio_required
+				alias_attribute :valid_codigo_beneficiario_inclusion, :valid_convenio_inclusion
+				alias_attribute :valid_codigo_cedente_length,         :valid_convenio_length
+				alias_attribute :valid_codigo_cedente_minimum,        :valid_convenio_minimum
+				alias_attribute :valid_codigo_cedente_maximum,        :valid_convenio_maximum
+				alias_attribute :valid_codigo_cedente_required,       :valid_convenio_required
+				alias_attribute :valid_codigo_cedente_inclusion,      :valid_convenio_inclusion
+
+				validates :convenio, custom_length: {is:      :valid_convenio_length},  if: :valid_convenio_length
+				validates :convenio, custom_length: {minimum: :valid_convenio_minimum}, if: :valid_convenio_minimum
+				validates :convenio, custom_length: {maximum: :valid_convenio_maximum}, if: :valid_convenio_maximum
+				validates :convenio, presence: true, if: :valid_convenio_required
+				validates :convenio, custom_inclusion: {in: :valid_convenio_inclusion}, if: :valid_convenio_inclusion
+			
+			# => ENDEREÇO
+				attr_accessor :valid_endereco_required
+				validates :endereco, presence: true, if: :valid_endereco_required
+			#####################################################################################
+
+			validates :agencia, :razao_social, :cpf_cnpj, presence: true
+			validates :agencia_dv, custom_length: {is: 1}
+
+			###################### FORMATAÇÂO DE VALORES CONFORME TAMANHO ########################
+				def modalidade
+					if valid_modalidade_maximum && @modalidade.present?
+						@modalidade.to_s.rjust(valid_modalidade_maximum, '0')
+					else
+						@modalidade.try(:to_s)
+					end
+				end
+				def carteira
+					if valid_carteira_maximum && @carteira.present?
+						@carteira.to_s.rjust(valid_carteira_maximum, '0')
+					else
+						@carteira.try(:to_s)
+					end
+				end
+				def conta_corrente
+					if valid_conta_corrente_maximum && @conta_corrente.present?
+						@conta_corrente.to_s.rjust(valid_conta_corrente_maximum, '0')
+					else
+						@conta_corrente.try(:to_s)
+					end
+				end
+				def convenio
+					if valid_convenio_maximum && @convenio.present?
+						@convenio.to_s.rjust(valid_convenio_maximum, '0')
+					else
+						@convenio.try(:to_s)
+					end
+				end			
+				def agencia
+					if valid_agencia_length && @agencia.present?
+						@agencia.to_s.rjust(valid_agencia_length, '0')
+					else
+						@agencia.try(:to_s)
+					end
+				end
+			#################################################################################
+
+			# Código do Banco.
+			# <b>Esse campo é específico para cada banco</b>.
+			#
+			# @return [String] Corresponde ao código do banco.
+			def codigo_banco
+				raise NotImplementedError.new("Not implemented #codigo_banco in #{self}.")
+			end
+
+			# Nome do banco.
+			def nome_banco
+				@nome_banco || raise(NotImplementedError.new("Not implemented #nome_banco in #{self}."))
+			end
+
+			# Dígito do código do banco.
+			# <b>Esse campo é específico para cada banco</b>.
+			#
+			# @return [String] Corresponde ao dígito do código do banco.
+			# @raise [NotImplementedError] Precisa implementar nas subclasses.
+			#
+			def codigo_banco_dv
+				raise NotImplementedError.new("Not implemented #codigo_banco_dv in #{self}.")
+			end
+
+			# Formata o código do banco com o dígito do código do banco.
+			# Método usado para o campo de código do banco localizado no cabeçalho do boleto.
+			#
+			# @return [String]
+			def codigo_banco_formatado
+				"#{codigo_banco}-#{codigo_banco_dv}"
+			end
+
+			# Agência, código do cedente ou nosso número.
+			# <b>Esse campo é específico para cada banco</b>.
+			#
+			# @return [String] - Corresponde aos campos "Agencia / Codigo do Cedente".
+			def agencia_codigo_cedente
+				"#{agencia} / #{codigo_cedente}"
+			end
+			
+			# Embora o padrão seja mostrar o número da carteira no boleto,
+			# <b>alguns bancos</b> requerem que seja mostrado um valor diferente na carteira.
+			# <b>Para essas exceções, sobrescreva esse método na subclasse.</b>
+			#
+			# @return [String] retorna o número da carteira
+			def carteira_formatada
+				carteira
+			end
+
+			# Utiliado para sempre retornar apenas os numero dos CPF/CNPJ
+			# EX:
+			#   self.cpf_cnpj = 074.756.887-98
+			#   puts self. cpf_cnpj
+			#      ~> '07475688798'
+			def cpf_cnpj
+				return "" unless @cpf_cnpj.present?
+				BrBoleto::Helper::CpfCnpj.new(@cpf_cnpj).sem_formatacao
+			end
+
+			# Utiliado para sempre retornar numero do CPF/CNPJ com a formatação correta
+			# EX:
+			#   self.cpf_cnpj = 07475688798
+			#   puts self.cpf_cnpj_formatado
+			#      ~> '074.756.887-98'
+			def cpf_cnpj_formatado
+				BrBoleto::Helper::CpfCnpj.new(cpf_cnpj).com_formatacao
+			end
+
+			# Retorna o cpf ou cnpj com a formatação de pontos com label
+			# EX:
+			#  'CNPJ: 12.345.678/0001-88'
+			#  'CPF:  074.345.456-83'
+			def cpf_cnpj_formatado_com_label
+				BrBoleto::Helper::CpfCnpj.new(cpf_cnpj).formatado_com_label
+			end
+
+			def tipo_cpf_cnpj(tamanho = 2)
+				BrBoleto::Helper::CpfCnpj.new(cpf_cnpj).tipo_documento(tamanho)
+			end
+
+			# Versões de layout para CNAB 240
+			def versao_layout_arquivo_cnab_240
+				raise NotImplementedError.new("Not implemented #versao_layout_arquivo_cnab_240 in #{self}.")
+			end
+			def versao_layout_lote_cnab_240
+				raise NotImplementedError.new("Not implemented #versao_layout_lote_cnab_240 in #{self}.")
+			end
+		end
+	end
+end

data/lib/br_boleto/conta/caixa.rb

@@ -0,0 +1,109 @@
+# encoding: utf-8
+module BrBoleto
+	module Conta
+		class Caixa < BrBoleto::Conta::Base
+			
+			# MODALIDADE CARTEIRA
+			#  opcoes:
+			#    11: título Registrado emissão CAIXA
+			#    14: título Registrado emissão Cedente
+			#    21: título Sem Registro emissão CAIXA
+
+			# versão do aplicativo da caixa
+			attr_accessor :versao_aplicativo
+
+			###############################  VALIDAÇÕES DINÂMICAS ###############################
+				# Versão do aplicativo
+				attr_accessor :valid_versao_aplicativo_required
+			#####################################################################################
+
+			validates :versao_aplicativo, custom_length: { maximum: 4 }
+			validates :versao_aplicativo, presence: true, if: :valid_versao_aplicativo_required
+
+			def default_values
+				super.merge({
+					carteira:                 '14', # Com registro
+					valid_carteira_required:  true,         # <- Validação dinâmica que a modalidade é obrigatória
+					valid_carteira_length:    2,            # <- Validação dinâmica que a modalidade deve ter 2 digitos
+					valid_carteira_inclusion: %w[11 14 21], # <- Validação dinâmica de valores aceitos para a modalidade
+					valid_convenio_required:  true,         # <- Validação que a convenio deve ter obrigatório
+					valid_convenio_maximum:   6,            # <- Validação que a convenio deve ter no máximo 6 digitos
+					versao_aplicativo:        '0',
+				})
+			end
+
+			def codigo_banco
+				'104'
+			end
+
+			# Dígito do código do banco descrito na documentação
+			def codigo_banco_dv
+				'0'
+			end
+
+			def nome_banco
+				@nome_banco ||= 'CAIXA ECONOMICA FEDERAL'
+			end
+
+			def versao_layout_arquivo_cnab_240
+				'050'
+			end
+
+			def versao_layout_lote_cnab_240
+				'030'
+			end
+
+			def agencia_dv
+				# utilizando a agencia com 4 digitos
+				# para calcular o digito
+				@agencia_dv ||= BrBoleto::Calculos::Modulo11FatorDe2a9RestoZero.new(agencia).to_s
+			end
+
+			def conta_corrente_dv
+				@conta_corrente_dv ||= BrBoleto::Calculos::Modulo11FatorDe2a9RestoZero.new(conta_corrente).to_s
+			end
+
+			def convenio_dv
+				@convenio_dv ||= BrBoleto::Calculos::Modulo11FatorDe2a9RestoZero.new(convenio).to_s
+			end
+
+			def versao_aplicativo
+				"#{@versao_aplicativo}".rjust(4, '0') if @versao_aplicativo.present?
+			end
+
+			# Formata a carteira dependendo se ela é registrada ou não.
+			#
+			# Para cobrança COM registro usar: <b>RG</b>
+			# Para Cobrança SEM registro usar: <b>SR</b>
+			#
+			# @return [String]
+			#
+			def carteira_formatada
+				if carteira.in?(carteiras_com_registro)
+					'RG'
+				else
+					'SR'
+				end
+			end
+
+			# Retorna as carteiras com registro da Caixa Econômica Federal.
+			# <b>Você pode sobrescrever esse método na subclasse caso exista mais
+			# carteiras com registro na Caixa Econômica Federal.</b>
+			#
+			# @return [Array]
+			#
+			def carteiras_com_registro
+				%w(14)
+			end
+
+			# Campo Agência / Código do Cedente
+			#
+			# @return [String]
+			#
+			def agencia_codigo_cedente
+				"#{agencia} / #{codigo_cedente}-#{codigo_cedente_dv}"
+			end
+
+		end
+	end
+end

data/lib/br_boleto/conta/sicoob.rb

@@ -0,0 +1,64 @@
+# encoding: utf-8
+module BrBoleto
+	module Conta
+		class Sicoob < BrBoleto::Conta::Base
+			
+			# MODALIDADE
+			# O banco siccob utiliza a combinação da carteira e modalidade para
+			# saber se é um pagamento com registro, sem registrou ou caucionada.
+			# Carteira / Modalidade  =  Tipo de pagamento
+			#    1     /    01       = Simples com Registro
+			#    1     /    02       = Simples sem Registro
+			#    3     /    03       = Garantia caicionada
+
+			def default_values
+				super.merge({
+					carteira:                '1', # Simples
+					modalidade:              '01', # Com registro
+					valid_modalidade_required:     true,         # <- Validação dinâmica que a modalidade é obrigatória
+					valid_modalidade_length:       2,            # <- Validação dinâmica que a modalidade deve ter 2 digitos
+					valid_modalidade_inclusion:    %w[01 02 03], # <- Validação dinâmica de valores aceitos para a modalidade
+					valid_carteira_required:       true,    # <- Validação dinâmica que a carteira é obrigatória
+					valid_carteira_length:         1,       # <- Validação dinâmica que a carteira deve ter 1 digito
+					valid_carteira_inclusion:      %w[1 3], # <- Validação dinâmica de valores aceitos para a carteira
+					valid_conta_corrente_required: true,    # <- Validação dinâmica que a conta_corrente é obrigatória
+					valid_conta_corrente_maximum:  8,       # <- Validação que a conta_corrente deve ter no máximo 8 digitos
+					valid_codigo_cedente_maximum:  6,       # <- Validação que a codigo_cedente/convênio deve ter no máximo 7 digitos
+				})
+			end
+
+			def codigo_banco
+				'756'
+			end
+
+			# Dígito do código do banco descrito na documentação
+			def codigo_banco_dv
+				'0'
+			end
+
+			def nome_banco
+				@nome_banco ||= 'SICOOB'
+			end
+
+			def versao_layout_arquivo_cnab_240
+				'081'
+			end
+
+			def versao_layout_lote_cnab_240
+				'040'
+			end
+
+			def agencia_dv
+				# utilizando a agencia com 4 digitos
+				# para calcular o digito
+				@agencia_dv ||= BrBoleto::Calculos::Modulo11FatorDe2a9RestoZero.new(agencia).to_s
+			end
+
+			def conta_corrente_dv
+				# utilizando a conta corrente com 5 digitos
+				# para calcular o digito
+				@conta_corrente_dv ||= BrBoleto::Calculos::Modulo11FatorDe2a9RestoZero.new(conta_corrente).to_s
+			end
+		end
+	end
+end

data/lib/br_boleto/helper/default_codes.rb

@@ -0,0 +1,33 @@
+module BrBoleto
+	module Helper
+		module DefaultCodes
+
+			# "Espécie do Título :
+			def get_especie_titulo(code)
+				"#{code}".adjust_size_to(2, '0', :right)
+				equivalent_especie_titulo[code] || '99'
+			end
+			def equivalent_especie_titulo
+				{
+					'01' => '01', #  Duplicata Mercantil
+					'02' => '02', #  Nota Promissória
+					'03' => '03', #  Nota de Seguro
+					'05' => '05', #  Recibo
+					'06' => '06', #  Duplicata Rural
+					'08' => '08', #  Letra de Câmbio
+					'09' => '09', #  Warrant
+					'10' => '10', #  Cheque
+					'12' => '12', #  Duplicata de Serviço
+					'13' => '13', #  Nota de Débito
+					'14' => '14', #  Triplicata Mercantil
+					'15' => '15', #  Triplicata de Serviço
+					'18' => '18', #  Fatura
+					'20' => '20', #  Apólice de Seguro
+					'21' => '21', #  Mensalidade Escolar
+					'22' => '22', #  Parcela de Consórcio
+					'99' => '99', #  Outros"
+				}
+			end
+		end
+	end
+end

data/lib/br_boleto/helper/format_value.rb

@@ -11,6 +11,7 @@ module BrBoleto
 
 			def string_to_date(value, format = "%d%m%Y")
 				return value if value.is_a?(Date)
+				format = '%d%m%y' if value.strip.size == 6
 				begin Date.strptime(value, format) rescue nil end
 			end			
 		end

data/lib/br_boleto/helper/number.rb

@@ -10,6 +10,36 @@ module BrBoleto
 				sprintf('%.2f', @numero).delete('.').rjust(size, '0')
 			end
 
+			# Formata o valor percentual.
+			# Exemplos:
+			#   1 - 
+			#    @numero = 2.5 (%)
+			#    formata_valor_percentual(6)
+			#    Resultado:  025000
+			#   2 - 
+			#    @numero = 12.34 (%)
+			#    formata_valor_percentual(4)
+			#    Resultado:  1234
+			#
+			def formata_valor_percentual(size=6)
+				return ''.rjust(size, '0') if @numero.blank?
+				if @numero >= 10
+					sprintf("%.#{size-2}f", @numero).delete('.').adjust_size_to(size, '0')
+				else
+					sprintf("0%.#{size-2}f", @numero).delete('.').adjust_size_to(size, '0')
+				end
+			end
+
+			# Retorna o percentual que o @numero representa do total
+			# Exemplo:
+			#   @numero = 407.5
+			#   get_percent_by_total(4750.68, precision=2)
+			#   Resultado =>  8.58 %
+			# Ou seja, R$ 407.5 Representa uma fatia de 8.58% de R$ 4750.68
+			def get_percent_by_total(total, precision=6)
+				(@numero.to_f*100.0/total.to_f).round(precision.to_i)
+			end
+
 		end
 	end
 end

data/lib/br_boleto/pagador.rb

@@ -0,0 +1,82 @@
+# encoding: utf-8
+module BrBoleto
+	class Pagador < BrBoleto::ActiveModelBase
+		attr_accessor :nome
+		attr_accessor :cpf_cnpj
+		attr_accessor :endereco
+		attr_accessor :bairro
+		attr_accessor :cep
+		attr_accessor :cidade
+		attr_accessor :uf
+
+		attr_accessor :nome_avalista
+		attr_accessor :documento_avalista
+
+		###################### CUSTOM VALIDATIONS #################
+		attr_accessor :valid_endereco_required
+		validates :endereco, :bairro, :cep, :cidade, :uf, presence: true, if: :valid_endereco_required
+		###########################################################
+
+		validates :nome, :cpf_cnpj, presence: true
+
+		def endereco_formatado
+			addr = []
+			addr << endereco unless endereco.blank?
+			addr << bairro   unless bairro.blank?
+			addr << @cep     unless cep.blank?
+			addr << "#{cidade}-#{uf}" unless cidade.blank?
+			addr.join(' - ')
+		end
+
+		def cep
+			"#{@cep}".only_numbers
+		end
+
+		def cpf_cnpj
+			BrBoleto::Helper::CpfCnpj.new(@cpf_cnpj).sem_formatacao
+		end
+		
+		def tipo_cpf_cnpj(tamanho = 2)
+			BrBoleto::Helper::CpfCnpj.new(cpf_cnpj).tipo_documento(tamanho)
+		end
+		# Utiliado para sempre retornar numero do CPF/CNPJ com a formatação correta
+		# EX:
+		#   self.cpf_cnpj = 07475688798
+		#   puts self.cpf_cnpj_formatado
+		#      ~> '074.756.887-98'
+		def cpf_cnpj_formatado
+			BrBoleto::Helper::CpfCnpj.new(cpf_cnpj).com_formatacao
+		end
+
+		# Retorna o cpf ou cnpj com a formatação de pontos com label
+		# EX:
+		#  'CNPJ: 12.345.678/0001-88'
+		#  'CPF:  074.345.456-83'
+		def cpf_cnpj_formatado_com_label
+			BrBoleto::Helper::CpfCnpj.new(cpf_cnpj).formatado_com_label
+		end
+
+		def tipo_documento_avalista(tamanho = 2)
+			BrBoleto::Helper::CpfCnpj.new(documento_avalista).tipo_documento(tamanho)
+		end
+		def documento_avalista
+			BrBoleto::Helper::CpfCnpj.new(@documento_avalista).sem_formatacao
+		end
+		# Utiliado para sempre retornar numero do CPF/CNPJ com a formatação correta
+		# EX:
+		#   self.documento_avalista = 07475688798
+		#   puts self.documento_avalista_formatado
+		#      ~> '074.756.887-98'
+		def documento_avalista_formatado
+			BrBoleto::Helper::CpfCnpj.new(documento_avalista).com_formatacao
+		end
+
+		# Retorna o cpf ou cnpj com a formatação de pontos com label
+		# EX:
+		#  'CNPJ: 12.345.678/0001-88'
+		#  'CPF:  074.345.456-83'
+		def documento_avalista_formatado_com_label
+			BrBoleto::Helper::CpfCnpj.new(documento_avalista).formatado_com_label
+		end
+	end
+end