MagnooSystem

Manual do Usuário

Sistema de Gestão para Assistência Técnica · v1.1
Documento gerado em agosto de 2026

Sumário

  1. Visão Geral do Sistema
    1. Dashboard
    2. Navegação
    3. Acesso e Login
  2. Clientes
    1. Cadastrar Cliente
    2. Editar e Buscar
  3. Ordens de Serviço
    1. Criar OS
    2. Status e Workflow
    3. Peças e Itens
    4. Financeiro da OS
    5. WhatsApp na OS
  4. Estoque
    1. Cadastrar Produto
    2. Entrada de Estoque
    3. Importar / Exportar Excel
    4. Edição em Massa
  5. Financeiro
    1. Lançamentos
    2. Despesas Parceladas
    3. Caixa Inicial
    4. Contas a Receber
    5. Alertas de Vencimento
  6. Relatórios
    1. Relatório de OS
    2. Relatório de Estoque
    3. Relatório Financeiro
    4. Histórico por Cliente
  7. WhatsApp
    1. Enviar mensagem pelo Cliente
    2. Enviar pela OS
    3. Templates
  8. Fiscal
    1. Configuração
    2. Emitir Nota Fiscal
    3. Consultar e Cancelar
  9. Tributos Federais
    1. Cadastrar Tributo
    2. Registrar Pagamento
    3. Status
  10. Usuários e Permissões
  11. Configurações e Backup
  12. Painel da Plataforma
    1. Acesso do Superadmin
    2. Empresas
    3. Módulos por Empresa
    4. Superadmins e Manutenção
1
🏠
Visão Geral do Sistema

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:

ÍconeMóduloFunção
🏠DashboardVisão geral e KPIs
👥ClientesCadastro e busca de clientes
📋Ordens de ServiçoCriar e gerenciar OS
📦EstoqueProdutos e movimentações
💰FinanceiroReceitas, despesas e contas
📊RelatóriosAnálises e exportações
🧾FiscalEmissão de NF-e / NFC-e (se contratado)
🏛️Tributos FederaisControle de FGTS, INSS, IRPF, IRPJ e DARF
💾BackupBackup e restauração dos dados
⚙️ConfiguraçõesDados da empresa e parâmetros do sistema

1.3 Acesso e Login

  1. Acesse o sistema pelo navegador no endereço fornecido pelo administrador.
  2. Digite seu usuário e senha.
  3. 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
👥
Clientes

2.1 Cadastrar um Novo Cliente

  1. Clique em Clientes na barra lateral.
  2. Clique no botão + Novo Cliente (canto superior direito).
  3. Selecione o tipo: Pessoa Física (CPF) ou Pessoa Jurídica (CNPJ). A máscara do campo muda automaticamente.
  4. Preencha os dados: nome, CPF/CNPJ, telefone, WhatsApp e endereço.
  5. 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

CampoObrigatórioDescrição
Tipo (PF/PJ)SimDefine a máscara do documento
NomeSimNome completo ou razão social
CPF / CNPJSimValidado e único por empresa
WhatsAppNãoUsado para envio de mensagens automáticas
TelefoneNãoTelefone fixo ou alternativo
EndereçoNãoRua, número, bairro, cidade, UF
E-mailNãoPara comunicações por e-mail
MagnooSystem · Manual do Usuário
3
📋
Ordens de Serviço

3.1 Criar uma Nova OS

  1. Clique em Ordens de Serviço na barra lateral.
  2. Clique em + Nova OS.
  3. No campo Cliente, comece a digitar o nome — aparece uma lista para selecionar.
  4. Preencha os dados do equipamento: tipo, marca, modelo e número de série.
  5. Descreva o defeito relatado pelo cliente.
  6. 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
StatusSignificado
OrçamentoAguardando aprovação do cliente
AbertaAprovada, aguardando início do serviço
Em AndamentoTécnico trabalhando no equipamento
ProntaServiço concluído, aguardando retirada
EntregueEquipamento devolvido ao cliente
FaturadaPagamento confirmado e registrado
CanceladaOS 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

  1. Abra a OS desejada clicando nela na lista.
  2. Na aba Itens, clique em + Adicionar Peça.
  3. Selecione o produto do estoque (o sistema mostra quantidade disponível).
  4. 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:

3.5 Enviar WhatsApp pela OS

  1. Abra a OS e clique no botão WhatsApp (ícone verde).
  2. Escolha o template de mensagem (OS criada, pronta, entregue, etc.).
  3. Confirme o número do cliente e clique em Enviar.
MagnooSystem · Manual do Usuário
4
📦
Estoque

4.1 Cadastrar um Produto

  1. Clique em Estoque na barra lateral.
  2. Clique em + Novo Produto.
  3. Preencha: código, nome, categoria, marca, preço de custo e preço de venda.
  4. Defina a quantidade mínima — o sistema alerta quando o estoque ficar abaixo desse valor.
  5. Clique em Salvar.

4.2 Registrar Entrada de Estoque

  1. Na lista de produtos, clique no botão Entrada (ícone de caixa) do produto desejado.
  2. Informe a quantidade que chegou e o preço de custo da compra.
  3. 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:

  1. Clique em Modelo Excel para baixar a planilha modelo.
  2. Preencha a planilha com seus produtos (siga as colunas do modelo).
  3. 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

ColunaObrigatórioExemplo
CódigoSimFILT-001
NomeSimFiltro de Óleo
CategoriaNãoFiltros
MarcaNãoMann
Preço de CustoNão12.50
Preço de VendaNão25.00
QuantidadeNão10
Quantidade MínimaNão3

4.5 Edição em Massa

  1. Marque as caixas de seleção (☑️) dos produtos desejados na lista.
  2. Uma barra aparece no topo com as opções Inativar Selecionados e Excluir Selecionados.
  3. 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
5
💰
Financeiro

O módulo financeiro controla receitas, despesas, parcelas e contas a receber da empresa.

5.1 Registrar um Lançamento

  1. Clique em Financeiro na barra lateral.
  2. Clique em + Novo Lançamento.
  3. Selecione o tipo: Receita (entrada de dinheiro) ou Despesa (saída).
  4. Preencha: descrição, valor, categoria, data de vencimento e forma de pagamento.
  5. Se já foi pago, marque Pago e informe a data do pagamento.
  6. Clique em Salvar.

5.2 Despesas Parceladas

  1. Ao criar uma despesa, marque a opção Parcelado.
  2. Informe o número de parcelas. O sistema pré-calcula as datas mensais automaticamente.
  3. Você pode editar as datas antes de salvar.
  4. 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):

  1. Clique no botão Caixa Inicial no topo do módulo Financeiro.
  2. Informe o valor e clique em Salvar.
  3. 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:

5.6 Alertas de Vencimento

Ao abrir o módulo Financeiro, o sistema exibe automaticamente alertas coloridos:

CorSituação
🔴 VermelhoLançamentos vencidos (data passou e não foi pago)
🟡 AmareloVencem hoje
🔵 AzulVencem amanhã
MagnooSystem · Manual do Usuário
6
📊
Relatórios

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

  1. Clique em Relatórios → selecione OS por Período.
  2. Defina a data inicial e data final.
  3. Opcionalmente filtre por cliente específico usando o seletor.
  4. Clique em Gerar. O relatório aparece abaixo com lista e totais.

6.2 Relatório de Estoque

  1. Selecione Estoque nos filtros de relatório.
  2. Filtre por categoria se necessário.
  3. Clique em Gerar para ver a posição atual com valores e quantidades.

6.3 Relatório Financeiro

  1. Selecione Financeiro nos filtros.
  2. Defina o período e o tipo (Receita / Despesa / Todos).
  3. 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:

  1. Selecione Histórico por Cliente.
  2. No campo Cliente, comece a digitar o nome — a lista filtra automaticamente por digitação.
  3. Selecione o período: semana, mês, ano ou personalizado.
  4. Para período personalizado, defina a data inicial e final.
  5. 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
7
💬
WhatsApp

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

  1. Na lista de Clientes, clique no ícone verde do WhatsApp na linha do cliente desejado.
  2. O telefone é preenchido automaticamente com o número cadastrado.
  3. Escolha um template pronto ou escreva a mensagem livremente.
  4. Clique em Enviar.

7.2 Enviar orçamento/status pela OS

  1. Abra a Ordem de Serviço desejada.
  2. 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).
  3. Revise o texto, ajuste se necessário e clique em Enviar.

7.3 Templates disponíveis

TemplateQuando usar
OS CriadaInformar o cliente que a OS foi aberta
Aguardando AprovaçãoEnviar orçamento para aprovação
Aprovação de OrçamentoMensagem com o resumo do orçamento, pronta para envio
Equipamento ProntoAvisar que o serviço foi concluído
Aguardando PeçaInformar que está aguardando peça
Equipamento EntregueConfirmar 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
8
🧾
Fiscal

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

  1. Acesse Fiscal → Configurações.
  2. Informe o Token Focus NFe fornecido pela plataforma.
  3. Selecione o ambiente: Homologação (testes) ou Produção.
  4. Preencha os dados fiscais da empresa (CNPJ, Inscrição Estadual, regime tributário).
  5. Salve as configurações.

8.2 Emitir uma nota fiscal

  1. Acesse Fiscal → Notas Fiscais.
  2. Clique em Emitir NF e escolha o tipo: NF-e (55) ou NFC-e (65).
  3. Preencha os dados do tomador (cliente), itens e valores — pode vincular a uma Ordem de Serviço existente.
  4. Clique em Emitir. O sistema envia para a SEFAZ via Focus NFe.
  5. Após aprovação (status Autorizado), o DANFE fica disponível para impressão/download.

8.3 Consultar e cancelar notas

