brcobranca 12.0.0 → 13.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40b85b52a4ac810c6f1415906dd2099ca3f8ca623bcfc5f133a871e12ff1fa4d
-  data.tar.gz: 593a1178adce41b5922e815436eb83e5db3f626711b2059b0b43cf7e08399642
+  metadata.gz: 6cb709eea03591dba80bcbd44a13db892cccf3631872d1ff612395b75efa7895
+  data.tar.gz: e71144ac7164a789303d3aa3fef7065c8ddbc46286c98b3f22a13aecd8c7a126
 SHA512:
-  metadata.gz: 1f8b46f27016dc18170876394015e9c575fdb6c302ec9ed5698744421aa1fbd6b5226345f5ebf79af24a5fc82e14ac948bd058612050da7c582432496e6bc399
-  data.tar.gz: 7968b70af83ef565021ba7f4666f7ffe35f64878ae2c6e9b36d454fb1cef8570012aa667c6de635eebe20c5587e4f5725f2738735d104105a07bd9d28068c309
+  metadata.gz: 0a7f6d6750e2a4ca483d72e1dc649b68e0da0c6252a806d82e4fe5a476ab4d96beee8cf2709c714f5f1d03b00f4e69bf995130592bdfc36e63ceecd6ad29f716
+  data.tar.gz: 2420142f69f9306c859c03c8c39f9f78072a6fe6fed30846b0cb25a4ad7bd9e85b7a2a13fd2139e3b4bafa3788b99ec5cd015879779dd411976a789e36bc3bfe

data/README.md

