Manual do usuário ControLoja

1. Introdução

O ControLoja é um sistema web de gestão para lojas: cadastro de produtos com variações (cor, tamanho, estoque e EAN), ponto de venda, catálogo público integrado ao WhatsApp, controle de despesas, relatórios e gestão de usuários.

Cada loja é um ambiente isolado: seus produtos, vendas, usuários e configurações não são visíveis por nenhuma outra loja.

Perfis de acesso

2. Acesso ao sistema (login)

2.1 Como entrar

1. 1. Abra o endereço do sistema (ex.: https://hub.controloja.com.br).
2. 2. No campo Usuário, informe no formato usuario@NomeDaLoja. Exemplos: Jose@LojaTeste (administrador), TestGer@LojaTeste (gerente), joao.silva@LojaTeste (vendedor).
3. 3. Informe a Senha e clique em Entrar.

2.2 Primeiro acesso

• O administrador inicial da loja é criado pela Plataforma no momento da criação da loja; a senha inicial é entregue junto com o acesso.
• Recomenda-se trocar a senha no menu Gestor → Alterar Senha logo no primeiro acesso.
• Novos usuários (gerentes e vendedores) são criados pelo Admin ou por um Gerente no menu Gestor.

2.3 Erros comuns no login

2.4 Assinatura, Trial e modo somente leitura

Toda loja possui uma data de vencimento (período de teste — Trial — ou plano mensal/anual):

3. Dashboard

Tela inicial do sistema (perfis Admin e Gerente). Mostra um panorama do mês atual.

Indicadores

Painéis

• Top Vendas — produtos mais vendidos no período, útil para decidir reposição e destaque no catálogo.
• Produtos com Estoque Baixo — alerta de reposição, considerando o estoque das variações.

4. Config

Menu exclusivo do perfil Admin. É aqui que se define a identidade da loja e a aparência do catálogo público.

4.1 Dados da Empresa

• Dados da Empresa — texto livre (nome, endereço, CNPJ, telefone). Aparece nos comprovantes de venda impressos.
• Observações Gerais — texto de rodapé dos comprovantes (ex.: "Agradecemos pela preferência!").

4.2 WhatsApp da Empresa

• Campo numérico de 13 dígitos: DDI + DDD + número. Exemplo: 5521999999999.
• É o número que recebe os pedidos do Catálogo. Se estiver incorreto, os clientes não conseguirão enviar o pré-pedido.

4.3 Personalização do Catálogo

4.4 Salvando

Clique em Salvar Configurações ao final. Uma mensagem de confirmação aparece; erros de validação (ex.: WhatsApp com menos de 13 dígitos) são exibidos em vermelho.

5. Cadastro

Menu com quatro abas: Produtos, Categorias, Cores e Tamanhos.

5.1 Categorias

• Campo de nome (até 15 caracteres) e botão de inclusão.
• Cada categoria da lista possui editar (lápis) e excluir (lixeira), com confirmação.
• Categorias são usadas nos filtros do Catálogo e dos relatórios de Vendas.

5.2 Cores

• Nome da cor com até 10 caracteres (ex.: Preto, Azul).
• Permite editar cores já cadastradas.

5.3 Tamanhos

• Nome do tamanho com até 5 caracteres (ex.: P, M, G, 42).
• Permite editar tamanhos já cadastrados.

5.4 Produtos — campos principais

Margem de lucro

Calculada automaticamente como ((Venda − Compra) ÷ Compra) × 100 e colorida:

Fotos

• Até 10 fotos por produto; cada arquivo até 500 KB.
• Resolução ideal: 1000x1000 pixels.
• A primeira foto é a principal (a que aparece no card do Catálogo).
• Miniaturas podem ser removidas individualmente antes de salvar.

Variações e Estoque (Cor × Tamanho)

O estoque não fica no produto, e sim em cada combinação de cor e tamanho:

1. 1. Selecione as cores e os tamanhos aplicáveis ao produto.
2. 2. O sistema monta uma matriz com todas as combinações.
3. 3. Preencha, para cada combinação: Estoque (quantidade disponível) e EAN (código de barras opcional, até 13 dígitos, usado pelo leitor no PDV).
4. 4. Combinações sem estoque aparecem como indisponíveis no Catálogo e no PDV.

Salvar e editar

• Clique em Cadastrar Produto. O botão fica desabilitado durante a gravação, evitando cadastro duplicado por clique duplo.
• Para alterar um produto, use Buscar na lista ao lado e dê um duplo clique no item — o formulário é preenchido em modo de edição. Use Cancelar para sair da edição.

6. PDV — Ponto de Venda

Tela de venda no balcão. Disponível para Admin, Gerente e Vendedor.

No celular, a tela é dividida em abas Produtos e Carrinho. Em desktop, aparece em duas colunas.

6.1 Buscar e adicionar produtos

1. 1. Digite a descrição no campo de busca ou use o leitor de código de barras (o EAN da variação leva direto ao item correto).
2. 2. Selecione o produto na lista.
3. 3. Escolha a cor, o tamanho (variação) e a quantidade.
4. 4. Clique em Adicionar ao carrinho.

6.2 Carrinho

• Remover itens
• Lançar Taxas
• Lançar Frete
• Aplicar Desconto
• Conferir o Total atualizado automaticamente

6.3 Finalização

• Cliente — até 30 caracteres
• Celular — 11 dígitos (DDD + número)
• Endereço — quando houver entrega
• Forma de pagamento — Débito, Dinheiro, Crédito, Pix ou Link

Clique em Finalizar Venda. O estoque das variações é descontado automaticamente.

6.4 Após a venda

• Imprimir A4 — folha completa, com dados da empresa e de entrega
• Imprimir 80mm — cupom para impressora térmica
• Enviar por WhatsApp — abre a conversa com o cliente
• Nova Venda — limpa a tela para o próximo atendimento

7. Catálogo

Vitrine pública da loja, acessível sem login.

7.1 Endereços

• Endereço padrão: https://hub.controloja.com.br/catalogo/NomeDaLoja
• Se a loja tiver domínio próprio configurado, o catálogo abre direto na raiz do domínio.

O menu Catálogo dentro do sistema mostra o link e permite abrir a vitrine.

7.2 O que o cliente vê

• Cabeçalho com logo, nome da loja e cor definidos em Config.
• Cards de produtos com foto, descrição e preço.
• Produtos marcados como "Sob Encomenda" exibem uma faixa identificadora, e há filtro para ocultá-los.
• Apenas produtos ativos e com foto principal aparecem.

7.3 Busca, filtros e links compartilháveis

• Busca por texto e filtro por categoria.
• Os filtros aplicados são refletidos na URL — basta copiar o endereço para compartilhar um resultado específico por WhatsApp ou redes sociais.

7.4 Rolagem infinita

O catálogo carrega 16 produtos por vez e vai buscando os próximos automaticamente conforme o cliente rola a página, com indicador discreto de carregamento.

7.5 Carrinho e envio do pedido

1. 1. O cliente seleciona cor e tamanho no card.
2. 2. Clica no botão de carrinho com "+" — o item entra no carrinho no primeiro clique. Se cor ou tamanho não estiverem selecionados, uma mensagem orienta a seleção.
3. 3. Informa nome (até 30 caracteres) e celular (11 dígitos).
4. 4. Finaliza: é gerado um Pré-Pedido e o WhatsApp da loja é aberto com o resumo do pedido.

7.6 Rodapé

O rodapé exibe, nas cores da loja: "© 2026 ControLoja. Todos os direitos reservados. | Acesse controloja.com.br e crie sua loja virtual."

8. Pré-Pedidos

Lista os pedidos recebidos pelo Catálogo. Disponível para Admin, Gerente e Vendedor. Cada pré-pedido recebe um código no formato PP000001 e exibe cliente, celular, itens e valor.

Status

Ações

• Levar ao PDV — abre o PDV com os itens já carregados e marca o pré-pedido como concluído. Basta confirmar pagamento e finalizar.
• Cancelar — muda o status para cancelado. Não afeta o estoque, pois não houve baixa.
• Excluir — remove o registro definitivamente (com confirmação).

9. Vendas

Relatório completo das vendas realizadas. Disponível para Admin e Gerente. Cada venda recebe um número no formato AAAAMMDD0001 (sequencial reiniciado a cada dia).

9.1 Filtros

• Data inicial e Data final
• Categoria
• Produto
• Cliente
• Forma de pagamento

9.2 Ações disponíveis

10. Despesas

Controle de saídas financeiras da loja. Disponível para Admin e Gerente.

Cadastro

Informe a data, a descrição, o valor e o responsável pelo pagamento, e clique em Cadastrar Despesa. Cada lançamento recebe um código CD00001.

Relatório

• Filtros por período e demais campos do lançamento.
• Exportação para Excel dos resultados filtrados.
• Edição e exclusão de lançamentos com confirmação.

11. Gestor

Gestão dos usuários da loja. Disponível para Admin e Gerente.

11.1 Novo Usuário

• Nome de Usuário — ex.: joao.silva (sem espaços). O nome MasterADM é reservado ao administrador inicial da loja.
• Nome Completo
• Senha e Confirmar Senha — devem coincidir e atender à política de segurança (tamanho mínimo e combinação de caracteres; a mensagem de erro indica o que falta).
• Perfil de Acesso — Gerente ou Vendedor

Clique em Criar Usuário. O login desse usuário será nomedeusuario@NomeDaLoja.

11.2 Alterar Senha

1. 1. Selecione o Usuário.
2. 2. Informe Nova Senha e Confirmar Nova Senha.
3. 3. Confirme. O usuário passa a usar a nova senha no próximo login.

11.3 Usuários do Sistema

Lista todos os usuários da loja com nome, perfil e um interruptor de habilitado/desabilitado.

• Usuários desabilitados não conseguem fazer login; sessões abertas são encerradas.
• O Admin da loja não pode ser desabilitado.
• Gerentes não podem desabilitar a si mesmos nem um Admin.

12. Apêndices

12.1 Limites de campos

12.2 Formatos de código

12.3 Faixas de margem

12.4 Formas de pagamento

Débito · Dinheiro · Crédito · Pix · Link

12.5 Perguntas frequentes

Documento de referência do sistema ControLoja. Recursos e limites podem evoluir com novas versões.