StatusSignificado
RascunhoNota criada, ainda não enviada para a SEFAZ
ProcessandoEnviada, aguardando retorno da SEFAZ
AutorizadoNota emitida e válida
ErroRejeitada — verifique a mensagem de erro para corrigir e reemitir
CanceladoNota cancelada dentro do prazo legal
DenegadoEmissã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
9
🏛️
Tributos Federais

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

  1. Acesse Tributos Federais na barra lateral.
  2. Clique em + Novo Tributo.
  3. Preencha Categoria (FGTS, INSS, IRPF, IRPJ ou Receita Federal), Valor e Vencimento.
  4. Informe a Competência (ex: Maio/2026) para identificar o período de referência.
  5. Opcionalmente, anexe o boleto/guia em PDF e defina uma data de pagamento programado.
  6. Clique em Salvar.

9.2 Registrar pagamento

  1. Clique no lápis do tributo desejado.
  2. Preencha o campo Pagamento Realizado com a data em que o pagamento foi efetuado.
  3. Opcionalmente, anexe o comprovante de pagamento.
  4. 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

StatusSignificado
PendenteVencimento futuro, sem pagamento registrado
AgendadoData de pagamento programado preenchida e ainda não venceu
VencidoData de vencimento passou sem pagamento registrado
PagoData 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
10
👤
Usuários e Permissões

O sistema permite múltiplos usuários com níveis de acesso diferentes por setor.

10.1 Acessar o Painel de Gestão

  1. Clique no seu nome ou avatar no canto inferior da barra lateral.
  2. O painel de gestão abre com duas abas: Usuários e Setores e Permissões.

10.2 Criar um Novo Usuário

  1. Na aba Usuários, clique em + Novo Usuário.
  2. Defina nome, login, senha e papel.
  3. Selecione o setor ao qual o usuário pertence.
  4. Clique em Salvar. O usuário já pode fazer login imediatamente.

10.3 Papéis disponíveis

PapelAcesso
Dono / AdminAcesso total — gerencia tudo, incluindo usuários e setores
GerentePode gerenciar usuários e setores da empresa
TécnicoAcesso definido pelo setor
AtendenteAcesso definido pelo setor
FinanceiroAcesso definido pelo setor
EstoqueAcesso definido pelo setor
VisualizadorApenas leitura (definido pelo setor)

10.4 Criar Setores e Configurar Permissões

  1. Na aba Setores e Permissões, clique em + Novo Setor.
  2. Defina o nome e a cor do setor.
  3. Marque quais módulos o setor pode acessar.
  4. Clique em Salvar.
  5. 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
⚙️
Configurações e Backup

11.1 Configurações do Sistema

As configurações gerais ficam acessíveis pelo menu de engrenagem ⚙️ na barra lateral. Você pode configurar:

11.2 Fazer Backup

O backup protege os dados da sua empresa. É recomendável fazer um backup periodicamente.

  1. Acesse Backup na barra lateral.
  2. Clique em Criar Backup.
  3. O sistema gera um arquivo .json com todos os dados da empresa.
  4. 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

  1. Acesse Backup na barra lateral.
  2. Localize o arquivo desejado na lista de backups já realizados.
  3. 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

ProblemaSolução
Não consigo fazer loginVerifique usuário e senha com o administrador. O sistema diferencia maiúsculas de minúsculas no login.
Botão de enviar WhatsApp não funcionaA mensagem só é enviada quando a conexão de WhatsApp da plataforma está ativa. Contate o administrador da plataforma.
Produto sem estoque ao adicionar na OSRegistre uma entrada de estoque antes de adicionar o produto à OS.
Relatório vazioVerifique se o período selecionado tem dados cadastrados.
Não vejo um módulo na telaSeu setor pode não ter permissão para aquele módulo. Solicite ao dono/gerente da empresa.
Aba Fiscal não apareceO 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
12
🛡️
Painel da Plataforma

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

  1. Clique em + Nova Empresa para abrir o formulário de cadastro.
  2. Preencha nome, CNPJ (opcional), plano, nome do dono, usuário de login e senha.
  3. 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ãoAção
👁️ Ver / EditarAbre os dados completos da empresa: dados cadastrais, usuários, integrações e zona de risco.
🔒 Bloquear / 🔓 LiberarSuspende ou reativa o acesso de todos os usuários da empresa.
🗑️ ExcluirRemove 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

AbaPara que serve
UsuáriosLista todos os usuários de todas as empresas, com opção de impersonar (entrar como aquele usuário) para dar suporte.
SuperadminsCadastra outras contas com acesso à plataforma, definindo o nível (owner, admin, suporte) e se pode impersonar usuários.
LogsHistórico de ações relevantes na plataforma: criação de empresas, bloqueios, impersonações, etc.
ManutençãoAtiva um modo de manutenção global que bloqueia o login de todas as empresas (superadmins continuam com acesso).
Config. PlataformaIdentidade 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