📖 Manual do sistema

‹ Início

1. Como o sistema pensa

O sistema segue o caminho físico da mercadoria. São 4 ideias, nada mais:

  1. Catálogo — a lista de tudo que você vende: preço de venda (PVP) e custo.
  2. Depósito (lotes) — cada compra do fornecedor vira um lote com quantidade e validade. É o seu armazém/geladeira no papel.
  3. Máquinas (canais) — cada mola de cada máquina: qual produto vai nela e quantos cabem.
  4. Visitas (contagens) — cada ida a uma máquina: você conta a sobra de cada canal e lança o dinheiro do painel. Você nunca digita "quanto vendeu" — o sistema calcula sozinho comparando duas visitas seguidas.
💡 A regra de ouroVenda = o que ficou na última visita − o que você contou agora. Por isso a contagem honesta é sagrada: é ela que faz todos os números do sistema serem verdade.

2. Plano de auditoria completa

O levantamento que coloca TUDO na palma da mão. Faça uma única vez, com calma — depois o sistema se mantém sozinho a cada visita.

0

Preparação · 10 min, em casa

  • Conferir que os SQLs pendentes foram rodados (renomear máquinas, permissões de canais)
  • Abrir o app no celular e ver as 3 máquinas na lista
  • Levar: celular carregado, papel e caneta (para os números da Jofemar)
1

Depósito · 1 a 2 horas

Objetivo: o que o app diz que existe = o que a prateleira/geladeira tem.

  • Abrir Entrada de mercadoria → No depósito
  • Produto a produto: contar fisicamente e comparar com a lista
  • Diferença? Tocar ✎ → Qtd restante e corrigir (quebra, consumo, erro de fatura)
  • Perecíveis: conferir a validade na embalagem e corrigir no ✎ (as datas atuais são estimativas)
2

Máquina a máquina · 40–60 min cada (Master, Escrava, Gourmet)

Objetivo: baseline de estoque dentro das máquinas + dinheiro zerado no registro.

  • No app: escolher a máquina e contar canal por canal (é a 1ª contagem real — o "Vendeu 0" é normal)
  • Durante a contagem: capacidade errada? "ajustar". Produto trocado? Anotar e corrigir depois em Máquinas e planograma
  • Na Jofemar (menu técnico): anotar no papel o valor dos tubos do moedeiro e os contadores de venda (total € e por canal). Fotografar o visor também vale
  • Recolher e contar as notas do cofre e moedas excedentes
  • No app: lançar moedas e notas contadas no fechamento e Concluir visita
  • Se a máquina permitir: zerar os contadores parciais — máquina e sistema passam a contar do mesmo zero (recomendado!)
3

Dinheiro de base · 15 min

  • Anotar o fundo de troco de cada moedeiro (valor que mora nos tubos) — isso é troco, não receita; guarde o número, ele explica diferenças futuras
  • Anotar o dinheiro do cofre/caixa da loja à parte (o módulo de caixa da loja é uma etapa futura do sistema)
4

Conferência contínua · +5 min em cada visita normal

  • Escolher 2–3 canais aleatórios e comparar o "Vendeu" do app com o contador por canal da Jofemar (ver seção 8)
  • Conferir a linha "Diferença" do resumo da visita (dinheiro vs venda esperada)
  • Divergência de mais de 1–2 unidades: investigar — mola que falha, produto preso, contagem apressada
⚠️ O único número que importa na auditoriaDepois da Fase 2, a segunda visita a cada máquina é a primeira com "Vendeu" real. É nela que a conferência com os contadores da Jofemar começa a valer.

3. Rotina de abastecimento (visita)

O coração do sistema. Sempre que abastecer, siga este ritual — leva menos de 10 minutos.

Passo 1 — Escolha a máquina

Contagem de estoque Início
Multiprodutos Master
Loja SPOT24 Portimão
Multiprodutos Escrava
Loja SPOT24 Portimão
Gourmet
Loja SPOT24 Portimão
Tela inicial: toque na máquina que vai abastecer

Passo 2 — Conte a sobra de cada canal

A tela mostra um canal de cada vez, na ordem física da máquina. Olhe a mola e conte quantos produtos sobraram (antes de repor!). Use −/+ ou toque no número para digitar.

Multiprodutos Master 28 / 78
38 Snickers
Cabe 15 · na última visita ficaram 12  ajustar
Quantos sobraram no canal?
7+
REPOR8
VENDEU5
Anterior
Próximo
Sobraram 7 Snickers → o app diz: reponha 8, vendeu 5
💡 Conte ANTES de reporA sobra é a fotografia da venda. Depois de contar e tocar "Próximo", aí sim encha a mola (o app assume que você encheu até a capacidade).

Passo 3 — Feche o caixa

No fim dos canais, lance o que o painel da máquina mostra de moedas e notas (ou o que você recolheu e contou).

Fechamento do caixa
Moedas (€)
23,50
Notas (€)
45,00
Caixa bate certinho   € 0,00
Concluir visita
Verde = dinheiro bate com a venda esperada. Vermelho = falta ou sobra

Passo 4 — Leia o resumo

Ao concluir, a visita é gravada para sempre e o resumo mostra: itens vendidos, receita esperada, caixa contado, diferença e o alerta de validades. Toque em "Nova visita" para a próxima máquina.

4. Entrada de mercadoria

