Pesquisar na Comunidade

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. Para Consultar Bolecode liquidado via QRCODE, precisa marcar indicadorPIX como TRUE 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. Para Consultar Bolecode liquidado via QRCODE, precisa marcar indicadorPIX como 1 (True) [ConsultaAPI] * indicadorSituacao : 2 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 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. Para Consultar Bolecode liquidado via QRCODE, precisa marcar indicadorPIX como 1 (True) BOLETO.ConsultarTitulosPorPeriodo("[ConsultaAPI] * indicadorSituacao : 2 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 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.

É 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. Para Consultar Bolecode liquidado via QRCODE, precisa marcar indicadorPIX True 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. Para Consultar Bolecode liquidado via QRCODE, precisa marcar indicadorPIX como 1 (True) [ConsultaAPI] IndicadorSituacaoBoleto = 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] IndicadorSituacaoBoleto = 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. Para Consultar Bolecode liquidado via QRCODE, precisa marcar indicadorPIX como 1 (True) BOLETO.ConsultarTitulosPorPeriodo("[ConsultaAPI] IndicadorSituacaoBoleto = 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] IndicadorSituacaoBoleto = 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 os filtros da consulta isbNenhum (consulta antiga): Lembrando que esta consulta em lista devolve todos boletos qualquer STATUS do dia informado com todas as situações. (full) pois a specific é para consulta individual, ja que ela obriga informar nosso numero.

Filtro de pesquisa para o Banco BTG Pactual. Delphi / Lazarus: Atenção: O Campo marcado com asterisco (*) é Obrigatório, sendo assim os demais são opcionais. Índice de continuidade é a paginação, quando necessário mais de uma consulta para o restante dos títulos. FiltrosAPI := Boleto.Configuracoes.WebService.Filtro; FiltrosAPI.Clear; * FiltrosAPI.indicadorSituacao := isbAberto; (Disponiveis: isbAberto, isbBaixado ou isbCancelado) FiltrosAPI.dataRegistro.DataInicio := strtodate('01/04/2025'); FiltrosAPI.dataRegistro.DataFinal := strtodate('02/04/2025'); FiltrosAPI.dataMovimento.DataInicio := strtodate('01/04/2025'); FiltrosAPI.dataMovimento.DataFinal := strtodate('02/04/2025'); FiltrosAPI.dataVencimento.DataInicio := strtodate('01/04/2025'); FiltrosAPI.dataVencimento.DataFinal := strtodate('02/04/2025'); FiltrosAPI.indiceContinuidade := 0; Atenção, o envio das consultas deve ser realizado pelo parâmetro: TpConsulta Boleto.Configuracoes.WebService.Operacao := tpConsulta; Exemplos: Consultar lista dos títulos em Aberto (sem exibir os boletos vencidos), Registrados no período 04/04/2025 até 10/04/2025: FiltrosAPI := Boleto.Configuracoes.WebService.Filtro; FiltrosAPI.Clear; * FiltrosAPI.indicadorSituacao := isbAberto; FiltrosAPI.dataRegistro.DataInicio := strtodate('04/04/2025'); FiltrosAPI.dataRegistro.DataFinal := strtodate('10/04/2025'); FiltrosAPI.indiceContinuidade := 0; Consultar lista dos títulos em cancelados, com vencimento no período 01/04/2025 até 05/04/2025: FiltrosAPI := Boleto.Configuracoes.WebService.Filtro; FiltrosAPI.Clear; * FiltrosAPI.indicadorSituacao := isbCancelado; FiltrosAPI.dataVencimento.DataInicio := strtodate('01/04/2025'); FiltrosAPI.dataVencimento.DataFinal := strtodate('05/04/2025'); FiltrosAPI.indiceContinuidade := 0; Consultar lista dos títulos Liquidados, com data movimento (liquidação) no período 01/04/2025 até 10/04/2025: FiltrosAPI := Boleto.Configuracoes.WebService.Filtro; FiltrosAPI.Clear; * FiltrosAPI.indicadorSituacao := isbBaixado; FiltrosAPI.dataMovimento.DataInicio := strtodate('01/04/2025'); FiltrosAPI.dataMovimento.DataFinal := strtodate('10/04/2025'); FiltrosAPI.indiceContinuidade := 0; ACBrLibBoleto: Atenção: É necessário incluir um titulo na lista de títulos antes do envio da consulta. O Campo marcado com asterisco (*) é Obrigatório, sendo assim os demais são opcionais. Índice de continuidade é a paginação, quando necessário mais de uma consulta para o restante dos títulos. [ConsultaAPI] * IndicadorSituacaoBoleto = 1 BoletoVencido = 0 contaCaucao = cnpjCpfPagador = codigoEstadoTituloCobranca = carteira = modalidadeCobranca = DataInicioRegistro = 01/04/2025 DataFinalRegistro = 02/04/2025 DataInicioMovimento = 01/04/2025 DataFinalMovimento = 02/04/2025 DataInicioVencimento = 01/04/2025 DataFinalVencimento = 02/04/2025 FiltrosAPI.indiceContinuidade = 0 Atenção, o envio das consultas deve ser realizado pelo parâmetro: TpConsulta Boleto_EnviarBoleto(3, sResposta, esTamanho); Exemplos: Consultar lista dos títulos em Aberto (sem exibir os boletos vencidos), Registrados no período 04/04/2025 até 10/04/2025: [ConsultaAPI] * indicadorSituacao := isbAberto boletoVencido := 1 DataInicioRegistro := 04/04/2025 DataInicioRegistro := 10/04/2025 indiceContinuidade := 0 Consultar lista dos títulos cancelados, com vencimento no período 01/04/2025 até 05/04/2025: [ConsultaAPI] * indicadorSituacao := 3 DataInicioVencimento := 01/04/2025 DataFinalVencimento := 05/04/2025 indiceContinuidade := 0 Consultar lista dos títulos Liquidados, com data movimento (liquidação) no período 01/04/2025 até 10/04/2025: [ConsultaAPI] * indicadorSituacao : 1 DataInicioMovimento: 01/04/2025 DataFinalMovimento : 10/04/2025 indiceContinuidade : 0 ACBrMonitorPlus: Atenção: O Campo marcado com asterisco (*) é Obrigatório, sendo assim os demais são opcionais. Índice de continuidade é a paginação, quando necessário mais de uma consulta para o restante dos títulos. BOLETO.ConsultarTitulosPorPeriodo("[ConsultaAPI] * IndicadorSituacaoBoleto = 1 DataInicioRegistro = 01/04/2025 DataFinalRegistro = 02/04/2025 DataInicioMovimento = 01/04/2025 DataFinalMovimento = 02/04/2025 DataInicioVencimento = 01/04/2025 DataFinalVencimento = 02/04/2025 FiltrosAPI.indiceContinuidade = 0") Exemplos: Consultar lista dos títulos em Aberto (sem exibir os boletos vencidos), Registrados no período 04/04/2025 até 10/04/2025: BOLETO.ConsultarTitulosPorPeriodo("[ConsultaAPI] * indicadorSituacao := 1 DataInicioRegistro := 04/04/2025 DataInicioRegistro := 10/04/2025 indiceContinuidade := 0") Consultar lista dos títulos Baixados, com vencimento no período 01/04/2025 até 05/04/2025: BOLETO.ConsultarTitulosPorPeriodo("[ConsultaAPI] * indicadorSituacao := 2 DataInicioVencimento := 01/04/2025 DataFinalVencimento := 05/04/2025 indiceContinuidade := 0") Consultar lista dos títulos Liquidados, com data movimento (liquidação) no período 01/04/2025 até 10/04/2025: BOLETO.ConsultarTitulosPorPeriodo("[ConsultaAPI] * indicadorSituacao : 3 DataInicioMovimento: 01/04/2025 DataFinalMovimento : 10/04/2025 indiceContinuidade : 0")

Sobre os filtros de consulta para a API Atual do SICREDI Esta consulta devolve todos boletos liquidados por DIA Se olhar no manual, só tem disponível esta consulta até o momento: É necessário incluir um titulo na lista de títulos antes do envio da consulta. Delphi/Lazarus: Situação isbBaixado, utilize DataMovimento no filtro. FiltrosAPI := Boleto.Configuracoes.WebService.Filtro; FiltrosAPI.Clear; FiltrosAPI.indicadorSituacao := isbBaixado; FiltrosAPI.dataMovimento.DataInicio := strtodate('07/04/2025'); (consulta apenas por DIA, nao por período) FiltrosAPI.dataMovimento.DataFinal := strtodate('07/05/2025'); FiltrosAPI.indiceContinuidade := 0; ACBrLib: Situação isbBaixado, utilize DataMovimento no filtro. [ConsultaAPI] IndicadorSituacaoBoleto = 2 DataInicioMovimento=07/09/2024 (ele consulta por dia, nao por período) DataFinalMovimento=09/09/2024 indiceContinuidade=0 ACBrMonitorPlus: Situação isbBaixado, utilize DataMovimento no filtro. BOLETO.ConsultarTitulosPorPeriodo("[ConsultaAPI] IndicadorSituacaoBoleto=2 (baixado) DataInicioMovimento=07/09/2024 (ela consulta por dia e nao por período) DataFinalMovimento=07/09/2024 indiceContinuidade=0")

Salve pessoal! Este tópico tem o objetivo de centralizar as informações disponíveis sobre a consulta em lista de API (tpConsulta) da solução ACBrBoleto. Como não existe um padrão para API, cada banco tem a sua particularidade em sua consulta em lista. Para facilitar, vamos criar links abaixo de cada banco, como realizar a consulta em lista. Para saber como funciona a consulta em Lista, selecione o Banco na lista Abaixo: Banco do Brasil Banrisul Bradesco BTG Pactual C6 Cora Credisis Cresol Itaú Inter PenseBank Safra Santander Sicoob Sicredi

Boas notícias pessoal, foi alterado o endpoint de consulta em lista do Santander API. No novo endpoint está mapeado informações como, juros, multas, descontos : Exemplo: [Boletos Index = 001] NumeroBoleto = 0000000xx0xx7 SeuNumero = Pyy9ww5xxP1 dataRegistro = 25/03/2025 dataVencimento = 19/03/2025 valorOriginal = 920,49 valorPago = 957,3 dataMovimento = 25/03/2025 dataCredito = 25/03/2025 valorJuros = 18,4 valorMulta = 18,41 valorOutrasDespesas = 0 valorDesconto = 0 variacaoCarteiraConvenio = 0 codigoEstadoTituloCobranca= 06 estadoTituloCobranca = LIQUIDADO contrato = 00XX83XX3 [Boletos Index = 002] NumeroBoleto = XX0XX00XX9XX4 SeuNumero = PXX9XX1XXP1 dataRegistro = 25/03/2025 dataVencimento = 25/03/2025 valorOriginal = 3454,6 valorPago = 3399 dataMovimento = 25/03/2025 dataCredito = 25/03/2025 valorJuros = 0 valorMulta = 0 valorOutrasDespesas = 0 valorDesconto = 55,6 variacaoCarteiraConvenio = 0 codigoEstadoTituloCobranca= 06 estadoTituloCobranca = LIQUIDADO - contrato = 00XX8XX63 Como é uma consulta em lista, não precisa adicionar titulo na lista. Como consultar Componentes Delphi e Lazarus: FiltrosAPI.Clear; FiltrosAPI.indicadorSituacao := isbBaixado; FiltrosAPI.dataMovimento.DataInicio := strtodate('01/03/2025'); FiltrosAPI.dataMovimento.DataFinal := strtodate('25/03/2025'); FiltrosAPI.indiceContinuidade := 0; Boleto.Configuracoes.WebService.Operacao := tpConsulta; Boleto.Enviar; Como consultar ACBrlib: [ConsultaAPI] IndicadorSituacaoBoleto = 2 DataInicioMovimento= 01/04/2025 DataFinalMovimento = 10/04/2025 indiceContinuidade = 0 Como consultar ACBrMonitorPlus: BOLETO.ConsultarTitulosPorPeriodo("[ConsultaAPI] IndicadorSituacaoBoleto = 2 DataInicioMovimento= 01/04/2025 DataFinalMovimento = 10/04/2025 indiceContinuidade = 0") Sobre a consulta.: Por enquanto a consulta a API do Banco está devolvendo apenas os boletos liquidados;

Agora o SICOOB V3 está implementada a consulta de movimentação. Para consulta de boletos em lista do Sicoob é necessário seguir 03 (três) passos: Solicitar a movimentação da carteira de cobrança registrada para beneficiário informado (As consultas estão limitadas em um período máximo de 2 dias); A API vai retornar o códigoSolicitação na propriedade NossoNumeroCorrespondente; Consultar a situação da solicitação da movimentação para saber se está disponível para download. Se estiver ele vai retornar os números arquivos disponível. (pode ser mais de um arquivo base64); Download e extração do(s) arquivo(s) de movimentação (a solução ACBr ja realiza o download e a descompactação internamente) e realiza leitura do retorno do arquivo e devolve a resposta padrão igual as outras API's; Vamos aos exemplos, como fazer (vou separar abaixo por tipo de Solução para ficar mais organizado): Se você utiliza componentes (Delphi ou Lazarus), clique aqui; Se você utiliza ACBrLibBoleto, clique aqui; Se você utiliza ACBrMonitor, clique aqui; Gostaria de agradecer o usuário @Rafaelbudag, que criou colaborou com a implementação inicial, realizamos alguns ajustes para compatibilizar com a versão V3 do Sicoob e com algumas propriedades já existentes em nossa solução. Obrigado também ao usuário @Microsys Sistemas por fornecer as credenciais de produção V3 para testes da consulta de movimentação, já que ambiente sandbox não é fiel a produção. *AS VIDEOS-AULAS SOBRE CONSULTA DE MOVIMENTAÇÃO SICOOB ESTÃO DISPONIVEL EM NOSSO PORTAL DE CURSOS*