Skip to main content
Esta página descreve Operação, um workflow que pode encadear vários relatórios. Não confundir com Relatório: um Relatório é a análise de uma única entidade; uma Operação pode gerar múltiplos relatórios em cascata (principal + sócios + filiais + endereços + parentes).
Resumo: uma Operação é uma receita reutilizável que diz “quando eu analisar este tipo de documento, quero também analisar vínculos relacionados, em ordem, aplicando políticas específicas para cada nível”. Útil principalmente para PJ, onde a decisão depende dos sócios, filiais e empresas relacionadas.

​
Por que existem

Uma análise isolada de um CNPJ é útil, mas muitas vezes o risco real está nos vínculos: sócios com histórico ruim, filiais em situação irregular, empresas ligadas por mesmo endereço. Reproduzir isso manualmente é lento e inconsistente. A Operação resolve isso: você desenha o fluxo uma única vez e, a cada análise, a GYRA+ executa a cascata de relatórios conforme as regras de parada que você definiu.

​
Anatomia de uma operação

Uma operação tem três blocos:

​
Níveis de vínculo disponíveis

Cada etapa pode cobrir um ou mais níveis simultaneamente.

​
Condição de entrada (condition)

Define quando a etapa seguinte deve rodar:

​
Condição de parada (stopCondition)

Define quando interromper a cascata para aquele vínculo específico:

​
Ciclo de vida de uma execução

​
Estados de cada folha (OperationResultLeaf)

Cada vínculo analisado recebe um estado:

​
Resultado agregado

A execução produz um OperationResult que contém:
  • O documento raiz analisado.
  • A versão da operação que rodou (rastreabilidade: se você editou depois, o resultado antigo ainda aponta para a versão antiga).
  • Uma lista de OperationResultLeaf, um por vínculo analisado, com status, referência ao relatório detalhado e o nível de vínculo.
No Toolbox, isso vira uma árvore: raiz em cima, vínculos expandidos por nível, status colorido em cada nó.

​
Exemplo concreto

Cenário: fintech de crédito PJ quer aprovar empresas só se a empresa e seus sócios estiverem limpos.
Leitura em português: “rode a política PJ Premium no CNPJ. Se reprovou, pare. Se aprovou, rode a política PF Express em cada sócio, se qualquer sócio reprovar, não vale a pena aprofundar, entregue o veredito.”

​
Versionamento e rastreabilidade

  • Toda alteração de operação cria nova versão (campo version).
  • OperationResult armazena qual versão rodou.
  • Mudanças ficam registradas em OperationChange com autor e tipo (EDITED, ADDED, REMOVED).
  • Isso garante que um resultado do mês passado continue explicável mesmo que você tenha mexido na operação hoje.

​
Próximos passos

Rodar uma operação

Passo a passo no Toolbox.

Interpretar o resultado

Como ler a árvore de vínculos e tomar decisão.

Política de Crédito

Cada etapa da operação usa uma política, entenda como configurá-la.

Relatório

Cada folha da operação gera um relatório completo.