Histórico da Página

01. VISÃO GERAL

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

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.

...

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.

O certificado gerado no processo anterior deve ser então convertido, utilizando o Wizard de conversão de certificado - CFGX060 no módulo Configurador - SIGACFG. Com os arquivos convertidos, estes devem ser salvos dentro da pasta cert/ngf (abaixo da pasta protheus_data)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.

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.

...

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 parametrizadonos campos Faixa Inicio (EE_FAXINI) , Faixa Fim (EE_FAXFIM) e Faixa atual (EE_FAXATU).Para utilizar
• as Somente será possível enviar instruções de cobrança, deve ser preenchido o campo a partir do preenchimento dos campos abaixo: 
  
  1. Banco Oficial (EE_CODOFI
  ) com '341'
  1. ) → Não preencher.
  2. Mensagem 1 (EE_FORMEN1) → Instrução de cobrança para o boleto (Formula)
  3. Mensagem 2 (EE_FORMEN2) → Instrução de cobrança para o boleto (Formula)
  4. Mens. Extra 1 (EE_FOREXT1)→ Instrução de cobrança para o boleto (Formula)
  5. Mens. Extra 2 (EE_FOREXT2)→ Não será usado para impressão da instrução. Itaú permite somente 03 mensagens
  6. Dias Protest (EE_DIASPRT) → Quantidade de dias de protesto do boleto
  7. Dias Recebim (EE_DIASREC) → Quantidade de dias para devolução do Boleto 

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 o nome do Arquivo chave do certificado (KEY) e Arquivo de certificado convertidos pelo Wizard de conversão de certificado - CGFX060(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 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

                 Image Added

• 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. 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.

Image Added

Image Added

• 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' 
    • No momento da transmissão de Boleto com QR Code Pix o Itaú exige informar uma chave pix. É preciso informar uma chave pix como principal no cadastro de Banco(MATA070) → Outras Ações → Chaves PIX.
      Image Added
                                                                                                                                                                                                          Image Added

• 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.

Image Added

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

Image Added

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

Image Added

• Abatimento: Neste campo poderá ou não ser informado um valor de abatimento para o boleto.  

       Onde poderá ser:

1. 1. Vazio - Caso o valor original já esteja calculado com a dedução dos valores de abatimento ou não exista abatimento para o boleto.
   2. Valor Abatimento (SomaAbat()) - Calculo padrão do sistema conforme a expressão: "SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)" .
   3. Expressão definida pelo usuário.
      • O resultado da expressão será atribuído ao campo “Abatimento”. 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.

Image Added

É possível informar o valor original já deduzindo o valor do abatimento. Basta clicar na engrenagem no campo "Valor Original" e informar uma expressão válida:

Exemplo:

• • "SE1->E1_SALDO - SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)"

Image Added

07. PAGAMENTO COM VALORES DIVERGENTES

O Protheus não envia a informação se o boleto poderá ou não ser pago com valores divergentes pois essa configuração é efetuada na própria conta no Banco Itaú. Ou seja, o cliente que recebe o boleto poderá ou não pagar com valores divergentes de acordo com a configuração da conta que emitiu o boleto, não havendo nenhuma configuração para isso no Protheus. Portanto pedimos que entre em contato com seu gerente de contas e verifique se a sua conta está configurada de acordo com a necessidade.

08. CONFIGURAÇÃO DE BOLETO

Permite que o usuário configure como será a impressão do boleto.

• Imprime abatimento
  • Como mensagem - O valor do abatimento será impresso nas mensagens do boleto
  • Campo desconto/abatimento - O valor do abatimento no titulo será impresso no (-) Desconto/Abatimento do boleto

Image Added

09. WEBHOOK - BAIXA TÍTULOS RETORNO

Webhook é um serviço onde o banco envia informações de baixas de boletos para o ERP Protheus.

A comunicação do Itaú para o Protheus acontece via autenticação de certificados mTLS. Para mais detalhes acessar a documentação Portal Dev Itaú de cada Webhook mais abaixo.

É necessário um serviço REST habilitado no Protheus. O REST deve estar habilitado com SSL utilizando um certificado A1 (Exemplo de configuração).

O banco Itaú disponibiliza dois serviços de Webhook:

• Webhook Boleto
  • Notificação de boletos pagos via código de barras.
  • URL → exemplo: https://seuip:suaporta/api/fin/v1/itau/bol/receivables/
  • Cadastro da URL deve ser feito na Configuração de contas desejado no NGF, opção Baixa Títulos (Retorno).
  • Pré-condições:
    • Solicitar ao banco Itaú acesso a API Webhook Boleto.
  • Para mais detalhes acesse a documentação que está disponível no Portal Dev Itaú - Boleto.
• Webhook Pix
  • Notificação de boletos pagos via QR Code.
  • URL → exemplo: https://seuip:suaporta/api/fin/v1/itau/pix/receivables/pix
  • Cadastro da URL deve ser feito na Configuração de contas desejado no NGF, opção Configurar Bolecode.
  • Pré-condições:
    • Chave Pix principal cadastrada em: Banco(MATA070) → Outras Ações → Chaves PIX
    • Habilitar o campo BoleCode (Boleto + Pix)= Sim no Layout da configuração de contas.
    • Solicitar ao banco Itaú ativação da funcionalidade Bolecode/Pix. O Itaú deverá disponibilizar um novo certificado com novo Id Cliente e chave que deverão ser informados na opção Configurar Bolecode.
    • Solicitar ao banco Itaú acesso a API Webhook Pix.
  • Para mais detalhes acesse a documentação que está disponível no Portal Dev Itaú - Pix.

O cadastro da URL junto ao banco Itaú é realizado pelo Protheus. Ao informar as URLs de Webhook na configuração da conta, ao acionar o botão de salvar as alterações o Protheus se comunica com a API do banco Itaú para cadastro da URL informada junto ao Itaú. Caso algum erro ocorra será mostrado em tela e não irá salvar as alterações. Certifique-se que todas as pré-condições foram atendidas e acesso disponibilizado pelo banco Itaú para utilizar as APIs de Webhook. Ao deixar o campo da URL em branco o Protheus retira o cadastro da URL junto ao banco Itaú.