Pular para conteúdo

Referência — Ordem de Serviço (OS)

Sobre a tela

A Ordem de Serviço (OS) é o coração do LuariX OS: o registro de um serviço solicitado por um cliente. Esta página detalha o formulário de criação/edição e os modais de ação do fluxo — as janelas que abrem para encaminhar, aceitar, concluir, pendenciar e cancelar uma OS.

Fluxo completo

Para entender os status, prioridades, SLA e exigências, veja Visão Geral e Fluxo. Para a ficha de detalhe e execução, veja Detalhe e Execução.

A. Formulário da OS

Acesse o botão Nova OS (na listagem ou no topo do gerenciamento). O formulário é organizado em blocos.

Bloco 1 — Dados da Ordem

Campo Tipo Obrig. Descrição
Cliente Seleção com busca Sim Busque pelo nome do cliente cadastrado. Ao selecionar, o sistema preenche automaticamente endereço, cidade e bairro do cliente
Título Texto Sim Resumo curto da solicitação (ex.: "Troca de medidor com defeito")
Endereço Exibição automática — Endereço do cliente (logradouro + número), preenchido sozinho ao escolher o cliente. Botão Abrir no Mapa abre no Google Maps
Cidade Seleção com busca Sim Cidade do atendimento. Ao trocar, o bairro é limpo
Bairro Seleção com busca Não Só habilita depois da cidade selecionada
Prioridade Seleção (Baixa / Média / Alta / Urgente) Não Grau de urgência: Urgente destaca a OS no topo dos painéis e da listagem
Agendamento Data e hora (datetime-local) Não Data/hora marcadas para o atendimento. Também pode ser definido no fluxo de agendamento do Kanban
Categoria Seleção com busca Não Classifica o tipo de serviço. Categorias podem ter SLA vinculado (os prazos são aplicados à OS)
Subcategoria Seleção com busca Não Só habilita depois da categoria. Refina o tipo de serviço
Descrição Texto (multilinha) Sim O problema relatado pelo cliente, com o máximo de detalhes. Ajuda o técnico no atendimento

Preenchimento automático do endereço

Ao escolher o cliente, endereço, cidade e bairro são preenchidos automaticamente a partir do cadastro do cliente — e podem ser ajustados na própria OS se o atendimento for em outro local.

Bloco 2 — Evidências Obrigatórias

Campo Tipo Obrig. Descrição
Exigir fotos/evidências na conclusão e cancelamento Chave liga-desliga Não Quando ativo, o técnico é obrigado a enviar ao menos uma foto para concluir (ou cancelar) a OS

Bloco 3 — Assinatura Digital Obrigatória

Campo Tipo Obrig. Descrição
Exigir assinatura digital na conclusão Chave liga-desliga Não Quando ativo, o técnico é obrigado a coletar a assinatura do cliente antes de concluir. O sistema gera o "Termo de Ciência e Conclusão" em PDF

Pré-requisito da assinatura

Para que o Termo de Ciência e Conclusão seja gerado, o administrador precisa ter feito o upload do arquivo base do termo (.docx) na aba OS das Configurações. Sem o modelo, a assinatura é coletada mas o documento final não é gerado.

Bloco 4 — Materiais / Equipamentos

Campo Tipo Obrig. Descrição
Exigir registro de materiais/equipamentos usados na conclusão Chave liga-desliga Não Quando ativo, o técnico é obrigado a informar ao menos um material/equipamento usado (gera saída de estoque vinculada à OS)

Bloco 5 — Anexos

Campo Tipo Obrig. Descrição
Anexos Upload (arrastar/ clicar) Não Arquivos complementares: PNG, JPG, JPEG, PDF, máx. 10MB por arquivo. Múltiplos arquivos permitidos; cada um pode ser removido

Bloco 6 — Atribuição (opcional na criação)

Campo Tipo Obrig. Descrição
Técnico Interno Seleção com busca Não Técnico da equipe própria da LuariX responsável pela execução
Prestadora Seleção com busca Não Empresa parceira que executará. Ao selecionar a prestadora sem técnico, a OS fica disponível no Pool da prestadora
Técnico Terceirizado Seleção com busca Não Técnico de uma prestadora. Só habilita depois de escolher a prestadora

Comportamento da atribuição na criação

Situação Resultado
A atribuição é opcional na criação Pode ser feita depois pelo fluxo de encaminhamento
Selecionou só a prestadora A OS vai para o Pool da prestadora
Selecionou prestadora + técnico terceirizado A OS já nasce atribuída a ele
Selecionou técnico interno A OS já nasce atribuída à equipe própria

