Histórico da Página
...
Informações | ||
---|---|---|
| ||
Caso o ambiente esteja utilizando a primeira versão 1 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 2 (V2), com certificado. |
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 2 - Somente será possível enviar instruções de cobrança a partir do preenchimento dos campos abaixo:
- Banco Oficial (EE_CODOFI) → Não preencher.
- Mensagem 1 (EE_FORMEN1) → Instrução de cobrança para o boleto (Formula)
- Mensagem 2 (EE_FORMEN2) → Instrução de cobrança para o boleto (Formula)
- Mens. Extra 1 (EE_FOREXT1)→ Instrução de cobrança para o boleto (Formula)
- Mens. Extra 2 (EE_FOREXT2)→ Não será usado para impressão da instrução. Itaú permite somente 03 mensagens
- Dias Protest (EE_DIASPRT) → Quantidade de dias de protesto do boleto
- Dias Recebim (EE_DIASREC) → Quantidade de dias para devolução do Boleto
...
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.
...
- 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.
...
Aviso | ||
---|---|---|
| ||
Importante
|
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 com SSL e disponibilizado para o Banco do Brasil ( verificar junto ao Banco do Brasil onde informar essa URL para envio de informações ao Protheus). O REST deve estar habilitado com SSL utilizando um certificado A1 (Exemplo de configuração).
Para mais detalhes acessar
...
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ú.devportal.itau.com.br/nossas-apis/itau-ep9-gtw-boletos-boletos-v3-ext-aws#tag/boletowebhooklink webhook pix: https://devportal.itau.com.br/nossas-apis/itau-ep9-gtw-pix-recebimentos-ext-v2