# Vendas e devoluções

Registre vendas e devoluções, associe clientes e produtos e acompanhe a data de pagamento e seus efeitos na Performance.

Versão 1.2.0

Em **Operações → Vendas**, registre o valor comercial e os responsáveis por cada pedido. As abas **Todos**, **Vendas** e **Devoluções** organizam a consulta. Uma devolução é um registro próprio, com valor positivo e Tipo = Devolução; a dedução nos resultados decorre do tipo, não de digitar um valor negativo.

## Cadastrar o pedido

1. No cabeçalho, use **Vendas**; na aba Devoluções, a ação aparece como **Devolução** e inicia esse tipo.
2. Preencha **Informações principais**. Confira **Cliente** e **Produtos**, quando essas abas estiverem disponíveis.
3. Revise o Valor comercial e as datas e use **Salvar**. Trocar de aba do cadastro mantém os dados em edição.

| Campo | Como preencher e efeito |
| --- | --- |
| Tipo | Venda ou Devolução. O novo cadastro começa em Venda, exceto quando aberto pela aba Devoluções. |
| Pedido | Obrigatório, até 100 caracteres e único na empresa, incluindo devoluções e registros inativos. |
| Data | Data da venda/devolução; começa na data atual. Obrigatória e utilizada na contabilização por Data da venda. |
| Data de pagamento | Opcional, exibida à direita de Data quando habilitada em Performance → Configurar. Uma data preenchida indica pagamento integral nessa data. |
| Valor | Valor comercial total, monetário e não negativo; começa em zero. Não é preenchido automaticamente pela soma dos produtos no formulário web. |
| Colaborador | Responsável pela venda, obrigatório quando Colaboradores está habilitado. Participação nos resultados depende também do vínculo desse colaborador com a Performance. |
| Parceiro | Opcional, quando Parceiros está habilitado em Pessoas. É distinto do Cliente e do Colaborador; pode participar dos resultados conforme o ciclo. |
| Organização / Suborganização | Associações disponíveis conforme configurações e alcance do acesso. A Suborganização precisa pertencer à Organização selecionada. |
| Detalhes | Texto opcional, até 4.000 caracteres. |

O gerador junto a **Pedido** sugere `PED-` para venda e `DEV-` para devolução, seguidos de seis letras/números. A sugestão não reserva o número. Se outro registro usar o mesmo pedido antes de salvar, altere-o ou gere outro. O cadastro não exige vínculo com um pedido anterior para registrar uma devolução.

## Cliente e produtos

A venda pode ter um Cliente e até 500 itens de produto. As abas dependem de Clientes e Produtos habilitados; não são obrigatórias para um pedido básico. No web, **Buscar cliente/produto → Busca** localiza pelo nome ou documento e apresenta até oito correspondências.

Em **Cliente**, selecionar um cadastro o vincula à venda e mostra **Nome**, **Documento**, **Responsável**, **Organização** e **Suborganização**, conforme os recursos habilitados. O Responsável desse cadastro é quem acompanha o cliente; não substitui automaticamente o Colaborador da venda. **Editar** libera os campos; **Cadastrar e vincular** salva a pessoa e mantém o vínculo. **+ Novo cliente** prepara outro cadastro.

Em **Produtos**, selecionar um cadastro mostra **Nome**, **Valor**, Organização e Suborganização. Use **+ Adicionar produto** para incluí-lo na coleção da venda. **Editar** e **Cadastrar e adicionar** alteram o produto de origem; **+ Novo produto** prepara um novo cadastro. Essas gravações no Gerenciador são imediatas e exigem suas permissões próprias: cancelar depois a venda não desfaz um cliente/produto já criado ou alterado.

Em **Produtos vinculados à venda**, cada item possui **Produto**, **Quantidade**, **Valor unitário** e **Remover**. A inclusão sugere quantidade 1 e o preço do produto. Quantidade e valor unitário pertencem à venda; alterá-los não altera o preço do catálogo. Quantidade deve ser positiva, com até quatro casas decimais; valor unitário admite zero e usa centavos. O total do item é arredondado: 0,1 × R$ 10,05 resulta em R$ 1,01. **Remover** retira o item da venda ao salvar, sem excluir o produto. Confira separadamente o Valor total da venda. Não há controle de estoque nem cálculo tributário nessa operação.

## Data de pagamento

Ative **Gerenciador → Performance → Configurar → Usar data de pagamento nas vendas** para exibir **Data de pagamento** imediatamente à direita de **Data** na tabela e no cadastro. A opção começa desativada.

Uma venda com data de pagamento é considerada paga nessa data, pelo seu valor integral. Sem data, ela não participa dos cálculos por pagamento. É possível corrigir ou limpar essa data, respeitando os fechamentos. A venda continua disponível para edição; o pagamento não bloqueia o cadastro.

A configuração libera o preenchimento e a escolha da base nos novos ciclos. Os cálculos seguem a **Base de cálculo para resultados** salva em cada Performance. Desativar a opção não apaga datas nem muda ciclos existentes.

## Exclusão e proteção

