Cadastro de Devolução de Cliente
Módulo: Comercial Caminho na aplicação: Menu > Comercial > Devoluções de Cliente > "Nova devolução" ou ícone Editar na lista Última atualização: 20/04/2026
Para que serve
Registra a devolução de mercadoria por parte do cliente. O processo começa pela seleção do pedido de venda faturado de origem, seguida da marcação dos itens devolvidos com suas quantidades. Ao confirmar, o sistema registra a entrada de estoque nos itens selecionados.
Quem pode usar
Usuários com acesso ao módulo Comercial.
Como usar (passo a passo)
Criando uma nova devolução
- Clique em "Nova devolução" na Lista de Devoluções de Cliente.
- A tela exibe o seletor de pedido de origem. Busque o pedido pelo número ou nome do cliente.
- Somente pedidos com situação "Faturado" aparecem na lista.
- Selecione o pedido e clique em "Continuar".
- O sistema carrega os dados do pedido e exibe os itens para seleção.
- Preencha os campos: Depósito, Data da Devolução e Motivo.
- Marque os itens devolvidos na coluna "Selecionado". Ao marcar, a quantidade é preenchida automaticamente com o total original.
- Ajuste a quantidade a devolver e o valor unitário de cada item selecionado.
- Clique em "Salvar". O sistema cria a devolução em estado Rascunho.
- Revise os dados e clique em "Confirmar devolução" para registrar o estoque.
Editando uma devolução em Rascunho
- Abra a devolução pela lista.
- Ajuste depósito, data, motivo e itens.
- Clique em "Salvar".
Cancelando uma devolução confirmada
- Abra a devolução confirmada.
- Clique em "Cancelar devolução".
- Informe o motivo no modal (obrigatório, mínimo 3 caracteres, máximo 255).
- Confirme. O estoque é estornado.
Campos da tela
Tela de seleção de pedido de origem (somente na criação)
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Pedido de origem | Sim | Pedido faturado | Busca por número ou nome do cliente. Exibe: PV{numero} — {cliente} — {valor} — |
Cabeçalho: Informações do pedido de origem
Exibido após a seleção do pedido. Somente leitura.
| Campo | Descrição |
|---|---|
| Pedido origem | Número no formato "PV{numero}" |
| Cliente | Nome do cliente do pedido |
| Data emissão | Data de emissão do pedido no formato DD/MM/AAAA |
| Total do pedido | Valor total em BRL |
| NF-e | Número da NF-e e chave de acesso (quando disponíveis) |
Seção: Dados da Devolução
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Depósito para entrada | Sim | Depósito da filial do pedido | Somente depósitos ativos da filial são exibidos |
| Data da devolução | Sim | Data no formato DD/MM/AAAA | Default: hoje |
| Motivo da devolução | Sim | Texto descritivo | Mínimo 3, máximo 1.000 caracteres |
| Observações | Não | Texto livre | Máximo 500 caracteres |
Seção: Itens do Pedido
Tabela com todos os itens do pedido de origem. Campos editáveis somente em Rascunho.
| Coluna | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Selecionado (checkbox) | — | Marque os itens devolvidos | Ao marcar, preenche automaticamente "Qtd. a devolver" com a quantidade original |
| Produto | — | Nome do produto | Somente leitura; exibe número do lote quando aplicável |
| Unidade | — | Unidade transacionada do item no pedido de venda original | Somente leitura |
| Qtd. original | — | Quantidade do pedido | Somente leitura |
| Qtd. a devolver | Sim (quando selecionado) | Quantidade devolvida | Máximo: quantidade original; precisão 4 casas decimais |
| Valor unitário | Não | Valor em R$ | Preenchido do pedido; editável para ajustes de valor |
| Subtotal | — | Calculado automaticamente | Qtd. a devolver × Valor unitário |
Total a devolver: exibido no cabeçalho da seção; soma dos subtotais dos itens selecionados.
Validações e regras
- Somente pedidos com situação "Faturado" aparecem no seletor de origem.
- Ao menos um item deve estar selecionado com quantidade > 0 para salvar.
- A quantidade a devolver não pode superar a quantidade original do item.
- Devoluções com situação Rascunho permitem edição e remoção.
- Devoluções Confirmadas são somente leitura (exceto cancelamento).
- Devoluções Canceladas são somente leitura.
- Ao confirmar, o sistema registra movimentações de entrada de estoque nos itens selecionados.
- Ao cancelar uma devolução confirmada, as movimentações de estoque são estornadas. Contas a receber eventualmente canceladas pela confirmação não são restauradas automaticamente.
- Ao salvar em criação, navega para
/comercial/devolucoes-venda/:id(replace: true). - Ao salvar em edição (Rascunho), recarrega os dados da devolução.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Selecione ao menos um item para devolver" | Nenhum item marcado ou com quantidade > 0 | Marque e informe a quantidade de ao menos um item |
| "Selecione o deposito" | Depósito não selecionado | Escolha o depósito de destino |
| "Obrigatorio" | Data da devolução vazia | Preencha a data |
| "Motivo obrigatorio" | Campo motivo vazio | Informe o motivo |
| "Muito curto" | Motivo com menos de 3 caracteres | Detalhe melhor o motivo |
| "Maximo 1000 caracteres" | Motivo excede o limite | Reduza o texto |
| "Devolucao criada" | Criação bem-sucedida | — |
| "Devolucao atualizada" | Atualização bem-sucedida | — |
| "Devolucao confirmada — estoque atualizado" | Confirmação bem-sucedida | — |
| "Devolucao cancelada" | Cancelamento bem-sucedido | — |
| "Erro ao carregar pedido de venda" | Pedido não encontrado ou erro na API | Verifique se o pedido existe e está faturado |
| "Erro ao carregar devolucao" | ID inválido ou erro na API | Volte para a lista e tente novamente |
| "Informe o motivo" | Motivo de cancelamento vazio no modal | Preencha o motivo de cancelamento |
| ⚠️ CONFIRMAR texto literal | Erros retornados pelo backend | ⚠️ CONFIRMAR mensagem exata |
Integrações e dependências
- Serviço:
devolucoesVendaService(devolucoes-venda.service) - Serviço auxiliar:
depositosService(carrega depósitos ativos da filial do pedido) - Carrega pedido de venda via
/comercial/pedidos-venda/{id} - A confirmação gera movimentações de estoque no módulo de estoque
- Contas a receber podem ser afetadas no módulo financeiro
Dúvidas frequentes
Por que o depósito é obrigatório? A devolução registra entrada de estoque; o sistema precisa saber em qual depósito os itens devem ser registrados.
Posso devolver parcialmente um item? Sim. Informe a quantidade parcial no campo "Qtd. a devolver". Não precisa ser a quantidade total do pedido.
O que acontece com o financeiro após a confirmação?
Posso reabrir uma devolução confirmada para editar? Não. Devoluções confirmadas só podem ser canceladas. Para corrigir, cancele e crie uma nova devolução.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |