Skip to main content
Uma execução é uma rodada da esteira para um CPF ou CNPJ, do primeiro relatório à última assinatura, com cada passo e cada decisão registrados.
Resumo: a execução roda a versão da esteira com que começou, para quando precisa de alguém (analista, aprovador, cliente ou parceiro) e termina com um selo: aprovada, reprovada, concluída ou erro. Ao terminar, sua organização recebe o webhook OPERATION.

Como uma execução começa

Antes de abrir, a plataforma confere: Quando a primeira etapa não gera relatório (uma Solicitação, um Checkpoint, um Enquadramento de produto ou uma Integração), a tela avisa: “Esteira iniciada. A primeira etapa não gera relatório: acompanhe pela execução.”

Estados da execução

Um selo final não é reescrito para melhor: uma execução reprovada ou com erro não vira “concluída” depois. A formalização tem desfecho próprio. Se o contrato não sai, a execução continua aprovada, e o contrato aparece como não concluído. Veja Formalização.

Estados de cada etapa

A decisão de cada etapa aparece como aprovada, alerta ou reprovada.

Onde uma execução espera

Uma execução em andamento pode estar parada esperando alguém. A tela diz quem: A decisão manual é registrada com autor, horário e comentário. Reprovar antes da Decisão (num Checkpoint, no Enquadramento de produto ou na revisão da Pré-aprovação) recusa a proposta: a execução grava a decisão final Reprovado e termina reprovada. Se outra pessoa decidiu primeiro, a tela avisa: “Esta etapa já não está esperando decisão (pode ter sido decidida por outra pessoa). A execução foi atualizada.”

Rodar de novo

Rodar a mesma esteira para o mesmo documento não duplica trabalho à toa. Sem proposta. Se já existe uma execução do mesmo dia, da mesma versão da esteira e do mesmo documento, e ela não terminou em erro, a plataforma devolve essa execução em vez de abrir outra. Nada novo roda. Com proposta. Na tela da proposta, Rodar de novo abre uma execução nova (“Com o CNPJ/CPF da proposta. A execução anterior continua registrada.”), com um motivo. Regras:
  • Se a proposta já tem uma execução em andamento, nada é disparado: “Esta proposta já tem uma execução em andamento na esteira “X”. Conclua ou encerre essa execução antes de rodar outra.”
  • O relatório do dia, se já estava decidido, é reaberto: o mesmo relatório volta a processar com os dados de entrada de hoje, a decisão anterior fica guardada no histórico, e não há cobrança de relatório novo. As camadas são reaplicadas.
  • Proposta encerrada não roda: “Esta proposta está encerrada (cancelada) e não pode rodar nova análise.”, com a situação da proposta entre parênteses.

Proposta encerrada no meio do caminho

Quando a proposta é cancelada, reprovada ou vence, as execuções dela que estão em andamento são encerradas:
  • As etapas ainda no ar aparecem como não rodou, com o motivo “a proposta foi encerrada”.
  • Uma formalização em andamento fica como não concluída.
  • O selo da execução é o da decisão de crédito que já existia.

Fechamento externo

Quando a esteira tem a etapa Aguardar fechamento externo, a execução para até o seu sistema avisar que a operação foi liberada. Isso é feito pela API pública, com o token da organização:
Repetir o mesmo fechamento devolve 200 com o mesmo resultado. Depois do fechamento, as etapas seguintes podem usar fechamento.referencia, fechamento.data e fechamento.documento. Resposta, erros e exemplos em Fechamento externo.

Webhook de fim de execução

Quando a execução termina, a GYRA+ envia o webhook do tipo OPERATION (nome público operation.updated) para as URLs cadastradas para esse tipo:
O webhook sai uma vez, no fim da execução. Não há evento por etapa, por voto de alçada ou por espera. Se o webhook tiver chave cadastrada, ela vai no header api-key.
Quando a esteira tem Comitê de crédito IA, o fim da deliberação também gera o webhook COMMITTEE_FINISHED, se a sua organização o cadastrou.
Como cadastrar: Webhooks e API keys e Criar webhook.

Próximos passos

Acompanhar execuções

A lista, a página da execução e a caixa de aprovações no toolbox.

Fechamento externo

Referência completa de POST /operation/close.