Cadastro de Devolução de Compra
Módulo: Compras Caminho na aplicação: Menu > Compras > Devoluções de Compra > "Nova devolução" ou ícone Editar em uma devolução existente Última atualização: 20/04/2026
Para que serve
Registra a devolução total ou parcial de mercadorias a um fornecedor, referenciando um pedido de compra que já possua itens recebidos. Ao confirmar, o sistema registra a saída de estoque dos itens selecionados e pode cancelar contas a pagar em aberto (em caso de devolução total).
Quem pode usar
Usuários com acesso ao módulo Compras.
Como usar (passo a passo)
Criação
- Na Lista de Devoluções de Compra, clique em Nova devolução.
- Na tela de seleção de pedido, localize o pedido de compra de origem (apenas pedidos com situação "Rec. Parcial" ou "Recebido" aparecem) e clique em Continuar.
- Informe o Depósito de saída, a Data da devolução e o Motivo da devolução (obrigatório).
- Na tabela de Itens do pedido, marque o checkbox dos itens que serão devolvidos.
- Ao marcar um item, a quantidade a devolver é preenchida automaticamente com a quantidade recebida daquele item.
- Ajuste a quantidade e o valor unitário conforme necessário.
- Se o item possuir lote, o número do lote é exibido abaixo do nome do produto (somente leitura nesta tela; vem do recebimento original).
- Informe observações gerais, se necessário.
- Clique em Salvar. O sistema redireciona para a tela de edição com o número gerado (
DC<numero>).
Edição (situação Rascunho)
- Clique no ícone Editar (lápis) na linha da devolução na listagem.
- Altere os campos desejados (depósito, data, motivo, itens selecionados, quantidades, valores).
- Clique em Salvar para gravar. Os dados são recarregados da API.
Confirmação
- Com a devolução em rascunho salva, clique em Confirmar devolução.
- Leia o aviso: a confirmação registra a saída de estoque dos itens selecionados e pode cancelar contas a pagar em aberto (em caso de devolução total).
- Confirme. A devolução passa para "Confirmada" e os campos ficam somente leitura.
Cancelamento
Disponível apenas para devoluções confirmadas.
- Clique em Cancelar devolução.
- Leia o aviso: as movimentações de saída geradas pela confirmação serão estornadas; contas a pagar canceladas não são restauradas automaticamente.
- Informe o motivo (mínimo 3, máximo 255 caracteres) e confirme.
- A devolução passa para "Cancelada".
Remoção
Disponível apenas para devoluções em rascunho.
- Clique em Remover e confirme.
- A devolução é excluída e o usuário é redirecionado para a listagem.
Campos da tela
Seção: Pedido origem (informativo, somente leitura)
Exibe o número do pedido de compra, o fornecedor, a data de emissão e o valor total do pedido.
Seção: Dados da devolução
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Depósito de saída | Sim | Selecione o depósito de onde as mercadorias sairão | Lista apenas depósitos ativos da filial do pedido |
| Data da devolução | Sim | Data em que os produtos serão devolvidos ao fornecedor (DD/MM/AAAA) | Padrão: data atual |
| Motivo da devolução | Sim | Descrição do motivo (mínimo 3 caracteres, máximo 1.000) | — |
| Observações | Não | Texto livre (máximo 500 caracteres) | — |
Seção: Itens do pedido
| Coluna | Descrição |
|---|---|
| (checkbox) | Marca o item para inclusão nesta devolução; desabilitado se quantidade recebida = 0 |
| Produto | Nome do produto; exibe número do lote (quando disponível) abaixo do nome |
| Un. | Unidade transacionada do item (herdada do recebimento/pedido original) |
| Qtd. pedido | Quantidade total do item no pedido de compra original |
| Qtd. recebida | Quantidade total efetivamente recebida em recebimentos confirmados |
| Qtd. a devolver | Quantidade a devolver neste ato (editável; máximo = quantidade recebida) |
| Valor unitário | Valor unitário de compra (editável) |
| Subtotal | Quantidade a devolver × valor unitário em R$ |
Totalizador
Exibido no cabeçalho da seção de itens: Total a devolver = soma de (quantidade a devolver × valor unitário) dos itens selecionados.
Validações e regras
- Só é possível criar uma devolução a partir de um pedido de compra com situação "Rec. Parcial" ou "Recebido".
- É obrigatório selecionar ao menos um item com quantidade maior que zero para salvar.
- O motivo da devolução é obrigatório (mínimo 3 caracteres).
- A quantidade a devolver não pode exceder a quantidade recebida do item.
- Itens com quantidade recebida igual a zero não podem ser selecionados.
- Ao marcar um item pela primeira vez, a quantidade a devolver é preenchida automaticamente com a quantidade recebida.
- Ao confirmar, a saída de estoque é registrada; ao cancelar, as movimentações são revertidas.
- Contas a pagar canceladas pela confirmação da devolução total não são restauradas automaticamente se a devolução for cancelada.
- Campos ficam bloqueados para edição após confirmação ou cancelamento.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Selecione o deposito" | Depósito de saída não selecionado | Selecione um depósito na lista |
| "Obrigatorio" | Campo de data não preenchido | Informe a data |
| "Motivo obrigatorio" | Campo de motivo vazio | Informe o motivo da devolução |
| "Selecione ao menos um item para devolver" | Nenhum item marcado ou com quantidade > 0 | Marque ao menos um item e informe a quantidade |
| "Informe o motivo" | Tentativa de cancelar sem preencher o motivo | Informe o motivo no campo exibido |
| "Devolucao atualizada" | Sucesso na atualização | — |
| "Devolucao criada" | Sucesso na criação | — |
| "Devolucao confirmada — saida de estoque registrada" | Sucesso na confirmação | — |
| "Devolucao cancelada" | Sucesso no cancelamento | — |
| "Devolucao removida" | Sucesso na remoção | — |
| "Erro ao carregar pedido de compra" | Falha ao buscar o pedido vinculado | Verifique a conexão e recarregue |
| "Erro ao carregar devolucao" | Falha ao buscar a devolução | Verifique a conexão e recarregue |
| "Erro ao carregar pedidos" | Falha ao listar pedidos na tela de seleção | Verifique a conexão e recarregue |
| — | Estoque abaixo da quantidade a devolver | ⚠️ CONFIRMAR |
Integrações e dependências
- Lista de Devoluções de Compra — tela de origem.
- Cadastro de Pedido de Compra — pedido de origem obrigatório.
- Depósitos — necessário cadastrar ao menos um depósito ativo na filial.
- Estoque — confirmação cria movimentação de saída; cancelamento reverte.
- Contas a Pagar — podem ser canceladas automaticamente na confirmação de devolução total (⚠️ CONFIRMAR comportamento exato do backend).
- Lotes — o número do lote exibido na linha do produto vem do recebimento original (somente leitura).
Dúvidas frequentes
Posso devolver apenas parte dos itens recebidos? Sim. Marque apenas os itens e informe as quantidades que deseja devolver. A devolução pode ser parcial tanto em itens quanto em quantidade por item.
O que acontece com o estoque ao cancelar uma devolução confirmada? As movimentações de saída são estornadas, devolvendo as quantidades ao estoque. Contas a pagar que foram canceladas pela confirmação não são restauradas automaticamente.
Posso criar uma devolução sem que o pedido tenha sido recebido? Não. Apenas pedidos com situação "Rec. Parcial" ou "Recebido" podem gerar devolução.
Qual a diferença entre o campo "Motivo da devolução" e "Observações"? O motivo é obrigatório e descreve a razão da devolução (ex.: produto com defeito, quantidade incorreta). As observações são complementares e opcionais.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |