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

# Montar uma esteira

> Guia da tela do construtor: criar a esteira, adicionar e configurar etapas, salvar versões, validar e ativar.

O construtor é onde você desenha o caminho do crédito uma vez, confere se ele está de pé e publica, sem precisar de ninguém do time técnico.

<Info>
  **Resumo:** em **Esteiras**, aba **Esteiras**, clique em **Nova esteira**. Escolha se ela analisa CPF ou CNPJ, comece pela primeira etapa, adicione as próximas, configure cada uma no painel lateral, clique em **Salvar** e depois em **Ativar**. Nada vale para execuções até você salvar e ativar.
</Info>

Para montar e editar esteiras você precisa da permissão `can-manage-operations`. O conceito está em [Esteiras](/esteiras/visao-geral) e o catálogo de etapas em [Etapas](/esteiras/etapas).

## Onde fica

No menu lateral, grupo **Motor de crédito**, item **Esteiras**. A tela tem três abas:

| Aba | Para quê |
| - | - |
| **Execuções** | Acompanhar as rodadas das esteiras. Veja [Acompanhar execuções](/toolbox/acompanhar-execucoes). |
| **Minhas aprovações** | Ofertas esperando o seu voto na alçada |
| **Esteiras** | A lista das esteiras e o botão **Nova esteira**. Só aparece para quem tem `can-manage-operations`. |

A lista mostra **Esteira**, **Resumo** (a sequência de etapas em uma frase), **Etapas**, **Última edição** e a chave **Ativa**. Filtre por **Nome**, **Criado por** e **Política**.

## Criar uma esteira

<Steps>
  <Step title="Clique em Nova esteira">
    O construtor abre com o título **Nova esteira**.
  </Step>

  <Step title="Dê um nome">
    O nome é único na organização. Sem nome, a tela avisa: "Dê um nome à esteira antes de adicionar a primeira etapa."
  </Step>

  <Step title="Comece de um modelo, se quiser">
    Em **Comece com um modelo**, escolha uma estrutura pronta: **Governança completa**, **Análise rápida**, **Decisão assistida**, **Oferta automática**, **Oferta revisada**, **Comitê IA**, **Alçada por valor**, **Comitê e alçada**, **Revisão e alçada** ou **Pré-check operacional**. Você ajusta políticas, fórmulas e aprovadores depois.
  </Step>

  <Step title="Adicione a primeira etapa">
    O modal **Primeira etapa** pede, antes de tudo, **A esteira analisa**: **CNPJ (empresa)** ou **CPF (pessoa)**. Depois escolha o tipo: **Análise**, **Checkpoint**, **Solicitação** ou **Enquadramento de produto**. É essa etapa que cria a esteira. Na Análise, escolha a política principal, do tipo escolhido. O Enquadramento nasce sem regras: você o configura no painel da etapa, depois de criar.
  </Step>
</Steps>

A esteira nasce **Inativa**. A tela confirma: "Esteira criada. Continue montando as etapas."

## A tela do construtor

| Área | O que mostra |
| - | - |
| Topo | Os botões **Histórico**, **Validar** e **Ativar** (ou **Desativar**). Abaixo, o nome, a escolha **CNPJ** ou **CPF**, a pílula **Ativa** ou **Inativa** e o estado de salvamento |
| Cartões de sinal | **Entrada** (CPF ou CNPJ), número de etapas, fontes reaproveitadas das etapas anteriores e **Estrutura válida** (**Pronta para ativação**) ou **Configuração incompleta** (**Revise as dependências**) |
| **Conferência das políticas** | Para políticas de uso Esteira: o que **impede a ativação** e os **avisos**. Vale para a versão salva. |
| **Fluxo de decisão** | A sequência de etapas. Clique numa etapa para configurá-la |
| **Configuração da etapa** | O painel lateral da etapa selecionada |
| Rodapé | O estado geral ("Esteira pronta", "Configuração incompleta") e se há **Alterações pendentes** |

## Adicionar etapas

Use **Adicionar próxima etapa**, ou os atalhos por tipo abaixo do fluxo. No modal **Nova etapa**, escolha o **Tipo da etapa** e, se quiser, o **Nome da etapa (opcional)**. Sem nome, a etapa usa o nome do tipo.

