Liberação: 28/10/2026
#Financeiro

Objetivo da mudança:

Implementar na integração via API do Itaú Online os mesmos recursos de tratamento de encargos bancários e duplicatas descontadas já existentes na importação por arquivo de texto (remessa/retorno). Anteriormente, a carteira online do Itaú não possuía as abas e opções para configurar as tarifas de cobrança, a entrada e o estorno de duplicatas descontadas, o que impedia o lançamento automático de contas a pagar referentes a essas despesas. Com a alteração, a rotina foi equiparada ao modelo de arquivos físicos. A aba “Encargos Bancários” passa a ser exibida (quando ativada), permitindo configurar a parametrização do portador de duplicatas descontadas e a grade de ocorrências. A API agora consulta a “Francesinha” do Itaú para capturar as tarifas e os eventos de desconto (ocorrência 02), liquidação (06) e retorno para cobrança simples (48), processando a baixa, os estornos e o lançamento das tarifas de forma automatizada no sistema.

Rotinas / Telas:

Principal > Financeiro > Geração de Layout Bancário > Contas a Receber > Banco Itaú Online [341] , tela : Configuração de Layout Bancário (frmConfigItauAPI)

 Instruções sobre o que configurar:

Para utilizar as novas parametrizações de encargos e duplicatas descontadas, siga as instruções abaixo:

1. 1. Acesse Principal > Útil > Configuração do Sistema , tela : Configurações do Sistema (frmCfgSistema) e certifique-se de que a CFG_ENCBAN – “Controla taxa/encargos bancários no contas a receber?” esteja configurada como “Sim”;

   2. O acesso de integração da empresa junto ao Itaú (credencial) deve ter permissão para acessar a API Boletos V3 do Itaú e a “Francesinha” do banco;

   3. Acesse Principal > Financeiro > Geração de Layout Bancário > Contas a Receber > Banco Itaú Online [341] , tela : Configuração de Layout Bancário (frmConfigItauAPI);

   4. Com a CFG_ENCBAN ativa, a aba “Encargos Bancários” ficará visível. Acesse-a para realizar a parametrização das tarifas e ocorrências, que inclui o preenchimento do portador de duplicatas descontadas e da respectiva grade de ocorrências.

 Instruções sobre como utilizar:

Com a carteira configurada para encargos, a importação via API ocorrerá da seguinte forma:

1. 1. Acesse a rotina de importação de retorno do banco;

   2. Ao processar o arquivo, o sistema conectará à API do Itaú consultando os boletos pagos e a “Francesinha” do período;

   3. No caso de cobrança simples, o sistema registrará a ocorrência da tarifa no retorno e gerará um contas a pagar no momento da baixa;

   4. Na entrada no desconto (ocorrência 02), a importação identificará IOF, juros e tarifas, gerando o crédito do desconto e o contas a pagar das custas na baixa, mantendo a duplicata em aberto;

   5. Na liquidação de descontada (ocorrência 06), a baixa no sistema ocorrerá sem a geração de novo crédito na movimentação bancária;

   6. Na volta para cobrança simples (ocorrência 08/48), o estorno será processado, devolvendo o título para cobrança simples e registrando o débito do estorno na movimentação bancária;

   7. O relatório impresso após a importação passará a utilizar o modelo que demonstra as taxas detalhadas da operação.