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 Operação, que é o workflow que pode gerar vários relatórios encadeados.
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: enviarPOST /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.
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 ostatusdo relatório assim que a política é avaliada. O relatório já chegaAPPROVED,DENIEDouALERTsem precisar de ação humana. - Desligada (modo manual): a política calcula o
policyStatusnormalmente (e ele fica visível no relatório como referência), mas ostatusdo 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/analyzepara registrar a primeira análise manual ePOST /report/re-analyzepara refazê-la se chegar nova informaçã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.
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.

