📖 Manual de Uso — Equipe Desffrut

Guia completo para todos os cargos da equipe. Clique na seção correspondente ao seu cargo.

O que o Dono pode fazer no sistema?

🎨 Aparência do portal Logo, cores, banners e nome da loja
📊 Relatórios e lucro Faturamento, despesas, resultado do mês
🏪 Dados das filiais Endereço, horário e WhatsApp de cada loja
📡 Anúncios e campanhas Medir retorno de anúncios, criar promoções sazonais
🔐 Segurança Histórico de tudo que aconteceu no sistema
🤝 Parceiros B2B Leads e funil de prospecção de clientes corporativos

Primeiro acesso

  1. Acesse /clientes/desffrut/login com o e-mail e senha cadastrados para o perfil de dono.
  2. Você irá direto para o Painel de Controle (Dashboard) automaticamente.
  3. Na primeira vez, configure a aparência em CMS & Portal → Identidade Visual: coloque o logo, nome da loja, slogan e cores.

Configurar a aparência das lojas e filiais

No Painel → CMS & Portal → Lojas: edite o endereço, horário de funcionamento e o número de WhatsApp de cada filial. Essas informações aparecem automaticamente na página pública "Nossas Lojas".

Colocar banners na página inicial

Painel → CMS & Portal → Banners: envie imagens de promoções para aparecer no carrossel da página principal. Você pode ativar ou desativar cada banner e definir por quanto tempo ele aparece.

Criar promoções sazonais (Dia das Mães, Natal etc.)

Painel → CMS & Portal → Campanhas: crie cupons de desconto globais para datas especiais. Defina a data de início e o fim da promoção — o sistema ativa e desativa automaticamente.

Gerenciar quem acessa o sistema

Para criar ou alterar o acesso de um funcionário, o desenvolvedor técnico (responsável pela manutenção do sistema) realiza essa operação. Os tipos de acesso disponíveis são:

  • Cliente — acesso apenas ao catálogo e ao próprio perfil
  • Caixa — acesso ao sistema de vendas (PDV)
  • Entregador — acessa apenas a lista de entregas do dia
  • RH / Financeiro — acessa folha de pagamento, contas e relatórios
  • Gerente — acessa produtos, estoque, pedidos e relatórios
  • Dono / Super Admin — acesso completo a tudo
O tipo de acesso "dev_admin" (desenvolvedor do sistema) é exclusivo do técnico responsável e não deve ser atribuído a funcionários da loja.

Ver os resultados financeiros do mês

Painel → Relatórios → BI / Gráficos: visualize quanto a loja faturou, quanto gastou e qual foi o lucro. O relatório financeiro completo (chamado de DRE — Demonstração do Resultado do Exercício, que é basicamente um resumo de receitas e gastos) está na aba "DRE".

Medir o retorno dos anúncios

Painel → Marketing: veja quais anúncios geraram mais vendas. O sistema se integra com as ferramentas de anúncio do Facebook/Instagram (chamado de Meta Pixel — um código invisível que conta quando alguém que viu o anúncio fez um pedido) e com o Google Analytics (ferramenta gratuita do Google que conta quantas pessoas visitaram o site e compraram).

Para ativar essas medições, basta pedir ao desenvolvedor os números de identificação das contas de anúncio e inserir no painel Marketing → Pixels & Tags.

Consultar o histórico de segurança

Painel → Administração → Auditoria: o sistema guarda um registro de tudo que aconteceu — quem fez sangria no caixa, quem cancelou uma venda, quem mudou o preço de um produto. Esse histórico é somente para consulta; ninguém consegue apagar os registros.

Cadastrar e editar produtos

  1. Painel → Produtos & Estoque → Produtos
  2. Clique em + Novo Produto.
  3. Preencha nome, categoria, unidade de venda (quilograma ou unidade), código de barras (o número abaixo das listras do pacote — chamado de EAN), preço de custo e preço de venda.
  4. Envie a foto do produto (formatos JPG, PNG ou WEBP, até 6 MB — o sistema converte automaticamente para um formato compacto).
  5. Salve. O produto aparece no catálogo público imediatamente.
Para esconder temporariamente um produto sem apagar o histórico de vendas dele, use o botão Ativo/Inativo na lista de produtos.

Programar promoções

Na tela de edição do produto, defina um Preço Promocional com data e hora de início e fim. O sistema aplica e remove o desconto automaticamente — sem precisar lembrar de alterar.

Controlar o estoque

Painel → Produtos & Estoque → Estoque: ajuste as quantidades disponíveis em cada loja, defina o estoque mínimo (abaixo disso o sistema emite alerta) e veja os produtos que precisam ser repostos.

