> ## Documentation Index
> Fetch the complete documentation index at: https://developers.gyramais.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> A GYRA+ tem um servidor MCP oficial: https://mcp.gyramais.com.br/mcp. A autenticação é o login do próprio usuário na plataforma, não uma credencial separada. Instalação em https://developers.gyramais.com.br/mcp/instalacao.
> Prefira as tools do MCP a montar chamadas HTTP na mão quando o usuário já tem o conector ligado.
> Para analisar crédito de um CNPJ ou CPF, use create_report_v2 e assine um webhook em vez de fazer polling.
> Para ler um documento (contrato social, comprovante de residência, imposto de renda, balanço), use validate_document: a entrada é um arquivo só e a plataforma reconhece o tipo sozinha.
> Para pedir documentos ao cliente final, use create_collection com o slug de um modelo obtido em list_collection_templates.
> Documento (CNPJ/CPF) é dado pessoal: não o repita em log nem o envie a serviços de terceiros.
# Acompanhar execuções
> Guia da tela de execuções: rodar uma esteira, ler a lista, abrir a página da execução, decidir etapas e votar na alçada.
A aba de execuções mostra, para cada pedido, em que ponto da esteira ele está, quem precisa agir e por que a decisão saiu como saiu.
**Resumo:** rode uma esteira pelo campo do topo do toolbox. Acompanhe em **Esteiras**, aba **Execuções**. Clique numa linha para abrir a página da execução, com as abas **Decisão**, **Evidências**, **Jornada** e **Auditoria**. Quem aprova ofertas trabalha na aba **Minhas aprovações**.
Para rodar e acompanhar esteiras você precisa da permissão `can-generate-report`. O que cada estado significa está em [Execuções](/esteiras/execucoes).
## Rodar uma esteira
No campo do topo do toolbox, **Digite o CPF ou CNPJ**.
No seletor **Selecione uma política ou esteira**, as esteiras ativas aparecem no grupo **Esteiras**, separadas das **Políticas**. Só aparecem as compatíveis com o documento, e no grupo **Políticas** só as de uso Relatório: uma política de uso Esteira roda dentro da esteira.
A execução começa. Se algo impedir, a tela mostra o motivo, por exemplo "A esteira "X" está inativa. Ative a esteira para executá-la.", ou "Não foi possível rodar a esteira." Quando a primeira etapa não gera relatório, a tela avisa: "Esteira iniciada. A primeira etapa não gera relatório: acompanhe pela execução."
Para uma proposta, rode pela tela da proposta: o botão **Rodar análise** (ou **Rodar de novo**, se já rodou) abre um modal em que você escolhe **Esteira** ou **Política** e o **Motivo**. A execução anterior continua registrada. Veja [Propostas](/propostas/visao-geral).
## A lista de execuções
Em **Esteiras**, aba **Execuções**:
| Coluna | O que mostra |
| - | - |
| **Cliente** | Nome e documento |
| **Esteira** | A esteira que rodou |
| **Progresso** | Em que etapa a execução está |
| **Status** | O estado, com a espera quando houver (por exemplo, "aguardando aprovação da alçada") |
| **Quando** | Início da execução |
Filtre por **Documento**, **Gerado por** (não aparece para o papel de analista, que vê só as próprias execuções), **Esteira** e **Status** (**Aguardando comitê**, **Aguardando alçada**, **Em execução**, **Aprovada**, **Reprovada**, **Erro**). Clique numa linha para abrir a página da execução.
## A página da execução
O topo mostra o nome do cliente (ou o documento), a esteira e um selo com a situação:
| Selo | Significado |
| - | - |
| **Em análise** | A execução está rodando e ninguém precisa agir agora |
| **Decisão no relatório** | Um analista precisa aprovar ou reprovar o relatório |
| **Comitê deliberando** | O Comitê de crédito IA está analisando |
| **Em alçada** | A oferta está com os aprovadores (e você já votou, ou não é aprovador) |
| **Aguardando seu voto** | Você é aprovador desta alçada e ainda não votou |
| **Aguardando o cliente** | O cliente precisa escolher a oferta da pré-aprovação |
| **Em formalização** | O crédito foi aprovado e o contrato está em andamento |
| **Aprovada** / **Recusada** | Terminou com a decisão de crédito |
| **Execução interrompida** | Uma falha técnica parou a execução |
| **Sem parecer do comitê** | O Comitê IA não entregou a deliberação |
| **Expirada** | A oferta venceu |
### Aba Decisão
É onde você age. O conteúdo depende de onde a execução está parada.
**Decisão do analista** (Checkpoint ou etapa que foi para o analista): escreva o **Comentário (obrigatório para reprovar)** e clique em **Aprovar** ou **Reprovar**. **Abrir relatório** leva ao relatório da etapa. Ao aprovar: "Etapa aprovada. A esteira segue." Ao reprovar: "Etapa reprovada. A esteira parou." (ou "A esteira segue pela etapa que roda mesmo assim.", se a próxima etapa roda em caso de reprovação).
**Escolha do produto** (Enquadramento de produto parado no analista): a tela diz por que parou. Escolha o **Produto da proposta** e clique em **Confirmar produto**, ou reprove. Reprovar aqui recusa a proposta.
**Revisão da pré-aprovação**: em **Faixa da oferta**, confirme a faixa calculada ou ajuste valor, prazos, carências e spread antes de enviar ao cliente, e clique em **Enviar oferta**. Fora dos limites do produto, a tela pede justificativa no comentário. Reprovar aqui recusa a proposta.
Quando a etapa tem analistas designados, só eles decidem; os demais veem **Aguardando as pessoas designadas**.
**Decisão no relatório**: quando a política manda revisar, a decisão é tomada no próprio relatório. A tela avisa: "A decisão desta etapa é tomada no relatório: aprove ou reprove a análise lá para a esteira continuar."
**Revisão da oferta**: ajuste limite, taxa e prazo se precisar. Mudar um valor exige motivo. Com Comitê antes, use **Usar sugestão** para partir da **Sugestão do Comitê IA**. Termine com **Confirmar oferta** ou **Recusar oferta**.
**Alçada**: o cartão mostra a oferta, a recomendação do Comitê IA (quando houver) e cada aprovador:
| Situação do aprovador | Texto |
| - | - |
| Aprovou | "Aprovou às HH:MM" ou "Aprovou com condição às HH:MM" |
| Recusou | "Recusou às HH:MM" |
| Ainda não votou | "Aguardando há X" |
| Não precisa mais votar | "Não necessário" |
Suas ações: **Aprovar**, **Aprovar com condição**, **Recusar**, **Retirar voto** e **Lembrar** um aprovador que ainda não votou. Atalhos: `a`, `c` e `r`. O quórum aparece como "N de M necessárias" até "Quórum atingido."
**Integração ou Chamada de API** com problema: o cartão da etapa mostra as pendências e a resposta resumida. Corrija o que for preciso e clique em **Reenviar**, ou decida a etapa.
Erros comuns ao decidir:
* "Esta decisão já foi registrada. A execução foi atualizada."
* "Esta etapa já não está esperando decisão (pode ter sido decidida por outra pessoa). A execução foi atualizada."
* "Você não faz parte da alçada responsável por esta oferta"
### Aba Evidências
Em **Análises da execução**, cada relatório que a esteira gerou (do tomador e dos vínculos), com a situação: **Aguardando decisão**, **Em análise**, **Aprovado**, **Alerta**, **Reprovado**, **Concluído** ou **Erro**. Clique para abrir o relatório completo. Como ler um relatório: [Relatório](/concepts/relatorio).
### Aba Jornada
**Fluxo da execução** desenha a esteira da versão em que a execução rodou, com o Enquadramento de produto quando ele rodou, e o estado de cada etapa (**concluída**, **em execução**, **aguardando você**, **não rodou**, **erro**) e "Etapa atual: X." O bloco **Operação** traz **Início**, **Duração**, **Última atualização**, **Falhas técnicas**, **Consultas evitadas** (fontes reaproveitadas), **Versão da esteira** e **Identificador**.
Etapa que não rodou mostra o motivo, por exemplo "a condição do conector não foi atendida", "a decisão anterior foi reprovada" ou "a proposta foi encerrada". Etapa em erro por uma condição **Executar quando** que não calculou mostra o motivo e pede para corrigir a condição na esteira e rodar de novo.
### Aba Auditoria
Aparece quando a execução termina.
* **Linha do tempo**: cada decisão com autor e horário, de "Execução iniciada" ao fim, incluindo os eventos da alçada ("Enviada para a alçada", votos, lembretes, "Alçada encerrada").
* **Pareceres dos especialistas**: os pareceres do Comitê IA.
* **Decisões por etapa**: **Etapa**, **Decisão**, **Origem**, **Decidido por**, **Quando** e **Comentário**.
## Minhas aprovações
A aba mostra só as ofertas em alçadas em que você foi designado, com o contador no título ("Minhas aprovações (N)"). O cabeçalho diz quantas decisões esperam por você. Sem pendências: "Você não tem ofertas aguardando sua aprovação."
O e-mail de aprovação pendente leva direto para cá pelo botão **Abrir execução**.
## Perguntas frequentes
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. Para rodar de novo uma proposta, use **Rodar de novo** na tela da proposta.
Veja o motivo na aba **Jornada**. Se a condição **Executar quando** de uma etapa não pôde ser calculada, corrija a fórmula na esteira, salve e rode de novo. Para falhas de fonte ou de sistema externo, rode a esteira de novo. Se persistir, fale com o suporte.
A formalização tem desfecho próprio e não muda a decisão de crédito. Veja [Formalização](/formalizacao/visao-geral).
Na tela do próprio relatório. Veja [Relatório](/concepts/relatorio) e [Score e decisão](/concepts/score-e-decisao).
## Próximos passos
Estados, esperas, rodar de novo e webhook.
Como a decisão e a oferta são montadas.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.