← Anterior: [Estoque](https://iurru.com/manual/Estoque) · [Manual](https://iurru.com/manual/) · Próxima: [Compras & NF](https://iurru.com/manual/Compras-e-NF)

# Oficina

**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](https://iurru.com/manual/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](https://iurru.com/manual/Usuarios-e-permissoes#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](https://iurru.com/manual/Clientes#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](#faturar).

**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](https://iurru.com/manual/Interface#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](https://iurru.com/manual/Caixa) e
[comissão](https://iurru.com/manual/Comissoes), 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

| Estado | Significado |
| --- | --- |
| **Aberta** | Criada, sem peça reservada ainda |
| **Aguardando peças** | Já tem pelo menos uma peça reservada (ver nota acima — não é só sobre "faltar" item) |
| **Faturada** | Virou venda, não pode mais ser editada |
| **Cancelada** | Encerrada sem virar venda |

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
```

---

← Anterior: [Estoque](https://iurru.com/manual/Estoque) · [Manual](https://iurru.com/manual/) · Próxima: [Compras & NF](https://iurru.com/manual/Compras-e-NF)