Registrar perdas e produtos estragados (quebras)

Painel → Produtos & Estoque → Quebras: informe quais produtos estragaram ou foram avariados, com a quantidade e o motivo. O estoque é deduzido automaticamente e a perda fica registrada para o relatório financeiro.

Gerenciar pedidos de entrega

📥
Pedido recebido
Aceitar pedido
📦
Separar e despachar
🛵
Entregador a caminho
🏠
Entregue ao cliente

Painel → Pedidos & Despacho:

  • Pendentes: pedidos recém chegados, esperando confirmação → clique ✅ Aceitar.
  • Em Preparo: pedidos que você aceitou, sendo separados → clique 🛵 Despachar para escolher o entregador.
  • Em Rota: pedidos saíram para entrega.
  • Via WhatsApp: pedidos enviados pelo WhatsApp do cliente, aguardando você confirmar pelo link recebido na mensagem.

Compras no CEASA

Painel → Compras CEASA: veja a lista dos produtos que estão abaixo do estoque mínimo (o que precisa comprar), registre a chegada da mercadoria e distribua entre as filiais.

Prospectar clientes corporativos (B2B)

Painel → Prospecção & CRM: gerencie os contatos de empresas interessadas em compras em volume. As oportunidades ficam organizadas em colunas por etapa da negociação (como um quadro de gestão de tarefas). Você também pode importar listas de contatos a partir de planilhas.

Relatório de produtos que precisam de reposição

Painel → Relatórios → Estoque Crítico: gera uma lista formatada para impressão de tudo que está abaixo do estoque mínimo — útil para levar ao CEASA ou enviar ao fornecedor.

Ciclo do funcionário no sistema

👤
Admissão
🕐
Registro de ponto
💵
Folha de pagamento
🚪
Desligamento

Admitir um novo funcionário

  1. Painel → RH → Funcionários → + Admitir.
  2. O funcionário precisa já ter um cadastro de login no sistema. Informe o número de identificação dele no sistema (o número que aparece quando você abre o perfil dele), cargo, tipo de contrato (CLT, Pessoa Jurídica, Autônomo ou Estágio), carga horária e salário.
  3. Salve. O funcionário entra na lista de ativos vinculado à filial correta.
O funcionário precisa ter sido cadastrado no sistema como usuário antes de ser registrado como funcionário. Se ainda não tem cadastro, peça ao dono ou desenvolvedor para criar.

Registrar o ponto do dia

Painel → RH → Ponto/Jornada: escolha o funcionário e o mês. Registre manualmente os horários de entrada, saída e intervalo. O sistema calcula automaticamente as horas trabalhadas e se há horas extras ou banco de horas.

Gerar a folha de pagamento

Painel → RH → Folha de Pagamento → + Gerar Folha: escolha o funcionário e o mês de referência. Informe horas extras, descontos e adicione observações se necessário. Salve — o valor vai automaticamente para a lista de contas a pagar.

Lançar uma conta a pagar

Painel → Financeiro → Contas a Pagar → + Lançar Conta: informe a descrição (ex.: "Aluguel — Junho/2026"), a categoria (Aluguel, Energia, Fornecedor, Folha de pagamento etc.), o valor, a data de vencimento e se repete todo mês. Contas vencidas ficam destacadas automaticamente.

Marcar uma conta como paga

Na lista de contas a pagar, clique em ✓ Pago na linha da conta. Os totais de pendente e pago são atualizados na hora.

Ver o fluxo de caixa

Painel → Financeiro → Fluxo de Caixa: tabela mês a mês mostrando quanto entrou de dinheiro (vendas), quanto saiu (despesas) e qual o saldo. Use para apresentar ao dono ou planejar os próximos meses.

Ver o resultado financeiro completo (DRE)

Painel → Relatórios → BI → DRE: o DRE (Demonstração do Resultado do Exercício — resumo de quanto a loja ganhou, quanto gastou e qual foi o lucro de verdade) mostra o cálculo completo: receita bruta, custo dos produtos vendidos (CMV — Custo da Mercadoria Vendida), despesas operacionais, lucro operacional (EBITDA — resultado antes de impostos) e imposto estimado. Filtre por mês e por loja.

Desligar um funcionário

Painel → RH → Funcionários → [nome do funcionário] → Desligar: registra a data do desligamento e bloqueia o acesso ao sistema imediatamente. O histórico de ponto e pagamentos fica guardado para consulta futura.

Como funciona o dia do caixa

🌅
Abrir o caixa
💰
Vender durante o dia
🏦
Fazer sangria (se precisar)
🌙
Fechar o caixa

Começando o dia — Abertura de caixa

  1. Acesse /clientes/desffrut/pdv/abertura (ou clique no link que o gerente informou).
  2. Informe o Fundo de Troco — é o dinheiro que você já tem na gaveta para dar troco aos clientes.
  3. Clique em Abrir Caixa. O sistema baixa automaticamente todos os produtos e preços do dia.
Não feche o navegador sem fechar o caixa no final do turno. Se a internet cair, continue vendendo normalmente — o sistema salva tudo no computador e envia quando a conexão voltar.

Teclas de atalho — Use o teclado para vender mais rápido

F1
Ir para a busca de produto
F2
Abrir tela de pagamento (fechar venda)
F3
Buscar cliente pelo CPF
F4
Abrir tela de sangria ou suprimento
F5
Ativar câmera para ler código de barras
ESC
Fechar qualquer janela aberta

Buscar e vender um produto

  1. Pressione F1 para ir ao campo de busca.
  2. Digite parte do nome do produto ou passe o leitor de código de barras (o aparelho em cima do balcão). Os resultados aparecem enquanto você digita.
  3. Clique no produto desejado para adicionar ao carrinho.
  4. Para produto vendido por peso: clique no botão ⚖️ e o sistema lê o peso direto da balança.

Fechar a venda e receber o pagamento

  1. Com os itens no carrinho, pressione F2.
  2. Escolha a forma de pagamento:
    • 💵 Dinheiro — informe o valor recebido e o troco é calculado
    • 💳 Cartão — passe o cartão na máquina e confirme
    • 📱 Pix — o cliente paga e você confirma manualmente quando o dinheiro cair
    • Pontos de Fidelidade — usa os pontos acumulados do cliente
  3. Clique em Confirmar Venda. O cupom é impresso automaticamente pela impressora.

Remover um item do carrinho

Clique no 🗑️ ao lado do item antes de fechar a venda. Se a venda já foi finalizada e precisa cancelar um item, é necessário que o gerente autorize com a senha dele.

Sangria (retirada de dinheiro) e Suprimento (colocar dinheiro)

  1. Pressione F4 ou acesse a tela de sangria.
  2. Escolha: Sangria (tirar dinheiro da gaveta, ex.: para depositar no banco) ou Suprimento (colocar mais dinheiro para troco).
  3. Informe o valor e o motivo obrigatório (ex.: "Depósito bancário às 14h — autorizado pelo gerente João").
  4. O sistema imprime o comprovante automaticamente.
Toda sangria fica registrada e aparece no histórico de segurança. Nunca faça sangria sem registrar no sistema.

E se a internet cair no meio do turno?

O sistema detecta a queda e avisa na tela — mas você continua vendendo normalmente. Todas as vendas ficam salvas no próprio computador. Quando a internet voltar, o sistema envia tudo automaticamente para o servidor em até 30 segundos, sem precisar fazer nada.

O preço registrado no cupom durante a queda de internet não muda — mesmo que o gerente tenha alterado o preço enquanto a internet estava fora.

Fechar o caixa no fim do turno

  1. No sistema de vendas, clique em Fechar Caixa.
  2. Confira o resumo: total de vendas, sangrias realizadas e saldo final estimado na gaveta.
  3. Confirme o fechamento. O relatório do turno é impresso automaticamente.

Sobre a impressora e equipamentos

A impressora de cupom funciona através de um programa auxiliar chamado QZ Tray (um pequeno programa instalado no computador da loja que faz a ponte entre o site e a impressora). Ele precisa estar aberto e ativo para imprimir — você verá o ícone dele na barra de tarefas do Windows.

Use sempre Google Chrome ou Microsoft Edge para operar o caixa — outros navegadores como Firefox ou Safari não são compatíveis com a balança e o leitor de câmera.

Como é o fluxo da sua entrega

📋
Ver pedidos no painel
🗺️
Abrir rota no Maps
🛵
Entregar ao cliente
Confirmar no sistema

Acessar o painel de entregas

  1. Faça login em /clientes/desffrut/login com seu e-mail e senha.
  2. O sistema abre direto na lista de pedidos Em Rota — somente os pedidos designados para você.

Ver o endereço e abrir a rota

Em cada cartão de pedido você encontra o endereço completo do cliente e dois botões de navegação:

  • 📍 Google Maps — abre o endereço no Google Maps já pronto para a navegação GPS.
  • 🗺 Waze — abre o endereço no Waze, se preferir.
