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

# obter_documento_fatura

> Gera um link temporário para baixar o arquivo original de uma fatura

Gera um link temporário para você baixar o arquivo original de um documento da fatura, como um boleto ou um demonstrativo. O link serve para qualquer formato de arquivo publicado, não só para PDF. A resposta mostra também o nome, o tipo do documento e a data e a hora de expiração do link (`expira_em`). O link expira pouco tempo depois de ser gerado: hoje, cerca de 30 minutos. Confira o horário exato em `expira_em`.

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). A ferramenta confere a empresa, a fatura e o arquivo antes de gerar o link. Ela não aceita links nem caminhos de arquivo informados por você.

> [!WARNING]
>
> **O link é uma credencial temporária.** Qualquer pessoa com o link consegue baixar o arquivo até ele expirar. O link continua válido até a expiração, mesmo que você saia da conta ou perca o acesso.
>
> * Compartilhe o link só com quem pediu o documento.
> * Não cole o link em canais abertos, e-mails em grupo ou tickets.
> * O arquivo original pode ter dados pessoais e financeiros, sem anonimização.

> [!NOTE]
>
> O assistente pode não conseguir abrir o link pela rede dele. Para que o assistente leia o conteúdo de um PDF ou XLSX, use [`ler_documento_fatura`](https://docs.piposaude.com.br/mcp/tools/faturamento/ler-documento-fatura) com os mesmos IDs. Essa ferramenta lê o arquivo no servidor da Pipo e não precisa do link.

O link não confirma pagamento.

## 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`. Não informe um link ou caminho de arquivo. |

## Exemplos de perguntas

* "Me passa o link para baixar o boleto da fatura de outubro"
* "Quero baixar o demonstrativo original desta fatura"


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