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

