Manual do AppEmpresa Manual do AppEmpresa — MOC Fidelidade App mobile da empresa-operadora do MOC Fidelidade. Use no balcão, na recepção, no caixa — onde for atender o cliente. Pra quem é este app: administradores e operadores das empresas que contratam o MOC Fidelidade. Tudo que o painel web (Admin) faz, esse app faz também. 1. Instalação Android Abra a Play Store . Procure por "MOC Fidelidade - Empresa" . Toque em Instalar . iPhone Abra a App Store . Procure por "MOC Fidelidade - Empresa" . Toque em Obter . Existem dois apps diferentes no MOC: o cliente (pra quem acumula pontos) e o empresa (pra quem opera). Instale o certo! 2. Acessar a sua conta Primeiro acesso (já criou empresa pelo site) Abra o app. Toque em "Entrar" . Use o mesmo e-mail e senha que você cadastrou no site mocfidelidade.com.br ao contratar. Pronto — entra direto no painel da sua empresa. Esqueceu a senha? Toque em "Esqueci minha senha" . Digite seu e-mail → receba código de 4 dígitos no e-mail. Valide o código. Crie uma senha nova (mínimo 6 caracteres). Ainda não tem empresa cadastrada? Toque em "Quero cadastrar uma empresa nova" na tela de login — abre o site no navegador, onde o fluxo completo de cadastro (plano + dados) é feito. Operador convidado (sem ser dono da empresa): você ganhou acesso por um convite. Faça o "Esqueci minha senha" com seu e-mail pra ativar a conta. 3. Escolher a empresa ativa Se você administra mais de uma empresa , após login aparece a tela "Selecionar empresa" : Toque na empresa pra ativar. Mostra seu papel: Administrador (gerencia tudo) ou Operador (opera o dia-a-dia). Se só houver uma, o app pula direto pro dashboard. Pode trocar a empresa ativa depois: menu lateral → "Trocar empresa" . 4. Concluir cadastro (banner no dashboard) Se sua empresa foi recém-criada e ainda não definiu CNPJ + razão social + nome fantasia + modelo de fidelidade , aparece um banner laranja no dashboard pedindo pra concluir. Toque em "Concluir" no banner. Preencha: CNPJ (opcional) Razão social Nome fantasia Modelo de fidelidade : Marcações ou Pontos Meta de marcações (se mrc) ou Pontos por R$ (se ptc) Toque em "Concluir cadastro" . Após concluir, todas as telas refletem o modelo escolhido. 5. Dashboard (tela inicial) Mostra: Hero laranja: modelo de fidelidade + total de clientes ativos. KPIs do dia: códigos gerados/usados, marcações ou pontos creditados, recompensas pendentes. Ações rápidas: atalhos pra gerar código, ler QR de cliente, ver clientes, recompensas etc. Alertas que podem aparecer no topo: Tarja vermelha — Cobrança em atraso: fatura atrasada bloqueia operações novas (gerar código, criar produto). Toque em "Ver" pra pagar. Banner laranja — Concluir cadastro: onboarding incompleto. 6. Gerar código pra cliente Operação principal do dia-a-dia. Cliente está no caixa, fez uma compra, hora de creditar marcação/pontuação. Menu lateral → "Códigos" (ou ação rápida no dashboard). Toque em "Gerar código" (botão flutuante). Defina: Quantidade — quantas marcações OU quantos pontos creditar. Expira em (minutos) — padrão 60. Use menor pra códigos "de balcão", maior pra códigos por WhatsApp. Toque em "Gerar código" . O app mostra um QR Code grande + código de 5 dígitos (toque pra copiar). O cliente: Escaneia o QR pela câmera do celular (abre o AppCliente direto). OU digita os 5 dígitos no AppCliente dele. Visual da tela Aguardando: QR colorido + código grande. Usado (verde): overlay verde com check + nome/avatar/horário de quem usou + quantidade creditada. Atualiza em ~2 segundos após o cliente usar — sem precisar atualizar manualmente. Expirado: overlay cinza com "EXPIRADO". Histórico de códigos Toque no ícone de histórico (relógio) no topo. Lista os 200 mais recentes. Filtre por Ativos / Usados / Expirados / Cancelados . Cancelar um código ativo No histórico, cada código com status Ativo mostra um ícone vermelho de bloqueio no canto direito. Toque, confirme no diálogo, e o código fica Cancelado — não pode mais ser usado. Útil quando você gerou errado ou descobriu que ele vazou pra alguém que não devia receber. Códigos já Usados ou Expirados não precisam ser cancelados. 7. Ler QR Code do cliente Cliente está apresentando uma recompensa? Quer identificar o cliente rapidamente? Menu lateral → "Ler QR do cliente" (ou ação rápida). Aponte a câmera pro QR que o cliente está mostrando. App identifica o cliente e abre a tela detalhe do cliente automaticamente. Funciona com flash (toque no raio no topo) e câmera frontal (toque no switch). 8. Clientes Menu lateral → "Clientes" . Lista todos os clientes vinculados à empresa ativa, ordenados por nome. Busca por nome, e-mail ou telefone (debounced — digita e busca sozinho em meio segundo). Cada item mostra saldo (marcações OU pontos, conforme modelo). Cadastrar cliente manual Toque em "Novo cliente" : Nome (obrigatório) E-mail (obrigatório) Telefone (opcional) Idempotente no e-mail: se já existe usuário com esse e-mail no MOC, vincula direto. Senão, cria conta nova com senha aleatória — cliente ativa via "esqueci minha senha". Detalhe do cliente Toque em um cliente. Mostra: Foto/nome/e-mail. Card hero do saldo (marcações ou pontos). Histórico unificado: créditos, débitos, ajustes — cada item mostra origem ( código , resgate , ajuste manual ) + observação se houver. Ajustar saldo manualmente Toque em "Ajustar saldo" (botão flutuante) no detalhe do cliente. Escolha Creditar ou Debitar (botão segmentado). Digite quantidade (sempre positiva — o botão escolhe o sinal). Observação (opcional, máx 255 caracteres) — fica visível no histórico do cliente. Use para: Estornar marcação errada. Premiar cliente por motivo especial. Corrigir saldo após problema. 9. Recompensas Menu lateral → "Recompensas" . Lista os resgates da empresa. Filtre por status: Solicitadas — cliente pediu o resgate, aguardando você aprovar. Aprovadas — você aprovou, aguardando entrega. Entregues — finalizadas. Canceladas — descartadas. Ações inline (botões no card) Solicitada: Aprovar (vira aprovada) ou Cancelar (devolve pontos no modelo ptc). Aprovada: Marcar como entregue (finaliza) ou Cancelar . Ação é imediata no card — sem confirmação extra. Em caso de erro, o card volta ao status anterior e mostra uma mensagem. 10. Produtos (catálogo) Menu lateral → "Produtos" . Lista produtos da empresa com preview da foto, preço (em BRL), pontos pra resgate (modelo ptc). Inativos aparecem riscados. Criar/editar produto Toque em "Novo produto" (FAB) ou em um produto existente. Foto — tira foto ou escolhe da galeria. Upload em background com indicador. Nome (obrigatório, máx 180 caracteres). Descrição (opcional). Preço em R$ (opcional). Pontos para resgate (só aparece em modelo ptc). Categoria (opcional, dropdown — aparecem só categorias ativas). Ativo — toggle (inativo some das listas pro cliente). Remover foto? Toque em "Remover imagem" abaixo da preview. Excluir produto Menu de 3 pontos (⋮) no item → Excluir . Confirmação modal. Resgates anteriores ficam intactos. 11. Categorias Menu lateral → "Categorias" (ou ícone de categoria no topo da tela de Produtos). Lista das categorias da empresa. CRUD simples: criar, renomear, ativar/desativar, excluir. Categoria com produto não pode ser excluída. O backend devolve erro 409 e o app mostra mensagem. 12. Plano (só Admin) Menu lateral → "Plano" . Mostra: Plano atual + valor mensal. Janela de trial (se aplicável). Próxima fatura (data prevista). Limite de clientes ativos. Pra trocar de plano , use o site mocfidelidade.com.br ou o painel Admin (web). 13. Faturas (só Admin) Menu lateral → "Faturas" . Lista todas as faturas da empresa. Filtre por status: Abertas — aguardando pagamento dentro do prazo. Atrasadas — vencidas (bloqueia operações novas). Pagas — quitadas. Detalhe da fatura Toque em uma fatura. Hero colorido por status com valor e vencimento. Métodos de pagamento (PIX, Boleto, Cartão) — toque pra iniciar checkout. PIX Mostra QR Code + código copia-e-cola . Toque em "Copiar código PIX" pra copiar pro clipboard. Boleto Linha digitável (botão de copiar). Abrir boleto — abre PDF no navegador. Cartão Abre Checkout Pro do Mercado Pago no navegador. Idempotente: se você já gerou o PIX/boleto, tocar de novo no método não cria outro — devolve o mesmo enquanto não expirar. 14. Operadores (só Admin) Menu lateral → "Operadores" . Lista todos os operadores vinculados à empresa, com badge Admin ou Operador . Convidar novo operador Toque em "Convidar" (FAB). E-mail (obrigatório). Nome (opcional — usado se for cadastro novo). Tipo: Operador — opera dia-a-dia (códigos, clientes, recompensas). Admin — pode gerenciar plano, faturas, operadores e cadastros. Se o e-mail já tiver conta MOC , vincula direto. Senão, cria com senha aleatória — o operador ativa via "esqueci minha senha" . Cota do plano O número de operadores que o plano permite é adicional ao proprietário — você (dono da conta) não consome a cota. Plano Start (1) = você + 1 funcionário. Profissional (3) = você + 3. E por aí vai. Pra saber quantos operadores adicionais seu plano permite, abra Plano no menu lateral. Remover operador Lixeira ao lado do operador → confirmação modal → remoção imediata. Operadores comuns veem a lista mas não podem convidar/remover (botões somem). 15. Suporte (tickets MOC) Menu lateral → "Suporte" . Lista tickets que você abriu pro time MOC, filtrados por status. Abrir ticket: botão flutuante. Assunto + mensagem. Detalhe do ticket Thread de mensagens com avatar e timestamp. Composer no rodapé pra responder enquanto o ticket está aberto ou em atendimento . Fechar ticket: ícone X no topo (não pode reabrir, mas pode criar outro depois). 16. Meus dados, Senha, Sobre Meus dados Menu lateral → "Meus dados" . Edita nome e telefone. E-mail é fixo. Alterar senha Menu lateral → "Alterar senha" . Pede senha atual + nova + confirmação (mínimo 6 caracteres). Sobre Versão do app. Links pra Site, Política, Termos. 17. Sair Menu lateral → "Sair" (em vermelho, no rodapé). Limpa a sessão local. Próximo acesso pede login. 18. Notificações push Quando um cliente solicita resgate, faz alguma operação relevante, ou uma fatura está perto de vencer, você recebe notificação push . Permita no primeiro login. Pra reativar depois: Config do celular → Apps → MOC Fidelidade - Empresa → Notificações . 19. Bloqueio por inadimplência Se sua empresa tem fatura atrasada , operações de mutação ficam bloqueadas (gerar código, criar produto, ajustar saldo). Aparece a tarja vermelha no dashboard. Liberadas mesmo inadimplente: Login / leitura. Ver clientes, faturas, plano. Pagar a fatura (PIX/Boleto/Cartão). Após pagamento confirmado (webhook do PSP), a tarja some sozinha — pode demorar alguns minutos. 20. FAQ — Erros comuns "Código não encontrado" ao cliente tentar usar: Cliente errou o código. Código expirou (verifique TTL ao gerar). Código já foi usado por outra pessoa (cada código é one-shot). "Saldo insuficiente" ao debitar: Cliente não tem saldo pra completar o débito. Verifique histórico no detalhe do cliente. "Falha no checkout" da fatura: Mercado Pago instável — espere 1 minuto e tente de novo. Verifique se o boleto não está vencido (depois de 30 dias o link some). "Categoria com produto vinculado": Você tentou excluir uma categoria que tem produtos. Mude esses produtos pra outra categoria primeiro. App pede pra atualizar e não deixa entrar: Atualização obrigatória por mudança crítica. Atualize na loja. 21. Limites do plano Cada plano tem limite de clientes ativos no mês . "Cliente ativo" = cliente que recebeu ao menos uma marcação/pontuação no mês corrente. Atingiu o limite? Operações de gerar código pra clientes novos no mês bloqueiam até o próximo ciclo. Considere upgrade de plano . 22. Suporte Dentro do app: menu "Suporte" . E-mail: contato@mocfidelidade.com.br Site: https://mocfidelidade.com.br Todos os horários no app aparecem em horário de São Paulo (UTC-3) .