🔧
MagnooSystem
Manual do Usuário
Sistema de Gestão para Assistência Técnica · v1.1
Documento gerado em agosto de 2026
O MagnooSystem é um sistema web completo para gestão de assistências técnicas. Tudo funciona dentro do navegador, sem necessidade de instalar programas adicionais.
1.1 Dashboard
A primeira tela após o login é o Dashboard, que mostra um resumo rápido do negócio:
📋
OS Abertas
Total de ordens de serviço em andamento no momento.
💰
Faturamento do Mês
Soma de todas as OS faturadas no mês atual.
📦
Peças em Espera
Itens aguardando chegada no estoque.
⚠️
Alertas Financeiros
Parcelas vencidas ou que vencem em breve.
1.2 Navegação
A barra lateral esquerda dá acesso a todos os módulos:
| Ícone | Módulo | Função |
| 🏠 | Dashboard | Visão geral e KPIs |
| 👥 | Clientes | Cadastro e busca de clientes |
| 📋 | Ordens de Serviço | Criar e gerenciar OS |
| 📦 | Estoque | Produtos e movimentações |
| 💰 | Financeiro | Receitas, despesas e contas |
| 📊 | Relatórios | Análises e exportações |
| 🧾 | Fiscal | Emissão de NF-e / NFC-e (se contratado) |
| 🏛️ | Tributos Federais | Controle de FGTS, INSS, IRPF, IRPJ e DARF |
| 💾 | Backup | Backup e restauração dos dados |
| ⚙️ | Configurações | Dados da empresa e parâmetros do sistema |
1.3 Acesso e Login
- Acesse o sistema pelo navegador no endereço fornecido pelo administrador.
- Digite seu usuário e senha.
- Clique em Entrar. O sistema carrega automaticamente suas permissões.
ℹ️
Cada usuário vê apenas os módulos que o administrador liberou para seu setor.
MagnooSystem · Manual do Usuário
2.1 Cadastrar um Novo Cliente
- Clique em Clientes na barra lateral.
- Clique no botão + Novo Cliente (canto superior direito).
- Selecione o tipo: Pessoa Física (CPF) ou Pessoa Jurídica (CNPJ). A máscara do campo muda automaticamente.
- Preencha os dados: nome, CPF/CNPJ, telefone, WhatsApp e endereço.
- Clique em Salvar.
ℹ️
Preencha o campo WhatsApp sempre que o cliente tiver número — ele é usado para envio de mensagens automáticas sobre as OS.
2.2 Buscar e Editar Clientes
Use a caixa de busca no topo da lista para encontrar por nome, CPF/CNPJ ou cidade. A busca funciona mesmo sem digitar pontuação no CPF.
Para editar, clique no ícone de lápis ✏️ na linha do cliente. Para excluir, clique na lixeira 🗑️.
✅
Os clientes ficam ordenados em ordem alfabética automaticamente após cada cadastro.
2.3 Campos disponíveis
| Campo | Obrigatório | Descrição |
| Tipo (PF/PJ) | Sim | Define a máscara do documento |
| Nome | Sim | Nome completo ou razão social |
| CPF / CNPJ | Sim | Validado e único por empresa |
| WhatsApp | Não | Usado para envio de mensagens automáticas |
| Telefone | Não | Telefone fixo ou alternativo |
| Endereço | Não | Rua, número, bairro, cidade, UF |
| E-mail | Não | Para comunicações por e-mail |
MagnooSystem · Manual do Usuário
3.1 Criar uma Nova OS
- Clique em Ordens de Serviço na barra lateral.
- Clique em + Nova OS.
- No campo Cliente, comece a digitar o nome — aparece uma lista para selecionar.
- Preencha os dados do equipamento: tipo, marca, modelo e número de série.
- Descreva o defeito relatado pelo cliente.
- Clique em Salvar. A OS é criada com status Orçamento.
3.2 Status e Workflow
Cada OS passa por um fluxo de status. Use o campo Status dentro da OS para avançar:
Orçamento
→
Aberta
→
Em Andamento
→
Pronta
→
Entregue
→
Faturada
| Status | Significado |
| Orçamento | Aguardando aprovação do cliente |
| Aberta | Aprovada, aguardando início do serviço |
| Em Andamento | Técnico trabalhando no equipamento |
| Pronta | Serviço concluído, aguardando retirada |
| Entregue | Equipamento devolvido ao cliente |
| Faturada | Pagamento confirmado e registrado |
| Cancelada | OS encerrada sem conclusão |
⚠️
Ao mudar para Faturada sem preencher data de saída ou pagamento, o sistema exibe um aviso de confirmação.
3.3 Adicionar Peças e Itens
- Abra a OS desejada clicando nela na lista.
- Na aba Itens, clique em + Adicionar Peça.
- Selecione o produto do estoque (o sistema mostra quantidade disponível).
- Informe a quantidade e clique em Confirmar. O estoque é baixado automaticamente.
✅
Se uma peça ainda não chegou ao estoque, marque-a como Aguardando Estoque para controle futuro.
3.4 Financeiro da OS
Na aba Financeiro da OS você pode registrar:
- Adiantamento — valor pago pelo cliente antes da conclusão
- Forma de pagamento — dinheiro, cartão, Pix, etc.
- Data de faturamento — registra quando o pagamento foi recebido
3.5 Enviar WhatsApp pela OS
- Abra a OS e clique no botão WhatsApp (ícone verde).
- Escolha o template de mensagem (OS criada, pronta, entregue, etc.).
- Confirme o número do cliente e clique em Enviar.
MagnooSystem · Manual do Usuário
4.1 Cadastrar um Produto
- Clique em Estoque na barra lateral.
- Clique em + Novo Produto.
- Preencha: código, nome, categoria, marca, preço de custo e preço de venda.
- Defina a quantidade mínima — o sistema alerta quando o estoque ficar abaixo desse valor.
- Clique em Salvar.
4.2 Registrar Entrada de Estoque
- Na lista de produtos, clique no botão Entrada (ícone de caixa) do produto desejado.
- Informe a quantidade que chegou e o preço de custo da compra.
- Clique em Confirmar. O saldo é atualizado imediatamente.
4.3 Importar Produtos via Excel
Para cadastrar muitos produtos de uma vez, use a importação por planilha:
- Clique em Modelo Excel para baixar a planilha modelo.
- Preencha a planilha com seus produtos (siga as colunas do modelo).
- Clique em Importar, selecione o arquivo e confirme.
ℹ️
Se um produto com o mesmo código já existir, seus dados serão atualizados (não duplicados).
✅
Para exportar o estoque atual (ex: para backup ou análise), clique em Exportar Excel.
4.4 Colunas da Planilha de Importação
| Coluna | Obrigatório | Exemplo |
| Código | Sim | FILT-001 |
| Nome | Sim | Filtro de Óleo |
| Categoria | Não | Filtros |
| Marca | Não | Mann |
| Preço de Custo | Não | 12.50 |
| Preço de Venda | Não | 25.00 |
| Quantidade | Não | 10 |
| Quantidade Mínima | Não | 3 |
4.5 Edição em Massa
- Marque as caixas de seleção (☑️) dos produtos desejados na lista.
- Uma barra aparece no topo com as opções Inativar Selecionados e Excluir Selecionados.
- Clique na ação desejada e confirme.
⚠️
Produtos vinculados a OS existentes não podem ser excluídos. Prefira inativar nesses casos.
MagnooSystem · Manual do Usuário
O módulo financeiro controla receitas, despesas, parcelas e contas a receber da empresa.
5.1 Registrar um Lançamento
- Clique em Financeiro na barra lateral.
- Clique em + Novo Lançamento.
- Selecione o tipo: Receita (entrada de dinheiro) ou Despesa (saída).
- Preencha: descrição, valor, categoria, data de vencimento e forma de pagamento.
- Se já foi pago, marque Pago e informe a data do pagamento.
- Clique em Salvar.
5.2 Despesas Parceladas
- Ao criar uma despesa, marque a opção Parcelado.
- Informe o número de parcelas. O sistema pré-calcula as datas mensais automaticamente.
- Você pode editar as datas antes de salvar.
- Ao salvar, todas as parcelas são criadas de uma vez.
✅
Cada parcela aparece separada na lista, facilitando o controle de qual foi paga e qual está em aberto.
5.3 Caixa Inicial
O Caixa Inicial representa o saldo de abertura do caixa (dinheiro em espécie que a empresa já possui):
- Clique no botão Caixa Inicial no topo do módulo Financeiro.
- Informe o valor e clique em Salvar.
- Esse valor é somado ao saldo total do caixa.
5.4 Contas a Receber
A aba Contas a Receber lista todas as receitas pendentes (não pagas) e atrasadas, incluindo OS pagas a prazo. Use para acompanhar o que está em aberto.
5.5 Filtros
Use a barra de filtros para encontrar lançamentos por:
- Período (data inicial e data final)
- Tipo (Receita / Despesa)
- Status (Pago / Pendente)
- Categoria
5.6 Alertas de Vencimento
Ao abrir o módulo Financeiro, o sistema exibe automaticamente alertas coloridos:
| Cor | Situação |
| 🔴 Vermelho | Lançamentos vencidos (data passou e não foi pago) |
| 🟡 Amarelo | Vencem hoje |
| 🔵 Azul | Vencem amanhã |
MagnooSystem · Manual do Usuário
O módulo de Relatórios permite analisar o desempenho do negócio por diferentes ângulos.
6.1 Relatório de Ordens de Serviço
- Clique em Relatórios → selecione OS por Período.
- Defina a data inicial e data final.
- Opcionalmente filtre por cliente específico usando o seletor.
- Clique em Gerar. O relatório aparece abaixo com lista e totais.
6.2 Relatório de Estoque
- Selecione Estoque nos filtros de relatório.
- Filtre por categoria se necessário.
- Clique em Gerar para ver a posição atual com valores e quantidades.
6.3 Relatório Financeiro
- Selecione Financeiro nos filtros.
- Defina o período e o tipo (Receita / Despesa / Todos).
- Clique em Gerar para ver o demonstrativo com saldo do período.
6.4 Histórico por Cliente
Mostra todas as OS de um cliente específico com totais gastos e ranking:
- Selecione Histórico por Cliente.
- No campo Cliente, comece a digitar o nome — a lista filtra automaticamente por digitação.
- Selecione o período: semana, mês, ano ou personalizado.
- Para período personalizado, defina a data inicial e final.
- Clique em Gerar.
ℹ️
Deixe o campo cliente em branco para ver o ranking geral dos melhores clientes no período.
MagnooSystem · Manual do Usuário
O envio de mensagens por WhatsApp é feito por template, a partir da tela de Clientes ou de dentro de uma Ordem de Serviço. Não existe mais uma aba de chat/conversas dentro do sistema — o envio é pontual, por mensagem.
ℹ️
Uma integração dedicada de WhatsApp (API externa) está em desenvolvimento para conectar automaticamente todos os pontos de envio do sistema a uma única conexão gerenciada pela plataforma.
7.1 Enviar mensagem pelo cadastro do Cliente
- Na lista de Clientes, clique no ícone verde do WhatsApp na linha do cliente desejado.
- O telefone é preenchido automaticamente com o número cadastrado.
- Escolha um template pronto ou escreva a mensagem livremente.
- Clique em Enviar.
7.2 Enviar orçamento/status pela OS
- Abra a Ordem de Serviço desejada.
- Clique no botão WhatsApp (verde) — o modal abre já com um resumo do orçamento pré-montado (defeito, mão de obra, peças e valor total).
- Revise o texto, ajuste se necessário e clique em Enviar.
7.3 Templates disponíveis
| Template | Quando usar |
| OS Criada | Informar o cliente que a OS foi aberta |
| Aguardando Aprovação | Enviar orçamento para aprovação |
| Aprovação de Orçamento | Mensagem com o resumo do orçamento, pronta para envio |
| Equipamento Pronto | Avisar que o serviço foi concluído |
| Aguardando Peça | Informar que está aguardando peça |
| Equipamento Entregue | Confirmar a entrega |
✅
O texto de cada template é montado automaticamente com os dados do cliente e da OS (nome, número, equipamento, valor) — basta revisar antes de enviar.
MagnooSystem · Manual do Usuário
Emissão de Notas Fiscais eletrônicas (NF-e / NFC-e) integrada ao sistema via Focus NFe. Disponível apenas para empresas com o módulo Fiscal habilitado pela plataforma.
8.1 Configuração inicial
- Acesse Fiscal → Configurações.
- Informe o Token Focus NFe fornecido pela plataforma.
- Selecione o ambiente: Homologação (testes) ou Produção.
- Preencha os dados fiscais da empresa (CNPJ, Inscrição Estadual, regime tributário).
- Salve as configurações.
8.2 Emitir uma nota fiscal
- Acesse Fiscal → Notas Fiscais.
- Clique em Emitir NF e escolha o tipo: NF-e (55) ou NFC-e (65).
- Preencha os dados do tomador (cliente), itens e valores — pode vincular a uma Ordem de Serviço existente.
- Clique em Emitir. O sistema envia para a SEFAZ via Focus NFe.
- Após aprovação (status Autorizado), o DANFE fica disponível para impressão/download.
8.3 Consultar e cancelar notas
| Status | Significado |
| Rascunho | Nota criada, ainda não enviada para a SEFAZ |
| Processando | Enviada, aguardando retorno da SEFAZ |
| Autorizado | Nota emitida e válida |
| Erro | Rejeitada — verifique a mensagem de erro para corrigir e reemitir |
| Cancelado | Nota cancelada dentro do prazo legal |
| Denegado | Emissão negada pela SEFAZ (ex: irregularidade cadastral) |
Na lista de notas, use os botões de Consultar (atualizar status) e Cancelar (dentro do prazo legal).
⚠️
Atenção: sempre valide suas configurações em ambiente de Homologação antes de emitir notas reais em Produção.
MagnooSystem · Manual do Usuário
Controle do pagamento de obrigações fiscais da empresa: FGTS, INSS, IRPF, IRPJ e Receita Federal (DARF). Quando um tributo é marcado como pago, o sistema lança automaticamente uma despesa na aba Financeiro.
9.1 Cadastrar novo tributo
- Acesse Tributos Federais na barra lateral.
- Clique em + Novo Tributo.
- Preencha Categoria (FGTS, INSS, IRPF, IRPJ ou Receita Federal), Valor e Vencimento.
- Informe a Competência (ex: Maio/2026) para identificar o período de referência.
- Opcionalmente, anexe o boleto/guia em PDF e defina uma data de pagamento programado.
- Clique em Salvar.
9.2 Registrar pagamento
- Clique no lápis do tributo desejado.
- Preencha o campo Pagamento Realizado com a data em que o pagamento foi efetuado.
- Opcionalmente, anexe o comprovante de pagamento.
- Clique em Salvar.
✅
Ao salvar com data de pagamento preenchida, o sistema cria automaticamente um lançamento de despesa (categoria Imposto) na aba Financeiro. Se o pagamento for desfeito (data removida), o lançamento é excluído automaticamente.
9.3 Status dos tributos
| Status | Significado |
| Pendente | Vencimento futuro, sem pagamento registrado |
| Agendado | Data de pagamento programado preenchida e ainda não venceu |
| Vencido | Data de vencimento passou sem pagamento registrado |
| Pago | Data de pagamento realizado preenchida |
Excluir um tributo pago que tinha lançamento no financeiro vinculado também remove esse lançamento automaticamente.
MagnooSystem · Manual do Usuário
O sistema permite múltiplos usuários com níveis de acesso diferentes por setor.
10.1 Acessar o Painel de Gestão
- Clique no seu nome ou avatar no canto inferior da barra lateral.
- O painel de gestão abre com duas abas: Usuários e Setores e Permissões.
10.2 Criar um Novo Usuário
- Na aba Usuários, clique em + Novo Usuário.
- Defina nome, login, senha e papel.
- Selecione o setor ao qual o usuário pertence.
- Clique em Salvar. O usuário já pode fazer login imediatamente.
10.3 Papéis disponíveis
| Papel | Acesso |
| Dono / Admin | Acesso total — gerencia tudo, incluindo usuários e setores |
| Gerente | Pode gerenciar usuários e setores da empresa |
| Técnico | Acesso definido pelo setor |
| Atendente | Acesso definido pelo setor |
| Financeiro | Acesso definido pelo setor |
| Estoque | Acesso definido pelo setor |
| Visualizador | Apenas leitura (definido pelo setor) |
10.4 Criar Setores e Configurar Permissões
- Na aba Setores e Permissões, clique em + Novo Setor.
- Defina o nome e a cor do setor.
- Marque quais módulos o setor pode acessar.
- Clique em Salvar.
- Depois de criado, clique em Permissões para detalhar: visualizar / criar / editar / deletar em cada módulo.
✅
Exemplo: o setor Técnico pode ter permissão para criar e editar OS, mas não para excluir. O setor Financeiro pode ver o financeiro mas não alterar estoque.
MagnooSystem · Manual do Usuário
11.1 Configurações do Sistema
As configurações gerais ficam acessíveis pelo menu de engrenagem ⚙️ na barra lateral. Você pode configurar:
- Dados da empresa: endereço, telefone, e-mail e horário de funcionamento (o nome e o CNPJ são definidos na criação da empresa e não podem ser alterados aqui).
- Numeração das Ordens de Serviço: número inicial da sequência de OS.
- Mensagem de boas-vindas exibida no sistema.
11.2 Fazer Backup
O backup protege os dados da sua empresa. É recomendável fazer um backup periodicamente.
- Acesse Backup na barra lateral.
- Clique em Criar Backup.
- O sistema gera um arquivo
.json com todos os dados da empresa.
- Clique no ícone de download para salvar o arquivo no seu computador.
⚠️
Guarde os backups em local seguro, como Google Drive, Dropbox ou HD externo. Em caso de falha no servidor, o backup é a única forma de recuperar os dados.
11.3 Restaurar Backup
- Acesse Backup na barra lateral.
- Localize o arquivo desejado na lista de backups já realizados.
- Clique em Restaurar e confirme a operação.
⚠️
A restauração substitui os dados atuais pelos do backup. Faça um backup do estado atual antes de restaurar um arquivo antigo. Esta operação é irreversível.
11.4 Perguntas Frequentes
| Problema | Solução |
| Não consigo fazer login | Verifique usuário e senha com o administrador. O sistema diferencia maiúsculas de minúsculas no login. |
| Botão de enviar WhatsApp não funciona | A mensagem só é enviada quando a conexão de WhatsApp da plataforma está ativa. Contate o administrador da plataforma. |
| Produto sem estoque ao adicionar na OS | Registre uma entrada de estoque antes de adicionar o produto à OS. |
| Relatório vazio | Verifique se o período selecionado tem dados cadastrados. |
| Não vejo um módulo na tela | Seu setor pode não ter permissão para aquele módulo. Solicite ao dono/gerente da empresa. |
| Aba Fiscal não aparece | O módulo Fiscal precisa ser habilitado pela plataforma para a sua empresa. |
✅
Em caso de dúvidas ou problemas não listados aqui, contate o suporte técnico do MagnooSystem.
MagnooSystem · Manual do Usuário
O Painel da Plataforma é a área de administração de todas as empresas que usam o MagnooSystem. É de uso exclusivo do dono do projeto (superadmin) — donos e usuários de empresas não têm acesso a ele.
12.1 Acesso do Superadmin
Uma conta de superadmin sem nenhuma empresa vinculada cai direto no Painel da Plataforma ao fazer login — não passa pelo Dashboard nem pelo menu lateral do sistema operacional das empresas. O botão disponível no cabeçalho é Sair.
ℹ️
Se uma conta de superadmin também for dona de alguma empresa (caso raro, geralmente só durante a configuração inicial), ela vê o sistema normal dessa empresa com um item extra "Plataforma" no menu lateral, e pode alternar entre as duas telas pelo botão "Voltar ao sistema" / "Plataforma".
12.2 Aba Empresas
- Clique em + Nova Empresa para abrir o formulário de cadastro.
- Preencha nome, CNPJ (opcional), plano, nome do dono, usuário de login e senha.
- Clique em Criar Empresa. O sistema já cria os 4 setores padrão (Administrativo, Técnico, Financeiro, Atendimento) e vincula o usuário informado como dono.
Na lista de empresas, use os botões de cada linha para:
| Ícone/Botão | Ação |
| 👁️ Ver / Editar | Abre os dados completos da empresa: dados cadastrais, usuários, integrações e zona de risco. |
| 🔒 Bloquear / 🔓 Liberar | Suspende ou reativa o acesso de todos os usuários da empresa. |
| 🗑️ Excluir | Remove a empresa e todos os seus dados permanentemente (aba Zona de Risco, dentro do modal de edição). |
12.3 Módulos por Empresa (Integrações API)
Na aba Integrações API, cada empresa aparece com um interruptor para o Módulo Fiscal: ligado, a aba Fiscal fica disponível para os usuários da empresa; desligado, a aba some do menu deles automaticamente.
✅
Use esta tela para liberar o módulo Fiscal apenas para as empresas que contrataram esse recurso.
12.4 Usuários, Superadmins, Logs e Manutenção
| Aba | Para que serve |
| Usuários | Lista todos os usuários de todas as empresas, com opção de impersonar (entrar como aquele usuário) para dar suporte. |
| Superadmins | Cadastra outras contas com acesso à plataforma, definindo o nível (owner, admin, suporte) e se pode impersonar usuários. |
| Logs | Histórico de ações relevantes na plataforma: criação de empresas, bloqueios, impersonações, etc. |
| Manutenção | Ativa um modo de manutenção global que bloqueia o login de todas as empresas (superadmins continuam com acesso). |
| Config. Plataforma | Identidade visual e mensagens gerais da plataforma. |
⚠️
Bloquear uma empresa, excluí-la ou ativar o modo de manutenção afeta imediatamente todos os usuários dela. Use com cautela.
MagnooSystem · Manual do Usuário