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

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.