Lista de Devoluções de Cliente
Módulo: Comercial Caminho na aplicação: Menu > Comercial > Devoluções de Cliente Última atualização: 20/04/2026
Para que serve
Exibe todas as devoluções de cliente registradas no tenant. Permite buscar, filtrar, criar e abrir devoluções. Uma devolução registra a entrada de mercadoria devolvida pelo cliente, estornando o estoque e podendo cancelar contas a receber em aberto.
Quem pode usar
Usuários com acesso ao módulo Comercial.
Como usar (passo a passo)
- Acesse Menu > Comercial > Devoluções de Cliente.
- Use os filtros de busca, situação e período para localizar devoluções.
- Clique no ícone Editar (lápis) na coluna de ações da linha para abrir o cadastro de edição.
- Clique em "Nova devolução" para iniciar o processo de devolução.
- A lista carrega mais registros ao rolar até o fim (scroll infinito, lotes de 50).
Campos da tela
Filtros
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Busca | Não | Cliente ou motivo | Filtra em tempo real |
| Situação | Não | Rascunho, Confirmada ou Cancelada | Seletor |
| Período | Não | Data de e data até | Seletor de intervalo no formato DD/MM/AAAA |
Colunas da tabela
| Coluna | Descrição |
|---|---|
| Número | Número sequencial da devolução no formato "DV{numero}" |
| Pedido origem | Número do pedido de venda originador no formato "PV{numero}" |
| Cliente | Nome do cliente |
| Data devolução | Data da devolução no formato DD/MM/AAAA |
| Valor | Valor total devolvido em BRL |
| Situação | Tag: Rascunho (cinza), Confirmada (verde), Cancelada (vermelho) |
Não há coluna de ações com lixeira na listagem. A remoção é feita dentro da tela de edição (disponível somente para devoluções em Rascunho).
Validações e regras
- Somente pedidos com situação "Faturado" podem gerar devolução.
- Devoluções confirmadas não podem ser editadas; somente canceladas.
- O cancelamento de uma devolução confirmada estorna as movimentações de estoque.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Erro ao carregar devolucoes" | Falha de comunicação com a API | Verifique a conexão e recarregue a página |
Integrações e dependências
- Serviço:
devolucoesVendaService(devolucoes-venda.service) - Devoluções são criadas a partir de Pedidos de Venda faturados
- Confirmação de devolução gera movimentação de entrada de estoque
Dúvidas frequentes
Por que não consigo criar devolução para um pedido? O pedido precisa estar com situação "Faturado". Pedidos em outros estados não aparecem no seletor de pedidos de origem.
A devolução cancela automaticamente as contas a receber?
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |