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

# consultar_pendencias_faturas

> Monta um checklist de boletos para conferência entre o RH e o Financeiro

Monta um checklist de conferência com os boletos das faturas de uma empresa. A ferramenta separa os boletos vencidos, os que estão perto do vencimento sem pagamento confirmado e os que ainda aguardam a data. Cada item mostra a fatura, a categoria e os dados do boleto, como o vencimento e os dias até o vencimento.

O CNPJ é resolvido para a empresa correspondente entre as que a sua conta acessa. A consulta **não inclui** as outras empresas do grupo.

> [!WARNING]
>
> **Este checklist não é uma cobrança nem um saldo devedor.** Ele usa o status publicado de cada boleto, que pode estar desatualizado. A ferramenta não consulta o banco, não confirma pagamento e não calcula o valor em aberto. O valor que aparece é o total da fatura.
>
> **A ausência de alertas não comprova que tudo foi pago.** Antes de concluir, leia os avisos da resposta e a contagem de itens com status não confirmado.

## Categorias do checklist

| Categoria | O que significa |
| - | - |
| `vencido_na_origem` | O boleto está publicado com o status vencido. |
| `vencimento_passado_sem_baixa_confirmada` | O vencimento já passou e o pagamento não está confirmado. |
| `vencimento_proximo_sem_baixa_confirmada` | O boleto vence em até `dias_alerta` dias e o pagamento não está confirmado. |
| `aguardando_checagem` | O boleto está pendente e vence depois do prazo de `dias_alerta`. |
| `status_nao_confirmado` | O status do boleto não pode ser interpretado. Fica fora da lista padrão. |
| `sem_boletos_publicados` | A fatura ainda não tem boletos publicados. |
| `dados_inconsistentes` | A fatura está marcada como sem boletos, mas tem boletos. |

Boletos pagos ou cancelados não entram no checklist. Faturas marcadas como sem boletos também não entram. A resposta sempre traz a contagem de itens de cada categoria.

> [!NOTE]
>
> **O status só vale para boletos com vencimento a partir de 1º de maio de 2026.** Um boleto com vencimento anterior, sem data de vencimento ou com status desconhecido vai para `status_nao_confirmado`. Esses itens não são alertas de cobrança e ficam fora da lista padrão. Para vê-los, use `incluir_status_nao_confirmado` ou `categoria` = `status_nao_confirmado`.

## Parâmetros

| Parâmetro | Obrigatório | Descrição |
| - | - | - |
| `cnpj` | Sim | CNPJ da empresa, com ou sem pontuação. |
| `dias_alerta` | Não | Quantos dias antes do vencimento o boleto vira alerta. Padrão 7, de 0 a 90. |
| `categoria` | Não | Mostra só uma categoria do checklist. Use um dos valores da tabela acima. |
| `incluir_status_nao_confirmado` | Não | `true` inclui os itens com status não confirmado, só para conferência. Padrão `false`. |
| `referencia_inicio` | Não | Início do período de referência da fatura, no formato `AAAA-MM-DD`. |
| `referencia_fim` | Não | Fim do período de referência da fatura, 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 itens 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: o item precisa atender a todos. O período usa sobreposição com o período de referência da fatura, não a data de vencimento. As datas seguem o horário de Brasília.

> [!NOTE]
>
> Cada página traz até 50 itens 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. O `next_uri` mantém os filtros e o `dias_alerta`.

## Exemplos de perguntas

* "Tem algum boleto vencido ou perto de vencer na empresa 12.345.678/0001-95?"
* "Quais boletos vencem nos próximos 15 dias sem pagamento confirmado?"
* "Liste os boletos com status não confirmado desta empresa para eu conferir com o Financeiro"


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