br_boleto 2.1.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 020fd56f017584d8546fcf0cca4b7c5303fa9a3e
-  data.tar.gz: 2c646b4f9b5e04dddd16a3887e35e0a0c01e4324
+  metadata.gz: 9e63b6bade6f42bb9fa2642ddd95632c7d9d0b57
+  data.tar.gz: 8624d1e332aad837ebb4d099fcc9e72211375f56
 SHA512:
-  metadata.gz: 4c2d14b4e5d366fb891681d90d841cf91e2b03101da60faad9932b1b39ee5384d79cd79a125a96f5511f88ca845c25ff9e719bc4e950aef443fd5a6cd4e832e1
-  data.tar.gz: e574dbdf4449c629f57248932a082199c03cc30bf4de4bd59452c86f08987fa9e5252574978c39405ecb07e7e4b6e3272d73b30c83eff364e8d5048e60a77e24
+  metadata.gz: 670443799e6482b64e9bd57426d0446f0efe503c3676714f43f1701742b68f963f4d039749cd2374a413ee073566d031a61648540a25febfb2d280cc03111aa0
+  data.tar.gz: 3ee9191d6629c296623abc1506e365122ca7052f07e58d60e09dc123285cd4bf6fbd604c2fa359b42c58fdd14190957aef7b8c5117dcc70e83f8326210018c53

data/.travis.yml

@@ -1,3 +1,4 @@
 language: ruby
 rvm:
+  - 2.2.0
   - 2.3.0

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    br_boleto (2.1.0)
+    br_boleto (2.2.0)
       activemodel (~> 4.2)
       activesupport (~> 4.2)
       rake (>= 0.8.7)

data/README.markdown

@@ -9,14 +9,35 @@ Emissão de Boletos Bancários em Ruby.
 **O que essa gem faz?**
 
  1. Boleto bancário (apenas os cálculos para o boleto, sem a interface) para os bancos:
-- Sicoob 
-- Caixa (em andamento)
+- Banco do Brasil (em andamento)
+- Bradesco (em andamento)
+- Caixa
+- Cecred
+- Itaú (em andamento)
+- Santander (em andamento)
+- Sicoob
+- Sicredi
+- Unicred
  2. Arquivo de remessa para os Bancos:
-- Sicoob (CNAB 240 e CNAB400)
-- Caixa  (CNAB 240)
+- Banco do Brasil (CNAB240 e CNAB400)
+- Bradesco (CNAB240 e CNAB400)
+- Caixa (CNAB240)
+- Cecred (CNAB240)
+- Itaú (CNAB240 e CNAB400)
+- Santander (CNAB240 e CNAB400)
+- Sicoob (CNAB240 e CNAB400)
+- Sicredi (CNAB240 e CNAB400)
+- Unicred (CNAB240 e CNAB400)
  3. Arquivo de retorno para os Bancos:
-- Sicoob (CNAB 240 e CNAB400)
-- Caixa  (CNAB 240)
+- Banco do Brasil (CNAB240 e CNAB400)
+- Bradesco (CNAB240 e CNAB400)
+- Caixa (CNAB240)
+- Cecred (CNAB240)
+- Itaú (CNAB240 e CNAB400)
+- Santander (CNAB240 e CNAB400)
+- Sicoob (CNAB240 e CNAB400)
+- Sicredi (CNAB240 e CNAB400)
+- Unicred (CNAB240 e CNAB400)
 
 
 
@@ -33,7 +54,15 @@ Emissão de Boletos Bancários em Ruby.
 
 Seguimos as documentações descritas abaixo:
 
+* [Banco do Brasil](documentacoes_boletos/Banco do Brasil)
+* [Bradesco](documentacoes_boletos/Bradesco)
+* [Caixa](documentacoes_boletos/Caixa)
+* [Cecred](documentacoes_boletos/cecred)
+* [Itaú](documentacoes_boletos/Itaú)
+* [Santander](documentacoes_boletos/Santander)
 * [Sicoob](documentacoes_boletos/Sicoob)
+* [Sicredi](documentacoes_boletos/Sicredi)
+* [Unicred](documentacoes_boletos/Unicred)
 
 
 ## Bancos Suportados
@@ -57,8 +86,50 @@ Para todos os bancos e carteiras implementadas, **seguimos as documentações**
   <tr>
     <td>Caixa</td>
     <td>1, 2.</td>
