Linha RM

Atalhos

Páginas filhas
  • DT Registro Boleto Online Itaú

Versões comparadas

Versão antiga 97

changes.mady.by.user Flavio Silva Lourenco

Gravado em

comparado com

Nova versão 114

changes.mady.by.user Flavio Silva Lourenco

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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. Caso o certificado digital 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 privada (campo disponível somente no modelo "v2"). Caso o certificado digital for do tipo PKCS #12 (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 página 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 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

Image Modified


Exemplos Exemplo para os campos da seção "juros":

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

Image Modified


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

  • v1
    • sacador_avalista.cpf_cnpj_sacador_avalista

Image Added

  • 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
Image Removed

Image Added



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

  • v1
    • grupo_desconto1.data_desconto
    • grupo_desconto1.tipo_desconto

Image Added

  • 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 
Image Removed


Exemplo para os campos da seção "beneficiário":

  • v2
    • data.beneficiario.id_beneficiario

Image Added


Exemplos para os campos da seção "protesto":

  • v2
    • data.dado_boleto.protesto.protesto
    • data.dado_boleto.protesto.codigo_tipo_protesto
    • data.dado_boleto.protesto.quantidade_dias_protesto

Image Added


Exemplos para os campos da seção "instrucao_cobranca"

  • v2 - Permitido até 3 instrução de cobrança
    • data.dado_boleto.instrucao_cobranca1.codigo_instrucao_cobranca
    • data.dado_boleto.instrucao_cobranca1.quantidade_dias_apos_vencimento
    • data.dado_boleto.instrucao_cobranca1.dia_util
    • data.dado_boleto.instrucao_cobranca2.codigo_instrucao_cobranca
    • data.dado_boleto.instrucao_cobranca2.quantidade_dias_apos_vencimento
    • data.dado_boleto.instrucao_cobranca2.dia_util
    • data.dado_boleto.instrucao_cobranca3.codigo_instrucao_cobranca
    • data.dado_boleto.instrucao_cobranca3.quantidade_dias_apos_vencimento
    • data.dado_boleto.instrucao_cobranca1.dia_util



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.