> ## 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_documentos_fatura

> Lista os boletos, demonstrativos e outros arquivos publicados de uma fatura

Lista os documentos publicados de uma fatura. Cada documento mostra o `documento_id`, o nome do arquivo e o tipo: `boleto`, `demonstrativo` ou `outro`.

Use o `id` da fatura que [`listar_faturas`](https://docs.piposaude.com.br/mcp/tools/faturamento/listar-faturas) devolve. Com o `documento_id`, você pode:

* ler o conteúdo no próprio assistente, com [`ler_documento_fatura`](https://docs.piposaude.com.br/mcp/tools/faturamento/ler-documento-fatura);
* baixar o arquivo original, com [`obter_documento_fatura`](https://docs.piposaude.com.br/mcp/tools/faturamento/obter-documento-fatura).

Esta ferramenta não devolve links nem o conteúdo dos arquivos.

> [!WARNING]
>
> A lista mostra só os documentos que já foram publicados. Se um boleto ou demonstrativo não aparece, isso não quer dizer que ele não existe. Ele pode ainda não ter sido publicado.

## Parâmetros

| Parâmetro | Obrigatório | Descrição |
| - | - | - |
| `cnpj` | Sim | CNPJ da empresa, com ou sem pontuação. |
| `fatura_id` | Sim | ID exato da fatura, devolvido por `listar_faturas`. Não é o ID da configuração de faturamento. |
| `limite` | Não | Máximo de documentos 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. |

> [!NOTE]
>
> Cada página traz até 50 documentos ou 64 KiB, o que vier primeiro. Para continuar, use [`ler_pagina_faturamento`](https://docs.piposaude.com.br/mcp/tools/faturamento/ler-pagina-faturamento) com o `next_uri` da resposta.

## Exemplos de perguntas

* "Quais documentos estão disponíveis para a fatura de setembro da Amil?"
* "Essa fatura já tem boleto e demonstrativo publicados?"


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