Exibir origem

01. VISÃO GERAL

Configurações necessárias para o registro de boletos por API do Itaú.

Para a comunicação do Protheus com o banco é necessário configurar a segurança de rede, caso necessário, para aceitar a saída da faixa de IP referente ao DNS:

https://sts.itau.com.br/

https://api.itau.com.br/

02. HABILITAR SERVIÇO - ITAÚ

Para a utilização da API do Itaú é necessário a ativação do serviço em sua conta. Esse processo deve ser solicitado diretamente ao seu gerente de conta.

Para estabelecer uma conexão segura com os API Gateways do Itaú é necessário enviar um client certificate. Este certificado é usado para estabelecer o mTLS (OAuth 2.0 Mutual Transport Layer Security).

Mais detalhes do processo de geração do certificado devem ser obtidos no portal do Itaú : https://devportal.itau.com.br/. O acesso ao mesmo deve ser também solicitado ao seu gerente de conta.

Nesse processo será gerado dois arquivos, um com extensão CRT e outro KEY que serão utilizados no processo de configuração e layout do Novo Gestor Financeiro.

Caso o ambiente esteja utilizando a primeira versão da API (V1) liberada no NGF, que não utiliza certificado, você pode editar o seu layout e assim atualizar para a nova versão, depois de realizados os pontos acima.

Novas configurações de contas serão realizadas apenas para a nova versão liberada (V2), com certificado.

03. CADASTRO DE BANCO - MATA070

Para habilitar a configuração de um layout para o Itaú, deve ser informado no campo Bco Oficial (A6_BCOOFI) o código 341.

É necessário o cadastro correto do dígito verificador da conta no campo Dv Conta (A6_DVCTA)

Caso o cadastro esteja incorreto na tabela de bancos (SA6), o ajuste deve ser realizado em sua subconta no Cadastro Parâmetros de bancos (tabela SEE) nos campos Age. Oficial (EE_AGEOFI), Cta. Oficial (EE_CTAOFI) e DV Cta.Ofic. (EE_DVCTOFI).

Exemplo de conta que precisa ser adequada : Conta 12345-6

No cadastro do banco, campo Nro Conta (A6_NUMCOM) = 123456 e DV Conta (A6_DVCTA) = vazio, o ajuste em sua sub conta deve ser Cta. Oficial (EE_CTAOFI) = 12345 e DV Cta.Ofic. (EE_DVCTOFI) = 6

04. PARÂMETROS DE BANCO - FINA130

Código da carteira deve ser informado no campo Cód. Carteira (EE_CODCART).
Nosso número deve ser parametrizado nos campos Faixa Inicio (EE_FAXINI) , Faixa Fim (EE_FAXFIM) e Faixa atual (EE_FAXATU).
Para utilizar as instruções de cobrança, deve ser preenchido o campo Banco Oficial (EE_CODOFI) com '341'.
Itaú VERSÃO 1 - Somente será possível enviar instruções de cobrança a partir do preenchimento dos campos na pasta Itaú:
1. Cod. Cob. 1 (EE_CODCOB1) → Instrução de cobrança para o boleto
2. Cód. Cob. 2 (EE_CODCOB2) → Instrução de cobrança para o boleto
3. Cód. Cob. 3 (EE_CODCOB3)→ Instrução de cobrança para o boleto
4. Dias Protest (EE_ITAUPRT) → Quantidade de dias de protesto do boleto
5. Dias Devolu. (EE_ITAUDEV) → Quantidade de dias para devolução do Boleto
6. Dias Não Rec (EE_ITAUNAO) → Quantidade de dias para não receber Boleto
Itaú VERSÃO 2 - Somente será possível enviar instruções de cobrança a partir do preenchimento dos campos abaixo:
1. Mensagem 1 (EE_FORMEN1) → Instrução de cobrança para o boleto (Formula)
2. Mensagem 2 (EE_FORMEN2) → Instrução de cobrança para o boleto (Formula)
3. Mens. Extra 1 (EE_FOREXT1)→ Instrução de cobrança para o boleto (Formula)
4. Mens. Extra 2 (EE_FOREXT2)→ Não será usado para impressão da instrução. Itaú permite somente 03 mensagens
5. Dias Protest (EE_DIASPRT) → Quantidade de dias de protesto do boleto
6. Dias Recebim (EE_DIASREC) → Quantidade de dias para devolução do Boleto

