br_boleto 2.2.2 → 2.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 14b335d2c150038b7a73ea02c1f1252a7150d5a8
-  data.tar.gz: bac0af9ca5150fcc722a97fecf0f3a2267fbed2f
+  metadata.gz: eb0e64f3266b753466757dc9edab8bbcf595c95b
+  data.tar.gz: 32673e61506c6363f45110cbc12fe1c42b080cd4
 SHA512:
-  metadata.gz: f2c8e7cdeaf637e77ea5e6be9b6943e17063e1dc2d19a0e97fc821546a420b27f9950d8859312096f6920946d5aee23c213c09f933867dbe40f65d3d863c805f
-  data.tar.gz: 60d71d69791148d46d2004b2d6c33b244bb1009ae5c58939c9a751c15c725e223c6198fdd7f56689133a46edb948a14aa124c2964253b35b4ba5839f0728211b
+  metadata.gz: 2845f01fd1c0c3e52eba462083925e6070c1d4dbb4e9f788edb40ec92e45a7a3fb2e02cea0b86438106de4a8b8ee5334d371c6120c1f0d49571bb3810335a8bc
+  data.tar.gz: e8974384f70e3b42758900906696bec80f79102aefb73c8c02b2163acd6f11fecc27762cce020d184e6044eeff7afc4171c330ea2fa0ffca737ea187f8f599bd

data/lib/br_boleto/boleto/base.rb

@@ -176,6 +176,29 @@ module BrBoleto
 				raise NotImplementedError.new("Not implemented #nosso_numero in #{self}.")
 			end
 
+			# Esse método deve ser utilizado para salvar o nosso número que 
+			# será retornado no arquivo de retorno.
+			# Foi necessário fazer esse método pois alguns bancos como o
+			# Bradesco e Itaú desconsideram o número da carteira no retorno,
+			# porém a carteira deve ser apresentada no boleto.
+			# Com o bjetivo de facilitar o desenvolvimento para não fazer essa
+			# regra da aplicação, foi desenvolvido esse método para que seja
+			# salvo o valor desse método na aplicação para que posteriormente
+			# a conciliação dos boletos funcione adecuadamente.
+			#
+			# Por padrão retorna os núemros e letras do nosso número, na qual
+			# é utilizada para a maioria dos bancos.
+			# Deve ser sobrescrito para os bancos que utilizam de forma diferente.
+			#
+			# O retorno é uma string pois em alguns bancos o DV do nosso número
+			# pode ser uma Letra.
+			# 
+			# @return [String] 999999999 OR 999999999X
+			#
+			def nosso_numero_retorno
+				"#{nosso_numero}".gsub(/[^\w\d]/i, '')
+			end
+
 			# Formata o valor do documentado para ser mostrado no código de barras
 			# e na linha digitável com 08 dígitos na casa dos Reais e 02 dígitos nas casas dos centavos.
 			#

data/lib/br_boleto/boleto/bradesco.rb

@@ -52,6 +52,12 @@ module BrBoleto
 				"#{conta.carteira}/#{numero_documento}-#{digito_verificador_nosso_numero}"
 			end
 
+			# No arquivo de retorno a carteira não vem junto com o nosso núemro
+			#
+			def nosso_numero_retorno
+				"#{nosso_numero}".gsub(/[^\w\d]/i, '')[2..-1]
+			end
+
 			# Para o cálculo do dígito, será necessário acrescentar o número da carteira à esquerda
 			# antes do Nosso Número (número do documento), e aplicar o módulo 11, com fatores de 2 a 7.
 			# @return [String] Retorno do cálculo do módulo 11 na base 7 (2,3,4,5,6,7)

data/lib/br_boleto/boleto/itau.rb

@@ -51,6 +51,12 @@ module BrBoleto
 			def nosso_numero
 				"#{conta.carteira}/#{numero_documento}-#{digito_verificador_nosso_numero}"
 			end
+			
+			# No arquivo de retorno a carteira não vem junto com o nosso núemro
+			#
+			def nosso_numero_retorno
+				"#{nosso_numero}".gsub(/[^\w\d]/i, '')[3..-1]
+			end
 
 			# 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.

data/lib/br_boleto/version.rb

@@ -2,7 +2,7 @@ module BrBoleto
 	module Version
 		MAJOR = 2 #inclui alterações de API e pode quebrar compatibilidade com versões anteriores
 		MINOR = 2 #inclui novas funcionalidades, sem quebrar APIs existentes
-		PATCH = 2 #corrige bugs ou traz melhorias em implementações já existentes
+		PATCH = 3 #corrige bugs ou traz melhorias em implementações já existentes
 		CURRENT = "#{MAJOR}.#{MINOR}.#{PATCH}"
 	end
 end

data/test/br_boleto/boleto/base_test.rb

@@ -240,4 +240,11 @@ describe BrBoleto::Boleto::Base do
 			subject.codigo_de_barras_do_banco
 		end
 	end
+
+	describe '#nosso_numero_retorno' do
+		it "deve retornar os números e letras encontrados no nosso_numero" do
+			subject.expects(:nosso_numero).returns(' 01/200000000365-X')
+			subject.nosso_numero_retorno.must_equal '01200000000365X'
+		end
+	end
 end

data/test/br_boleto/boleto/bradesco_test.rb

@@ -65,6 +65,13 @@ describe BrBoleto::Boleto::Bradesco do
 		end
 	end
 
+	describe '#nosso_numero_retorno' do
+		it "deve pegar o valor do nosso_numero desconsiderando a carteira" do
+			subject.expects(:nosso_numero).returns('21/00000003646-9')
+			subject.nosso_numero_retorno.must_equal '000000036469'
+		end
+	end
+
 	describe "#codigo_de_barras_do_banco" do
 		subject do 
 			FactoryGirl.build(:boleto_bradesco, conta: {

data/test/br_boleto/boleto/itau_test.rb

@@ -73,6 +73,13 @@ describe BrBoleto::Boleto::Itau do
 		end
 	end
 
+	describe '#nosso_numero_retorno' do
+		it "deve pegar o valor do nosso_numero desconsiderando a carteira" do
+			subject.expects(:nosso_numero).returns('109/00003646-9')
+			subject.nosso_numero_retorno.must_equal '000036469'
+		end
+	end
+
 	describe "#codigo_de_barras_do_banco (com as carteiras especiais de cobrança 107, 122, 142, 143, 196 e 198)" do
 		subject do 
 			FactoryGirl.build(:boleto_itau, conta: {

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: br_boleto
 version: !ruby/object:Gem::Version
-  version: 2.2.2
+  version: 2.2.3
 platform: ruby
 authors:
 - Bruno M. Mergen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-17 00:00:00.000000000 Z
+date: 2017-01-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake