Módulo Devoluções

O que é o módulo Devoluções

O módulo Devoluções gerencia a devolução, total ou parcial, de uma venda ou de uma nota fiscal. Ele calcula automaticamente as proporções de descontos, acréscimos e impostos, integra com estoque e financeiro, e pode gerar uma NF de devolução ou um vale-troca para o cliente.

Cada devolução tem numeração própria (DEV-000001) e rastreia a origem — venda interna ou uma NF avulsa, quando a venda não existe no sistema.

Como acessar

No menu lateral, acesse Operações → Vendas → Devoluções. Rota: /devolucoes.

No menu lateral, entre em Devoluções. Rotas disponíveis:

• /devolucoes — listagem.
• /devolucoes/cadastrar — nova devolução.
• /devolucoes/editar/[id] — edição.
• /devolucoes/visualizar/[id] — modo leitura.
• /devolucoes/compartilhada/[hash] — link público para o cliente.

Listagem

A listagem traz número, cliente, total a devolver, status, data e badges de integração.

Filtros

• Status da devolução.
• Meio de devolução (sem pagamento, dinheiro, vale-troca, contas a pagar, estorno no gateway).
• Devolução parcial.
• Período (data inicial e final).
• Cliente.

Status e cores

Badges de integração

Cada devolução mostra selos indicando o que já foi processado:

• V — devolução vinculada à venda original atualizada.
• E — estoque lançado (itens retornaram ao depósito).
• C — contas lançadas (no financeiro).
• VT — vale-troca gerado.

Menu de contexto

As ações disponíveis variam conforme o status:

• Em aberto — Visualizar, Editar, Excluir, Alterar status, Gerar NF de devolução.
• Em andamento — Visualizar, Lançar estoque, Lançar conta, Gerar vale-troca, Imprimir vale, Compartilhar.
• Finalizada — Visualizar, Estornar estoque, Estornar conta, Imprimir.

Formulário

Dados básicos

A devolução precisa de uma origem — venda interna (venda origem) ou uma nota fiscal externa (número, série e chave da NF). O cliente e a data da venda vêm preenchidos automaticamente.

Itens da devolução

Selecione quais produtos estão voltando e a quantidade. O preço unitário e os totais são calculados a partir do documento de origem. Devoluções parciais são naturais no fluxo: o sistema mantém o restante na venda original.

Valores

Totais de produtos, descontos, acréscimos, impostos e total a devolver. Quando a devolução é parcial, o sistema rateia proporcionalmente — se você devolve 40% dos itens, 40% do desconto, acréscimo e imposto também voltam.

Meio de devolução

• Sem pagamento — apenas logística reversa, sem movimento financeiro.
• Dinheiro — devolve em dinheiro, gera saída no caixa/financeiro.
• Vale-troca — gera um vale no nome do cliente para usar depois.
• Contas a pagar — gera uma conta a pagar para o cliente no financeiro.
• Estorno no gateway — aciona o estorno na maquininha ou no gateway online.

Depósito e logística reversa

Informe o depósito para onde os produtos devem voltar. A configuração Depósito de devolução do módulo Vendas é usada como padrão.

Financeiro

Categoria e conta financeira usadas quando a devolução gera movimento no caixa ou no contas a pagar.

Observações e marcadores

Marcadores e observações internas para registro e filtros posteriores.

Fluxo completo

1. Selecionar a venda ou a NF de origem.
2. Escolher itens e quantidades a devolver.
3. Definir meio de devolução e depósito.
4. Salvar — status Em aberto.
5. Lançar estoque — itens voltam ao depósito.
6. Lançar conta — gera contas ou movimenta caixa, conforme o meio.
7. Gerar vale-troca (se aplicável) — cria o vale e torna disponível.
8. Gerar NF de devolução — quando necessária fiscalmente.
9. Finalizar — todas as integrações realizadas.

Integrações com outros módulos

Vendas

A venda de origem é atualizada: o item devolvido passa a contar como tal, e relatórios de vendas refletem o valor líquido.

Estoque

O lançamento de estoque devolve os itens ao depósito configurado. A configuração Lançar estoque automático na devolução do módulo Vendas, quando ativa, faz isso ao finalizar.

Finanças

Dependendo do meio de devolução, o sistema cria contas a pagar, saída de caixa ou estorno de recebimentos, sempre classificados pela categoria financeira escolhida.

Vale-troca

Quando o meio é vale-troca, o módulo Vale-Troca recebe automaticamente o crédito no nome do cliente, com a devolução como origem rastreável.

Fiscal (NF de devolução)

O módulo pode gerar uma NF de devolução com os itens e valores calculados, mantendo o vínculo com a NF de origem.

PDV e Restaurante

Devoluções feitas pelo PDV ou no restaurante também caem nesta listagem, preservando o vínculo com a venda original.

Compartilhamento com o cliente

O botão Compartilhar gera um link público /devolucoes/compartilhada/[hash] que o cliente pode abrir sem login para ver o comprovante e, quando existir, o vale-troca recebido.

Permissões

• Visualizar devolução.
• Criar devolução.
• Editar devolução.
• Excluir devolução.
• Finalizar devolução.
• Lançar estoque da devolução.
• Criar NF de devolução.
• Compartilhar devolução.

Perguntas frequentes

Posso devolver uma venda parcialmente mais de uma vez?

Sim. A cada devolução, o sistema considera o que ainda pode voltar. Quando a soma bate com o total, a venda é marcada como totalmente devolvida.

Como devolver um produto sem a venda estar no sistema?

Use a opção de devolução por NF: informe número, série e chave da nota fiscal. Os cálculos funcionam do mesmo jeito, apenas sem o vínculo com uma venda interna.

O desconto da venda é devolvido junto?

Sim, proporcionalmente ao total dos itens devolvidos. O sistema rateia descontos, acréscimos e impostos na mesma proporção.

Posso gerar um vale-troca automaticamente ao finalizar?

Sim. Basta escolher o meio de devolução Vale-troca. Ao acionar a ação correspondente, o módulo Vale-Troca recebe o crédito.

Como estornar uma devolução finalizada?

Use as ações de estorno disponíveis no menu de contexto: Estornar estoque e Estornar conta. Elas revertem as integrações. Em seguida, edite ou cancele a devolução.