Excluir pede confirmação e inativa a venda e seus produtos. Alterações usam a versão atual do registro; recarregue se outra sessão gravou antes. Os fechamentos protegem as datas da venda e do pagamento. Ter Data de pagamento preenchida não bloqueia o cadastro para edição.

## Status, aprovação e permissões

**Status → Ativo, Pendente ou Inativo** é o estado do registro, não informa se a venda foi recebida. Quando seu acesso exige aprovação, o pedido salvo fica Pendente e segue para **Operações → Liberações**. Editar um pedido pendente não substitui a aprovação. Registros pendentes ou inativos não entram nos cálculos que exigem vendas ativas/aprovadas.

Acesso à operação, criação, edição, exclusão e aprovação dependem das permissões. Um usuário Padrão consulta seus próprios registros de colaborador ou parceiro; permissões de edição não liberam vendas de outras pessoas. Administradores respeitam o alcance organizacional configurado. Novos vínculos precisam estar ativos e acessíveis. Catálogos desabilitados preservam os vínculos existentes, mas podem ocultar seus campos ou impedir novos vínculos.

Confira a decisão e seus efeitos em [Liberações](/spm/manual/liberacoes/#efeitos-da-decisao). Limites contratados, pedido repetido, referências indisponíveis e fechamento podem recusar o salvamento; erro em um item do pedido não grava apenas parte desse pedido.

## Tabela e disponibilidade

No web, a tabela tem oito registros por página. **Filtro** combina os campos das colunas visíveis: Tipo, Pedido, Colaborador, Parceiro, Organização, Suborganização, Data, Data de pagamento, Valor, Detalhes e Status, conforme recursos habilitados. Cliente e Produtos não são filtros dessa tabela. Sem escolher Inativo, a consulta oculta registros inativos. Alterar aba ou filtro limpa a seleção.

**Cadastro rápido** adiciona linhas temporárias para os dados básicos, sem Cliente ou Produtos. Confira o Colaborador sugerido. Cada clique acrescenta outra linha; **Cancelar** descarta os rascunhos locais. A ação **Editar** da linha abre o cadastro completo.

**Selecionar todos** abrange a aba filtrada inteira, inclusive outras páginas; clicar com alguma seleção a limpa. **Editar** no topo, sem seleção, libera os campos básicos da página; uma seleção delimita aquele registro. Com várias, **Editar selecionados** aplica um mesmo campo/valor aos selecionados. Pedido não pode ser alterado por esse lote. Cliente, produtos e demais campos não selecionados são preservados; mudar Organização limpa a Suborganização incompatível.

**Salvar** conclui a edição local; **Cancelar** a descarta. Os lotes são processados em blocos de até 500 registros: um erro desfaz o bloco, mas blocos anteriores podem já estar salvos. Leia a quantidade confirmada antes de tentar novamente.

## Duplicar vendas

**Duplicar**, sem seleção, prepara cópias dos dados básicos da página visível. Com seleção, copia os selecionados da aba filtrada, inclusive outras páginas. A cópia vem sem Pedido, Cliente ou Produtos; preencha um novo Pedido e revise os demais dados. Ela só é criada ao salvar. Não é uma cópia integral do pedido.

## Importar e exportar vendas

Os botões **Importar** e **Exportar** exibidos na tabela de Vendas ainda não executam transferência nesta versão. Para importar pedidos por arquivo, use um mapeamento em [Operações → Arquivos](/spm/manual/importacoes-operacionais/#selecionar-e-validar). O cadastro de Vendas não recebe XML fiscal nem possui anexo de nota: esse fluxo fica em [Documentos → XML de nota fiscal](/spm/manual/documentos-operacao/#xml-de-nota-fiscal).

## Como a venda entra na Performance

Registrar uma venda não cria comissão ou pagamento automaticamente. O pedido precisa estar ativo/aprovado e ligado a um colaborador ou parceiro participante do ciclo; as regras do indicador determinam como o resultado remunera.

A base salva no ciclo considera **Data da venda** ou **Data de pagamento**, usando o valor integral das vendas ativas menos devoluções. Sem data de pagamento, a venda não entra na segunda base. O colaborador e o parceiro são os da venda/devolução. Pagamentos de comissão, bônus, prêmio, fixo e reembolso não alteram essa base.

Uma venda de R$ 3.000 paga em agosto contribui R$ 3.000 no ciclo que usa Data de pagamento de agosto. Consulte [bases e datas da Performance](/spm/manual/performance-bases-de-calculo/#data-da-venda-e-data-de-pagamento). Não existe seletor de Performance no pedido: a associação decorre dos participantes, datas e base do ciclo.

## Disponibilidade

Web e aplicativo oferecem consulta, cadastro, edição e duplicação de vendas/devoluções conforme permissões, aprovação e fechamentos. O aplicativo trabalha com um registro selecionado; não oferece o cadastro rápido, a edição em lote nem a transferência de arquivos da tabela web.

No aplicativo, Cliente e Produto são escolhidos entre cadastros existentes; o espelho para criar/editar esses catálogos pertence ao web. Nos produtos, **Usar este total na venda** copia explicitamente a soma dos itens para Valor. Configurações dos catálogos ficam no web.