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

# ler_documento_fatura

> Lê o conteúdo de um PDF ou XLSX da fatura no servidor da Pipo

Lê o conteúdo de um documento da fatura em PDF ou XLSX e entrega o texto ao assistente. A leitura acontece no servidor da Pipo. O assistente não precisa abrir nenhum link. A ferramenta reconhece o formato pelo conteúdo do arquivo.

Use o `fatura_id` de [`listar_faturas`](https://docs.piposaude.com.br/mcp/tools/faturamento/listar-faturas) e o `documento_id` de [`listar_documentos_fatura`](https://docs.piposaude.com.br/mcp/tools/faturamento/listar-documentos-fatura). Cada chamada confere de novo a empresa, a fatura e o arquivo.

* **PDF:** devolve o texto de até 5 páginas por chamada. Uma página longa pode vir em mais de uma parte.
* **XLSX:** devolve a lista de abas e as células de uma aba, com o endereço (por exemplo, `B7`), o valor e o formato. Células com zero também aparecem. Cada chamada traz até 200 células.

> [!WARNING]
>
> **Fórmulas de planilha não são recalculadas.** A ferramenta mostra só o último resultado salvo no arquivo. Esse resultado pode estar desatualizado ou faltar. A ferramenta também não soma subtotais. Confira os totais no arquivo original antes de usar o número.

> [!WARNING]
>
> O conteúdo do documento não confirma pagamento, quitação nem saldo devedor. Em PDF, a extração pode perder o desenho das tabelas.

## O que a ferramenta não lê

* Arquivos com mais de **10 MiB**.
* Páginas digitalizadas (imagem sem texto). Não há OCR. A resposta avisa quando uma página não tem texto.
* Planilhas no formato XLS antigo, arquivos ZIP e arquivos protegidos por senha.
* Planilhas com macros. A ferramenta também não abre os links da planilha.
* PDF com mais de 10 000 páginas. XLSX com mais de 100 abas ou mais de 200 000 células em uma aba.

Nesses casos, baixe o original com [`obter_documento_fatura`](https://docs.piposaude.com.br/mcp/tools/faturamento/obter-documento-fatura). Se a leitura estiver ocupada, tente de novo em instantes.

> [!NOTE]
>
> A ferramenta oculta textos com o padrão de CPF e de e-mail. Isso **não** é uma anonimização completa: nomes e outros dados pessoais podem continuar no texto. A Pipo não guarda o arquivo nem o texto lido.

## 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`. |
| `documento_id` | Sim | ID do documento, devolvido por `listar_documentos_fatura`. |
| `pagina_inicio` | Não | Só PDF. Página inicial. Padrão 1. |
| `quantidade_paginas` | Não | Só PDF. Quantas páginas ler. Padrão 1, máximo 5. |
| `aba` | Não | Só XLSX. Número da aba, a partir de 1. Padrão 1. |
| `deslocamento_celulas` | Não | Só XLSX. Posição da primeira célula na aba. Padrão 0. |
| `limite_celulas` | Não | Só XLSX. Quantas células ler. Padrão 100, máximo 200. |
| `deslocamento_texto` | Não | Ponto de continuação dentro de uma página ou célula longa. Padrão 0. Prefira o `next_uri`. |

Não misture os parâmetros: em um PDF, não use os parâmetros de aba e célula; em um XLSX, não use os parâmetros de página.

> [!NOTE]
>
> Cada resposta tem até 64 KiB. Quando o documento continua, a resposta traz `next_uri`. Use [`ler_pagina_faturamento`](https://docs.piposaude.com.br/mcp/tools/faturamento/ler-pagina-faturamento) com o `next_uri` até o fim do documento. A continuação termina o trecho atual antes de passar para a próxima página ou aba.

## Exemplos de perguntas

* "O que diz o demonstrativo da fatura de setembro?"
* "Quais valores aparecem na planilha de demonstrativo desta fatura?"
* "Qual a data de vencimento escrita no boleto desta fatura?"


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