@@ -53,7 +53,7 @@ Criado pelo pessoal da [Akretion](http://www.akretion.com) muito TOP \o/
 | Caixa             | 240             | 240                   |
 | Citibank          | Não             | 400                   |
 | HSBC              | Não             | Não                   |
-| Itaú              | 400             | 400 e 444             |
+| Itaú              | 400 e 240       | 400, 444 e 240        |
 | Santander         | 400 e 240       | 400 e 240             |
 | Sicoob            | 240             | 400 e 240             |
 | Sicredi           | 240             | 240                   |

data/lib/brcobranca/boleto/itau.rb

@@ -28,6 +28,18 @@ module Brcobranca
         '341'
       end
 
+      # Agencia mantenedora da conta.
+      # @return [String] 4 caracteres numericos.
+      def agencia=(valor)
+        @agencia = valor.to_s.rjust(4, "0") if valor
+      end
+
+      # Numero da carteira no banco.
+      # @return [String] 3 caracteres numericos.
+      def carteira=(valor)
+        @carteira = valor.to_s.rjust(3, "0") if valor
+      end
+
       # Número do convênio/contrato do cliente junto ao banco.
       # @return [String] 5 caracteres numéricos.
       def convenio=(valor)
@@ -65,17 +77,18 @@ module Brcobranca
       #
       # @return [String] 1 caracteres numéricos.
       def nosso_numero_dv
-        if %w[112 126 131 146 150 168].include?(carteira)
-          "#{carteira}#{nosso_numero}".modulo10
-        else
-          "#{agencia}#{conta_corrente}#{carteira}#{nosso_numero}".modulo10
-        end
+        Brcobranca::Util::Itau.nosso_numero_dv(
+          agencia, conta_corrente, carteira, nosso_numero
+        )
       end
 
-      # Calcula o dígito verificador para conta corrente do Itau.
-      # Retorna apenas o dígito verificador da conta ou nil caso seja impossível calcular.
+      # Calcula o digito verificador para conta corrente do Itau.
+      # Retorna apenas o digito verificador da conta, ou nil se nao for
+      # possivel calcular.
       def agencia_conta_corrente_dv
-        "#{agencia}#{conta_corrente}".modulo10
+        Brcobranca::Util::Itau.agencia_conta_corrente_dv(
+          agencia, conta_corrente
+        )
       end
 
       # Nosso número para exibir no boleto.

data/lib/brcobranca/remessa/cnab240/itau.rb

@@ -0,0 +1,326 @@
+# frozen_string_literal: true
+
+module Brcobranca
+  module Remessa
+    module Cnab240
+      class Itau < Brcobranca::Remessa::Cnab240::Base
+        validates_length_of :agencia, maximum: 4,
+                                      message: "deve ter 4 dígitos."
+        validates_length_of :conta_corrente, maximum: 5,
+                                             message: "deve ter 5 dígitos."
+        validates_length_of :carteira, maximum: 3,
+                                       message: "deve ter 3 dígitos."
+
+        def initialize(campos = {})
+          # emissao_boleto/distribuicao_boleto/codigo_carteira/
+          # forma_cadastramento nao fazem parte do layout do Segmento P do
+          # Itau (ver #monta_segmento_p), mas precisam de um valor de 1
+          # digito para passar nas validacoes genericas de Cnab240::Base.
+          campos = { especie_titulo: "01",
+                     emissao_boleto: "0",
+                     distribuicao_boleto: "0" }.merge!(campos)
+          super
+        end
+
+        def agencia=(valor)
+          @agencia = valor.to_s.rjust(4, "0") if valor
+        end
+
+        def conta_corrente=(valor)
+          @conta_corrente = valor.to_s.rjust(5, "0") if valor
+        end
+
+        def carteira=(valor)
+          @carteira = valor.to_s.rjust(3, "0") if valor
+        end
+
+        def cod_banco
+          "341"
+        end
+
+        def nome_banco
+          "BANCO ITAU SA".ljust(30, " ")
+        end
+
+        def versao_layout_arquivo
+          "040"
+        end
+
+        def versao_layout_lote
+          "030"
+        end
+
+        def exclusivo_servico
+          "00"
+        end
+
+        # Digito verificador de agencia/conta corrente.
+        #
+        # @return [String]
+        def agencia_conta_corrente_dv
+          Brcobranca::Util::Itau.agencia_conta_corrente_dv(
+            agencia, conta_corrente
+          ).to_s
+        end
+
+        # Digito verificador do nosso numero.
+        #
+        # Calculado sobre o nosso numero ja com 8 posicoes (mesmo valor
+        # gravado no segmento P), e nao sobre o valor "cru" informado pelo
+        # usuario - ver #monta_segmento_p e #formata_nosso_numero.
+        #
+        # @return [String]
+        def nosso_numero_dv(pagamento)
+          Brcobranca::Util::Itau.nosso_numero_dv(
+            agencia, conta_corrente, carteira, formata_nosso_numero(pagamento)
+          ).to_s
+        end
+
+        # Nosso numero com exatamente 8 posicoes.
+        #
+        # O nosso numero pode vir do chamador (ex.: sequencia interna do
+        # Odoo) com mais de 8 digitos; nesse caso ficam os 8 ultimos
+        # digitos (o mesmo criterio usado para interpretar o nosso numero
+        # no arquivo de retorno), em vez de simplesmente preencher com
+        # zeros a esquerda sem cortar o excedente.
+        #
+        # @return [String]
+        def formata_nosso_numero(pagamento)
+          pagamento.nosso_numero.to_s.rjust(8, "0")[-8..-1]
+        end
+
+        # Informacoes da conta corrente do cedente no header de lote.
+        #
+        # CAMPO         TAMANHO
+        # zeros         1
+        # agencia       4
+        # brancos       1
+        # zeros         7
+        # conta corrente 5
+        # brancos       1
+        # DAC ag/conta  1
+        #
+        # @return [String]
+        def info_conta
+          zeros = "".rjust(7, "0")
+          "0#{agencia} #{zeros}#{conta_corrente} #{agencia_conta_corrente_dv}"
+        end
+
+        # Sem uso de codigo de convenio pelo Itau neste layout (header arquivo)
+        #
+        # @return [String]
+        def codigo_convenio
+          "".rjust(20, " ")
+        end
+
+        # Sem uso de codigo de convenio pelo Itau neste layout (header lote)
+        #
+        # @return [String]
+        def convenio_lote
+          "".rjust(20, " ")
+        end
+
+        def uso_exclusivo_banco
+          "".rjust(20, " ")
+        end
+
+        def uso_exclusivo_empresa
+          "".rjust(20, " ")
+        end
+
+        # Complemento do header de arquivo
+        #
+        # @return [String]
+        def complemento_header
+          "#{''.rjust(14, ' ')}#{''.rjust(3, '0')}#{''.rjust(12, ' ')}"
+        end
+
+        # Complemento do trailer de lote
+        #
+        # @return [String]
+        def complemento_trailer
+          "".rjust(217, " ")
+        end
+
+        def dv_agencia_cobradora
+          "0"
+        end
+
+        # Prazo para baixa com exatamente 2 posicoes.
+        #
+        # O valor padrao herdado de Brcobranca::Remessa::Pagamento e "000"
+        # (3 digitos, dimensionado para o layout generico de outros bancos)
+        # e nao e truncado por um rjust simples, o que descasa o segmento P
+        # do Itau (campo de 2 digitos, posicoes 225-226) em 1 byte quando o
+        # chamador nao informa esse campo explicitamente.
+        #
+        # @return [String]
+        def dias_baixa(pagamento)
+          pagamento.dias_baixa.to_s.rjust(2, "0")[-2..-1]
+        end
+
+        # Monta o registro segmento P do arquivo.
+        #
+        # Layout especifico do Itau (manual "Cobranca FEBRABAN 240", item
+        # 3.1, Segmento P) - o campo "N. da carteira" (3 digitos, posicoes
+        # 038-040) nao corresponde ao hook generico `codigo_carteira` da
+        # classe base (1 digito), por isso o segmento e montado por inteiro.
+        #
+        # CAMPO                                 POSICAO  TAMANHO
+        # codigo banco                          001-003  3
+        # lote de servico                       004-007  4
+        # tipo de registro                      008      1
+        # num. sequencial do registro no lote   009-013  5
+        # cod. segmento                         014      1
+        # uso exclusivo                         015      1
+        # cod. movimento remessa                016-017  2
+        # zeros                                 018      1
+        # agencia                               019-022  4
+        # brancos                               023      1
+        # zeros                                 024-030  7
+        # conta corrente                        031-035  5
+        # brancos                               036      1
+        # DAC agencia/conta                     037      1
+        # numero da carteira                    038-040  3
+        # nosso numero                          041-048  8
+        # DAC nosso numero                      049      1
+        # brancos                               050-057  8
+        # zeros                                 058-062  5
+        # numero do documento                   063-072  10
+        # brancos                               073-077  5
+        # data de vencimento                    078-085  8
+        # valor do titulo                       086-100  15
+        # agencia cobradora                     101-105  5
+        # DAC agencia cobradora                 106      1
+        # especie do titulo                     107-108  2
+        # aceite                                109      1
+        # data de emissao do titulo             110-117  8
+        # zeros                                 118      1
+        # data base juros de mora               119-126  8
+        # valor de mora por dia de atraso       127-141  15
+        # zeros                                 142      1
+        # data limite do 1o desconto            143-150  8
+        # valor do 1o desconto                  151-165  15
+        # valor do IOF                          166-180  15
+        # valor do abatimento                   181-195  15
+        # identificacao do titulo na empresa    196-220  25
+        # codigo para negativacao/protesto      221      1
+        # prazo para negativacao/protesto       222-223  2
+        # codigo para baixa                     224      1
+        # prazo para baixa                      225-226  2
+        # zeros                                 227-239  13
+        # brancos                               240      1
+        #
+        # @return [String]
+        def monta_segmento_p(pagamento, nro_lote, sequencial)
+          segmento_p = ""
+          segmento_p += cod_banco
+          segmento_p << nro_lote.to_s.rjust(4, "0")
+          segmento_p << "3"
+          segmento_p << sequencial.to_s.rjust(5, "0")
+          segmento_p << "P"
+          segmento_p << " "
+          segmento_p << pagamento.identificacao_ocorrencia
+          segmento_p << "0"
+          segmento_p << agencia
+          segmento_p << " "
+          segmento_p << "".rjust(7, "0")
+          segmento_p << conta_corrente
+          segmento_p << " "
+          segmento_p << agencia_conta_corrente_dv
+          segmento_p << carteira
+          segmento_p << formata_nosso_numero(pagamento)
+          segmento_p << nosso_numero_dv(pagamento)
+          segmento_p << "".rjust(8, " ")
+          segmento_p << "".rjust(5, "0")
+          segmento_p << pagamento.formata_documento_ou_numero(10, " ")
+          segmento_p << "".rjust(5, " ")
+          segmento_p << pagamento.data_vencimento.strftime("%d%m%Y")
+          segmento_p << pagamento.formata_valor(15)
+          segmento_p << "".rjust(5, "0")
+          segmento_p << dv_agencia_cobradora
+          segmento_p << especie_titulo
+          segmento_p << aceite
+          segmento_p << pagamento.data_emissao.strftime("%d%m%Y")
+          segmento_p << "0"
+          segmento_p << data_mora(pagamento)
+          segmento_p << pagamento.formata_valor_mora(15)
+          segmento_p << "0"
+          segmento_p << pagamento.formata_data_desconto("%d%m%Y")
+          segmento_p << pagamento.formata_valor_desconto(15)
+          segmento_p << pagamento.formata_valor_iof(15)
+          segmento_p << pagamento.formata_valor_abatimento(15)
+          segmento_p << pagamento.formata_documento_ou_numero(25, " ")
+          segmento_p << pagamento.codigo_protesto
+          segmento_p << pagamento.dias_protesto.to_s.rjust(2, "0")
+          segmento_p << codigo_baixa(pagamento)
+          segmento_p << dias_baixa(pagamento)
+          segmento_p << "".rjust(13, "0")
+          segmento_p << " "
+          segmento_p
+        end
+
+        # Monta o registro segmento Q do arquivo.
+        #
+        # Layout especifico do Itau - o nome do pagador ocupa 30 posicoes
+        # (com 10 posicoes em branco a seguir) e o nome do sacador/avalista
+        # ocupa 30 posicoes, diferente do padrao generico de 40 posicoes sem
+        # espacamento usado pela classe base.
+        #
+        # CAMPO                                 POSICAO  TAMANHO
+        # codigo banco                          001-003  3
+        # lote de servico                       004-007  4
+        # tipo de registro                      008      1
+        # num. sequencial do registro no lote   009-013  5
+        # cod. segmento                         014      1
+        # brancos                               015      1
+        # cod. movimento remessa                016-017  2
+        # tipo insc. pagador                    018      1
+        # documento pagador                     019-033  15
+        # nome pagador                          034-063  30
+        # brancos                               064-073  10
+        # logradouro                            074-113  40
+        # bairro                                114-128  15
+        # cep                                   129-133  5
+        # sufixo cep                            134-136  3
+        # cidade                                137-151  15
+        # uf                                    152-153  2
+        # tipo insc. sacador/avalista           154      1
+        # documento sacador/avalista            155-169  15
+        # nome sacador/avalista                 170-199  30
+        # brancos                               200-209  10
+        # zeros                                 210-212  3
+        # brancos                               213-240  28
+        #
+        # @return [String]
+        def monta_segmento_q(pagamento, nro_lote, sequencial)
+          segmento_q = ""
+          segmento_q += cod_banco
+          segmento_q << nro_lote.to_s.rjust(4, "0")
+          segmento_q << "3"
+          segmento_q << sequencial.to_s.rjust(5, "0")
+          segmento_q << "Q"
+          segmento_q << " "
+          segmento_q << pagamento.identificacao_ocorrencia
+          segmento_q << pagamento.identificacao_sacado(false)
+          segmento_q << pagamento.documento_sacado.to_s.rjust(15, "0")
+          segmento_q << pagamento.nome_sacado.format_size(30)
+          segmento_q << "".rjust(10, " ")
+          segmento_q << pagamento.endereco_sacado.format_size(40)
+          segmento_q << pagamento.bairro_sacado.format_size(15)
+          segmento_q << pagamento.cep_sacado[0..4]
+          segmento_q << pagamento.cep_sacado[5..7]
+          segmento_q << pagamento.cidade_sacado.format_size(15)
+          segmento_q << pagamento.uf_sacado
+          segmento_q << pagamento.identificacao_avalista(false)
+          segmento_q << pagamento.documento_avalista.to_s.rjust(15, "0")
+          segmento_q << pagamento.nome_avalista.format_size(30)
+          segmento_q << "".rjust(10, " ")
+          segmento_q << "".rjust(3, "0")
+          segmento_q << "".rjust(28, " ")
+          segmento_q
+        end
+      end
+    end
+  end
+end

data/lib/brcobranca/remessa/cnab240/sicredi.rb

@@ -151,16 +151,49 @@ module Brcobranca
           nosso_numero.somente_numeros.ljust(20, ' ')
         end
 
-        def codigo_desconto(_pagamento)
-          '1'
+        # Campo 30.3P - Codigo do desconto 1.
+        # Manual Sicredi: '0' - Sem desconto | '1' - Valor fixo ate a data
+        # informada | '2' - Percentual ate a data informada.
+        # Para o codigo '0' o valor e a data do desconto devem ser zerados.
+        # Deve respeitar o valor informado pelo beneficiario.
+        def codigo_desconto(pagamento)
+          if pagamento.cod_desconto == '0'
+            pagamento.data_desconto = nil
+            pagamento.valor_desconto = 0.0
+          end
+          pagamento.cod_desconto
         end
 
         def codigo_baixa(_pagamento)
           '1'
         end
 
+        # Campo 39.3P - No de dias para baixa/devolucao.
+        # Manual Sicredi: o Sicredi nao utiliza esse campo, preencher com zeros.
         def dias_baixa(_pagamento)
-          '060'
+          '000'
+        end
+
+        # Campo 19.3P - Seu Numero (posicoes 63-77).
+        # Manual Sicredi: "Embora no layout constem 15 posicoes, o Sicredi
+        # apenas validara as 10 primeiras (campos 63-72), ou seja, da esquerda
+        # para a direita. Nao pode conter espaco."
+        # O numero deve entao ser alinhado a esquerda e o restante preenchido
+        # com zeros (o campo nao pode conter espaco).
+        def numero(pagamento)
+          pagamento.documento_ou_numero.to_s.gsub(/[^0-9A-Za-z]/, '').ljust(15, '0')[0...15]
+        end
+
+        # Campos 17.3Q, 18.3Q e 19.3Q - Beneficiario Final.
+        # Manual Sicredi: nao havendo Beneficiario Final o tipo deve ser "0"
+        # e o campo CPF/CNPJ (posicoes 155-169) deve ficar em branco.
+        # O BRCobranca preenche o CPF/CNPJ com zeros quando nao informado.
+        def monta_segmento_q(pagamento, nro_lote, sequencial)
+          segmento_q = super
+          return segmento_q unless pagamento.documento_avalista.to_s.strip.empty?
+
+          segmento_q[153, 16] = "0#{''.rjust(15, ' ')}"
+          segmento_q
         end
 
         def data_mora(pagamento)

data/lib/brcobranca/remessa/cnab240/unicred.rb

@@ -3,7 +3,328 @@
 module Brcobranca
   module Remessa
     module Cnab240
-      class Unicred < Brcobranca::Remessa::Cnab240::Sicredi
+      # Banco Unicred (136)
+      #
+      # Layout proprio do Unicred, baseado no manual "COBRANCA UNICRED -
+      # TROCA ELETRONICA CEDENTE CNAB 240 E 400" (item 6), disponivel em
+      # docs/unicred. Difere do padrao generico FEBRABAN principalmente no
+      # segmento P (posicao do nosso numero, carteira com 2 posicoes e
+      # diversos campos tratados como filler) e no segmento R, onde ficam as
+      # mensagens do titulo.
+      class Unicred < Brcobranca::Remessa::Cnab240::Base
+        # Parametro de movimento vinculado ao cedente no momento do
+        # cadastramento (campo 22 do header de arquivo - UN001).
+        attr_accessor :parametro_movimento
+
+        validates_presence_of :agencia, :conta_corrente, :digito_conta, :documento_cedente,
+                              message: 'não pode estar em branco.'
+        validates_length_of :agencia, is: 4, message: 'deve ter 4 dígitos.'
+        validates_length_of :conta_corrente, maximum: 12, message: 'deve ter no máximo 12 dígitos.'
+        validates_length_of :digito_conta, is: 1, message: 'deve ter 1 dígito.'
+        validates_length_of :carteira, is: 2, message: 'deve ter 2 dígitos.'
+        validates_length_of :parametro_movimento, is: 3, message: 'deve ter 3 dígitos.'
+        validates_inclusion_of :carteira, in: %w[21], message: 'não existente para este banco.'
+
+        # Nova instancia do Unicred
+        def initialize(campos = {})
+          campos = {
+            carteira: '21',
+            parametro_movimento: '000',
+            emissao_boleto: '2',
+            distribuicao_boleto: '2',
+            especie_titulo: '02',
+            forma_cadastramento: '1',
+            tipo_documento: '1'
+          }.merge!(campos)
+          super(campos)
+        end
+
+        def agencia=(valor)
+          @agencia = valor.to_s.rjust(4, '0') if valor
+        end
+
+        def carteira=(valor)
+          @carteira = valor.to_s.rjust(2, '0') if valor
+        end
+
+        # Codigo do banco na camara de compensacao
+        # @return [String] 3 caracteres numericos.
+        def cod_banco
+          '136'
+        end
+
+        # Nome do banco
+        # @return [String] 30 caracteres.
+        def nome_banco
+          'UNICRED'.ljust(30, ' ')
+        end
+
+        # Versao do layout do arquivo (campo 20 do header de arquivo)
+        def versao_layout_arquivo
+          '085'
+        end
+
+        # Versao do layout do lote (campo 7 do header de lote)
+        def versao_layout_lote
+          '044'
+        end
+
+        # Densidade de gravacao do arquivo: 1600 BPI
+        def densidade_gravacao
+          '01600'
+        end
+
+        # Digito verificador da agencia, calculado pelo modulo 11 com o mesmo
+        # criterio usado na remessa CNAB 400 do Unicred.
+        # @return [String] 1 caractere.
+        def digito_agencia
+          agencia.modulo11(mapeamento: { 10 => 'X' }).to_s
+        end
+
+        # Nosso numero com o digito verificador (campo 13 do segmento P).
+        # @return [String] 11 caracteres numericos.
+        def formata_nosso_numero(nosso_numero)
+          numero = nosso_numero.to_s.somente_numeros.rjust(10, '0')
+          "#{numero}#{numero.modulo11(mapeamento: { 10 => 0, 11 => 0 })}"
+        end
+
+        # O Unicred nao utiliza o codigo do convenio: campo 7 do header de
+        # arquivo e campo 11 do header de lote sao filler.
+        def codigo_convenio
+          ''.rjust(20, ' ')
+        end
+
+        alias convenio_lote codigo_convenio
+
+        # Informacoes da conta do cedente
+        # (header de arquivo 053-072 / header de lote 054-073)
+        #
+        # @return [String] 20 caracteres.
+        def info_conta
+          # CAMPO           TAMANHO
+          # agencia         5
+          # dv agencia      1
+          # conta corrente  12
+          # dv conta        1
+          # filler          1
+          "#{agencia.rjust(5, '0')}#{digito_agencia}#{conta_corrente.to_s.rjust(12, '0')}#{digito_conta}0"
+        end
+
+        # Campos 22 e 23 do header de arquivo (posicoes 172 a 191):
+        # parametro de movimento seguido do campo reservado ao banco.
+        def uso_exclusivo_banco
+          "#{parametro_movimento}#{''.rjust(17, ' ')}"
+        end
+
+        # Campo 24 do header de arquivo (posicoes 192 a 211)
+        def uso_exclusivo_empresa
+          ''.rjust(20, ' ')
+        end
+
+        # Campo 25 do header de arquivo (posicoes 212 a 240)
+        def complemento_header
+          ''.rjust(29, ' ')
+        end
+
+        # Complemento do trailer de lote (posicoes 24 a 240)
+        #
+        # @return [String] 217 caracteres.
+        def complemento_trailer
+          # CAMPO                                             TAMANHO
+          # qtde de titulos em cobranca simples               6
+          # valor total dos titulos em cobranca simples       17
+          # qtde/valor dos titulos em cobranca vinculada      23
+          # qtde/valor dos titulos em cobranca caucionada     23
+          # qtde/valor dos titulos em cobranca descontada     23
+          # numero do aviso de lancamento                     8
+          # uso exclusivo FEBRABAN                            117
+          cobranca_simples = "#{quantidade_titulos_cobranca}#{valor_titulos_carteira(17)}"
+          "#{cobranca_simples}#{''.rjust(69, '0')}#{''.rjust(125, ' ')}"
+        end
+
+        # Complemento do segmento R (posicoes 180 a 240)
+        #
+        # @return [String] 61 caracteres.
+        def complemento_r
+          # CAMPO                    TAMANHO
+          # uso exclusivo FEBRABAN   20
+          # filler                   32
+          # uso exclusivo FEBRABAN   9
+          "#{''.rjust(20, ' ')}#{''.rjust(32, '0')}#{''.rjust(9, ' ')}"
+        end
+
+        # Monta o registro header do lote
+        #
+        # No layout do Unicred as duas mensagens do header de lote (posicoes
+        # 104 a 183) e a data do credito (posicoes 200 a 207) sao filler - as
+        # mensagens do titulo trafegam no segmento R.
+        #
+        # @return [String]
+        #
+        def monta_header_lote(nro_lote)
+          header_lote = super
+          header_lote[103, 80] = ''.rjust(80, ' ')
+          header_lote[199, 8] = ''.rjust(8, ' ')
+          header_lote
+        end
+
+        # Monta o registro segmento P do arquivo
+        #
+        # CAMPO                                 POSICAO  TAMANHO
+        # codigo banco                          001-003  3
+        # lote de servico                       004-007  4
+        # tipo de registro                      008      1
+        # num. sequencial do registro no lote   009-013  5
+        # cod. segmento                         014      1
+        # uso exclusivo FEBRABAN                015      1
+        # cod. movimento remessa                016-017  2
+        # agencia                               018-022  5
+        # dv agencia                            023      1
+        # conta corrente                        024-035  12
+        # dv conta                              036      1
+        # filler                                037      1
+        # nosso numero (com dv)                 038-048  11
+        # filler                                049-056  8
+        # carteira                              057-058  2
+        # filler                                059-062  4
+        # numero do documento (seu numero)      063-077  15
+        # data de vencimento                    078-085  8
+        # valor nominal do titulo               086-100  15
+        # agencia cobradora                     101-105  5
+        # dv agencia cobradora                  106      1
+        # filler                                107-108  2
+        # aceite                                109      1
+        # data de emissao do titulo             110-117  8
+        # codigo do juros de mora               118      1
+        # filler                                119-126  8
+        # juros de mora por dia/taxa            127-141  15
+        # codigo do desconto 1                  142      1
+        # data do desconto 1                    143-150  8
+        # valor/percentual do desconto 1        151-165  15
+        # filler                                166-180  15
+        # valor do abatimento                   181-195  15
+        # identificacao do titulo na empresa    196-220  25
+        # codigo para protesto                  221      1
+        # prazo para protesto                   222-223  2
+        # filler                                224-227  4
+        # codigo da moeda                       228-229  2
+        # numero do contrato                    230-239  10
+        # uso exclusivo FEBRABAN                240      1
+        #
+        # @return [String]
+        #
+        def monta_segmento_p(pagamento, nro_lote, sequencial)
+          segmento_p = ''
+          segmento_p += cod_banco
+          segmento_p << nro_lote.to_s.rjust(4, '0')
+          segmento_p << '3'
+          segmento_p << sequencial.to_s.rjust(5, '0')
+          segmento_p << 'P'
+          segmento_p << ' '
+          segmento_p << pagamento.identificacao_ocorrencia
+          segmento_p << agencia.rjust(5, '0')
+          segmento_p << digito_agencia
+          segmento_p << conta_corrente.to_s.rjust(12, '0')
+          segmento_p << digito_conta.to_s
+          segmento_p << '0'
+          segmento_p << formata_nosso_numero(pagamento.nosso_numero)
+          segmento_p << ''.rjust(8, ' ')
+          segmento_p << carteira
+          segmento_p << '0 0 '
+          segmento_p << numero(pagamento)
+          segmento_p << pagamento.data_vencimento.strftime('%d%m%Y')
+          segmento_p << pagamento.formata_valor(15)
+          segmento_p << ''.rjust(5, ' ')
+          segmento_p << ' '
+          segmento_p << ''.rjust(2, '0')
+          segmento_p << aceite
+          segmento_p << pagamento.data_emissao.strftime('%d%m%Y')
+          segmento_p << pagamento.tipo_mora
+          segmento_p << ''.rjust(8, '0')
+          segmento_p << pagamento.formata_valor_mora(15)
+          segmento_p << codigo_desconto(pagamento)
+          segmento_p << pagamento.formata_data_desconto('%d%m%Y')
+          segmento_p << pagamento.formata_valor_desconto(15)
+          segmento_p << ''.rjust(15, '0')
+          segmento_p << pagamento.formata_valor_abatimento(15)
+          segmento_p << identificacao_titulo_empresa(pagamento)
+          segmento_p << pagamento.codigo_protesto
+          segmento_p << pagamento.dias_protesto.to_s.rjust(2, '0')
+          segmento_p << '0'
+          segmento_p << ''.rjust(3, ' ')
+          segmento_p << '09'
+          segmento_p << ''.rjust(10, '0')
+          segmento_p << ' '
+          segmento_p
+        end
+
+        # Monta o registro segmento R do arquivo
+        #
+        # No layout do Unicred os campos de desconto 2/3 e de multa sao filler;
+        # o segmento carrega a informacao ao sacado e as duas mensagens.
+        #
+        # CAMPO                                 POSICAO  TAMANHO
+        # codigo banco                          001-003  3
+        # lote de servico                       004-007  4
+        # tipo de registro                      008      1
+        # num. sequencial do registro no lote   009-013  5
+        # cod. segmento                         014      1
+        # uso exclusivo FEBRABAN                015      1
+        # cod. movimento remessa                016-017  2
+        # filler (desconto 2 e desconto 3)      018-065  48
+        # filler                                066      1
+        # filler (multa)                        067-089  23
+        # informacao ao sacado                  090-099  10
+        # mensagem 1                            100-139  40
+        # mensagem 2                            140-179  40
+        # complemento                           180-240  61
+        #
+        # @return [String]
+        #
+        def monta_segmento_r(pagamento, nro_lote, sequencial)
+          segmento_r = ''
+          segmento_r += cod_banco
+          segmento_r << nro_lote.to_s.rjust(4, '0')
+          segmento_r << '3'
+          segmento_r << sequencial.to_s.rjust(5, '0')
+          segmento_r << 'R'
+          segmento_r << ' '
+          segmento_r << pagamento.identificacao_ocorrencia
+          segmento_r << ''.rjust(48, '0')
+          segmento_r << ' '
+          segmento_r << ''.rjust(23, '0')
+          segmento_r << ''.rjust(10, ' ')
+          segmento_r << mensagem_1.to_s.format_size(40)
+          segmento_r << mensagem_2.to_s.format_size(40)
+          segmento_r << complemento_r
+          segmento_r
+        end
+
+        # Monta o registro trailer do arquivo
+        #
+        # CAMPO                                 POSICAO  TAMANHO
+        # codigo banco                          001-003  3
+        # lote de servico                       004-007  4
+        # tipo de registro                      008      1
+        # uso exclusivo FEBRABAN                009-017  9
+        # qtde de lotes do arquivo              018-023  6
+        # qtde de registros do arquivo          024-029  6
+        # qtde de contas para conciliacao       030-035  6
+        # uso exclusivo FEBRABAN                036-240  205
+        #
+        # @return [String]
+        #
+        def monta_trailer_arquivo(nro_lotes, sequencial)
+          trailer_arquivo = ''
+          trailer_arquivo += cod_banco
+          trailer_arquivo << '99999'
+          trailer_arquivo << ''.rjust(9, ' ')
+          trailer_arquivo << nro_lotes.to_s.rjust(6, '0')
+          trailer_arquivo << sequencial.to_s.rjust(6, '0')
+          trailer_arquivo << ''.rjust(6, '0')
+          trailer_arquivo << ''.rjust(205, ' ')
+          trailer_arquivo
+        end
       end
     end
   end

data/lib/brcobranca/retorno/cnab240/base.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require 'parseline'
+require "parseline"
 
 module Brcobranca
   module Retorno
@@ -13,13 +13,15 @@ module Brcobranca
           codigo_banco = codigo_banco_do_arquivo(file)
 
           case codigo_banco
-          when '033'
+          when "033"
             Brcobranca::Retorno::Cnab240::Santander.load_lines(file, options)
-          when '085'
+          when "341"
+            Brcobranca::Retorno::Cnab240::Itau.load_lines(file, options)
+          when "085"
             Brcobranca::Retorno::Cnab240::Ailos.load_lines(file, options)
-          when '748'
+          when "748"
             Brcobranca::Retorno::Cnab240::Sicredi.load_lines(file, options)
-          when '756'
+          when "756"
             Brcobranca::Retorno::Cnab240::Sicoob.load_lines(file, options)
           else
             Brcobranca::Retorno::RetornoCnab240.load_lines(file, options)

data/lib/brcobranca/retorno/cnab240/itau.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+module Brcobranca
+  module Retorno
+    module Cnab240
+      class Itau < Brcobranca::Retorno::Cnab240::Base
+        # Regex para remocao de headers/trailers e registros diferentes de T
+        # ou U.
+        REGEX_DE_EXCLUSAO_DE_REGISTROS_NAO_T_OU_U =
+          /^((?!^.{7}3.{5}[TU].*$).)*$/
+
+        def self.load_lines(file, options = {})
+          default_options = {
+            except: REGEX_DE_EXCLUSAO_DE_REGISTROS_NAO_T_OU_U
+          }
+          options = default_options.merge(options)
+
+          lines = Line.load_lines(file, options)
+          lines.each_slice(2).inject([]) do |retornos, cnab_lines|
+            validate_par_t_u!(cnab_lines)
+            retornos << generate_retorno_based_on_cnab_lines(cnab_lines)
+          end
+        end
+
+        # Garante que cada grupo de linhas T/U produzido por .load_lines
+        # esta completo e na ordem esperada antes de virar um retorno.
+        #
+        # Um arquivo corrompido ou truncado pode gerar um grupo com so a
+        # linha T (sem a U correspondente) ou fora de ordem; sem essa
+        # checagem, generate_retorno_based_on_cnab_lines trataria
+        # silenciosamente qualquer linha que nao seja T como se fosse U,
+        # produzindo um retorno com dados de liquidacao incorretos/parciais.
+        def self.validate_par_t_u!(cnab_lines)
+          return if cnab_lines.size == 2 &&
+                    cnab_lines[0].tipo_registro == "T" &&
+                    cnab_lines[1].tipo_registro == "U"
+
+          sequencial = cnab_lines.first&.sequencial
+          raise ArgumentError,
+                "Par de registros T/U invalido ou incompleto no retorno " \
+                "do Itau (sequencial: #{sequencial.inspect})"
+        end
+
+        def self.generate_retorno_based_on_cnab_lines(cnab_lines)
+          retorno = new
+          cnab_lines.each do |line|
+            if line.tipo_registro == "T"
+              Line::REGISTRO_T_FIELDS.each do |attr|
+                retorno.send(:"#{attr}=", line.send(attr))
+              end
+            else
+              Line::REGISTRO_U_FIELDS.each do |attr|
+                retorno.send(:"#{attr}=", line.send(attr))
+              end
+            end
+          end
+          retorno
+        end
+
+        # Linha de mapeamento do retorno do arquivo CNAB 240 do Itau.
+        #
+        # O registro CNAB 240 possui 2 tipos de registros que juntos geram
+        # um registro de retorno bancario. O primeiro e do tipo T que
+        # retorna os dados gerais sobre o titulo/pagador. O segundo e do
+        # tipo U que retorna os valores da liquidacao.
+        #
+        # Os nomes de campo reutilizam, sempre que fazem sentido, o
+        # vocabulario generico ja definido em Brcobranca::Retorno::Base (em
+        # vez de nomes especificos do Itau), pois e esse vocabulario que
+        # fica exposto para quem consome a classe via
+        # Brcobranca::Retorno::Cnab240::Base (ex.: a API HTTP do
+        # boleto_cnab_api so serializa os atributos ja conhecidos dessa
+        # lista generica).
+        #
+        # Posicoes conforme manual "Cobranca FEBRABAN 240" do Itau, item
+        # 3.2 (Arquivo Retorno), Segmentos T e U.
+        class Line < Base
+          extend ParseLine::FixedWidth # Extendendo parseline
+
+          REGISTRO_T_FIELDS = %w[
+            codigo_registro codigo_ocorrencia agencia_com_dv carteira
+            nosso_numero cedente_com_dv documento_numero data_vencimento
+            valor_titulo agencia_recebedora_com_dv valor_tarifa
+            motivo_ocorrencia sequencial
+          ].freeze
+          REGISTRO_U_FIELDS = %w[
+            juros_mora desconto_concedito valor_abatimento iof_desconto
+            valor_recebido outros_recebimento data_ocorrencia data_credito
+          ].freeze
+
+          attr_accessor :tipo_registro
+
+          fixed_width_layout do |parse|
+            # comuns aos registros T e U
+            parse.field :codigo_registro, 7..7
+            parse.field :sequencial, 8..12
+            parse.field :tipo_registro, 13..13
+            parse.field :codigo_ocorrencia, 15..16
+
+            # segmento T
+            parse.field :agencia_com_dv, 18..21
+            parse.field :cedente_com_dv, 30..36
+            parse.field :carteira, 37..39
+            parse.field :nosso_numero, 40..47
+            parse.field :documento_numero, 58..67
+            parse.field :data_vencimento, 73..80
+            parse.field :valor_titulo, 81..95
+            parse.field :agencia_recebedora_com_dv, 99..104
+            parse.field :valor_tarifa, 198..212
+            parse.field :motivo_ocorrencia, 213..220
+
+            # segmento U
+            parse.field :juros_mora, 17..31
+            parse.field :desconto_concedito, 32..46
+            parse.field :valor_abatimento, 47..61
+            parse.field :iof_desconto, 62..76
+            parse.field :valor_recebido, 77..91
+            parse.field :outros_recebimento, 92..106
+            parse.field :data_ocorrencia, 137..144
+            parse.field :data_credito, 145..152
+          end
+        end
+      end
+    end
+  end
+end

data/lib/brcobranca/util/itau.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Brcobranca
+  module Util
+    # Regras de calculo de digito verificador (DAC) compartilhadas entre as
+    # implementacoes de Boleto e Remessa/Retorno CNAB do Itau (341), para
+    # evitar duplicacao e manter as duas em sincronia.
+    module Itau
+      # Carteiras cujo DAC do nosso numero e calculado apenas com
+      # "carteira/nosso_numero", sem agencia/conta.
+      CARTEIRAS_SEM_AGENCIA_CONTA = %w[112 126 131 146 150 168].freeze
+
+      module_function
+
+      # Digito verificador (modulo 10) da agencia/conta corrente.
+      #
+      # @return [Integer]
+      def agencia_conta_corrente_dv(agencia, conta_corrente)
+        "#{agencia}#{conta_corrente}".modulo10
+      end
+
+      # Digito verificador (modulo 10) do nosso numero.
+      #
+      # Para a grande maioria das carteiras, e calculado sobre
+      # "agencia/conta_corrente/carteira/nosso_numero". Excecao: carteiras em
+      # CARTEIRAS_SEM_AGENCIA_CONTA, calculado apenas sobre
+      # "carteira/nosso_numero".
+      #
+      # @return [Integer]
+      def nosso_numero_dv(agencia, conta_corrente, carteira, nosso_numero)
+        if CARTEIRAS_SEM_AGENCIA_CONTA.include?(carteira.to_s)
+          "#{carteira}#{nosso_numero}".modulo10
+        else
+          "#{agencia}#{conta_corrente}#{carteira}#{nosso_numero}".modulo10
+        end
+      end
+    end
+  end
+end

data/lib/brcobranca/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Brcobranca
-  VERSION = '12.0.0'
+  VERSION = '13.0.0'
 end

data/lib/brcobranca.rb

@@ -148,6 +148,7 @@ module Brcobranca
 
     module Cnab240
       autoload :Base,          'brcobranca/retorno/cnab240/base'
+      autoload :Itau,          "brcobranca/retorno/cnab240/itau"
       autoload :Santander,     'brcobranca/retorno/cnab240/santander'
       autoload :Sicredi,       'brcobranca/retorno/cnab240/sicredi'
       autoload :Sicoob,        'brcobranca/retorno/cnab240/sicoob'
@@ -186,6 +187,7 @@ module Brcobranca
       autoload :Base,               'brcobranca/remessa/cnab240/base'
       autoload :BaseCorrespondente, 'brcobranca/remessa/cnab240/base_correspondente'
       autoload :Caixa,              'brcobranca/remessa/cnab240/caixa'
+      autoload :Itau,               "brcobranca/remessa/cnab240/itau"
       autoload :BancoBrasil,        'brcobranca/remessa/cnab240/banco_brasil'
       autoload :Santander,          'brcobranca/remessa/cnab240/santander'
       autoload :Sicoob,             'brcobranca/remessa/cnab240/sicoob'
@@ -200,5 +202,6 @@ module Brcobranca
   module Util
     autoload :Empresa, 'brcobranca/util/empresa'
     autoload :Errors, 'brcobranca/util/errors'
+    autoload :Itau, "brcobranca/util/itau"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brcobranca
 version: !ruby/object:Gem::Version
-  version: 12.0.0
+  version: 13.0.0
 platform: ruby
 authors:
 - Kivanio Barbosa
@@ -150,6 +150,7 @@ files:
 - lib/brcobranca/remessa/cnab240/base.rb
 - lib/brcobranca/remessa/cnab240/base_correspondente.rb
 - lib/brcobranca/remessa/cnab240/caixa.rb
+- lib/brcobranca/remessa/cnab240/itau.rb
 - lib/brcobranca/remessa/cnab240/santander.rb
 - lib/brcobranca/remessa/cnab240/sicoob.rb
 - lib/brcobranca/remessa/cnab240/sicoob_banco_brasil.rb
@@ -175,6 +176,7 @@ files:
 - lib/brcobranca/retorno/cnab240/ailos.rb
 - lib/brcobranca/retorno/cnab240/base.rb
 - lib/brcobranca/retorno/cnab240/caixa.rb
+- lib/brcobranca/retorno/cnab240/itau.rb
 - lib/brcobranca/retorno/cnab240/santander.rb
 - lib/brcobranca/retorno/cnab240/sicoob.rb
 - lib/brcobranca/retorno/cnab240/sicredi.rb
@@ -194,6 +196,7 @@ files:
 - lib/brcobranca/util/date.rb
 - lib/brcobranca/util/empresa.rb
 - lib/brcobranca/util/errors.rb
+- lib/brcobranca/util/itau.rb
 - lib/brcobranca/validations.rb
 - lib/brcobranca/version.rb
 homepage: https://github.com/kivanio/brcobranca
@@ -215,7 +218,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - GhostScript > 9.0, para gerar PDF e código de Barras
-rubygems_version: 3.6.7
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Gem que permite trabalhar com boletos e CNABs para bancos brasileiros.
 test_files: []