Histórico da Página

...

03. CADASTRO DE BANCO - MATA070

...

• 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 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ú: campos abaixo: 
  
  1. Banco Oficial
  2. Cod. Cob. 1 (EE_CODCOB1CODOFI) → Instrução de cobrança para o boleto
  3. Cód. Cob. 2 (EE_CODCOB2) → Instrução de cobrança para o boleto
  4. Cód. Cob. 3 (EE_CODCOB3)→ Instrução de cobrança para o boleto
  5. Dias Protest (EE_ITAUPRT) → Quantidade de dias de protesto do boleto
  6. Dias Devolu. (EE_ITAUDEV) → Quantidade de dias para devolução do Boleto 
  7. 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. 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 (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:

...

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

...

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