# Etapas, campos e responsáveis do Pipeline

Defina etapas, campos e responsáveis antes de acompanhar oportunidades.

Versão 1.2.2

Em **Extensões → Pipeline**, as abas **Status**, **Campos** e **Responsáveis** estruturam as oportunidades da empresa. **Configurar** habilita o módulo; **Operações → Pipeline** cadastra e acompanha oportunidades usando essas definições. Não há associação com ciclo de Performance nesta extensão.

## Preparar a jornada

1. Com Pipeline habilitado pelo Master, abra Status e revise as etapas.
2. Em Campos, cadastre as informações adicionais e confira Uso na operação.
3. O Master associa os colaboradores em Responsáveis.
4. Use as definições em Operações → Pipeline.

Extensões, Operações e Dashboard têm permissões independentes. Para colaboradores sujeitos à associação de responsáveis, permissão e associação são requisitos conjuntos. Manter etapas e campos exige permissão para a página; habilitar o módulo e administrar Responsáveis exige Master.

## Status

| Campo | Opções e regras |
| --- | --- |
| Nome | Obrigatório, até 150 caracteres. Pode ser alterado inclusive nos três status fixos. |
| Etapa da jornada | Em andamento para etapas intermediárias; Saída ganha para sucesso; Saída perdida para encerramento sem sucesso. Entrada é reservada ao status fixo inicial. |
| Ordem | Inteiro de 1 a 99; em novos cadastros, a ausência de valor usa a próxima ordem sugerida. Define a posição das colunas do Kanban, da esquerda para a direita. Empates usam uma ordenação estável por identidade do cadastro. |
| Disponibilidade | Ativo ou Inativo; padrão Ativo. Os três status fixos exibem Permanente e não permitem mudar sua disponibilidade. |

**Entrada**, **Ganha** e **Perdida** existem como status fixos. Apenas o Nome pode ser editado: tipo, ordem e disponibilidade são protegidos. Não podem ser duplicados nem inativados. Renomear Ganha não muda sua classificação de Saída ganha.

Há até **20 status**, contando fixos, ativos e inativos. Etapas novas começam em Em andamento; também podem representar saídas ganhas ou perdidas. Inativar uma etapa adicional preserva seus vínculos e não libera outra vaga. Disponibilidade é o estado do cadastro da etapa, não o resultado de uma oportunidade.

## Campos fixos e personalizados

**Nome**, **Valor**, **Criação**, **Previsão**, **Descrição** e **Status** são os seis campos fixos: não podem ser editados, duplicados, inativados ou excluídos nesta extensão. São parte permanente da estrutura; Valor, Criação, Previsão e Descrição continuam opcionais no preenchimento da oportunidade.

**Valor** já existe como campo monetário nativo, com **Obrigatório = Não** e **Disponibilidade = Permanente**. Não é preciso criar um personalizado Moeda para informar o valor da oportunidade ou utilizar as bases monetárias da Performance. O valor é preenchido em [Operações → Pipeline](/spm/manual/pipeline-operacao/#valor-da-oportunidade).

Se um campo antigo aparecer como **Valor (personalizado #...)** ou o nativo tiver ficado vazio, consulte [Valores anteriores à adoção do campo nativo](/spm/manual/pipeline-operacao/#valores-anteriores-a-adocao-do-campo-nativo): a preservação do personalizado e a cópia inicial têm condições próprias.

Além dos fixos, há até **20 campos configuráveis**, incluindo os campos com associação e os inativos.

| Campo do editor | Opções e regras |
| --- | --- |
| Tipo de campo | Sem associação ou Com associação. Não muda depois de salvar. |
| Tipo de dado | Para Sem associação: Texto, Número ou Moeda. Texto é o padrão. Não muda depois de salvar. |
| Nome | Para Sem associação: obrigatório, até 150 caracteres e editável posteriormente. Para Com associação, é definido pela origem. |
| Associar a | Para Com associação: Organização, Suborganização, Cliente, Produto ou Vendas. Selecione a origem, não um registro específico. |
| Obrigatório | Não ou Sim; começa Não no campo sem associação. Nos campos associados é Sim, bloqueado para edição. A exigência só atua quando o campo está disponível na operação. |
| Ordem | Inteiro de 1 a 99; organiza a apresentação dos campos. Não transforma um campo em etapa do Kanban. |
| Disponibilidade | Ativo ou Inativo; padrão Ativo para os configuráveis. Campos fixos exibem Permanente. |
| Origem | Leitura: Campo fixo, Personalizado ou nome da associação. |
| Uso na operação | Indicador de leitura. Distingue campo ativo, módulo inativo, origem inativa e integração futura; antes de salvar, informa Após salvar. |

Um campo personalizado acrescenta informação à oportunidade; não cria uma coluna do Kanban. O tipo Moeda não transforma seu valor em venda e não altera os cálculos da Performance.

## Dependências das associações e integração com Vendas

Cada origem só pode ser cadastrada uma vez, mesmo se o campo existente estiver inativo; o seletor indica **já cadastrado**. Organização, Suborganização, Cliente e Produto dependem da disponibilidade dos cadastros de origem. O campo Suborganização também exige o campo Organização ativo; inativar Organização inativa Suborganização.

Desligar a origem preserva a definição, mas a indicação **Uso na operação** mostra sua indisponibilidade. Escolher um cliente ou produto concreto acontece no registro operacional. **Vendas** aparece no seletor, com nome de campo **Venda**, mas permanece **Preparado para integração futura**: ganhar uma oportunidade não gera uma venda automaticamente.

## Associar responsáveis

Em **Extensões → Pipeline → Responsáveis**, o Master usa o cadastro rápido, escolhe **Colaborador responsável** e salva. Só colaboradores ativos, ainda não associados, aparecem para nova associação. Não é possível repetir a pessoa. Não se cadastra um parceiro ou novo colaborador nesta aba.

A tabela mostra **Nome**, **E-mail**, **Nível de acesso** e **Status**, com filtros e oito linhas por página. Esses dados vêm de Pessoas e não são editados aqui. **Remover associação** pede confirmação e preserva o cadastro do colaborador; sua habilitação no workflow é retirada, sem apagar oportunidades históricas. Associar não cria login nem concede permissões.

Há exportação JSON dos responsáveis filtrados, sem importação, duplicação ou edição dos dados pessoais. Salve ou cancele as associações pendentes antes de sair da aba.

## Edição, arquivos e erros

Status e Campos oferecem cadastro completo/rápido, filtros, seleção, edição e inativação dos registros permitidos. Duplicar prepara novos cadastros para revisar e salvar; os fixos permanecem protegidos. Salvar valida o lote enviado; Cancelar descarta os rascunhos.

Importar/exportar usa JSON da aba. Campos exporta apenas os configuráveis, sem os seis fixos. A importação cria registros, sem restaurar identidades ou atualizar automaticamente os existentes. Confira limites, nomes, associação já cadastrada e dependências; as restrições dos fixos também valem para edição em lote e arquivos.

## Disponibilidade

O Gerenciador e os arquivos ficam no web. O aplicativo utiliza as definições nas operações autorizadas, sem editor nativo de Status, Campos ou Responsáveis.