Carteiras e recarga
Onde: área administrativa, tela Cantina — Carteira (busca por matrícula).
TODO: VALIDATE (posição exata no menu do sistema administrativo).
Quem pode usar: usuários com a permissão Cantina — Carteira (admin) — normalmente a secretaria ou o financeiro. A consulta e o ajuste alcançam apenas alunos com carteira na unidade do operador.
Para que serve
É a visão administrativa da carteira do aluno: saldo atual, extrato dos últimos lançamentos e o ajuste manual (crédito ou débito) para correções operacionais — item cobrado errado, devolução combinada com a família, acerto de inventário.
Campos
| Campo / área | O que mostra |
|---|---|
| Matrícula do aluno | Campo de busca (ex.: 2026001234) |
| Cartão Aluno | Nome e matrícula |
| Cartão Saldo atual | O saldo, com o aviso "conta bloqueada" quando for o caso |
| Cartão Ajuste manual | Valor, tipo (Crédito ou Débito) e motivo obrigatório |
| Extrato | Últimos 30 lançamentos: quando, descrição, origem (Recarga, PDV ou Ajuste manual), valor e saldo após cada lançamento |
Ações
- Buscar: digite a matrícula e clique em Buscar. Se não encontrar, a mensagem é "Nenhum aluno encontrado com a matrícula ..." — confira o número e a unidade.
- Lançar ajuste: informe o valor (maior que zero), escolha Crédito ou Débito e escreva o motivo — ele fica gravado no histórico do aluno e aparece no extrato (também para a família). A confirmação repete o valor e o motivo lançados.
:::info Regra do sistema
- Motivo obrigatório: sem motivo o ajuste não é lançado ("Informe o motivo do ajuste — ele fica registrado no histórico do aluno").
- Débito manual respeita o saldo: passa pela mesma regra do PDV — se o saldo não cobre, a mensagem é "Saldo insuficiente para este débito" e nada muda. O saldo nunca fica negativo, nem por ajuste.
- Extrato imutável: nenhum lançamento é editado ou apagado; correção se faz com um novo lançamento (com motivo).
- O estado "conta bloqueada" impede vendas no PDV.
TODO: VALIDATE(não há tela para bloquear/desbloquear a conta nesta versão — o estado existe e é exibido, mas a alteração é um procedimento do suporte).
:::
O ciclo da recarga — feita pela família, no portal
A escola não recebe dinheiro de recarga no balcão. O ciclo é:
- O responsável abre o Portal da família → aba Cantina → Recarga e escolhe o valor (opções de R$ 20,00, R$ 40,00, R$ 60,00 e R$ 100,00).
- O sistema gera uma cobrança normal com protocolo, em nome de quem pediu a recarga (quem recarrega é quem paga).
- O responsável paga pelo link de pagamento (PIX ou boleto; o cartão de crédito está indisponível para recarga nesta versão).
- Quando o pagamento é confirmado, o crédito entra sozinho na carteira do aluno — sem ação da escola — e aparece no extrato como "Recarga".
A carteira do aluno é criada automaticamente no primeiro acesso da família à área da Cantina no portal. O aluno menor de idade, quando tem o próprio acesso, vê apenas o saldo e o extrato — recarga e bloqueios são ações do responsável adulto.
Política de saldo
O saldo da cantina é dinheiro da família em poder da escola, não receita:
- não expira;
- devolução, quando pedida, é sem taxa e vai para quem recarregou;
- não existe compensação automática com mensalidades em atraso — a escola só pode abater débitos do saldo com autorização expressa e registrada do responsável.
Nesta versão do sistema não há uma tela própria de devolução: a devolução aprovada é executada
como ajuste manual de débito com o motivo registrado. TODO: VALIDATE (a política formal
de devolução — prazos e alçadas — está em aprovação pela direção).
Problemas comuns
- "Nenhum aluno encontrado com a matrícula" — além de erro de digitação, pode ser aluno de outra unidade (a busca é restrita à sua) ou aluno ainda sem carteira — peça para a família acessar o Portal ao menos uma vez.
- "A família pagou a recarga e o saldo não entrou" — o crédito entra quando o pagamento é confirmado (PIX costuma confirmar em minutos; boleto pode levar mais tempo). Se a cobrança consta como paga no Financeiro e o crédito não apareceu, acione o suporte.
- "Preciso corrigir uma venda errada" — lance um ajuste de crédito no valor do item, com o motivo (ex.: "Devolução — item lançado em duplicidade no PDV").