Vendas
Vendas — Rastreabilidade (Portal Easypac)
A tela de Vendas é onde você registra as saídas de produto para clientes.
Visão Geral
A tela de Vendas é onde você registra as saídas de produto para clientes. Cada venda tem um cabeçalho (empresa, cliente, data da venda, número do documento e chave de acesso da NF-e) e uma lista de itens (produto, unidade, rastreabilidade do lote e quantidade).
Cada item lançado consome o saldo do lote escolhido, registrando para qual cliente o lote foi vendido. A partir de uma venda já gravada, você também pode gerar o arquivo de etiquetas para impressora térmica, com uma etiqueta por item.
A janela Imprimir Etiquetas também é usada nas telas de Compras e Produção Simples: nela você escolhe itens de um documento já gravado (compra, produção simples ou venda), escolhe um modelo de etiqueta e baixa um arquivo com uma etiqueta por item marcado. Ela é aberta pelo botão “Imprimir Etiquetas” da grade de itens dessas telas.
Cada etiqueta traz os dados da empresa do documento, o nome do produto, a quantidade com unidade, o código de rastreabilidade do lote, um QR Code que leva à consulta de rastreabilidade e, nos modelos nutricionais, a tabela nutricional do produto. A impressão é feita no seu computador, em uma impressora de etiquetas compartilhada.
Pré-requisitos
Para usar a tela de Vendas, você precisa ter ao menos uma empresa vinculada ao seu usuário.
Para lançar uma venda:
- O cliente precisa estar cadastrado.
- O produto precisa estar cadastrado e ativo na empresa.
- O produto precisa ter ao menos um lote com saldo na unidade escolhida.
- O seu computador tenha acesso a uma impressora de etiquetas (Zebra ou compatível) compartilhada, com a configuração inicial feita uma vez.
Permissões e Perfis de Acesso
- Abrir a listagem de vendas: permissão de Listagem.
- Lançar uma nova venda: permissão de Novo.
- Editar uma venda: permissão de Editar.
- O produto tenha descrição e o lote tenha código de rastreabilidade.
- O seu computador tenha acesso a uma impressora de etiquetas (Zebra ou compatível) compartilhada, com a configuração inicial feita uma vez.
O item Vendas só aparece no menu Rastreabilidade quando o módulo de Rastreabilidade está habilitado para a sua empresa. Usuários com perfil fiscal não têm acesso à tela de Vendas.
Fluxo Operacional
Fluxo — lançar uma nova venda
- Abra Rastreabilidade > Vendas e clique em Novo.
- Em Dados da Venda, confira a empresa, escolha o Cliente, confira a Data Venda e, se quiser, informe o Num Doc e a Chave de Acesso NFE.
- Clique em Salvar. Após a mensagem “Cabeçalho salvo com sucesso!”, a tela abre a edição da venda com o bloco Itens da Venda.
- Em Itens da Venda, clique em Novo, escolha o produto, a unidade e a rastreabilidade, informe a quantidade e salve.
- Repita o passo 4 para cada item.
Fluxo — consultar e alterar uma venda
- Na listagem, ajuste os filtros e clique em Filtrar.
- Selecione a linha e clique em Editar, ou dê duplo clique na linha.
- Altere o cabeçalho, lance novos itens, edite um item (duplo clique na linha do item) ou exclua um item.
- O botão Cancelar volta à listagem com os filtros anteriores.
Fluxo — imprimir etiquetas de uma venda
- Na edição da venda, clique em Imprimir Etiquetas na grade de itens.
- Escolha o modelo de etiqueta, marque os itens e clique em Imprimir.
- O navegador baixa o arquivo de etiquetas para enviar à impressora térmica.
- O botão que gera o arquivo também é identificado como “Baixar Etiquetas”. O navegador baixa o arquivo com uma etiqueta por item marcado.
- A janela continua aberta para uma nova geração. Para sair, clique em “Cancelar” ou no X.
O mesmo fluxo vale para as telas de Compras e Produção Simples: abra a edição de uma compra ou produção simples já gravada e, na grade de itens, clique em “Imprimir Etiquetas” (ícone de impressora).
Interface e Comportamentos da Tela
Listagem de vendas
A grade tem as colunas ID, Data Estoque, Num. Documento, Cliente, Produto, Rastreabilidade, Unidade e Quantidade, todas ordenáveis. As vendas mais recentes aparecem primeiro. Os botões são Novo e Editar; Editar só fica habilitado com uma linha selecionada, e o duplo clique na linha faz o mesmo.
A grade mostra uma linha por item: uma venda com três itens aparece em três linhas, com o mesmo ID. Uma venda ainda sem itens aparece em uma linha com produto, unidade e rastreabilidade vazios e quantidade zero.
Não há botão para excluir a venda inteira; apenas os itens podem ser excluídos.
Filtros da listagem
O painel de filtros tem o botão Filtrar e os campos:
- Empresa: seleção múltipla; a sua empresa padrão já vem marcada.
- Produto e Cliente: abrem uma janela de pesquisa; o X ao lado limpa o valor.
- Rastreabilidade e Num. Documento: buscam o valor exato digitado.
- Data Estoque Inicial e Data Estoque Final: obrigatórias; o período padrão é o dia de hoje.
Ao abrir a tela, a grade já carrega com os filtros padrão. Os seletores de Produto e Cliente do filtro consideram a empresa ativa escolhida no topo do portal. Se a data final ficar anterior à inicial, ela é igualada à inicial automaticamente.
Os filtros ficam guardados na sessão: ao voltar de uma venda pelo botão Cancelar, a listagem é restaurada com os mesmos filtros.
Cabeçalho Dados da Venda
O cabeçalho tem os campos Empresa, Cliente (obrigatório), Data Venda (obrigatória), Num Doc e Chave de Acesso NFE, e os botões Cancelar e Salvar. Na inclusão, a Empresa vem com a sua empresa padrão e a Data Venda com o dia de hoje. A Data Venda não aceita datas futuras.
O seletor de Cliente oferece os clientes da empresa escolhida no cabeçalho. Trocar a empresa limpa o cliente escolhido.
O bloco Itens da Venda só aparece depois que o cabeçalho é salvo.
Grade de itens da venda
A grade tem as colunas Id, Num. Item, Produto, Unidade, Quantidade e Lote. Os botões são Imprimir Etiquetas, Novo e Excluir; Excluir só fica habilitado com uma linha selecionada. Para editar um item, dê duplo clique na linha.
O botão “Imprimir Etiquetas” fica na barra da grade de itens das telas de Compras, Produção Simples e Vendas e só aparece quando o documento já foi gravado.
Janela de item da venda
A janela tem o título “Novo Item” ou “Edição de Item” e os campos:
- Produto: obrigatório; oferece os produtos da empresa da venda.
- Unidade: obrigatória.
- Selecione a Rastreabilidade: grade com ID, Código, Saldo Unidade, Unidade e Data Produção. Clique na linha da rastreabilidade desejada para selecioná-la.
- Quantidade: obrigatória e maior que zero, limitada ao saldo do lote escolhido.
Os campos aparecem em sequência: a grade de rastreabilidades aparece depois de escolher o produto, e a Quantidade aparece depois de selecionar uma rastreabilidade. A grade mostra apenas os lotes do produto na unidade escolhida e com saldo disponível. Ao trocar o produto ou a unidade, a lista é atualizada.
Saldo do lote
- Ao incluir um item, o saldo do lote diminui pela quantidade vendida.
- Ao editar a quantidade de um item, o saldo é ajustado pela diferença.
- Ao excluir um item, a quantidade volta ao saldo do lote.
Janela Imprimir Etiquetas
A janela tem os campos Modelo de Etiqueta e Itens (com caixa de marcação, Descrição, Código e Quantidade), os botões Cancelar e Imprimir e o ícone de ajuda “Configuração Inicial para Impressão”. Os modelos disponíveis são:
- 50x120mm – Padrão Caixa/Sacaria
- 50x160mm – Padrão Caixa/Sacaria
- 50x120mm – Nutricional
- 120x60mm – Nutricional
- 25x40x4mm – Simples
- 25x30x2mm – Simples Oval
A coluna Quantidade da janela mostra o saldo atual do lote; a etiqueta impressa usa a quantidade vendida no item.
Ajuda de configuração inicial para impressão
A ajuda explica, em três passos feitos uma única vez no computador, como preparar a impressão: descobrir o nome do computador, descobrir o nome compartilhado da impressora e associar os arquivos de etiqueta ao arquivo imprimir.bat. Informe o “Nome do computador” e o “Nome compartilhado da impressora” e clique em “Gerar e Baixar imprimir.bat”. Depois disso, um duplo clique no arquivo de etiqueta imprime automaticamente.
Feedbacks ao Usuário
Avisos e confirmações
| Situação | Feedback | Texto exibido |
|---|---|---|
| Data final do filtro anterior à inicial | Aviso; data final igualada à inicial | “Entre a data inicial e a data final não pode haver um intervalo inferior a 0 dias. Período atualizado automaticamente.” |
| Cabeçalho salvo | Sucesso; a tela abre a edição da venda | “Cabeçalho salvo com sucesso!” |
| Item salvo | Sucesso; a grade de itens é atualizada | “Item salvo com sucesso!” |
| Clique em excluir item | Confirmação com Ok e Cancelar | “Tem certeza? / Você está prestes a remover o item: {código} – {produto}” |
| Item excluído | Sucesso; a grade é atualizada | “Operação efetuada com sucesso.” |
Situações sem mensagem
| Situação | O que acontece |
|---|---|
| Filtrar com uma das datas vazia | O painel é marcado como inválido e o filtro não é aplicado |
| Salvar o cabeçalho sem Cliente ou Data Venda | Os campos são destacados e nada é salvo |
| Salvar o item com campo obrigatório vazio | Aparece o aviso de campos obrigatórios e a tela rola até o campo |
| Imprimir sem modelo ou sem item marcado | A janela é destacada como inválida e nada é gerado |
| Gerar o imprimir.bat com algum campo vazio | Os campos são destacados e nada é gerado |
| Documento sem itens com lote | A grade mostra “Sem registros” |
| Download concluído | Nenhum aviso; a janela continua aberta |
Mensagens de erro
| Mensagem | O que fazer |
|---|---|
| “Quantidade {quantidade} é maior que a disponível” | Reduzir a quantidade ao saldo do lote ou escolher outro lote. |
| “Lote de produto não encontrado.” | Reabrir a janela de item e escolher outra rastreabilidade. |
| “Venda não encontrada” | O item já foi excluído ou não existe — atualizar a grade. |
| “Id do lote não encontrado” | O item está sem lote e não pode ser excluído — acionar o suporte técnico. |
| “Item não encontrado” | O item foi removido — atualizar a grade. |
| “Modelo inválido” | Escolher um dos seis modelos da lista. |
| “Model de etiqueta não encontrado” | Usar outro modelo e acionar o suporte técnico. |
| “Tag ##<nome>## inválida!” | O modelo de etiqueta está com problema — acionar o suporte técnico. |
| “Existe uma ou mais tags não tratadas!” | Acionar o suporte técnico. |
Relatórios e Documentos Gerados
Arquivo de etiquetas
O botão Imprimir da janela Imprimir Etiquetas gera na hora um arquivo com uma etiqueta por item marcado, que o navegador baixa em seguida. Cada etiqueta traz o produto, a quantidade, os dados da empresa, o código de rastreabilidade e um QR Code que leva à consulta de rastreabilidade do lote. Nos modelos nutricionais, a etiqueta inclui a tabela nutricional do produto. Não aparece mensagem de sucesso: você sabe que terminou porque o arquivo é baixado. A quantidade sai com a unidade. Nos modelos nutricionais, a tabela traz os nutrientes cadastrados para o produto. No modelo 120x60mm – Nutricional, a tabela sai deitada.
Arquivo de impressão
A ajuda de configuração inicial gera um arquivo de comandos do Windows que envia o arquivo de etiqueta para a impressora compartilhada informada.
Troubleshooting
A opção Vendas não aparece no menu Rastreabilidade
O que fazer: solicitar ao administrador que verifique se o módulo de Rastreabilidade está habilitado para a sua empresa. Usuários com perfil fiscal não têm acesso à tela de Vendas.
O item Vendas aparece no menu, mas não abre
O que fazer: solicitar ao administrador a permissão de Listagem de Vendas.
Acesso negado ao abrir a listagem, uma nova venda ou a edição
O que fazer: solicitar ao administrador a permissão que falta: Listagem para abrir a listagem, Novo para lançar uma venda, Editar para abrir a edição.
A listagem de vendas abre vazia
Mensagem exibida: “Sem registros” ou “Nenhum registro encontrado”.
O que fazer: o período padrão é só o dia de hoje — ampliar a Data Estoque Inicial. Verificar se há ao menos uma empresa marcada no filtro Empresa e se os filtros de produto, cliente, rastreabilidade ou número do documento estão corretos (rastreabilidade e número do documento exigem o valor exato).
O botão Filtrar não aplica o filtro
O que fazer: preencher Data Estoque Inicial e Data Estoque Final, que são obrigatórias.
Aviso de intervalo ao alterar as datas do filtro
Mensagem exibida: “Entre a data inicial e a data final não pode haver um intervalo inferior a 0 dias. Período atualizado automaticamente.”
O que fazer: a data final foi igualada à inicial. Reajustar a data final para o período desejado.
O mesmo ID de venda aparece em várias linhas, ou uma venda aparece com quantidade zero
O que fazer: a grade mostra uma linha por item. Uma venda sem itens aparece uma vez, com produto vazio e quantidade zero. Abrir a edição para ver ou lançar os itens.
Ao trocar o produto ou o cliente do filtro, a grade traz as vendas dos dois
O que fazer: clicar no X do seletor para limpar o valor anterior antes de escolher o novo.
O seletor de cliente ou de produto não mostra o registro procurado
O que fazer: no filtro da listagem, os seletores consideram a empresa ativa do topo do portal — trocar a empresa ativa. No cabeçalho da venda, o cliente é da empresa escolhida no cabeçalho. O produto só aparece se estiver ativo na empresa. Usar a pesquisa por código ou parte do nome.
Erro ao abrir uma nova venda ou a edição
O que fazer: em nova venda, verificar com o administrador se você tem empresa vinculada. Na edição, voltar à listagem e selecionar a venda novamente.
Não é possível salvar o cabeçalho da venda
O que fazer: preencher Cliente e Data Venda (que não pode ser posterior a hoje).
O bloco Itens da Venda não aparece na nova venda
O que fazer: salvar o cabeçalho primeiro. Depois de “Cabeçalho salvo com sucesso!”, o bloco de itens aparece.
A quantidade é maior que o saldo
Mensagem exibida: “Quantidade {quantidade} é maior que a disponível”
O que fazer: reduzir a quantidade ao saldo do lote, mostrado na grade de rastreabilidades, ou escolher outro lote. Na edição, a nova quantidade é comparada ao saldo restante do lote, por isso também pode ser recusada.
Lote de produto não encontrado ao salvar o item
Mensagem exibida: “Lote de produto não encontrado.”
O que fazer: reabrir a janela de item e escolher outra rastreabilidade.
A grade de rastreabilidades não mostra o lote esperado
O que fazer: só aparecem lotes do produto escolhido, na unidade escolhida e com saldo disponível. Verificar o produto, a unidade e o saldo do lote.
O campo Quantidade não aparece na janela de item
O que fazer: escolher o produto e clicar na linha da rastreabilidade desejada.
Aviso de campos obrigatórios ao salvar o item
O que fazer: preencher Produto, Unidade, rastreabilidade e Quantidade maior que zero.
Quantidade menor que 1 (por exemplo 0,500) é recusada
O que fazer: a tela pode recusar quantidades menores que 1 com o aviso de campos obrigatórios. Acionar o suporte técnico.
A janela de item fecha e o erro aparece depois
O que fazer: a janela fecha ao salvar; se o item for recusado, reabrir a janela e digitar o item novamente.
Falha ao excluir o item
Mensagem exibida: “Venda não encontrada” ou “Id do lote não encontrado”.
O que fazer: “Venda não encontrada” indica que o item já foi excluído — atualizar a grade. “Id do lote não encontrado” indica que o item está sem lote — acionar o suporte técnico.
Não existe botão para excluir a venda inteira
O que fazer: apenas os itens podem ser excluídos; a venda não pode ser excluída pelo portal.
Imprimir etiquetas não faz nada
O que fazer: escolher o Modelo de Etiqueta e marcar ao menos um item.
O arquivo de etiquetas não é baixado
O que fazer: verificar se a empresa tem endereço, cidade, UF, CNPJ e telefone cadastrados e se o lote tem código de rastreabilidade. Se o problema persistir, acionar o suporte técnico. Verificar também o nome da empresa e a descrição do produto: todos os dados são exigidos, mesmo que o modelo não os mostre. Se nenhuma mensagem aparecer, reabrir a janela, marcar os itens novamente e tentar de novo.
A quantidade na janela de impressão é diferente da quantidade vendida
O que fazer: a coluna Quantidade da janela mostra o saldo atual do lote; a etiqueta impressa usa a quantidade vendida no item.
O arquivo de etiqueta não imprime ao dar duplo clique
O que fazer: fazer a configuração inicial descrita na ajuda da janela: informar o nome do computador e o nome compartilhado da impressora, baixar o arquivo de impressão e associar os arquivos de etiqueta a ele. O arquivo baixado se chama “Impressao.bat”.
A grade de vendas ou de itens não atualiza
O que fazer: recarregar a tela. Se persistir, acionar o suporte técnico.
O botão Imprimir Etiquetas não aparece na grade de itens
O que fazer: gravar o documento primeiro. O botão só aparece em documentos já gravados.
A janela Imprimir Etiquetas abre com a grade de itens vazia
Mensagem exibida: “Sem registros”
O que fazer: verificar se os itens do documento têm lote e produto cadastrados. Corrigir o lote no documento e reabrir a janela.
A janela abre com a grade vazia e um aviso de erro
O que fazer: fechar a janela e tentar novamente. Se persistir, acionar o suporte técnico com o texto exibido.
Erro “Modelo inválido”
Mensagem exibida: “Modelo inválido” O que fazer: escolher um dos modelos da lista. Se o erro persistir, acionar o suporte técnico.
Erro “Model de etiqueta não encontrado”
Mensagem exibida: “Model de etiqueta não encontrado”
O que fazer: usar outro modelo e acionar o suporte técnico para disponibilizar o modelo escolhido.
Erro de tag inválida ou de tags não tratadas
Mensagem exibida: “Tag ##<nome>## inválida!” ou “Existe uma ou mais tags não tratadas!”
O que fazer: acionar o suporte técnico para corrigir o modelo de etiqueta.
O arquivo baixado está vazio ou incorreto
O que fazer: acionar o suporte técnico informando o navegador usado e o documento.
O QR Code da etiqueta impressa não abre a consulta de rastreabilidade
O que fazer: acionar o suporte técnico.
A tabela nutricional mostra porção diferente da real ou um “%” sozinho
O que fazer: os textos de porção (“Poções por embalagem: 10” e “Poção: 100 g (2 xícaras)”) são fixos para qualquer produto. O “%” sozinho indica nutriente sem percentual do valor diário — completar o cadastro nutricional do produto.
Casos de Uso
Caso 1 — Lançamento de uma venda de 25 kg de farinha
A analista da expedição abre Rastreabilidade > Vendas e clica em Novo. Escolhe o cliente “Padaria Pão Quente”, mantém a data de hoje, informa o Num Doc 1042 e salva; a tela mostra “Cabeçalho salvo com sucesso!”. Em Itens da Venda, clica em Novo, escolhe “Farinha de Trigo Tipo 1”, a unidade KG e o lote L-2210 (saldo 400). Informa 25 e salva; a tela mostra “Item salvo com sucesso!” e o saldo do lote passa a 375.
Caso 2 — Correção da quantidade de um item
O supervisor percebe que o item de 25 kg deveria ser de 20 kg. Na edição da venda, dá duplo clique na linha do item, altera a quantidade para 20 e salva. O saldo do lote volta de 375 para 380.
Caso 3 — Exclusão de um item lançado por engano
Na edição da venda, o usuário seleciona o item e clica em Excluir. Confirma “Tem certeza?” e a tela mostra “Operação efetuada com sucesso.”. A quantidade volta ao saldo do lote e a venda continua cadastrada, agora sem itens.
Caso 4 — Impressão das etiquetas com tabela nutricional
Depois de lançar dois itens, a analista clica em Imprimir Etiquetas, escolhe o modelo “50x120mm – Nutricional”, marca os dois itens e clica em Imprimir. O navegador baixa um arquivo com duas etiquetas, cada uma com o QR Code de rastreabilidade e a tabela nutricional. Com a configuração inicial já feita no computador, um duplo clique no arquivo imprime as etiquetas.