Sempre que chegar compra do fornecedor. Início → Entrada de mercadoria.

  1. Escolha o produto (ou "+ Cadastrar produto novo…" se for novidade)
  2. Fornecedor, quantidade e custo unitário
  3. Validade do lote — o app já sugere a data para perecíveis; confirme com a embalagem
  4. Toque Registrar entrada → vira um lote no depósito
Entrada de mercadoria
Produto
Kebab Misto
Quantidade
20
Custo unitário (€)
1,78
Validade deste lote
14/09/2026
Entrada registrada: 20 un no depósito. ✓
Uma caixa de kebabs virando lote com validade controlada
💡 Uma fatura = vários lotesRegistre item a item. Produtos iguais de datas/validades diferentes devem ser lotes separados — é isso que faz o FIFO funcionar.

5. Depósito e validades

A lista "No depósito" é sua prateleira virtual, ordenada do que vence primeiro para o que dura mais.

Kebab Misto
Badulake · entrou 15/06
20 un
14/08 · em 2 dias
Snickers
Sector Vending · entrou 22/06
24 un
19/03 · em 246 dias
Vermelho = vence em 3 dias ou menos: gire primeiro (FIFO)

O edita validade e quantidade restante de cada lote. Use para: corrigir datas reais da embalagem, dar baixa de quebras, acertos de contagem do depósito.

⚠️ Vermelho no depósito = decisãoProduto perto de vencer: leve para a máquina já, faça promoção no preço, ou aceite a perda dando baixa no lote. O pior é não decidir.

6. Preços e promoções

Início → Catálogo e preços. Busque, toque ✎, mude, salve.

  • Preço do catálogo (PVP) — vale para todas as máquinas que não tenham preço próprio no canal
  • Preço do canal (na tela Máquinas e planograma) — vale só naquela máquina; é como está a Gourmet hoje (preços da fachada)
  • Ao digitar, o app mostra na hora o lucro por unidade e a margem % — decida a promoção vendo o número
⚠️ Mudou no app? Mude na máquina!O app não programa a Jofemar. Preço novo = mudar nos dois lugares, senão a conferência de caixa desanda.

7. Trocar produtos de canal

Início → Máquinas e planograma. Abas por máquina, ✎ em cada canal.

  • Trocar produto — escolha qualquer um do catálogo, ou "(canal vazio)" para desativar a mola
  • Capacidade — quantas unidades cabem cheias (também dá para ajustar durante a contagem)
  • Preço do canal — deixe vazio para seguir o catálogo
⚠️ Trocou produto? Ignore 1 "Vendeu"Na primeira visita após a troca, o "Vendeu" daquele canal compara produtos diferentes — ignore-o. Da visita seguinte em diante, volta ao normal. Troque no app no mesmo dia da troca física.

8. Conferir com a máquina (Jofemar)

A máquina tem contadores próprios. Cruzá-los com o app de vez em quando é a sua garantia de que tudo bate.

O que a Jofemar te dá (menu técnico)

Na máquinaCompara com o quê no app
Vendas por canal (contador parcial)"Vendeu" somado das visitas desde o último reset
Total vendido em € (parcial)"Receita esperada" somada das visitas
Valor nos tubos do moedeiroFundo de troco anotado na auditoria (Fase 3)
Dinheiro no cofre (notas+moedas excedentes)"Caixa contado" da visita

A rotina de conferência aleatória (5 min)

  1. Antes de contar, entre no menu técnico e anote as vendas de 2–3 canais à sua escolha (varie a cada visita!)
  2. Faça a visita normal no app
  3. Compare: o "Vendeu" do app deve bater com (contador de agora − contador da última visita)

Se não bater

SintomaCausa provável
App diz que vendeu MAIS que a máquinaProduto caiu/sumiu sem venda: mola disparou sozinha, furto na reposição, ou contagem anterior errada
App diz que vendeu MENOSContagem de hoje errada (contou a mais), ou reposição não registrada
Dinheiro sempre abaixo da venda esperadaVendas cashless/MB não lançadas, ou moedeiro reteve moedas — conferir a origem na visita
💡 Zere os parciais na auditoriaSe na Fase 2 você zerar os contadores parciais da Jofemar, toda conferência futura vira uma subtração simples. Vale o trabalho de achar a opção no menu.

9. E se...?

...ficar sem internet no meio da visita?

Continue contando normalmente — a contagem vive no telefone até você concluir. Se o "Concluir visita" falhar, o app avisa e nada se perde: espere o sinal voltar e toque de novo.

...eu contar errado e já tiver concluído?

O histórico não se edita pelo app (de propósito — auditoria é auditoria). Se foi grosseiro, me avise que corrigimos pelo painel do Supabase; se foi 1–2 unidades, a próxima contagem se autocorrige (a sobra real conta a verdade).

...aparecer "Sobrou mais do que tinha"?

Ou a contagem anterior foi baixa, ou repôs sem registrar. Confira e siga — o aviso é um alerta, não um bloqueio.

...o produto do canal não for o da tela?

Termine a visita (conte o que está lá), depois corrija em Máquinas e planograma e ignore o "Vendeu" daquele canal na visita seguinte.

...eu quiser ver os dados crus?

Painel do Supabase → Table Editor. Tudo que o app grava está lá: visitas, contagens, lotes, produtos, canais.