# Trilha de Status - Guia para Vendedores

> Documentação para vendedores da Unefesta.
> Versão HTML: https://www.unefesta.com.br/documentacao-vendedor/pedidos/trilha-de-status-guia-para-vendedores

## O que é a Trilha de Status / Grupo de Status?

A **Trilha de Status** é um conjunto de etapas personalizadas que você configura para informar ao comprador em qual fase o pedido dele está, desde o momento em que o pedido é recebido até a finalização completa.

Cada trilha de status é composta por múltiplas etapas sequenciais que representam o progresso do pedido. Por exemplo:
- Pedido Recebido
- Em Preparação
- Enviado
- Em Trânsito
- Entregue

## Por que usar a Trilha/Grupo de Status?

1. **Transparência**: Mantenha seus clientes informados sobre o progresso do pedido
2. **Organização**: Acompanhe internamente o status de cada pedido
3. **Profissionalismo**: Demonstre organização e cuidado com os pedidos dos clientes
4. **Redução de Suporte**: Clientes informados fazem menos perguntas sobre o status do pedido

## Como Criar uma Trilha de Status

### Passo 1: Acessar o menu Minha Loja

1. Acesse sua loja no painel do vendedor
2. Navegue até a seção **"Trilhas de Status"**

### Passo 2: Configurar o Trilha/Grupo de Status

1. **Nome do Grupo**: Dê um nome descritivo para identificar esta trilha (ex: "Trilha de Entrega Padrão", "Trilha para Eventos")
2. **Descrição**: Adicione uma descrição interna para seu controle (visível apenas para você)

### Passo 3: Adicionar Etapas

Para cada etapa, você precisará preencher:

- **Nome da Etapa**: Nome curto e claro (ex: "Pedido Recebido", "Em Preparação", "Enviado")
- **Descrição**: Explique o que acontece nesta etapa (ex: "Seu pedido foi recebido e está sendo preparado")
- **Rastreio de Frete**: Marque esta opção se nesta etapa você informará o código de rastreamento
  - ⚠️ **Importante**: Apenas uma etapa pode ter rastreio de frete por trilha
- **Etapa Opcional**: Marque se esta etapa pode ser pulada
  - ⚠️ **Regra**: A primeira e a última etapa **não podem** ser opcionais
- **Aguardando retorno**: na locação, esta flag é o “entregue/retirado”
  - Ao avançar o pedido para uma etapa com esta opção marcada, a Unefesta considera que os itens **saíram da loja** (entrega ou retirada)
  - Em pedidos com item de locação, cria automaticamente um **rascunho de caução** (se ainda não existir)
  - Libera a **vistoria de devolução**
  - Enquanto o pedido permanecer nesta etapa, as unidades **ainda não devolvidas** ficam **indisponíveis** para novas reservas, mesmo depois do fim do período agendado (se o produto controla estoque). Unidades já conferidas na vistoria liberam estoque parcial sem precisar sair da etapa
  - Na trilha **LOCAÇÃO PADRÃO**, a etapa **Locado** já vem com esta flag

### Passo 4: Organizar as Etapas

- Use as setas (↑ ↓) para reordenar as etapas
- A ordem das etapas define a sequência que o pedido seguirá
- Você pode remover etapas clicando no ícone de lixeira (exceto se for a única etapa)

### Passo 5: Salvar a Trilha

1. Clique em **"Criar grupo"** para salvar sua trilha de status
2. Você será redirecionado para a lista de trilhas criadas

## Exemplo de Trilha de Status

### Exemplo 1: Venda de Produtos Físicos

```
1. Pedido Recebido (obrigatória)
   - Descrição: "Seu pedido foi recebido e está sendo processado"
   
2. Em Preparação (opcional)
   - Descrição: "Seus itens estão sendo separados e embalados"
   
3. Enviado (obrigatória, com rastreio)
   - Descrição: "Seu pedido foi enviado! Código de rastreamento: [código]"
   
4. Em Trânsito (opcional)
   - Descrição: "Seu pedido está a caminho"
   
5. Entregue (obrigatória)
   - Descrição: "Seu pedido foi entregue com sucesso!"
```

### Exemplo 2: Eventos e Serviços

```
1. Pedido Confirmado (obrigatória)
   - Descrição: "Seu pedido foi confirmado e o pagamento aprovado"
   
2. Em Produção (opcional)
   - Descrição: "Estamos preparando seu evento/serviço"
   
3. Pronto para Retirada/Entrega (obrigatória)
   - Descrição: "Seu pedido está pronto!"
   
4. Finalizado (obrigatória)
   - Descrição: "Obrigado pela confiança!"
```

### Exemplo 3: Locação (trilha LOCAÇÃO PADRÃO)

```
1. Pedido recebido
2. Aguardando contrato (opcional) — o aceite do cliente só avança sozinho se o nome da etapa contiver “contrato”
3. Em separação
4. Aguardando Retirada (opcional, pode ter rastreio)
5. Locado — marque **Aguardando retorno** (entrega/retirada + rascunho de caução + vistoria)
6. Devolvido (opcional)
7. Finalizado
```

## Como Relacionar a Trilha ao Pedido

Após criar uma trilha de status, você pode relacioná-la a um pedido:

1. Acesse a página de detalhes do pedido
2. Na seção **"Trilha de Status"**, você verá:
   - Um seletor para escolher qual trilha aplicar ao pedido
   - Uma linha do tempo visual mostrando todas as etapas
3. Selecione a trilha desejada no dropdown
4. Clique na etapa atual do pedido na linha do tempo
5. O sistema atualizará automaticamente o status do pedido

⚠️ **Atenção**: Ao alterar o status do pedido, não será possível retornar ao estado anterior. Certifique-se antes de confirmar a mudança.

## Visualização pelo Comprador

Quando você atualiza o status do pedido usando a trilha de status:

- O comprador verá a linha do tempo na página de detalhes do seu pedido
- As etapas concluídas aparecerão em verde
- A etapa atual aparecerá destacada em azul
- As etapas futuras aparecerão em cinza
- A descrição da etapa atual será exibida para o comprador

## Código de Rastreio do Pedido

Quando uma etapa da trilha estiver com **Rastreio de Frete** habilitado, o vendedor poderá informar o **código de rastreio** do envio.

### Como funciona

1. O pedido precisa estar na etapa atual que possui rastreio habilitado
2. Na página de detalhes do pedido, na seção **Fretes**, aparecerá o campo de **Rastreio**
3. O vendedor pode:
   - **Adicionar** código
   - **Editar** código
   - **Excluir** código

### Importante

- O código é informado por **frete** do pedido
- Se houver mais de um frete no pedido, cada frete pode ter um código diferente
- Fora da etapa com rastreio habilitado, o código pode ser exibido, mas não fica disponível para edição

## Aguardando retorno (locação)

A flag **Aguardando retorno** na etapa da trilha é o sinal operacional de que a locação **foi entregue ou retirada**.

Não existe um botão separado de “confirmar entrega”. Avançar para essa etapa (no pedido ou no Kanban) faz, de uma vez:

1. **Entregue/retirado** — o pedido passa a ser tratado como itens em posse do cliente.
2. **Rascunho de caução** — em pedidos com item de locação, a Unefesta cria um rascunho na aba de cobranças extras (valor pela política, se der para calcular). Você revisa e clica em **Emitir**.
3. **Vistoria** — a fila de [devoluções](./solicitacoes-pos-venda.md) libera a conferência das unidades.
4. **Estoque** — as unidades ainda pendentes de devolução continuam bloqueadas para novas reservas enquanto o pedido estiver nesta etapa, mesmo após o fim do slot. Conforme você registra a vistoria, as unidades liberadas voltam a ficar disponíveis **sem precisar avançar a trilha**.

Na trilha **LOCAÇÃO PADRÃO** isso é a etapa **Locado**. Você pode usar outro nome; o que vale é a flag, não o texto.

Ao sair dessa etapa (por exemplo para **Devolvido** ou **Finalizado**), qualquer bloqueio extra restante deixa de valer. A vistoria só fica disponível enquanto a etapa atual tiver a flag.

Se a próxima reserva do mesmo item já estiver marcada e a unidade não voltou, use **Reatribuir estoque** no pedido seguinte — [Estoque e disponibilidade](../anuncios/estoque-disponibilidade.md).

### Pré-captura ao emitir a caução

Se a loja gera link de pagamento (PagBank ou Mercado Pago) **e** a política de garantia + a forma de pagamento do pedido pedem caução (modo “sempre com caução”, ou “depende do pagamento” com pedido no cartão), o botão **Emitir pré-captura** envia ao comprador um link de **cartão** para autorizar o valor. Sem link da loja, ou com PIX/dinheiro e política sem caução, o rascunho continua existindo: você emite cobrança comum ou registra o recebimento fora da plataforma.

## Aguardando retorno e disponibilidade

Quando a etapa atual de um pedido possui **Aguardando retorno** ativo:

- a consulta de disponibilidade bloqueia só as **unidades ainda pendentes** desse pedido (quantidade pedida menos a já devolvida na vistoria; em itens com série/código, só as unidades ainda não liberadas);
- unidades já conferidas como devolvidas voltam a poder ser reservadas por outros pedidos, mesmo com o pedido atual ainda em **Locado** / aguardando retorno;
- isso evita novas reservas sobre o que ainda está com o cliente, sem travar o estoque já devolvido;
- ao avançar para uma etapa sem essa propriedade, o bloqueio extra deixa de ser aplicado (mesmo se alguma unidade não tiver sido vistoriada);
- em períodos que já estão bloqueados pela reserva atual (slot), o sistema evita somar o bloqueio duas vezes.

### Como o comprador visualiza

O comprador vê o rastreio em:

- **Meus pedidos** > **Detalhes do pedido** > seção **Fretes e rastreio**

Se ainda não houver código informado, será exibido:

- **"Ainda não informado"**

## Gerenciando suas Trilhas de Status

### Editar uma Trilha

1. Na página de listagem de trilhas
2. Clique no botão de editar na trilha desejada
3. Faça as alterações necessárias
4. Salve as mudanças

### Excluir uma Trilha

1. Na página de listagem de trilhas
2. Clique no botão de excluir na trilha desejada
3. Confirme a exclusão

⚠️ **Atenção**: Ao excluir uma trilha, pedidos que já estão usando essa trilha não serão afetados, mas você não poderá mais aplicá-la a novos pedidos.

## Dicas e Boas Práticas

1. **Seja Específico**: Use nomes de etapas claros e descrições detalhadas
2. **Mantenha Atualizado**: Atualize o status do pedido regularmente para manter o cliente informado
3. **Use Rastreio**: Se você envia produtos físicos, sempre marque a etapa de envio com rastreio de frete
4. **Crie Múltiplas Trilhas**: Diferentes tipos de produtos/serviços podem ter trilhas diferentes
5. **Comunique Mudanças**: Se houver atrasos, atualize o status e considere entrar em contato com o cliente

---

**Última atualização**: Agosto 2026