br_boleto 0.1.0 → 1.0.0

data/lib/br_boleto/boleto/sicoob.rb

@@ -0,0 +1,211 @@
+# encoding: utf-8
+module BrBoleto
+	module Boleto
+		# 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.
+		#
+		class Sicoob < Base
+			# === Carteira/Modalidade:
+			#
+			#   '1/01' - Simples com registro
+			#   '1/02' - Simples sem registro
+			#   '3/03' - Garantida Caucionada
+			#
+			attr_accessor :modalidade_cobranca
+
+			def modalidade_cobranca
+				if @modalidade_cobranca.present?
+					@modalidade_cobranca.to_s.rjust(2, '0')
+				else
+					'01'
+				end
+			end
+
+			#Modalidades de cobranças válidas conforme a documentação
+			def self.modalidade_cobranca_validas
+				%{'01' '02' '03'}
+			end
+
+			def deve_validar_modalidade_cobranca?
+				true
+			end
+
+			# Quantidade de parcelas que o boleto possui
+			# Liberando a possibilidade de edição
+			attr_accessor :parcelas
+			def parcelas
+				if @parcelas.present?
+					@parcelas.to_s.rjust(3, '0')
+				else
+					'001'
+				end
+			end
+
+
+			# 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
+				7
+			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 3]
+			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 < BrBoleto::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?
+			validates :modalidade_cobranca, inclusion: { in: ->(object) { object.class.modalidade_cobranca_validas } }, if: :deve_validar_modalidade_cobranca?
+
+			# @return [String] 4 caracteres
+			#
+			def agencia
+				@agencia.to_s.rjust(4, '0') if @agencia.present?
+			end
+
+			# @return [String] 7 caracteres
+			# O Código do cedente é o mesmo que o codigo do beneficiário
+			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(7, '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 numero do documento mais o digito
+			# verificador no nosso_numero, que é um cálculo descrito na documentação.
+			#
+			# @return [String]
+			#
+			def nosso_numero
+				"#{numero_documento}-#{digito_verificador_nosso_numero}"
+			end
+
+			# Tipo de cobrança
+			# Ex: :com_registro, :sem_registro, :garantia_caucionada
+			#
+			# Obs: O VALOR DESSE METODO NÃO INFLUÊNCIA NA GERAÇÃO DO BOLETO
+			# É APENAS PARA QUESTÃO DE INFORMAÇÃO CASO PRECISE PARA OUTRAS COISAS.
+			#
+			def tipo_cobranca
+				case "#{modalidade_cobranca}".rjust(2, "0")
+				when '01'
+					:com_registro
+				when '02'
+					:sem_registro
+				when '03'
+					:garantia_caucionada
+				end
+			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.gsub('-','')}#{parcelas}"
+			end
+
+			def digito_verificador_nosso_numero
+				BrBoleto::Calculos::Modulo11Fator3197.new("#{agencia}#{codigo_cedente.rjust(10, '0')}#{numero_documento}")
+			end
+		end
+	end
+end

data/lib/br_boleto/calculos/modulo11_fator3197.rb

@@ -49,19 +49,19 @@ module BrBoleto
     #
     # @example
     #
-    #    BrBoleto::Calculos::Modulo11FatorDe2a7.new('20')
+    #    BrBoleto::Calculos::Modulo11Fator3197.new('20')
     #    # => '5'
     #
-    #    BrBoleto::Calculos::Modulo11FatorDe2a7.new('64')
+    #    BrBoleto::Calculos::Modulo11Fator3197.new('64')
     #    # => '7'
     #
-    #    BrBoleto::Calculos::Modulo11FatorDe2a7.new('26')
+    #    BrBoleto::Calculos::Modulo11Fator3197.new('26')
     #    # => '4'
     #
-    #    BrBoleto::Calculos::Modulo11FatorDe2a7.new('6')
+    #    BrBoleto::Calculos::Modulo11Fator3197.new('6')
     #    # => 'P'
     #
-    #    BrBoleto::Calculos::Modulo11FatorDe2a7.new('14')
+    #    BrBoleto::Calculos::Modulo11Fator3197.new('14')
     #    # => '0'
     #
     class Modulo11Fator3197 < Modulo11

data/lib/br_boleto/helper/cpf_cnpj.rb