+    <td>Homologado dia 11/11/2016</td>
+   <td>Bruno M. Mergen</td>
+  </tr>
+  <tr>
+    <td>Cecred</td>
+    <td>1.</td>
+    <td>Homologado dia 07/11/2016</td>
+   <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Unicred</td>
+    <td>09.</td>
+    <td>Homologado dia 11/11/2016</td>
+   <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Sicredi</td>
+    <td>1, 3.</td>
+    <td>Homologado dia 17/11/2016</td>
+   <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Banco do Brasil</td>
+    <td>11, 12, 15, 16, 17, 18, 31, 51.</td>
+    <td>Pendente</td>
+   <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Bradesco</td>
+    <td>06, 09, 19, 21, 22.</td>
+    <td>Pendente</td>
+   <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Itaú</td>
+    <td>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.</td>
+    <td>Pendente</td>
+   <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Santander</td>
+    <td>101, 102, 121.</td>
     <td>Pendente</td>
-   <td></td>
+   <td>Ricardo Zanuzzo</td>
   </tr>
 </table>
 
@@ -89,8 +160,86 @@ Para todos os bancos e carteiras implementadas, **seguimos as documentações**
   <tr>
     <td>Caixa</td>
     <td>240</td>
+    <td>Homologado dia 11/11/2016</td>
+    <td>Bruno M. Merge</td>
+  </tr>
+  <tr>
+    <td>Cecred</td>
+    <td>240</td>
+    <td>Homologado dia 07/11/2016</td>
+    <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Unicred</td>
+    <td>240</td>
+    <td>Homologado dia 11/11/2016</td>
+    <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Unicred</td>
+    <td>400</td>
+    <td>Pendente</td>
+    <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Sicredi</td>
+    <td>240</td>
+    <td>Homologado dia 17/11/2016</td>
+    <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Sicredi</td>
+    <td>400</td>
+    <td>Pendente</td>
+    <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Banco do Brasil</td>
+    <td>240</td>
+    <td>Pendente</td>
+    <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Banco do Brasil</td>
+    <td>400</td>
+    <td>Pendente</td>
+    <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Bradesco</td>
+    <td>240</td>
+    <td>Pendente</td>
+    <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Bradesco</td>
+    <td>400</td>
+    <td>Pendente</td>
+    <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Itaú</td>
+    <td>240</td>
+    <td>Pendente</td>
+    <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Itaú</td>
+    <td>400</td>
+    <td>Pendente</td>
+    <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Santander</td>
+    <td>240</td>
+    <td>Pendente</td>
+    <td>Ricardo Zanuzzo</td>
+  </tr>
+  <tr>
+    <td>Santander</td>
+    <td>400</td>
     <td>Pendente</td>
-    <td></td>
+    <td>Ricardo Zanuzzo</td>
   </tr>
 </table>
 

data/br_boleto.gemspec

@@ -19,7 +19,7 @@ Gem::Specification.new do |gem|
   # gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
   gem.require_paths = ["lib"]
 
-  gem.required_ruby_version = ['~> 2.2', '~> 2.3']
+  gem.required_ruby_version = '>= 2.2.0'
 
 
   gem.add_dependency "rake", '>= 0.8.7'

data/lib/br_boleto.rb

@@ -77,6 +77,8 @@ module BrBoleto
 		autoload :Sicredi
 		autoload :Cecred
 		autoload :Itau
+		autoload :BancoBrasil
+		autoload :Santander
 	end
 	
 	module Boleto
@@ -90,6 +92,8 @@ module BrBoleto
 		autoload :Sicredi
 		autoload :Cecred
 		autoload :Itau
+		autoload :BancoBrasil
+		autoload :Santander
 	end
 
 
@@ -109,6 +113,8 @@ module BrBoleto
 			autoload :Sicredi
 			autoload :Cecred
 			autoload :Itau
+			autoload :BancoBrasil
+			autoload :Santander
 		end
 		module Cnab400
 			extend ActiveSupport::Autoload
@@ -118,6 +124,8 @@ module BrBoleto
 			autoload :Unicred
 			autoload :Sicredi
 			autoload :Itau
+			autoload :BancoBrasil
+			autoload :Santander
 		end
 	end
 	
@@ -135,6 +143,8 @@ module BrBoleto
 			autoload :Sicredi
 			autoload :Cecred
 			autoload :Itau
+			autoload :BancoBrasil
+			autoload :Santander
 		end
 		module Cnab400
 			extend ActiveSupport::Autoload
@@ -144,11 +154,12 @@ module BrBoleto
 			autoload :Unicred
 			autoload :Sicredi
 			autoload :Itau
+			autoload :BancoBrasil
+			autoload :Santander
 		end
 	end
 
 	
-
 	# Módulo que possui classes que realizam os cálculos dos campos que serão mostrados nos boletos.
 	#
 	module Calculos

data/lib/br_boleto/association/have_conta.rb

