Ciclo de vida da ordem de serviço
Uma ordem de serviço tem cinco status possíveis. O fluxo normal:
SCHEDULED → IN_PROGRESS → COMPLETED → CLOSED
Mais um estado de exceção — Cliente ausente — alcançável a partir de Agendada ou Em andamento quando uma visita não pode prosseguir.
Não há status "Em espera" nem "Cancelada" para ordens de serviço. (Os projetos têm seus próprios estados ON_HOLD / CANCELLED, mas ordens de serviço individuais não.)
Agendada
O estado padrão de uma ordem recém-criada. O cliente espera o técnico no horário agendado. O portal do cliente mostra "Agendada para [data]" e o nome do técnico. Você pode editar qualquer coisa em uma ordem agendada sem restrição.
Em andamento
O técnico começou o trabalho. O app móvel move a ordem para cá quando o técnico toca em Iniciar trabalho. O portal do cliente mostra "Em andamento". O controle de tempo começa aqui (se o seu plano inclui controle de tempo móvel).
Cliente ausente
O técnico chegou no horário e na data agendados, mas ninguém estava disponível (não compareceu, portão trancado, código errado). Marque isso na página de detalhe da ordem com o botão → Cliente ausente enquanto a ordem está Agendada ou Em andamento.
- O portal do cliente mostra "Visita perdida" com: "Nosso técnico visitou em [data/hora], mas ninguém estava disponível. Entre em contato para combinar um novo horário."
- A ordem sai das raias ativas do Painel de despacho para não entulhar a fila de hoje.
- Não há reagendamento automático — este status apenas registra o que aconteceu. Quando o cliente entrar em contato de novo, mova a ordem para Em andamento (se ele estiver disponível agora) ou Fechada (para dar baixa). Qualquer nova data é definida manualmente na ordem, não por um fluxo de reagendamento.
Concluída
O técnico terminou o trabalho. Pelo app móvel: Concluir trabalho → envio de foto opcional → assinatura do cliente opcional → toque em Pronto. O portal do cliente atualiza para "Concluída" e mostra as fotos e a assinatura. Uma ordem concluída pode ser faturada em um clique.
Fechada
O estado final administrativo: a ordem foi faturada / conciliada e é arquivada para fora da fila ativa. As ordens fechadas continuam totalmente legíveis, mas saem das visões padrão do Painel de despacho e do Agendador.
Personalizar os status
Os status das ordens de serviço são fixos — você não pode renomear nem adicionar aos quatro acima. No entanto, os status de tarefa e os status de componentes (os subitens dentro de uma ordem de serviço) SÃO personalizáveis em Configurações → Serviço de Campo. Padrões: tarefas usam PENDING / IN_PROGRESS / COMPLETED / SKIPPED / FAILED; componentes usam PENDING / ORDERED / RECEIVED / INSTALLED / RETURNED.
O que acontece quando você muda o status
Cada mudança de status é registrada na linha do tempo de auditoria da ordem (no fim da página de detalhe). Os portais do cliente atualizam de acordo. Se você configurou uma regra em /platform/rules ligada a eventos de status, ela dispara.