@@ -0,0 +1,60 @@
+module BrBoleto
+	module Helper
+		class CpfCnpj
+			
+			def initialize(cpf_cnpj)
+				@cpf_cnpj = ajusta_cpf_cnpj_com_zero("#{cpf_cnpj}")
+			end
+
+			def cpf?
+				cpf_ou_cnpj? == :cpf
+			end
+
+			def cnpj?
+				cpf_ou_cnpj? == :cnpj				
+			end
+
+			def cpf_ou_cnpj?
+				@cpf_cnpj.size > 11 ? :cnpj : :cpf
+			end
+
+			def tipo_documento(tamanho = 2)
+				return '0' if sem_formatacao.blank?
+				sem_formatacao.size < 14 ? '1'.rjust(tamanho, '0') : '2'.rjust(tamanho, '0')
+			end
+
+			def sem_formatacao
+				@cpf_cnpj.gsub(/[\.]|[\-]|[\/]/,'')
+			end
+
+			def com_formatacao
+				cnpj? ? formata_cnpj : formata_cpf
+			end
+
+			def formatado_com_label
+				cnpj? ? "CNPJ #{formata_cnpj}" : "CPF #{formata_cpf}"
+			end
+
+		private
+
+			def ajusta_cpf_cnpj_com_zero(value)
+				return "" if value.blank?
+				if value.to_s.size <= 11
+					value.to_s.rjust(11, '0')
+				else
+					value.to_s.rjust(14, '0')
+				end
+			end
+			
+			def formata_cpf
+				@cpf_cnpj.gsub!(/[\.]|[\-]|[\/]/,'')
+				"#{@cpf_cnpj[0..2]}.#{@cpf_cnpj[3..5]}.#{@cpf_cnpj[6..8]}-#{@cpf_cnpj[9..10]}"
+			end
+
+			def formata_cnpj
+				@cpf_cnpj.gsub!(/[\.]|[\-]|[\/]/,'')
+				"#{@cpf_cnpj[0..1]}.#{@cpf_cnpj[2..4]}.#{@cpf_cnpj[5..7]}/#{@cpf_cnpj[8..11]}-#{@cpf_cnpj[12..13]}"
+			end
+		end
+	end
+end

data/lib/br_boleto/helper/number.rb

@@ -0,0 +1,15 @@
+module BrBoleto
+	module Helper
+		class Number
+			def initialize(numero)
+				@numero = numero
+			end
+
+			def formata_valor_monetario(size=13)
+				return ''.rjust(size, '0') if @numero.blank?
+				sprintf('%.2f', @numero).delete('.').rjust(size, '0')
+			end
+
+		end
+	end
+end

data/lib/br_boleto/remessa/base.rb

@@ -0,0 +1,89 @@
+module BrBoleto
+	module Remessa
+		class Base
+			# Seguindo a interface do Active Model para:
+			# * Validações;
+			# * Internacionalização;
+			# * Nomes das classes para serem manipuladas;
+			#
+			include ActiveModel::Model
+
+			# variavel que terá os lotes no qual será gerado o arquivo de remessa
+			# um lote deve conter no minimo 1 pagamento
+			# Pode haver 1 ou vários lotes para o mesmo arquivo
+			attr_accessor :lotes
+
+			def self.class_for_lote
+				BrBoleto::Remessa::Lote
+			end
+
+			# Razão social da empresa
+			attr_accessor :nome_empresa
+
+			# agencia (sem digito verificador)
+			attr_accessor :agencia
+
+			# numero da conta corrente
+			attr_accessor :conta_corrente
+
+			# digito verificador da conta corrente
+			attr_accessor :digito_conta
+
+			# carteira do cedente
+			attr_accessor :carteira
+
+			# sequencial remessa (num. sequencial que nao pode ser repetido nem zerado)
+			attr_accessor :sequencial_remessa
+
+			# aceite (A = ACEITO/N = NAO ACEITO)
+			attr_accessor :aceite
+
+			def initialize(attributes = {})
+				self.lotes = [] # Para poder utilizar o << para adicionar lote
+				attributes = default_values.merge!(attributes)
+				assign_attributes(attributes)
+				yield self if block_given?
+			end
+
+			def assign_attributes(attributes)
+				attributes ||= {}
+				attributes.each do |name, value|
+					send("#{name}=", value)
+				end
+			end
+
+			validates :nome_empresa, presence: true
+			validates :aceite,       inclusion: { in: %w(A a n N), message: "valor deve ser A(aceito) ou N(não ceito)" }
+
+			validates_each :lotes do |record, attr, value|
+				record.errors.add(attr, 'não pode estar vazio.') if value.empty?
+				value.each do |lote|
+					if lote.is_a? record.class.class_for_lote
+						if lote.invalid?
+							lote.errors.full_messages.each { |msg| record.errors.add(attr, msg) }
+						end
+					else
+						record.errors.add(attr, 'cada item deve ser um objeto Lote.')
+					end
+				end				
+			end
+
+			# O atributo lotes sempre irá retornar umm Array 
+			def lotes
+				@lotes = [@lotes].flatten
+			end
+
+			def default_values
+				{aceite: "N"}
+			end
+
+			def persisted?
+				false
+			end
+
+			def nome_empresa_formatada
+				"#{nome_empresa}".adjust_size_to(30)
+			end			
+		end
+	end
+end

