Devolução de Venda — Criar e Gerenciar
Quando o cliente devolve uma peça que comprou na sua oficina (PDV, balcão, ordem de serviço), você precisa registrar essa devolução no sistema antes de qualquer outra coisa — antes de devolver dinheiro, dar crédito ou emitir nota fiscal de devolução. Este manual cobre como criar, aprovar, concluir e cancelar a devolução. A emissão da nota fiscal é um passo posterior, tratado em manual separado.
Importante — não confunda os dois fluxos:
- Devolução de Venda (este manual) — o cliente devolveu uma peça que comprou na sua oficina. Fica no menu Operacional → Devoluções.
- Devolução de Compra — sua empresa está devolvendo mercadoria ao fornecedor. Fica no menu Estoque → Devoluções de Compra.
1. Disponibilidade por plano
| Plano | Disponível? |
|---|---|
| Básico | Sim |
| Profissional | Sim |
| Avançado | Sim |
2. Quando usar
Use este fluxo quando:
- Cliente final devolveu uma ou mais peças vendidas na sua oficina;
- Pode ser devolução (cliente quer dinheiro/crédito de volta) ou troca (cliente quer outra peça no lugar);
- A venda original existe no sistema — pode ser do PDV, do balcão, ou de uma ordem de serviço.
Você não precisa devolver a venda inteira. Pode devolver só alguns produtos e em quantidades menores que as compradas. Por exemplo: se o cliente comprou 4 pastilhas mas devolveu 2, você registra só as 2 que voltaram.
3. Permissões necessárias
| Quero… | Permissão que preciso |
|---|---|
| Ver a lista de devoluções de venda | Listar devolução de venda |
| Abrir o detalhe de uma devolução | Visualizar devolução de venda |
| Criar uma nova devolução | Criar devolução de venda |
| Aprovar uma devolução pendente | Aprovar devolução de venda |
| Concluir uma devolução aprovada | Concluir devolução de venda |
| Cancelar uma devolução | Cancelar devolução de venda |
| Emitir nota fiscal de devolução (em manual separado) | Emitir nota fiscal |
Se um botão não aparece pra você, fale com quem administra o sistema para liberar a permissão.
4. Como acessar
- Menu lateral → "Operacional".
- No hub, clique no card "Devoluções" (descrição "Devoluções de vendas", ícone de seta circular).
- Você chega na lista de todas as devoluções de venda da empresa selecionada.
Dica: Se você está procurando devolver mercadoria para um fornecedor, esse não é o caminho — vá em Estoque → Devoluções de Compra.
5. A lista de devoluções
A lista mostra cada devolução já criada com:
- Número da devolução;
- Tipo (Devolução ou Troca);
- Cliente;
- Venda original referenciada;
- Status (Pendente, Aprovada, Concluída, Cancelada);
- Total de reembolso;
- Data de criação.
Use a coluna de ações pra abrir o detalhe, aprovar, concluir ou cancelar conforme o status.
No topo, o botão "Nova Devolução" abre o formulário de criação.
6. Criando uma nova devolução
Clique em "Nova Devolução" no topo da lista. O formulário tem dois cards principais: Informações Gerais e Itens.
6.1 Informações Gerais
| Campo | Como preencher |
|---|---|
| Venda* | Busque a venda pelo número (digite 3 ou mais caracteres) e selecione na lista que aparece. A venda é a base de tudo — define o cliente, os produtos disponíveis e o histórico fiscal. |
| Tipo* | Escolha entre "Devolucao" (cliente quer reembolso ou crédito) ou "Troca" (cliente vai levar outra peça). |
| Tipo de Reembolso (opcional) | Só se aplica quando o tipo é Devolucao. Escolha entre: "Estorno" (vai devolver dinheiro ao cliente) ou "Credito em loja" (cliente fica com crédito pra usar depois). Se ainda não decidiu, deixe em "Nenhum". |
| Motivo* | Texto livre (até 500 caracteres) explicando por que o cliente devolveu. Exemplo: "Peça com defeito", "Cliente comprou tamanho errado". |
| Observação (opcional) | Detalhes adicionais (até 500 caracteres). |
6.2 Itens
A tabela começa com uma linha vazia. Cada linha é um produto que está sendo devolvido. Você adiciona quantos itens quiser com o botão "Adicionar Item" no topo do card; remove com o ícone de lixeira ao final de cada linha (só fica disponível se houver mais de uma).
Em cada linha:
| Campo | Como preencher |
|---|---|
| Produto* | Busque pelo código (SKU) ou nome do produto (digite 3 ou mais caracteres) e selecione. Ao escolher, o Valor Unit. é preenchido automaticamente com o preço de venda do produto. |
| Quantidade* | Quantos do mesmo produto estão sendo devolvidos. Inteiro positivo (mínimo 1). |
| Valor Unit.* | Valor unitário a ser reembolsado. Preenchido automaticamente quando você seleciona o produto, mas pode editar (por exemplo, se cobrou desconto na venda original). |
| Subtotal | Calculado automaticamente (Quantidade × Valor Unit.). |
Embaixo do card há o "Total reembolso" somando todos os subtotais.
Atenção: só inclua aqui o que realmente está voltando. Se o cliente comprou 4 unidades e devolveu 2, coloque quantidade 2. A NF de devolução (etapa posterior) vai usar exatamente esses itens — não a venda inteira.
6.3 Salvar
Clique em "Criar Devolucao" no canto inferior direito. Se algum campo obrigatório estiver vazio, o sistema indica em vermelho. Após criar, você é redirecionado para o detalhe da devolução criada, que nasce no status Pendente.
Se quiser sair sem salvar, clique em "Cancelar" ao lado.
7. Ciclo de vida — status
| Status | O que significa |
|---|---|
| Pendente | Acabou de ser criada — aguarda decisão (aprovar ou cancelar). |
| Aprovada | Foi validada e está liberada pra ser concluída e/ou ter NF emitida. |
| Concluida | Foi efetivamente processada — peça(s) reincorporada(s) ao estoque, reembolso ou crédito formalizado. Status final. |
| Cancelada | Não vai acontecer — descartada antes ou depois de aprovar. Status final. |
Sequência possível:
Pendente → Aprovada → Concluida
↓ ↓
Cancelada Cancelada
Status finais (Concluída e Cancelada) não voltam atrás.
8. Tela de detalhe
Quando você abre uma devolução pela lista (ou após criá-la), vê:
8.1 Cabeçalho
- Número da devolução (gerado automaticamente).
- Data de criação.
- Botões de ação no canto direito, conforme o status atual.
8.2 Botões de ação (variam conforme o status)
| Status atual | Botões disponíveis |
|---|---|
| Pendente | "Aprovar" + "Cancelar" |
| Aprovada | "Concluir" + "Cancelar" + "Emitir NF de devolução" (quando a venda já tem NF original) |
| Concluida | "Emitir NF de devolução" (quando ainda não há NF emitida) |
| Cancelada | Nenhum — operação encerrada |
8.3 Card "Informacoes Gerais"
Mostra status, tipo, cliente, link pra venda original, motivo, tipo de reembolso (se preenchido), observação, quem aprovou e quando, quando foi concluída.
8.4 Card "Itens da Devolucao"
Tabela com produto, quantidade, valor unitário e valor de reembolso de cada item.
8.5 Card "Total reembolso"
Valor total a ser reembolsado ao cliente.
8.6 Card "Notas Fiscais Emitidas" (aparece após emitir)
Lista as NFs de devolução vinculadas — número/série, finalidade (sempre Devolução), status (Processando, Autorizada, Rejeitada, Cancelada), data e link pra detalhes. Atualiza sozinho enquanto há nota em processamento.
9. Aprovando uma devolução
Quando o gestor ou responsável valida o pedido do cliente:
- Abra o detalhe da devolução (status Pendente).
- Clique em "Aprovar" (exige permissão Aprovar devolução de venda).
- O sistema registra quem aprovou e a data/hora.
- Status passa para Aprovada.
A partir daqui, é possível emitir a NF de devolução (manual separado).
10. Concluindo uma devolução
A conclusão marca o ponto em que a operação se encerra fisicamente — a peça já voltou pro estoque, o cliente já foi reembolsado ou recebeu o crédito.
- Abra uma devolução Aprovada.
- Clique em "Concluir" (exige permissão Concluir devolução de venda).
- Status passa para Concluida e é registrada a data/hora.
10.1 Mensagem especial quando o reembolso é "Estorno"
Se o Tipo de Reembolso for "Estorno" (vai devolver dinheiro), ao concluir o sistema mostra um aviso:
"Uma conta a pagar (categoria D050 - Devolucao de Vendas) foi criada em aberto. Confira em Financeiro > Contas a Pagar para registrar o estorno ao cliente."
Ou seja: o sistema cria automaticamente uma conta a pagar representando o dinheiro a ser devolvido ao cliente. Vá em Financeiro → Contas a Pagar pra registrar o pagamento desse estorno quando ele ocorrer.
Dica: Se o Tipo de Reembolso for "Credito em loja" ou "Nenhum", essa mensagem não aparece — o sistema não gera conta a pagar.
11. Cancelando uma devolução
Se a devolução não vai acontecer (cliente desistiu, foi criada por engano, etc.):
- Abra o detalhe com status Pendente ou Aprovada.
- Clique em "Cancelar" (vermelho, exige permissão Cancelar devolução de venda).
- Status passa para Cancelada — operação final.
Atenção: se você já emitiu uma NF de devolução vinculada a essa devolução, também precisa cancelar a NF na tela dela (botão "Cancelar NF"), respeitando o prazo da SEFAZ (em geral 24h).
12. Próximo passo — emitir a NF de devolução
Depois de criar e aprovar a devolução, o último passo é emitir a NF-e de devolução referenciando a NF original da venda. Esse passo é coberto em manual separado:
Próximo manual: Devolução de Venda — Emitir NF — passo a passo da emissão, polling de status, baixar PDF/XML.
13. Resumindo o fluxo completo
1. Cliente devolve peça(s) no balcão
2. Operador vai em Operacional → Devoluções → Nova Devolução
3. Seleciona a venda original, tipo, motivo
4. Adiciona apenas os produtos que voltaram (com qtd correta)
5. Clica "Criar Devolucao" → nasce Pendente
6. Gestor ou operador aprova → Aprovada
7. (Opcional) Emite NF de devolução
8. Quando peça volta ao estoque e cliente recebe reembolso/crédito → Concluir
(Se for "Estorno", uma conta a pagar é gerada automaticamente)
14. Erros comuns e o que fazer
| Mensagem | O que significa | O que fazer |
|---|---|---|
| "Venda e obrigatoria" | Você não escolheu uma venda na busca. | Digite 3+ caracteres do número da venda e selecione. |
| "Motivo e obrigatorio" | Campo motivo vazio. | Preencha o motivo (até 500 caracteres). |
| "Adicione pelo menos um item" | Lista de itens está vazia ou sem produto. | Selecione produto e quantidade em pelo menos uma linha. |
| "Produto e obrigatorio" | Linha de item sem produto selecionado. | Busque e selecione o produto, ou remova a linha vazia. |
| "Quantidade deve ser > 0" | Quantidade inválida. | Use número positivo. |
| "Valor deve ser >= 0" | Valor unitário negativo. | Corrija o valor. |
| Botão "Aprovar" não aparece | Você não tem a permissão. | Solicite ao administrador. |
| Botão "Emitir NF de devolução" não aparece mesmo aprovado | A venda original ainda não teve NF emitida. | Emita primeiro a NF da venda original e tente de novo. |