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

# Consultas de dados

> Consulta a bureau brasileiro por CPF, CNPJ ou placa. Cada consulta é paga, então o acesso é restrito e existem defesas de custo antes da chamada.

<Info>
  Depende da chave `consultas` e é restrita a administrador e dono. Na barra lateral,
  **Prospectar → Consultas**.
</Info>

A tela de consultas pergunta a um bureau de dados brasileiro o que se sabe sobre um CPF,
um CNPJ ou uma placa. **Cada consulta é cobrada do dono da instância**, e é por isso que
o acesso é restrito por papel e que existem duas defesas antes de qualquer chamada sair.

## Como o catálogo é organizado

Um produto de consulta é uma pergunta de negócio, não uma rota de API. O primeiro corte
é sobre quem é a consulta:

<CardGroup cols={3}>
  <Card title="Pessoa">
    Consultas por CPF.
  </Card>

  <Card title="Empresa">
    Consultas por CNPJ.
  </Card>

  <Card title="Veículo">
    Consultas por placa ou por documento do proprietário.
  </Card>
</CardGroup>

Dentro disso, os produtos se agrupam em quatro famílias: **quem é e como falar**,
**situação financeira**, **risco e restrições** e **veículos e habilitação**.

## As defesas de custo

<Steps>
  <Step title="Validação local do documento">
    O dígito verificador do CPF e do CNPJ e o formato da placa são conferidos aqui,
    antes de a chamada sair. Documento inválido nunca vira consulta paga.

    Isso importa mais do que parece: pelo menos um dos bureaus **não valida documento**,
    e um CPF com dígito errado pode voltar com a ficha de outra pessoa.
  </Step>

  <Step title="Reaproveitamento de 30 dias">
    Uma consulta bem-sucedida do mesmo par produto e documento feita nos últimos 30 dias
    é reaproveitada em vez de refeita. Consultar o mesmo CNPJ duas vezes na mesma semana
    custa uma vez.
  </Step>
</Steps>

## Produto fora do ar

Antes de listar o catálogo, a plataforma pergunta a cada bureau se ele está de pé, por
endereços que não cobram nada. Só falha durável, como credencial recusada ou contrato
bloqueado, derruba um produto da tela; tempo esgotado e erro interno não escondem nada,
porque a consulta de verdade ainda tem chance de responder.

Um produto que nenhum bureau atende **sai da tela** em vez de falhar depois do clique.
Quando ele está fora do ar por contrato, a tela diz isso com essas palavras, para o
operador não achar que o problema é a conta dele.

## Histórico

Toda consulta fica registrada, com o bureau que atendeu, as tentativas, o identificador
da requisição, para abrir chamado citando a consulta exata, e se foi cobrada. É o
extrato de gasto do módulo.

## Credenciais

As chaves são da sua instância, cadastradas pelo super admin em
**Administração → Integrações**, e ficam cifradas. **Não existe chave global de
propósito**: uma chave nossa faria a plataforma pagar a consulta do cliente, e o
contrato de bureau é nominal.