Skip to main content
Resumo: toda análise começa pelo input sempre visível no topo do toolbox. Você digita o CPF ou CNPJ, o sistema identifica o tipo de documento, abre o dropdown com as políticas e as esteiras ativas e, ao apertar Enter, dispara o processamento. Em segundos o relatório está na tela. Para vários documentos, use o + do input e crie um lote.

O input sempre visível

No topo de todas as telas do toolbox fica o campo de análise. Ele é o ponto de entrada para qualquer consulta. O fluxo direto é:
1

Digitar o documento

CPF (11 dígitos) ou CNPJ (14 dígitos). O toolbox identifica o tipo automaticamente, valida o dígito verificador e filtra a lista de políticas compatíveis. Documento inválido é sinalizado antes de você poder prosseguir.
2

Escolher a política no dropdown

Logo abaixo do input abre um dropdown com as políticas e as esteiras ativas para o tipo de documento digitado, em dois grupos: Esteiras e Políticas. Se você marcou uma padrão (chave Definir como padrão, logo abaixo do dropdown), ela já vem pré-selecionada.Escolher uma esteira abre uma execução dela para o documento. Para acompanhar as etapas seguintes, veja Acompanhar execuções.
3

Apertar Enter

Dispara o processamento e redireciona você direto para a tela do relatório. Não há outro clique. Ctrl ou Cmd + Enter abre o relatório em nova guia.
4

Acompanhar o processamento

A análise passa pelos estados:
  • PROCESSING, coleta de dados em andamento.
  • EVALUATING, política rodando sobre os dados coletados.
  • COMPLETED, resultado disponível.
Tempo típico: 5 a 30 segundos, conforme as fontes consultadas.
5

Ler o resultado

Ao terminar, aparece status (APPROVED, ALERT, DENIED, ERROR), breakdown por regra e precificação, se houver. Guia em Interpretar Resultado do Relatório.
Se ao digitar o documento o dropdown vem vazio, é porque nenhuma política nem esteira compatível está ativa para aquele tipo. O gestor precisa ativar um template antes. Ver Usar Templates.
Para CNPJ, você pode anexar o PDF do balanço no próprio input (Adicionar PDF de balanço (opcional)), antes de disparar a análise. O relatório já nasce com a extração financeira em processamento. Também dá para enviar depois, pela gaveta Arquivos do relatório, em Enviar balanço / DRE. Detalhes em Análise Financeira.

Análise em lote

Para analisar vários documentos de uma vez, não precisa planilha nem upload de arquivo. Tudo começa pelo mesmo input:
1

Clicar no + do input

No canto do input sempre visível há o botão + (Lote de relatórios). Ele abre a janela Novo lote de relatórios.
2

Colar ou digitar os documentos

Copie uma coluna de CNPJs/CPFs de uma planilha, lista ou e-mail e cole na caixa. Também aceita digitação direta. O toolbox faz a checagem em tempo real: conta os documentos válidos, remove repetidos e lista os inválidos, que serão ignorados. Todos os documentos do lote precisam ser do mesmo tipo (CPF ou CNPJ). O limite recomendado é de 5.000 documentos por lote.
3

Nomear o lote e escolher a política

Clique em Próximo. Dê um nome reconhecível ao lote (ex: Revisão carteira Abril 2026) e selecione a política que vale para todos os documentos. Só aparecem políticas compatíveis com o tipo dos documentos.
4

Escolher quando rodar

Clique em Próximo de novo e escolha a frequência: Uma vez (entra no próximo ciclo de processamento, assim que criado), Diário, Semanal ou Mensal. Nos recorrentes, você escolhe os dias (no semanal e no mensal) e a janela de execução, e o lote roda até ser pausado.
5

Criar lote

Clique em Criar lote. O processamento roda em segundo plano, em paralelo, e o lote aparece em Análises de crédito, aba Em lote.
6

Acompanhar e baixar

Ao terminar, o lote entrega:
  • Um arquivo XLS com as principais informações agrupadas de cada documento (status, score, motivos, precificação).
  • O XLS fica disponível para download na aba Em lote.
  • Cada relatório individual também é acessível na plataforma pelo link no próprio XLS ou pela listagem do lote.
O XLS consolidado é o formato pensado para gestor de carteira ou analista revisar um grande volume rapidamente. Para investigar um caso específico, abra o relatório individual.

Via API

O fluxo equivalente por integração direta:
Resposta: objeto Report com id, que você pode consultar por polling ou receber via webhook. Referência em POST /v2/report.

Reanálise

A reanálise existe para casos em que um relatório foi gerado com dados incompletos ou com erro em alguma fonte, e ainda não fechou com decisão final (APPROVED ou DENIED). Como funciona:
  • Ao gerar o relatório novamente para o mesmo documento (pelo input ou pela API), o relatório existente é reprocessado caso ainda não esteja APPROVED ou DENIED. Os dados que estavam com erro ou parciais podem então ser revistos.
  • Se o relatório já fechou com status final (APPROVED ou DENIED), ele não é atualizado: uma nova chamada gera um relatório distinto.
Não há um botão “Reanalisar” no toolbox. A reanálise acontece automaticamente ao se solicitar uma nova análise para o mesmo documento, dentro das condições acima.

Limitações e considerações

  • Documento inválido é bloqueado antes do envio.
  • Dropdown vazio significa que não há política nem esteira ativa para o tipo, gestor precisa habilitar.
  • Fontes indisponíveis no momento da consulta podem gerar ERROR. O relatório mostra qual fonte falhou; basta reanalisar depois.
  • Concorrência do lote é paralelizada, mas lotes muito grandes podem ser enfileirados conforme o contrato.

Perguntas frequentes

Porque nenhuma política nem esteira compatível com o tipo de documento (PF ou PJ) está ativa para a sua organização. O administrador ou gestor precisa ativar pelo menos um template em Motor de crédito, Políticas, aba Templates. Ver Usar Templates.
Política é um conjunto de regras que roda sobre um documento e devolve um relatório com a decisão. Esteira é um fluxo com etapas (camadas de análise, documentos do cliente, alçada, contrato) que usa políticas no caminho; ver Esteiras.
Escolha a política (ou esteira) no dropdown que abre ao digitar o documento e ligue a chave Definir como padrão, logo abaixo. Vale uma padrão por tipo de documento (CPF e CNPJ).
Pode. Se o relatório anterior ainda não fechou com APPROVED ou DENIED, ele é reprocessado (reanálise). Se já fechou, uma nova chamada gera um relatório distinto.
Mais de 2 minutos em PROCESSING é sinal de fonte lenta ou falha temporária. Aguarde 1 minuto a mais e, se continuar, rode de novo. Se o padrão se repetir, fale com o suporte.
Análises que terminam em ERROR antes da avaliação da política não contam. As que chegaram a rodar a política, mesmo com fonte parcial, contam normalmente.

Próximos passos

Interpretar resultado

Status, breakdown por regra, precificação.

Acompanhar execuções

Seguir uma esteira etapa por etapa.

Webhooks

Receber o resultado em tempo real no seu backend.

API de relatório

Integração direta via HTTP.