* O atalho **Decisão** cria o bloco de decisão. Com ele montado, Revisão da oferta, Comitê e Alçada deixam de aparecer como atalhos: você os liga dentro da Decisão.
* A primeira etapa também pode ser uma **Integração**, colocada no topo depois que a esteira existe. Uma etapa que não pode abrir a esteira não sobe para o topo: "A primeira etapa roda só com o documento, a proposta e os dados de entrada: use Análise, Checkpoint, Solicitação, Integração ou Enquadramento de produto."
* Etapas que só existem na formalização avisam no modal: "Esta etapa entra na Formalização: só roda se a proposta for aprovada."
* Sem o módulo de Formalização, **Contrato e assinatura** aparece com o selo **Upgrade** e leva à apresentação do módulo.

## Configurar cada etapa

O painel **Configuração da etapa** mostra o tipo, a posição ("Etapa N"), o nome e os campos do tipo. Três partes se repetem em todas:

* **O que acontece aqui**: uma frase sobre o que a etapa faz.
* **Executar quando**: **Sempre**, **Se aprovado**, **Se aprovado ou alerta**, **Se alerta severo**, **Por produto** ou **Personalizada**. A primeira etapa não tem decisão anterior: ela roda sempre, ou por uma condição sobre a proposta e os dados de entrada.
* A validação da etapa: **Tudo certo**, **Fora de ordem** ou **Falta configurar**, com a mensagem.

Os campos de cada tipo estão em [Etapas](/esteiras/etapas). Alguns tipos abrem uma gaveta própria: **Contrato e assinatura**, **Chamada de API** e os grupos de **Vínculos**.

### Por produto