@@ -33,32 +33,34 @@ module BrBoleto
 
 		#######################  VALIDAÇÔES DA CONTA #######################
 		# Devem ser sobrescrita a cada classe que utilizar, pois pode variar
-		def valid_conta_corrente_length;      end
-		def valid_conta_corrente_minimum;     end
-		def valid_conta_corrente_maximum;     end
-		def valid_conta_corrente_required;    end
-		def valid_modalidade_length;          end
-		def valid_modalidade_minimum;         end
-		def valid_modalidade_maximum;         end
-		def valid_modalidade_required;        end
-		def valid_codigo_cedente_length;      end
-		def valid_codigo_cedente_minimum;     end
-		def valid_codigo_cedente_maximum;     end
-		def valid_codigo_cedente_required;    end
-		def valid_codigo_cedente_inclusion;   end
-		def valid_endereco_required;          end
-		def valid_carteira_length;            end
-		def valid_carteira_minimum;           end
-		def valid_carteira_maximum;           end
-		def valid_carteira_required;          end
-		def valid_convenio_length;            end
-		def valid_convenio_minimum;           end
-		def valid_convenio_maximum;           end
-		def valid_convenio_required;          end
-		def valid_modalidade_inclusion;       end
-		def valid_carteira_inclusion;         end
-		def valid_convenio_inclusion;         end
-		def valid_versao_aplicativo_required; end # Banco da Caixa
+		def valid_conta_corrente_length;       end
+		def valid_conta_corrente_minimum;      end
+		def valid_conta_corrente_maximum;      end
+		def valid_conta_corrente_required;     end
+		def valid_modalidade_length;           end
+		def valid_modalidade_minimum;          end
+		def valid_modalidade_maximum;          end
+		def valid_modalidade_required;         end
+		def valid_codigo_cedente_length;       end
+		def valid_codigo_cedente_minimum;      end
+		def valid_codigo_cedente_maximum;      end
+		def valid_codigo_cedente_required;     end
+		def valid_codigo_cedente_inclusion;    end
+		def valid_endereco_required;           end
+		def valid_carteira_length;             end
+		def valid_carteira_minimum;            end
+		def valid_carteira_maximum;            end
+		def valid_carteira_required;           end
+		def valid_convenio_length;             end
+		def valid_convenio_minimum;            end
+		def valid_convenio_maximum;            end
+		def valid_convenio_required;           end
+		def valid_modalidade_inclusion;        end
+		def valid_carteira_inclusion;          end
+		def valid_convenio_inclusion;          end
+		def valid_versao_aplicativo_required;  end # Banco da Caixa
+		def valid_variacao_carteira_required;  end # Banco do Brasil
+		def valid_codigo_transmissao_required; end # Banco Santander
 
 
 		def set_regras_tamanho_e_validations!
@@ -95,7 +97,9 @@ module BrBoleto
 			@conta.valid_convenio_required       = valid_convenio_required       if "#{valid_convenio_required}".present?
 			@conta.valid_convenio_inclusion      = valid_convenio_inclusion      if "#{valid_convenio_inclusion}".present?
 			
-			@conta.valid_versao_aplicativo_required = valid_versao_aplicativo_required if "#{valid_versao_aplicativo_required}".present?
+			@conta.valid_versao_aplicativo_required  = valid_versao_aplicativo_required  if "#{valid_versao_aplicativo_required}".present?
+			@conta.valid_variacao_carteira_required  = valid_variacao_carteira_required  if "#{valid_variacao_carteira_required}".present?
+			@conta.valid_codigo_transmissao_required = valid_codigo_transmissao_required if "#{valid_codigo_transmissao_required}".present?
 
 		end
 

data/lib/br_boleto/boleto/banco_brasil.rb