Bloco 7 — Observações Internas

Campo Tipo Obrig. Descrição
Observações internas Texto (multilinha) Não Anotações visíveis apenas para a equipe (não aparecem para o cliente)

Botões do formulário

Botão O que faz
Criar Ordem (novo) / Atualizar (edição) Salva a OS. Na edição, atualiza apenas dados da OS — nunca redispare o fluxo de atribuição/encaminhamento
Cancelar Volta sem salvar

B. Modais de ação da OS

Conforme o status, cada OS exibe as ações possíveis. Todos abrem modais com campos próprios:

Campo Tipo Obrig. Descrição
Tipo de encaminhamento Seleção Sim Como a OS será distribuída (ex.: para prestadora ou para equipe interna)
Prestadora Seleção com busca Sim (para prestadora) A prestadora que receberá a OS
Técnico Terceirizado Seleção com busca Sim (se tipo com técnico) Só habilita depois da prestadora. Sem técnico, a OS vai ao Pool
Observações do encaminhamento Texto (multilinha) Não Instruções adicionais para a prestadora/técnico
Campo Tipo Obrig. Descrição
Como deseja prosseguir? Seleção Sim Escolha entre atribuir a um técnico ou deixar no Pool
Selecione o técnico Seleção com busca Sim (se atribuir) O técnico da prestadora que ficará com a OS

Abre direto a atribuição ao técnico logado — sem campos adicionais. A OS sai do pool e entra nas "Minhas OS" do técnico.

Campo Tipo Obrig. Descrição
Data e Hora do Agendamento Data e hora Sim Momento marcado para o atendimento (mínimo: agora)
Observações Texto (multilinha) Não Informações adicionais sobre o agendamento
Campo Tipo Obrig. Descrição
Motivo da pendência Texto (multilinha) Sim Por que a OS está aguardando. Enquanto pendente, o SLA fica pausado
Campo Tipo Obrig. Descrição
Resumo da Resolução Texto (multilinha) Sim O que foi feito para resolver o serviço
Evidências/Fotos Upload de fotos Sim se exigido As fotos que comprovam o serviço (obrigatórias quando a OS exige)
Checklist de execução Lista de itens com ✓/⬜ Sim se houver Marque cada item como executado. Itens obrigatórios não marcados bloqueiam a conclusão e o sistema lista as pendências
Assinatura Assinatura digital Sim se exigido Coleta a assinatura do cliente (na web ou no Mini App do Telegram)
Frota / veículo de origem Seleção Condicional Para o técnico: o veículo da frota dele de onde sairão os materiais
Produto Seleção com busca Condicional Produto consumido (só aparecem os disponíveis na origem escolhida)
Item (serial) / Quantidade Seleção ou número Condicional Serial para produtos com rastreio; quantidade (limitada ao saldo) para produtos por quantidade

Regra de negócio — conclusão

O botão de concluir só libera depois que todas as exigências marcadas na criação forem cumpridas (fotos, assinatura, materiais). Materiais saem do estoque como saídas vinculadas à OS e o saldo atualiza na hora.

Disponível na ficha de uma OS concluída, para retomar o serviço (retrabalho):

Campo Tipo Obrig. Descrição
Motivo da reabertura Texto (multilinha) Sim (mín. 5 caracteres) Por que a OS está voltando para execução — fica registrado no histórico

Ao reabrir, a OS volta para Em Execução. Na nova conclusão, um novo link de avaliação é gerado para o cliente.

Campo Tipo Obrig. Descrição
Motivo do cancelamento Texto (multilinha) Sim Registra o motivo, que fica no histórico e no relatório
Evidências/Fotos Upload de fotos Sim se exigido Se a OS exige fotos na conclusão, o cancelamento também exige

Termos usados nesta tela

Termo Significado
Pool A fila de ordens da prestadora sem técnico definido. Qualquer técnico da prestadora pode pegar (veja o glossário)
SLA Prazos de resposta e resolução calculados automaticamente (o relógio pausa quando a OS é pendenciada)
Pendenciar Pausar a OS aguardando algo; o prazo (SLA) fica pausado
Exigências de conclusão Condições definidas na criação (fotos, assinatura, materiais) para liberar a conclusão
Checklist de execução Itens da rotina copiados da categoria (ou ajustados na OS) que o técnico marca como executados na conclusão — obrigatórios bloqueiam a finalização

Próximos passos