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.

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?

Funciona com flash (toque no raio no topo) e câmera frontal (toque no switch).

8. 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

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)

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

11. Categorias

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)

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)

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)

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)

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

Alterar senha

Sobre

Versão do app.
Links pra Site, Política, Termos.

17. Sair

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:

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

Todos os horários no app aparecem em horário de São Paulo (UTC-3).