Em **Por produto**, escolha os produtos para os quais a etapa roda e, se quiser, exija também a decisão anterior (**Qualquer decisão anterior**, **E se aprovado** e assim por diante). Clique em **Salvar condição**. Use com o [Enquadramento de produto](/esteiras/etapas#enquadramento-de-produto) para abrir um caminho por produto.

### Condição personalizada

Em **Personalizada**, escreva a fórmula, por exemplo `valor_escolhido > 500000` ou `produto = "IMOB"`. Digite `#` para escolher variáveis das etapas anteriores, use **resposta.campo** para um campo de formulário e **Variáveis (N)** para os [dados de entrada](/esteiras/dados-de-entrada). A tela mostra a condição em português ("Roda quando ...") e clique em **Salvar condição**. Referência inválida aparece como "Revise a condição: ...". Uma variável que nenhuma etapa anterior traz marca o cartão com **Variável indisponível**.

## Ordem das etapas

O construtor não trava a ordem enquanto você trabalha. Uma etapa fora do lugar ganha o aviso **Fora de ordem**, com o que fazer. Exemplos:

* "O Aprofundar precisa vir depois de uma Análise que crie o relatório. Mova esta etapa para baixo de uma Análise."
* "A Pré-aprovação precisa vir antes da Decisão. Mova esta etapa para cima."
* "A Solicitação por vínculo precisa de uma etapa Vínculos antes dela."
* "A esteira aceita uma Decisão só. Remova esta etapa ou a outra Decisão."
* "Fora da ordem do bloco de Decisão: Decisão, Revisão antes do Comitê IA, Comitê IA, Revisão depois do Comitê IA e Alçada. Mova esta etapa."
* "O Aguardar fechamento externo vem depois de um Contrato e assinatura ou como a última etapa. Mova esta etapa para baixo."

Numa esteira inativa você salva mesmo com etapas fora de ordem. Numa esteira **ativa**, não: "A esteira está ativa: arrume as etapas fora de ordem antes de salvar."

## Salvar e versões

Nada é gravado enquanto você edita. As mudanças ficam no rascunho, e a barra **Alterações pendentes** aparece embaixo.

<Steps>
  <Step title="Salvar">
    Grava tudo de uma vez e cria uma versão nova: "Esteira salva (versão X.XX)." O estado de salvamento passa a mostrar "Salva na versão X.XX".
  </Step>

  <Step title="Descartar alterações">
    Volta para a última versão salva.
  </Step>

  <Step title="Histórico de versões">
    Lista cada versão com data, autor, nome e etapas. **Ver alterações por etapa** mostra o que mudou. **Restaurar no rascunho** traz a versão de volta: "Versão X.XX restaurada no rascunho. Revise e salve para publicar."
  </Step>
</Steps>

Se alguém salvou a esteira depois que você abriu, o seu Salvar é recusado: "Você está tentando salvar uma versão nova da esteira a partir de uma versão desatualizada." Clique em **Descartar e sincronizar** para carregar a versão atual e refazer o seu ajuste.

Salvar não afeta execuções em andamento: cada uma continua na versão em que começou.

## Validar e ativar

<Steps>
  <Step title="Validar">
    Confere a esteira inteira sem ativar. Tudo certo: "Configuração válida. A esteira está pronta para ativação." Com avisos da conferência das políticas, a tela lista os avisos, que não impedem. Caso contrário, a mensagem diz o que corrigir, como "Abra a etapa Decisão e salve para concluir a configuração." ou "Corrija as fórmulas inválidas em "X"."
  </Step>

  <Step title="Salve antes">
    Com alterações pendentes, ativar e desativar ficam bloqueados: "Salve as alterações antes de ativar ou desativar a esteira."
  </Step>

  <Step title="Ativar">
    A plataforma confere ordem, fórmulas, fontes, alçadas, contas dos conectores e a conferência das políticas. Ativada: "Esteira ativada."
  </Step>
</Steps>

Você também ativa e desativa pela chave **Ativa** na lista. Uma esteira com problema aparece com um ícone de alerta: **Esteira com aviso** ou **Esteira inválida**.

### Avisos de fonte

* **Esteira ativa com fontes em conflito**: a esteira já estava ativa com duas fontes para o mesmo dado. Ela continua rodando, mas não poderá ser reativada se for desativada.
* **Regra sem fonte**: a camada de uma etapa tem regra que nenhuma fonte declarada atende. Declare a fonte na política da camada ou remova a regra.
* **Fonte ausente**: a etapa depende de uma fonte que nenhuma etapa anterior traz.

Detalhes em [Camadas e add-ons](/esteiras/camadas-e-add-ons).

## Trocar o tipo de documento

Na esteira salva, a escolha **CNPJ** ou **CPF** ao lado do nome troca o tipo. Salve as alterações pendentes antes ("Salve as alterações antes de trocar o tipo da esteira."), e troque antes as políticas das etapas que são do outro tipo. Trocou: "A esteira agora analisa CPF."

## Partes e assinaturas

Esteiras com Contrato e assinatura ou Solicitação têm também a política de partes (quem assina e em que papel). Se as regras de partes estão salvas mas a esteira não tem nenhuma dessas etapas, a tela avisa que elas estão sem efeito. Veja [Partes e assinaturas](/formalizacao/partes-e-assinaturas).

## Excluir uma esteira

Na lista, **Ações**, excluir. A tela pede confirmação ("Deseja realmente excluir a esteira?") e confirma com "Esteira excluída."

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Por que só alguns tipos aparecem na primeira etapa?">
    Numa esteira nova, a primeira etapa é que cria a esteira, e ela roda só com o documento, a proposta e os dados de entrada: Análise, Checkpoint, Solicitação ou Enquadramento de produto. Os outros tipos aparecem como "(depois da primeira etapa)". Depois de criar a esteira, todos ficam disponíveis, conforme os módulos da sua organização.
  </Accordion>

  <Accordion title="Mudei a política de uma etapa. As execuções antigas mudam?">
    Não. Cada execução roda o retrato da versão da esteira em que começou.
  </Accordion>

  <Accordion title="Posso trocar o tipo de uma etapa?">
    Não. Remova a etapa e adicione outra do tipo certo.
  </Accordion>

  <Accordion title="A política de uma etapa aparece como indisponível">
    A esteira aponta para uma política que não está entre as políticas ativas da organização. O vínculo continua salvo; reative a política ou escolha outra.
  </Accordion>
</AccordionGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Etapas" icon="list-ol" href="/esteiras/etapas">
    Os campos de cada tipo de etapa.
  </Card>

  <Card title="Acompanhar execuções" icon="list-check" href="/toolbox/acompanhar-execucoes">
    O que fazer depois que a esteira roda.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.