Para funcionamento da comunicação bancária por API do Itaú o usuário deve configurar os parâmetros de banco

05. LAYOUT - FINA710 - NOVO GESTOR FINANCEIRO

Ao iniciar a configuração de layout para uma nova conta do Itaú serão apresentados os passos:

01. Seleção da conta

Selecione a conta que deseja realizar a configuração

02. Inserção de credenciais

Nesse passo serão inseridas as informações obtidas junto ao banco no processo de habilitar o serviço em sua conta.

Informe nesse passo o ID do cliente e Chave secreta do cliente fornecidos pelo banco.

Informe o nome do Arquivo chave do certificado (KEY) e Arquivo de certificado (CRT).

03. Configuração de layout

Nesse passo, serão configuradas todas as informações que serão encaminhadas para o banco na transmissão do boleto.

04. Ambiente de homologação

Quando em ambiente de homologação, o banco não retorna as informações de linha digitável e código de barras.

06. CONFIGURAÇÃO DE LAYOUT

Para a utilizar o registro online de boletos para o Itaú Versão 2, deve-se observar a seguinte regra:

Porc Juros Mensal: Neste campo, deve ser informado o percentual mensal de juros.

Como padrão, disponibilizamos o campo E1_PORCJUR já multiplicado por 30, respeitando a seguinte regra: juros diário X 30 dias = juros mensal

Número do documento: Neste campo deverá ser informado qual será o número do documento que será transmitido ao banco e posteriormente impresso no boleto.

Onde poderá ser:

1. Número do Título (E1_NUM)
2. ID CNAB (E1_IDCNAB)
3. Expressão definida pelo usuário.
  - O resultado da expressão será atribuído ao campo “Número do documento”. Para as macros-execuções a expressão a ser executada deverá ser válida. Para informar uma expressão clique na “Engrenagem” que está ao lado do campo.

Linha Microsiga Protheus > Itaú - Configuração Boletos - FINA710 > num_doc_layout_field.png

Linha Microsiga Protheus > Itaú - Configuração Boletos - FINA710 > num_doc_layout_expression.png

BoleCode (Boleto + Pix): Este campo indica se o boleto terá opção de pagamento via QR Code (Pix). O QR Code é impresso no boleto e é possível o cliente efetuar o pagamento pelo QRCode ou pelo Código de Barras.
- Sim - O boleto será registrado com o PIX, na impressão irá aparecer o QR Code PIX para recebimento do valor.
- Não - O Boleto será registrado sem o PIX, na impressão não irá aparecer o QR Code PIX.
  - Para ativar esta funcionalidade é necessário entrar em contato com o banco Itaú. O banco Itaú irá disponibilizar um novo certificado e novas credenciais que deverão ser informados em 'Configurar BoleCode'

Essa funcionalidade esta em processo de piloto, sendo assim, ainda não esta liberada para uso!

Aceite: Este campo indica o reconhecimento formal da divida (assinatura no documento) pelo pagador, deverá ser informado os valores:
- Sim - Quando existe a necessidade do pagador reconhecer/aceitar a cobrança.
- Não - Quando não existe a necessidade de reconhecimento da cobrança.

Linha Microsiga Protheus > Itaú - Configuração Boletos - FINA710 > image2023-2-8_11-30-53.png

Beneficiário Filial: Neste campo deverá ser informado qual filial que será utilizada para a transmissão e impressão do boleto.

Linha Microsiga Protheus > Itaú - Configuração Boletos - FINA710 > image2023-2-8_11-32-57.png

Os dados cadastrados nessa filial serão utilizados na transmissão e na impressão:

Linha Microsiga Protheus > Itaú - Configuração Boletos - FINA710 > image2023-2-8_14-32-25.png

Caso este campo não esteja preenchido a Filial Atual (Filial Logado ou Filial configurada no agendamento) será utilizada no dados da transmissão e impressão do boleto.