> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piposaude.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# listar_faturas

> Lista as faturas publicadas de uma empresa, com valor total e resumo dos boletos

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.

> [!NOTE]
>
> 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.

> [!WARNING]
>
> **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`](https://docs.piposaude.com.br/mcp/tools/faturamento/consultar-pendencias-faturas).

## Parâmetros

| Parâmetro | Obrigatório | Descrição |
| - | - | - |
| `cnpj` | Sim | CNPJ da empresa, com ou sem pontuação. |
| `referencia_inicio` | Não | Início do período de referência, no formato `AAAA-MM-DD`. |
| `referencia_fim` | Não | Fim do período de referência, no formato `AAAA-MM-DD`. A data entra no recorte. |
| `operadora` | Não | Nome exato da operadora. Maiúsculas e minúsculas não fazem diferença. |
| `configuracao_id` | Não | UUID da configuração de faturamento. Não é o ID do contrato de benefício. |
| `limite` | Não | Máximo de faturas por página. Padrão 50, máximo 50. |
| `deslocamento` | Não | Posição inicial da página. Padrão 0. Use o `proximo_deslocamento` da resposta anterior. |

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.

> [!NOTE]
>
> 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`](https://docs.piposaude.com.br/mcp/tools/faturamento/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`](https://docs.piposaude.com.br/mcp/tools/faturamento/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"


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.