Skip to main content
Lista as faturas publicadas de uma empresa. Cada fatura mostra a operadora, a configuração de faturamento, o período de referência, o vencimento, o valor total, a quantidade de beneficiários e um resumo do status dos boletos. A lista vem ordenada da referência mais recente para a mais antiga. O CNPJ é resolvido para a empresa correspondente entre as que a sua conta acessa. A consulta não inclui as outras empresas do grupo. Para ver matriz e filiais, consulte cada CNPJ.
O valor vem em centavos de real no campo valor_total_centavos. Por exemplo, 123456 é R$ 1.234,56. O assistente faz a conversão ao responder.
O valor total não é saldo devedor. É o total da fatura, não o valor em aberto. O status dos boletos é o status publicado, que pode estar desatualizado. Esta ferramenta não confirma pagamento. Para ver o que pede atenção, use consultar_pendencias_faturas.

​
Parâmetros

Os filtros se combinam: a fatura precisa atender a todos. O período usa sobreposição: uma fatura entra quando o período de referência dela toca o intervalo informado. O filtro não usa a data de vencimento. As configurações arquivadas também aparecem.
Cada página traz até 50 faturas ou 64 KiB, o que vier primeiro. Quando há mais faturas, a resposta traz next_uri e proximo_deslocamento. Para continuar, use ler_pagina_faturamento com o next_uri. Cada página consulta os dados de novo. Se uma fatura mudar entre duas páginas, a ordem pode mudar.
A consulta lê até 10 000 faturas por empresa. Acima disso, a resposta avisa que o resultado é parcial. Esta ferramenta não mostra faturas que ainda não foram publicadas e não baixa documentos. Para ver os arquivos de uma fatura, use listar_documentos_fatura com o id da fatura.

​
Exemplos de perguntas

  • “Quais faturas da empresa 12.345.678/0001-95 foram publicadas em 2026?”
  • “Qual o valor total das faturas da Bradesco Saúde deste semestre?”
  • “Me mostre a última fatura desta empresa e o status dos boletos”