Novidade ! ACBrBoleto Consulta em Lista (TpConsulta) Francesinhas ITAU API !

[Daniel InfoCotidiano]

Boas notícias pessoal.
Itau liberou um novo endpoint para realizar consultas em lista da movimentação de boletos com a promessa de dados mais estáveis, e informações mais completas nas respostas. Exemplo:

[Boletos Index            = 000]
NumeroBoleto              = 0XX57XX2
SeuNumero                 = XX2X0
dataRegistro              = 30/12/1899
dataVencimento            = 29/01/2025
valorOriginal             = 1092
valorPago                 = 1113,63
valorRecebido             = 1113,63
dataMovimento             = 05/02/2025
dataCredito               = 05/02/2025
valorJuros                = 0
valorMulta                = 0
valorOutrasDespesas       = 23,38
valorDesconto             = -1,75
variacaoCarteiraConvenio  = 0
codigoEstadoTituloCobranca= 06
estadoTituloCobranca      = Liquidado

Link da documentação:

https://devportal.itau.com.br/nossas-apis/itau-ep9-gtw-boletos-boletos-v3-ext-aws?tab=especificacaoTecnica#operation/get/francesas/{id_francesa}/movimentacoes

Tivemos relatos que em certos casos, necessita liberação do itau deste endpoint. Entrar em contato com o Suporte API Itau.
Veja tbm se está utilizando credenciais corretas para boletos normais e pix, pois existe em alguns casos credenciais ClientID, ClientSecret diferentes para Boletos Convencionais e Boletos Bolecode (hibridos)

Identificamos uma "inconformidade" do ITAU quando consultamos boletos com situação em Aberto:
O filtro da consulta (tipo de movimentação) em nossos testes, mesmo na ferramenta postman, ou seja, fora da solução ACBrBoleto, quando utilizado tipo_movimentacao=entradas ele está devolvendo boletos Liquidados com status de aberto e sem o valor de pagamento, esta resposta pode confundir o usuário, então por conta deste comportamento do banco Itaú, este filtro com situação em Aberto não está disponível para uso na solução ACBrBoleto.

* Isso acontece que o banco retorna o status do boleto dependente da data.*
  Exemplo de um boleto gerado 10/05/2025 e recebido/pago em 20/05/2025
 Se você pesquisar por abertos em 10/05/2025 ele vai aparecer Aberto e não liquidado (mesmo estando já liquidado na presente data)
 Se você pesquisar por liquidados em 20/05/2025 o mesmo boleto vai aparecer como liquidado.
Devido a isso,  a consulta com filtro isbAberto não está disponível, afim de evitar erros de processamento retroativo.


É uma consulta em lista por dia. (e não por período)

Como consultar Delphi / Lazarus
Precisa alimentar com um titulo, pode ser com o valor zerado, apenas para ele pegar algumas informações bancarias.

  FiltrosAPI.Clear;
  FiltrosAPI.indicadorSituacao        := isbBaixado; // (2-isbBaixado, 3-isbCancelado);
  FiltrosAPI.dataMovimento.DataInicio := strtodate('01/03/2025'); (consulta francesinhas diáriamente)
  FiltrosAPI.dataMovimento.DataFinal  := strtodate('01/03/2025'); (NAO É POR PERÍODO, A CONSULTA É POR DIA)
  FiltrosAPI.indiceContinuidade       := 0;
  Boleto.Configuracoes.WebService.Operacao := tpConsulta;
  Boleto.Enviar;

Para utilizar a consulta que já existia que devolvia qualquer situação de boletos, utilize indicadorSituacao = isbNenhum;

 FiltrosAPI.Clear;
  FiltrosAPI.indicadorSituacao        := isbNenhum; // (0-isbNenhum);
  FiltrosAPI.dataRegistro.DataInicio := strtodate('01/03/2025'); (Consulta por dia, nao é francesinha)
  FiltrosAPI.dataRegistro.DataFinal  := strtodate('01/03/2025'); (NAO É POR PERÍODO, A CONSULTA É POR DIA)
  FiltrosAPI.indiceContinuidade       := 0;
  Boleto.Configuracoes.WebService.Operacao := tpConsulta;
  Boleto.Enviar;

 É uma consulta em lista por dia. (e não por período)

Como consultar ACBrLib
Precisa alimentar com um titulo, pode ser com o valor zerado, apenas para ele pegar algumas informações bancarias.

  [ConsultaAPI]
* indicadorSituacao  : 2
  boletoVencido      : 1
  DataInicioMovimento: 01/04/2025  (consulta francesinhas diáriamente)
  DataFinalMovimento : 01/04/2025  (NAO É POR PERÍODO, A CONSULTA É POR DIA)
  indiceContinuidade : 0

Para utilizar a consulta que já existia que devolvia qualquer situação de boletos, utilize indicadorSituacao = isbNenhum;

  [ConsultaAPI]
* indicadorSituacao  : 0
  boletoVencido      : 1
  DataInicioRegistro: 01/04/2025  (Consulta por dia, nao é francesinha)
  DataFinalRegistro : 01/04/2025  (NAO É POR PERÍODO, A CONSULTA É POR DIA)
  indiceContinuidade : 0

 Como consultar ACBrMonitorPlus
Precisa alimentar com um titulo, pode ser com o valor zerado, apenas para ele pegar algumas informações bancarias.

  BOLETO.ConsultarTitulosPorPeriodo("[ConsultaAPI]
* indicadorSituacao  : 2
  boletoVencido      : 1
  DataInicioMovimento: 01/04/2025  (consulta francesinhas diáriamente)
  DataFinalMovimento : 01/04/2025  (NAO É POR PERÍODO, A CONSULTA É POR DIA)
  indiceContinuidade : 0")

Para utilizar a consulta que já existia que devolvia qualquer situação de boletos, utilize indicadorSituacao = isbNenhum;

  BOLETO.ConsultarTitulosPorPeriodo("[ConsultaAPI]
* indicadorSituacao  : 0
  boletoVencido      : 1
  DataInicioRegistro: 01/04/2025  (Consulta por dia, nao é francesinha)
  DataFinalRegistro : 01/04/2025  (NAO É POR PERÍODO, A CONSULTA É POR DIA)
  indiceContinuidade : 0")

 

Sobre o mapeamento "Valor de outras despesas":

Conforme print abaixo, não temos descriminado na documentação os códigos de juros, multa, descontos, etc para que seja mapeado em campos específicos.