Vender
Movimentar
- Acesse Movimentar → Vender.
- No topo da tela, selecione opcionalmente a Rota de venda. O campo de rota aparece antes do cliente.
- Quando a empresa usa tabelas de preço variáveis e o seu perfil permite escolher a tabela na tela de venda: com rota de venda selecionada, a tabela de preço acompanha automaticamente a tabela definida na rota (e o campo fica bloqueado até você limpar ou trocar a rota, sem mercadorias na venda). Sem rota, você escolhe a tabela livremente entre as opções permitidas.
- Com rota selecionada, a busca de cliente lista apenas clientes permitidos naquela rota (cobertura geográfica da rota). Sem rota, a busca de cliente lista toda a base ativa.
- Busque e selecione o cliente (obrigatório). Os campos de plano e forma de pagamento só são habilitados após a seleção. Use o ícone de lixeira para limpar a seleção. Aviso de inadimplência: se o cliente tiver títulos em atraso, um modal de aviso será exibido; a venda pode prosseguir normalmente.
- Adicione produtos: digite o nome para buscar e selecione; informe a quantidade. O saldo na busca segue a unidade da mercadoria: unidade inteira mostra número inteiro; unidade marcada como fracionada mostra até 3 casas, com vírgula. Na linha, a quantidade inteira continua de 1 em 1. Na unidade fracionada, digite com vírgula (ex.: 0,350). O preço unitário segue o cadastro (ou preço promocional, se houver campanha ativa). Se o produto estiver em mais de uma campanha ativa, o menor preço é aplicado.
- Modo PDV: na seção de itens, ative o interruptor Modo PDV para informar primeiro a quantidade e, em seguida, bipar o código de barras cadastrado na mercadoria simples ou na variante. Se a mesma mercadoria (ou variante) já estiver na venda, a quantidade é somada na linha existente, como na busca por nome; caso contrário, é criada uma nova linha. As mesmas regras de catálogo, rota e estoque da busca por nome continuam valendo. Se não houver código de barras cadastrado, a mercadoria não é encontrada. A preferência do modo PDV é lembrada neste navegador. Com o modo ativo, o botão + Adicionar mercadoria fica oculto; use a lixeira na linha para remover itens. Desative o interruptor Modo PDV para voltar à busca por nome, SKU ou ID.
- Brindes (configuração): se o administrador marcar em Configurações → Diretivas Comerciais a opção Permitir adição de mercadorias como brinde nas vendas, passa a existir a coluna Brinde na grade. Marque Sim na linha para registrar mercadoria ou variante com preço zerado na venda, em linha separada (não soma quantidade com a linha paga). O resumo não inclui brindes no total. A mesma mercadoria ou variante já vendida na linha padrão pode ser incluída de novo como brinde. Venda só com brindes (total zero) exige plano à vista (não é possível parcelar ou usar dias para a 1ª parcela).
- Produtos com variações: quando a mercadoria possuir grade preparada, a linha da venda pode exibir um seletor opcional de variante. Ao escolher uma variante ativa, o sistema usa seu preço como referência visual da linha e registra a variante escolhida como metadado da venda. Em vendas sem rota, a saída real baixa o saldo detalhado da variante. Em vendas com rota, quando a rota já opera com aprovisionamento por variante, o consumo e a validação usam o saldo da variante dentro da rota; mercadorias simples (sem grade operacional na rota) seguem o saldo agregado do produto na rota.
- Com rota selecionada, a busca de produtos mostra somente mercadorias com saldo disponível na rota. Sem rota, mostra mercadorias do estoque geral (fora de rota).
- Após adicionar uma mercadoria, a rota fica travada para edição nesta venda. Para trocar a rota, remova as mercadorias da venda e selecione novamente.
- Ao selecionar ou alterar a rota de venda (com lista de mercadorias vazia), o sistema recarrega mercadorias, clientes e vendedores da rota; nesse intervalo é exibida uma mensagem de carregamento.
- Escolha o plano de pagamento e a forma de pagamento. Em planos parcelados, pode ser solicitada uma entrada: informe o valor e selecione a forma da entrada e a forma das parcelas separadamente. O valor das parcelas é recalculado automaticamente. Se o plano tiver "Aplicar juros", os juros são calculados sobre o valor total (após descontos) e as parcelas já incluem o valor com juros.
- Plano Livre: quando o administrador ativar o plano de sistema Livre em Cadastros → Planos de Pagamento, ele passa a aparecer na venda (não em compras). Ao escolhê-lo, a forma fica travada em Crediário e é obrigatório informar a data de vencimento do título (posterior à data da venda). Gera um único título a receber. O cliente CONSUMIDOR FINAL não pode usar este plano.
- Plano de pagamento composto: quando o plano for o modo composto, a tela exibe linhas independentes (forma + valor + vencimento). A soma dos valores deve fechar com o total a pagar (resumo ao lado, já com juros do plano se existirem). Cada linha começa sem valor e sem vencimento: preencha manualmente ou use Preencher linha 1 com o restante quando houver duas ou mais linhas. Em cada linha, Dinheiro e PIX preenchem o vencimento com a data de hoje automaticamente e o campo de data fica bloqueado; nas demais formas, o vencimento é livre e deve ser informado (em geral após hoje para títulos que não são caixa imediato). Em cartão, o vencimento vem pré-preenchido com o D+ da forma (editável, a partir de hoje) e o valor entra no caixa só na baixa, em Cartões a receber. O Crediário pode ser escolhido em qualquer linha do composto (salvo para o cliente CONSUMIDOR FINAL, que segue sem crediário). Com forma cheque em uma linha, os dados do cheque e a microfilmagem opcional aparecem logo abaixo dessa linha.
- Cartão “Parcelas e entrada” (antes do bloco Observações): pré-visualização de parcelas do plano tradicional ou resumo do pagamento composto conforme o que você informa nas linhas (inclusive enquanto ainda há campos incompletos). No plano parcelado com entrada, o próprio cartão pode exibir o campo de valor da entrada.
- Informe o vendedor responsável (obrigatório quando a configuração "Exigir vendedor em todas as vendas" estiver ativa). Por padrão, a lista mostra apenas usuários ADMIN e SELLER ativos; se a diretiva Permitir apenas Administradores e Vendedores como responsáveis por uma venda estiver desmarcada (Configurações → Diretivas Comerciais), todos os usuários ativos aparecem. Com rota de venda selecionada, a lista continua sendo a dos operadores da rota. Se o responsável tiver Comissão (%) no cadastro, o sistema calcula e grava a comissão da venda (base: total da venda), usada em relatórios e em acertos de comissão.
- Se permitido nas configurações, o desconto segue a forma de aplicação definida em Configurações (veja 9.4): um percentual único sobre o total do pedido (excluindo automaticamente o valor das linhas em promoção no cálculo do desconto) ou percentual por mercadoria (coluna na grade de itens, até o máximo por linha). Em ambos os casos valem o limite máximo e a permissão por perfil (apenas ADMIN ou ADMIN e SELLER). Itens em campanha ativa não recebem desconto adicional. No modo por mercadoria, o operador pode editar tanto o Desconto (%) quanto o Valor unitário: ao editar o unitário, o sistema recalcula o percentual da linha em tempo real, valida o limite configurado e marca a linha como inválida quando extrapolar as regras.
- Use Anexar documento para enviar um PDF ou imagem (comprovante, contrato, autorização etc.), até 10 MB. O campo é opcional ou obrigatório conforme a configuração "Exigir anexo de documento na venda" (veja 9.4). O armazenamento é feito via Cloudinary, com segregação por cliente (tenant). Se o servidor não tiver Cloudinary configurado, o anexo não está disponível.
- Clique em Registrar venda.
Cliente CONSUMIDOR FINAL: quando o cliente selecionado for "CONSUMIDOR FINAL", o plano de pagamento permitido será apenas À vista e a forma de pagamento Crediário não estará disponível. Para os demais clientes, todos os planos e formas de pagamento cadastrados (e ativos) poderão ser utilizados.
Após registrar, o sistema redireciona para Listar Vendas. Se o plano for de crediário, com dias até o primeiro vencimento maiores que zero, ou a forma de pagamento for Cheque, será exibido um popup perguntando se deseja imprimir uma nova nota promissória para o cliente assinar e se deseja enviar o resumo da compra por e-mail ao cliente (ambas opções marcadas por padrão). Ao confirmar, a nota promissória abre em nova aba para impressão e o e-mail é enviado conforme seleção. O envio de e-mail requer GMAIL_USER e GMAIL_APP_PASSWORD configurados no servidor.
Vendas parceladas geram títulos em Títulos a receber. No estoque: sem rota, a baixa ocorre no estoque geral; com rota, a baixa ocorre no saldo da rota (quantidade vendida da rota). O sistema bloqueia a venda se algum produto não tiver quantidade suficiente na origem selecionada (salvo se "Permitir vendas sem estoque" estiver ativo para vendas sem rota).