O endereço já está formatado para busca — clique e o aplicativo de navegação abre direto na rota.

Verificar a forma de pagamento antes de sair

O cartão do pedido mostra como o cliente vai pagar: dinheiro (com o troco necessário indicado), cartão de débito/crédito ou Pix. Verifique antes de sair para não ter surpresa na entrega.

Confirmar a entrega

  1. Após entregar e receber o pagamento, clique em ✅ Entreguei no cartão do pedido.
  2. O pedido sai da sua lista e os pontos de fidelidade são creditados automaticamente para o cliente.
Clique em "Entreguei" somente após a entrega física e recebimento do pagamento. Não confirme antes disso.

Avisar o cliente que o pedido saiu

No cartão do pedido, o botão 📲 Saiu para Entrega abre o WhatsApp do cliente com uma mensagem automática já escrita — basta clicar em Enviar. Sem custo, sem precisar digitar nada.

O que fazer se houver problema na entrega

Se o cliente não estiver em casa ou houver qualquer imprevisto, ligue ou mande mensagem para o gerente antes de voltar para a loja. Não marque como entregue se a entrega não foi concluída.

A impressora não está imprimindo. O que faço?

  1. Verifique se o programa auxiliar QZ Tray (ícone na barra de tarefas do Windows, perto do relógio) está aberto e ativo. Se não estiver, abra ele.
  2. Acesse Painel → Hardware → Impressora e clique em Testar Impressão.
  3. Confira se a impressora está ligada, com papel e sem nenhum aviso de erro piscando nela.
  4. Se nada funcionar, reinicie o programa: clique com o botão direito no ícone do QZ Tray → Reiniciar.
  5. Use sempre Google Chrome ou Microsoft Edge — a impressora não funciona com outros navegadores.

Como cancelo um produto já colocado no carrinho?

No sistema de vendas, clique no ícone de lixeira 🗑️ ao lado do produto enquanto a venda ainda está aberta. Se a venda já foi finalizada e impressa, é preciso que o gerente autorize o cancelamento com a senha dele.

O estoque ficou com número negativo. O que isso quer dizer?

Acontece quando o caixa vendeu sem internet e, ao sincronizar, o produto já havia sido vendido por outro caixa também. O sistema registra a venda normalmente e marca o estoque como negativo para que o gerente possa investigar e ajustar. O gerente corrige em Estoque → Ajuste de Quantidade.

O cliente quer cancelar o pedido de entrega. O que fazer?

  • Se o pedido ainda está como "Pendente" ou "Aguardando Validação pelo WhatsApp": o gerente consegue cancelar diretamente no painel, na tela de pedidos.
  • Se o pedido já está "Em Preparo" ou em etapas posteriores: o gerente avalia o caso e entra em contato com o cliente para combinar.
  • Os pontos de fidelidade usados no pedido cancelado são devolvidos automaticamente.

Esqueci a senha. Como faço para recuperar?

Para clientes: na tela de login, clique em "Esqueci minha senha". Para funcionários: peça ao dono ou ao responsável técnico (desenvolvedor) para gerar uma senha temporária — ele faz isso pelo painel de sistema sem ver a senha atual.

A internet caiu no meio da venda. Perco os dados?

Não. O sistema continua funcionando normalmente com os dados que já foram baixados na abertura do caixa. As vendas ficam salvas no próprio computador. Quando a internet voltar, tudo é enviado automaticamente para o servidor em até 30 segundos, sem precisar fazer nada.

O cliente informou o CPF errado e os pontos não foram para a conta certa. O que faço?

Não é possível transferir pontos entre contas pela interface normal. Para corrigir, entre em contato com o dono ou responsável técnico, informando o nome dos dois clientes e a quantidade de pontos a transferir. A correção é feita manualmente no banco de dados.

A balança não está lendo o peso. O que faço?

  1. Acesse Painel → Hardware → Balança e clique em Testar Leitura.
  2. Verifique se o cabo que liga a balança ao computador (via adaptador USB) está bem conectado nos dois lados.
  3. Se aparecer uma lista de portas para escolher, tente as opções uma a uma até o peso aparecer.
  4. Use sempre Chrome ou Edge — a leitura da balança não funciona em outros navegadores.

Como instalar o site no celular como um aplicativo?

Abra o site no Google Chrome do celular → toque nos 3 pontinhos (⋮) no canto superior direito → Adicionar à tela inicial. O site vira um atalho que abre como um app, sem barra de endereço.

Manual v1.1 · Desffrut · Atualizado em 24/06/2026
Para atualizar este manual, edite views/manual/index.php