@@ -0,0 +1,130 @@
+# encoding: utf-8
+module BrBoleto
+	module Boleto
+		# Implementação de emissão de boleto bancário pelo Banco BancoBrasil.
+		#
+		# === Documentação Implementada
+		#
+		# A documentação na qual essa implementação foi baseada está localizada na pasta
+		# 'documentacoes_dos_boletos/bradesco' dentro dessa biblioteca.
+		class BancoBrasil < Base
+			def conta_class
+				BrBoleto::Conta::BancoBrasil
+			end
+
+			#################  VALIDAÇÕES DINÂMICAS  #################
+				def valid_numero_documento_maximum
+					numero_documento_esperado[conta.convenio.to_s.size]
+				end
+
+				def valid_carteira_inclusion
+					%w[11 12 15 16 17 18 31 51]
+				end
+				
+				# Tamanho máximo de uma conta corrente no Banco BancoBrasil
+				def valid_conta_corrente_maximum 
+					8
+				end
+
+				# Tamanho máximo para o codigo_cedente/Convênio
+				# def valid_convenio_maximum 
+				# 	8
+				# end	
+
+				# codigo_cedente/Convênio deve ser obrigatório
+				def valid_convenio_required
+					true
+				end
+			##########################################################
+
+			# === Código do Convênio VS. Número do Documento
+			#
+			# No caso do Banco do Brasil, o tamanho do código do cedente ditará o tamanho do número do documento.
+			# Ou seja, quando o código do cedente for X, o tamanho do número do documento deverá ser Y.
+			# Segue abaixo:
+			#     ______________________________________________________________
+			#    | Tamanho do Código Cedente  | Tamanho do Número do documento |
+			#    |----------------------------|--------------------------------|
+			#    |          04                |           07                   |
+			#    |          06                |           05                   |
+			#    |          07                |           10                   |
+			#    |          08                |           09                   |
+			#    ---------------------------------------------------------------
+			#
+			def numero_documento_esperado
+				{ 0 => 0, 4 => 7, 6 => 5, 7 => 10, 8 => 9 }
+			end
+
+
+			# Conforme descrito na documentação, o valor que deve constar em local do pagamento é
+			# "Pagável em qualquer banco até o vencimento. Após, atualize o boleto no site bb.com.br"
+			def default_values
+				super.merge({
+					:local_pagamento   => 'Pagável em qualquer banco até o vencimento. Após, atualize o boleto no site bb.com.br'
+				})
+			end
+
+			# Nosso Número descrito na documentação (Pag. 18 a 22):
+			#
+			# ==== Código do Convênio (4 dígitos) Número do Documento (7 dígitos) - Nosso número DV
+			# Exemplo: 44447777777-D 
+			#
+			# ==== Código do Convênio (6 dígitos) Número do Documento (5 dígitos) - Nosso número DV
+			# Exemplo: 66666655555-D
+			#
+			# ==== Código do Convênio (7 dígitos) Número do Documento (10 digitos)
+			# Exemplo: 77777771010101010
+			#
+			# ==== Código do Convênio (8 dígitos) Número do Documento (9 dígitos)
+			# Exemplo: 88888888999999999
+			#
+			def nosso_numero
+				tamanho = conta.convenio.to_s.size
+				if tamanho == 7 or tamanho == 8
+					"#{conta.convenio}#{numero_documento}"
+				else
+					"#{conta.convenio}#{numero_documento}-#{digito_verificador_nosso_numero}"
+				end
+			end
+
+			# Para o cálculo do dígito, será necessário acrescentar o código do convenio
+			# 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)
+			def digito_verificador_nosso_numero
+				BrBoleto::Calculos::Modulo11FatorDe9a2RestoX.new("#{conta.convenio}#{numero_documento}")
+			end
+
+			#  === Código de barras do banco com Convênio de 4 e 6 dígitos
+	      #     ___________________________________________________________________________
+	      #    | Posição         |   Tamanho     | Descrição                               |
+	      #    |-----------------|---------------|-----------------------------------------|
+	      #    | 20-30           |     11          | Nosso-Número, sem dígito verificador  |
+	      #    | 20-23 ou 20-25  |   4 ou 6      | Código do cedente fornecido pelo Banco  |
+	      #    | 24-30 ou 26-30  |   7 ou 5      | Nosso-Número, sem dígito verificador    |
+	      #    | 31-34           |     04          | Agência (sem o dígito)                |
+	      #    | 35-42           |     08          | Conta corrente (sem o dígito)         |
+	      #    | 43-44           |     02          | Carteira                              |
+	      #    -----------------------------------------------------------------------------
+	      #
+	      # === Código de barras do banco com Convênio de 7 e 8 dígitos
+	      #     ___________________________________________________________________________
+	      #    | Posição         |   Tamanho     | Descrição                               |
+	      #    |-----------------|---------------|-----------------------------------------|
+	      #    | 20-30           |     17        | Nosso-Número, sem dígito verificador    |
+	      #    | 20-32 ou 20-33  |  7 ou 8       | Código do cedente fornecido pelo Banco  |
+	      #    | 33-42 ou 34-42  |  9 ou 10      | Nosso-Número, sem dígito verificador    |
+	      #    | 43-44           |    02         | Carteira                                |
+	      #    ----------------------------------------------------------------------------
+	      #
+			def codigo_de_barras_do_banco
+				tamanho = conta.convenio.to_s.size
+				if tamanho == 7 or tamanho == 8
+					"000000#{conta.convenio}#{numero_documento}#{conta.carteira}"
+				else
+					"#{conta.convenio}#{numero_documento}#{conta.agencia}#{conta.conta_corrente}#{conta.carteira}"
+				end
+			end
+
+		end
+	end
+end