Oficina

No app: Oficina → Ordens de serviço

Menu: Oficina → Ordens de serviço

Para lojas que, além de vender peça, prestam serviço (troca de óleo, alinhamento, reparo). A ordem de serviço (OS) é o documento que junta peças + mão de obra de um atendimento e, no fim, vira uma venda de verdade — com baixa de estoque, comissão e entrada no caixa, do mesmo jeito que uma venda feita no PDV. A OS existe pra cobrir o intervalo entre "o cliente trouxe o carro" e "o serviço terminou e foi cobrado", período em que ainda não faz sentido ter uma venda fechada (o valor final de mão de obra pode não estar definido, pode faltar peça).

Ver e editar OS exige a mesma permissão de editar clientes (clients.edit) — não é uma permissão separada de Oficina. Times que recebem/atendem clientes normalmente já têm essa permissão; quem só vende no PDV sem tocar em cadastro de cliente pode não ter acesso a essa tela.

Na versão instalada (produção), o menu Oficina só aparece para o cargo Mecânico — nem administrador vê, a menos que também tenha esse cargo. Veja Usuários e permissões → Papéis.

Abrir uma OS

1. Cliente — selecione o cliente cadastrado.
2. Veículo — marca, modelo, ano e cor. É possível buscar por placa (7 caracteres, sem hífen — o sistema aceita com ou sem e normaliza) e, se o veículo ainda não existir, cadastrá-lo na hora sem sair da OS — o veículo fica vinculado ao cliente e reaparece nas próximas OS dele. Veja Veículos do cliente.
3. Descrição do serviço — obrigatória, texto livre (o que vai ser feito).
4. Mecânico (opcional) — só um campo informativo, não gera comissão separada nem se liga a nenhum controle de ponto/produtividade.

A OS nasce no estado Aberta.

Reservar peças

Vincule os produtos que o serviço vai consumir, com a quantidade de cada um. Isso é diferente de vender a peça: reservar só trava o estoque pra essa OS, sem baixar de verdade ainda — a baixa definitiva só acontece no faturamento.

Como o sistema calcula o disponível pra reservar: não é só o estoque atual do produto — é estoque atual − quantidade já reservada em outras OS abertas. Duas OS podem disputar a mesma peça em estoque; a segunda a reservar só consegue o que sobrar depois da primeira. Se não sobrar o suficiente, a reserva é recusada: "Estoque insuficiente. Disponível: X (total: Y, em reserva: Z)."

Ao reservar a primeira peça, a OS muda de Aberta pra Aguardando peças — isso acontece sempre que uma reserva é adicionada com sucesso, não só quando falta item. Ou seja, "Aguardando peças" aqui não significa literalmente "peça em falta": significa "esta OS já tem peça reservada, aguardando a execução/faturamento consumir essa reserva". Se você reservou com estoque de sobra, o nome do estado ainda diz "Aguardando peças" — é assim que o sistema chama a etapa entre reservar e faturar.

Sino de alertas: hoje, na prática, a aba Oficina do sino de alertas só lista OS ainda na etapa Aberta (sem nenhuma peça reservada ainda) — uma OS que já passou pra "Aguardando peças" não aparece mais nessa lista por um descompasso interno entre o nome do estado usado na tela de Oficina e o nome que o sino procura. Não conte com o sino pra acompanhar OS que já têm peça reservada; abra a lista de OS diretamente pra isso.

Mão de obra

Campo Mão de obra (R$), editável a qualquer momento enquanto a OS não for faturada nem cancelada. É um valor único por OS (não item a item) — some com o total das peças usadas na hora de faturar.

Faturar

O botão Faturar fecha a OS e gera a venda correspondente — peças efetivamente usadas (você informa a quantidade usada de cada reserva, que pode ser menor que a quantidade reservada — "usei só 1 dos 2 filtros que reservei") + mão de obra — e a leva pro fluxo normal de caixa e comissão, exatamente como uma venda do PDV.

• Reserva não usada vira devolução automática: qualquer peça reservada que não entrar na lista de "usado" no faturamento tem sua reserva liberada (returned) sozinha — não é preciso desfazer a reserva na mão antes de faturar.
• A forma de pagamento é sempre dinheiro — o faturamento de OS não oferece escolha de forma de pagamento (o botão literalmente chama-se "Faturar (dinheiro)"); não há parcelamento, fiado, cartão nem PIX por esse caminho hoje. Se o cliente vai pagar por outro meio, é preciso tratar isso à parte, fora do fluxo de faturamento da OS.
• A OS passa ao estado Faturada.

A OS precisa ter valor de mão de obra ou quantidade usada em pelo menos uma reserva pra faturar. Uma OS vazia não vira venda: "Defina mão de obra ou quantidades usadas nas reservas."

Estados da OS

Cancelar libera as reservas de peça (elas voltam a ficar disponíveis pra outras OS) e pede confirmação ("Cancelar esta ordem?"). Uma OS Faturada ou Cancelada não pode mais ter mão de obra ou reservas alteradas.

Os rótulos Em andamento e Concluída existem na lista de estados possíveis do sistema, mas nenhuma ação da tela leva uma OS pra esses dois estados hoje — na prática, toda OS pula direto de Aberta/Aguardando peças pra Faturada ou Cancelada.

Fluxo completo

Cliente + veículo  →  OS aberta  →  reserva de peças  →  Aguardando peças
                                                                │
                                        mão de obra  ──────────┤
                                                                ▼
                                                         Faturar → Venda (dinheiro) → Caixa