Linha RM

Atalhos

Páginas filhas
  • DT Registro Boleto Online Itaú

Registro Boleto Online Itaú

Características do Requisito

Linha de Produto:

RM

Segmento:

Construção & Projetos

Módulo:

TOTVS Gestão Financeira

Requisito/Story/Issue:

FINANCEIRO01-24

Descrição

Esta implementação tem como objetivo preparar o TOTVS Gestão Financeira para utilizar o serviço de registro online de cobrança registrada do Banco Itaú.


Procedimento para Configuração

No TOTVS Gestão Financeira, menu Movimentações Bancárias | Controle Bancário | Convênio, devem ser feitas as configurações do convênio para o registro de boleto online:


  • Permite registro de boleto online: Define se o convênio permite utilizar o registro de boleto online.
  • Ambiente: Define o ambiente que será feito o registro do boleto no Banco.
  • Modelo de Registro Online: Define o modelo do registro online: v1 ou v2
    1. No modelo v2 o ambiente de teste não irá salvar Código de barras e  IPTE, pois é apenas um ambiente para validação
  • URL do serviço de registro do boleto: Deve ser informada a URL do serviço de registro do boleto disponibilizada pelo Banco. 
  • URL do sistema autorizador: Deve ser informado a URL do sistema autorizador que retornará o token de acesso ao serviço de registro de cobrança.
  • Chave: Parâmetro de acesso ao serviço de registro de boleto fornecido pelo Banco (campo disponível somente no modelo "v1")
  • Client Id: Código de acesso ao sistema autorizador fornecido pelo Banco.
  • Client Secret: Senha de acesso ao sistema autorizador fornecido pelo Banco.
  • Certificado digital: Informe o certificado digital obtido pela empresa (campo disponível somente no modelo "v2")
  • Caminho do arquivo de chave privada: Informe o caminho onde se encontra o arquivo pertinente a chave privada (campo disponível somente no modelo "v2")
    • Caso o certificado digital for um arquivo .pfx que já contempla a chave privada, não será necessário informar esse caminho

Atenção:

  • Deve ser informado o CNPJ do beneficiário/cedente na pagina Dados Adicionais.

Pode ser utilizado o Cadastro de Layout do Registro Online, para enviar dados de forma flexível para o registro online dos boletos para o banco. Para isso deve ser feito o Cadastro de associação de fórmulas e campos do registro online no cadastro do convênio.

O cadastro do layout do registro online do Itaú deve ser feita de acordo com o manual de cobrança online do banco, da seguinte maneira:

Obs.: O Layout da V1 é totalmente diferente da v2, então o cadastro de layout de registro on-line deve ser refeito na migração da v1 para v2. Veja abaixo alguns exemplos

Exemplos para os campos da seção principal:

  • v1
    • tipo_carteira_titulo 
    • valor_cobrado
  • v2
    • data.dado_boleto.codigo_carteira
    • data.dado_boleto.valor_total_titulo




Exemplos para os campos da seção juros:

  • v1
    • juros.tipo_juros 
  • v2
    • data.dado_boleto.juros.codigo_tipo_juros 



Exemplos para os campos da seção sacador avalista:

  • v1
    • sacador_avalista.cpf_cnpj_sacador_avalista
  • v2
    • data.dado_boleto.sacador_avalista.pessoa.nome_pessoa
    • data.dado_boleto.sacador_avalista.pessoa.nome_fantasia
    • data.dado_boleto.sacador_avalista.pessoa.tipo_pessoa.numero_cadastro_pessoa_fisica
    • data.dado_boleto.sacador_avalista.pessoa.tipo_pessoa.numero_cadastro_nacional_pessoa_juridica



Exemplo para os campos da seção grupo de desconto:

  • v1
    • grupo_desconto1.data_desconto
    • grupo_desconto1.tipo_desconto
  • v2 
    • data.dado_boleto.desconto.codigo_tipo_desconto
    • data.dado_boleto.desconto.descontos1.quantidade_dias_desconto
    • data.dado_boleto.desconto.descontos1.valor_desconto
    • data.dado_boleto.desconto.descontos1.percentual_desconto 
    • data.dado_boleto.desconto.descontos2.quantidade_dias_desconto
    • data.dado_boleto.desconto.descontos2.valor_desconto
    • data.dado_boleto.desconto.descontos2.percentual_desconto 
    • data.dado_boleto.desconto.descontos3.quantidade_dias_desconto
    • data.dado_boleto.desconto.descontos3.valor_desconto
    • data.dado_boleto.desconto.descontos3.percentual_desconto 



IMPORTANTE:

  • De acordo com o layout do banco pode ocorrer 5 (cinco) descontos, portanto o nome do campo deverá ser 'grupo_desconto1.', 'grupo_desconto2.' sucessivamente de acordo com número de vezes que ocorre. Seguir a mesma regra para o grupo de rateio e grupo de e-mail do pagador.
  • O campo Data da Multa será calculado a partir da Data de Vencimento do boleto acrescido do parâmetro Dias de Atraso configurado na etapa Valor Líquido do Lançamento Financeiro.
  • Ao utilizar o modelo 'v2' do registro online, não será possível efetuar o cancelamento online do registro do boleto na mesma data que ocorreu o registro online. Nesse caso, o cancelamento deverá ser efetuado através do processo de cancelamento de remessa de boleto. Obs: Esta regra é do Banco Itaú e não da aplicação.