data/lib/br_boleto/remessa/cnab240/base.rb

@@ -0,0 +1,328 @@
+# -*- encoding: utf-8 -*-
+require 'br_boleto/remessa/cnab240/helper/header_arquivo'
+require 'br_boleto/remessa/cnab240/helper/header_lote'
+require 'br_boleto/remessa/cnab240/helper/segmento_p'
+require 'br_boleto/remessa/cnab240/helper/segmento_q'
+require 'br_boleto/remessa/cnab240/helper/segmento_r'
+require 'br_boleto/remessa/cnab240/helper/segmento_s'
+require 'br_boleto/remessa/cnab240/helper/trailer_lote'
+require 'br_boleto/remessa/cnab240/helper/trailer_arquivo'
+
+module BrBoleto
+	module Remessa
+		module Cnab240
+			class Base < BrBoleto::Remessa::Base
+				
+				# Utilizado para montar o header do arquivo
+				include BrBoleto::Remessa::Cnab240::Helper::HeaderArquivo
+				
+				# Utilizado para montar o header do lote
+				include BrBoleto::Remessa::Cnab240::Helper::HeaderLote
+
+				# Utilizado para montar o segmento P
+				include BrBoleto::Remessa::Cnab240::Helper::SegmentoP
+
+				# Utilizado para montar o segmento Q
+				include BrBoleto::Remessa::Cnab240::Helper::SegmentoQ
+
+				# Utilizado para montar o segmento R
+				include BrBoleto::Remessa::Cnab240::Helper::SegmentoR
+
+				# Utilizado para montar o segmento S
+				include BrBoleto::Remessa::Cnab240::Helper::SegmentoS
+
+				# Utilizado para montar o trailer do lote
+				include BrBoleto::Remessa::Cnab240::Helper::TrailerLote
+
+				# Utilizado para montar o trailer do arquivo
+				include BrBoleto::Remessa::Cnab240::Helper::TrailerArquivo
+
+				# documento do cedente (CPF/CNPJ)
+				attr_accessor :documento_cedente
+
+				# convenio do cedente
+				attr_accessor :convenio
+
+				# mensagem 1
+				attr_accessor :mensagem_1
+
+				# mensagem 2
+				attr_accessor :mensagem_2
+
+				# Data e hora da geração do arquivo
+				attr_accessor :data_hora_arquivo
+
+				# codigo da carteira
+				#   opcoes:
+				#     1 - cobranca simples
+				#     2 - cobranca caucionada
+				#     3 - cobranca descontada
+				#     7 – modalidade Simples quando carteira 17 (apenas Banco do Brasil)
+				attr_accessor :codigo_carteira
+
+				# forma de cadastramento dos titulos (campo nao tratado pelo Banco do Brasil)
+				#   opcoes:
+				#     1 - com cadastramento (cobrança registrada)
+				#     2 - sem cadastramento (cobrança sem registro)
+				attr_accessor :forma_cadastramento
+
+				# identificacao da emissao do boleto (verificar opcoes nas classes referentes aos bancos)
+				attr_accessor :emissao_boleto
+
+				# identificacao da distribuicao do boleto (verificar opcoes nas classes referentes aos bancos)
+				attr_accessor :distribuicao_boleto
+
+				# especie do titulo (verificar o padrao nas classes referentes aos bancos)
+				attr_accessor :especie_titulo
+
+				
+				def self.tamanho_codigo_carteira
+					1
+				end
+
+				def self.tamanho_forma_cadastramento
+					1
+				end
+
+				def self.tamanho_emissao_boleto
+					1
+				end
+
+				def self.tamanho_distribuicao_boleto
+					1
+				end
+
+				def self.tamanho_especie_titulo
+					2
+				end
+
+				def convenio_obrigatorio?
+					true
+				end
+
+				validates :convenio,          presence: true, if: :convenio_obrigatorio?
+				validates :documento_cedente, presence: true
+
+				validates :codigo_carteira,     length: {is: tamanho_codigo_carteira,     message: "deve ter #{tamanho_codigo_carteira} dígito."}
+				validates :forma_cadastramento, length: {is: tamanho_forma_cadastramento, message: "deve ter #{tamanho_forma_cadastramento} dígito."}
+				validates :emissao_boleto,      length: {is: tamanho_emissao_boleto,      message: "deve ter #{tamanho_emissao_boleto} dígito."}
+				validates :distribuicao_boleto, length: {is: tamanho_distribuicao_boleto, message: "deve ter #{tamanho_distribuicao_boleto} dígito."}
+				validates :especie_titulo,      length: {is: tamanho_especie_titulo,      message: "deve ter #{tamanho_especie_titulo} dígitos."}
+
+				def default_values
+					super.merge({
+						codigo_carteira:     '1',
+						forma_cadastramento: '1'
+					})
+				end
+
+				# Tipo de inscricao do cedente
+				# (pessoa fisica ou juridica)
+				#
+				# @return [String]
+				#
+				def tipo_inscricao
+					# Retorna 1 se CPF e 2 se CNPJ
+					BrBoleto::Helper::CpfCnpj.new(documento_cedente).tipo_documento(1)
+				end
+
+				# Data de geracao do arquivo
+				#
+				# @return [String]
+				#
+				def data_geracao
+					data_hora_arquivo.to_date.strftime('%d%m%Y')
+				end
+
+				# Hora de geracao do arquivo
+				#
+				# @return [String]
+				#
+				def hora_geracao
+					data_hora_arquivo.strftime('%H%M%S')
+				end
+				
+				def data_hora_arquivo
+					@data_hora_arquivo.to_time
+				rescue
+					return Time.now
+				end
+
+				# Monta um lote para o arquivo
+				#
+				# @param lote [BrBoleto::Remessa::Lote]
+				#   objeto contendo os detalhes do boleto (valor, )
+				#
+				# @param nro_lote [Integer]
+				# numero do lote no arquivo
+				#
+				# @return [Array]
+				#
+				def monta_lote(lote, nro_lote)
+					return if lote.invalid?
+
+
+					# Metodo 'monta_header_lote' implementado no module -> BrBoleto::Remessa::Cnab240::Helper::HeaderLote
+					itens_lote = [monta_header_lote(lote, nro_lote)]
+					
+					#Nº Sequencial de Registros no Lote:
+					sequencial_do_lote = 0
+
+					lote.pagamentos.each do |pagamento|					
+						# Metodo 'monta_segmento_p' implementado no module -> BrBoleto::Remessa::Cnab240::Helper::SegmentoP
+						sequencial_do_lote += 1
+						itens_lote << monta_segmento_p(pagamento, nro_lote, sequencial_do_lote)
+						
+						# Metodo 'monta_segmento_q' implementado no module -> BrBoleto::Remessa::Cnab240::Helper::SegmentoQ
+						sequencial_do_lote += 1
+						itens_lote << monta_segmento_q(pagamento, nro_lote, sequencial_do_lote)
+
+						# Metodo 'monta_segmento_r' implementado no module -> BrBoleto::Remessa::Cnab240::Helper::SegmentoR
+						sequencial_do_lote += 1
+						itens_lote << monta_segmento_r(pagamento, nro_lote, sequencial_do_lote)
+
+						# Metodo 'monta_segmento_s' implementado no module -> BrBoleto::Remessa::Cnab240::Helper::SegmentoS
+						sequencial_do_lote += 1
+						itens_lote << monta_segmento_s(pagamento, nro_lote, sequencial_do_lote)
+					end
+					
+					# total_de_registros_do_lote é a quantidade de registros(linhas) que constam em um lote
+					# Total de complementos do lote + o HEADER_LOTE + TRAILER_LOTE
+					#        sequencial_do_lote     +       1       +      1  
+					total_de_registros_do_lote = sequencial_do_lote + 2
+
+					# Metodo 'monta_trailer_lote' implementado no module -> BrBoleto::Remessa::Cnab240::Helper::TrailerLote
+					itens_lote << monta_trailer_lote(lote, nro_lote, total_de_registros_do_lote)
+
+					itens_lote
+				end
+
+				# Gera os dados para o arquivo remessa
+				#
+				# @return [String]
+				#
+				def dados_do_arquivo
+					return if self.invalid?
+
+					# contador dos registros do lote
+					contador = 1
+
+					# Metodo 'monta_header_arquivo' implementado no module -> BrBoleto::Remessa::Cnab240::Helper::HeaderArquivo
+					arquivo = [monta_header_arquivo] 
+					contador += 1
+
+					lotes.each_with_index do |lote, index|
+						novo_lote = monta_lote(lote, (index + 1))
+						arquivo.push novo_lote
+						novo_lote.each { |_lote| contador += 1 }
+					end
+
+					# Metodo 'monta_trailer_arquivo' implementado no module -> BrBoleto::Remessa::Cnab240::Helper::TrailerArquivo
+					arquivo << monta_trailer_arquivo(lotes.count, contador)
+
+					retorno = arquivo.join("\n")
+					ActiveSupport::Inflector.transliterate(retorno).upcase
+				end
+
+				# Número do Documento de Cobrança 
+				# Cada banco tem sua maneira de identificar esse número, mas o padrão é o
+				# Valor que se encontra no nosso numero
+				# 15 posições
+				#
+				def segmento_p_numero_do_documento(pagamento)
+					pagamento.nosso_numero.to_s.rjust(15, '0')
+				end
+
+				# Complemento do registro
+				#
+				# Este metodo deve ser sobrescrevido na classe do banco
+				#
+				def complemento_header
+					raise NotImplementedError.new('Sobreescreva este método na classe referente ao banco que você esta criando')
+				end
+
+				# Numero da versao do layout do arquivo
+				#
+				# Este metodo deve ser sobrescrevido na classe do banco
+				#
+				def versao_layout_arquivo
+					raise NotImplementedError.new('Sobreescreva este método na classe referente ao banco que você esta criando')
+				end
+
+				# Numero da versao do layout do lote
+				#
+				# Este metodo deve ser sobrescrevido na classe do banco
+				#
+				def versao_layout_lote
+					raise NotImplementedError.new('Sobreescreva este método na classe referente ao banco que você esta criando')
+				end
+
+				# Informacoes do convenio para o lote
+				#
+				# Este metodo deve ser sobrescrevido na classe do banco
+				#
+				def convenio_lote(lote)
+					raise NotImplementedError.new('Sobreescreva este método na classe referente ao banco que você esta criando')
+				end
+
+				# Nome do banco
+				#
+				# Este metodo deve ser sobrescrevido na classe do banco
+				#
+				def nome_banco
+					raise NotImplementedError.new('Sobreescreva este método na classe referente ao banco que você esta criando')
+				end
+
+				# Codigo do banco
+				#
+				# Este metodo deve ser sobrescrevido na classe do banco
+				#
+				def codigo_banco
+					raise NotImplementedError.new('Sobreescreva este método na classe referente ao banco que você esta criando')
+				end
+
+				# Informacoes da conta do cedente
+				#
+				# Este metodo deve ser sobrescrevido na classe do banco
+				#
+				def informacoes_da_conta
+					raise NotImplementedError.new('Sobreescreva este método na classe referente ao banco que você esta criando')
+				end
+
+				# Codigo do convenio
+				#
+				# Este metodo deve ser sobrescrevido na classe do banco
+				#
+				def codigo_convenio
+					raise NotImplementedError.new('Sobreescreva este método na classe referente ao banco que você esta criando')
+				end
+
+				# Digito verificado da agência
+				# Normalmente calculado pelo Modulo 11
+				# Deve ser sobrescrito na classe do banco
+				#
+				def digito_agencia
+					raise NotImplementedError.new('Sobreescreva este método na classe referente ao banco que você esta criando')
+				end
+
+				# Complemento do segmento P
+				# Recebe um objeto da classe BrBoleto::Remessa::Pagamento
+				# Composto por 34 digitos
+				# Cada banco tem seu padrão
+				# Deve ser sobrescrito na classe do banco
+				#
+				def complemento_p(pagamento)
+					raise NotImplementedError.new('Sobreescreva este método na classe referente ao banco que você esta criando')
+				end
+
+				# Complemento final do trailer do lote
+				# Por padrão coloco 217 caracateres em branco pois é na maioria dos bancos
+				# Mas para alguns bancos isso pode mudar
+				#
+				def complemento_trailer_lote(lote, nr_lote)
+					''.rjust(217, ' ')	
+				end
+			end
+		end
+	end
+end