Skip to main content
Esta página descreve o Relatório, a análise de crédito de um CPF ou CNPJ individual. Para criar um relatório na plataforma, ver Rodar uma Análise. Para criar via API, ver Criar Relatório. Não confundir com Esteira, o fluxo que pode encadear relatórios, documentos, alçada e contrato.

Visão geral

Um relatório é o produto principal da GYRA+. Ele reúne, em um único objeto estruturado, todas as informações relevantes para a análise de crédito de uma pessoa física (CPF) ou jurídica (CNPJ). Cada relatório é gerado a partir de um CPF ou CNPJ combinado com uma Política de Crédito. A política determina quais fontes serão consultadas, quais regras serão aplicadas e qual a decisão final.

Como criar um relatório

Na plataforma: no Toolbox, abra Operações, clique em “Nova operação”, informe o CPF ou CNPJ, selecione a política de crédito que define como a análise será feita, escolha o tipo de relatório e confirme. Ver Rodar uma Análise. Via API: enviar POST /report com o documento, o policyId da política e o tipo. Ver Criar Relatório.

Ciclo de vida de um relatório

O processamento é assíncrono. Após o POST /report, você recebe o resultado via webhook ou consulta com GET /report/:id.
Quando a política usa o Comitê de Crédito IA, há uma etapa a mais depois da decisão automática: os pareceres por seção e o resultado da política vão a comitê, que devolve uma decisão fundamentada. O comitê pode rodar sozinho ou ser convocado sob demanda, pelo botão Convocar Comitê no relatório ou por POST /report/{id}/committee. A conclusão é avisada pelo webhook COMMITTEE_FINISHED.

Status do relatório × Status da política

O relatório tem duas dimensões de status, que costumam ser confundidas: policyStatus sempre é calculado, mas ele só vira o status do relatório se a política estiver configurada para isso.

Configuração na política: “Usar resultado da política no relatório”

Cada política de crédito tem a opção “Usar resultado da política no relatório”:
  • Ligada (modo automático): o policyStatus é copiado para o status do relatório assim que a política é avaliada. O relatório já chega APPROVED, DENIED ou ALERT sem precisar de ação humana.
  • Desligada (modo manual): a política calcula o policyStatus normalmente (e ele fica visível no relatório como referência), mas o status do relatório só muda quando um analista decide via UI ou API. Útil quando a política é usada como apoio à mesa de crédito, e não como decisor final.

Fazendo análise manual

Independentemente do modo da política, é sempre possível sobrescrever ou complementar a decisão:
  • Pelo Toolbox: abra o relatório, leia o parecer e os indicadores, e use os botões de aprovar/negar com justificativa.
  • Pela API: use POST /report/analyze para registrar a primeira análise manual e POST /report/re-analyze para refazê-la se chegar nova informação.
A análise manual altera o status do relatório e dispara o webhook REPORT_STATUS. O policyStatus original é preservado para auditoria: você consegue ver tanto o que a política decidiu quanto o que o analista decidiu.
Use modo automático para fluxos de alto volume (onboarding, checkout) onde a política expressa todo o apetite de risco. Use modo manual quando a decisão exige julgamento humano (mesa de crédito B2B, due diligence, casos sensíveis).

Tipos de relatório

A GYRA+ oferece quatro profundidades de análise, identificadas como tipos de relatório. Cada tipo está vinculado à política de crédito utilizada.

Dados adicionais por relatório

Para cada tipo de relatório é possível adicionar dados complementares:

Comparativo completo dos relatórios

Acesse o comparativo detalhado com todos os campos disponíveis em cada tipo.

Estrutura de um relatório

Um relatório é composto por seções. Cada seção corresponde a um tema de análise (processos judiciais, protestos, score, etc.) e é gerada de forma independente pelas integrações ativas na política.
Veja a documentação completa de cada seção no Dicionário de Dados.

Como acessar um relatório

Configure um webhook para receber a decisão assim que o relatório for concluído, sem precisar fazer polling.