Skip to main content
Depende da chave consultas e é restrita a administrador e dono. Na barra lateral, Prospectar → Consultas.
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:

Pessoa

Consultas por CPF.

Empresa

Consultas por CNPJ.

Veículo

Consultas por placa ou por documento do proprietário.
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

1

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

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.

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.