Como usar este manual

Pense nesta wiki como um guia turístico do painel. Cada seção traz uma visão leiga do que o módulo faz, exemplos do dia a dia e um mini passo a passo para executar as tarefas mais comuns. Sempre que tiver dúvida sobre um termo, consulte o glossário ao final.

1. Entenda o cenário

Leia a descrição "O que é" para saber, em palavras simples, qual problema o módulo resolve.

2. Siga o passo a passo

Use a coluna "Como fazer" para executar as ações principais sem medo de esquecer etapas.

3. Explore conexões

Veja as tags finais para entender quais outros módulos se relacionam com o atual.

Clientes

Base principal de cadastro. Tudo começa aqui: dados pessoais, contatos e endereços dos assinantes.

O que é

Lista de todas as pessoas físicas ou jurídicas atendidas pelo provedor. Cada cliente pode ter uma ou mais assinaturas.

Quando usar

  • Cadastro de um novo assinante.
  • Atualizar telefone ou e-mail para cobranças.
  • Consultar endereços para visitas técnicas.

Como fazer

  1. Clique em “Adicionar Cliente”.
  2. Preencha dados básicos (Nome, CPF/CNPJ, contatos).
  3. Adicione endereço de instalação e observações úteis.
  4. Salve e, se necessário, já crie a assinatura pelo atalho.

Dicas rápidas

  • Use observações para registrar histórico de atendimentos.
  • Manter CPF/CNPJ correto evita problemas fiscais.
  • Verifique se o cliente está vinculado ao tenant certo.

Assinaturas

Gerencia o contrato ativo de cada cliente: plano, status financeiro, autenticação e equipamentos.

O que é

O coração do provedor. Cada assinatura representa um serviço entregue ao cliente, com informações de rede, cobrança e histórico de status.

Quando usar

  • Ativar um novo cliente e definir plano/servidor.
  • Verificar status (adimplente, inadimplente, bloqueado).
  • Migrar várias assinaturas para outro servidor.

Como fazer

  1. Localize a assinatura pelo nome do cliente ou status.
  2. Edite para atualizar plano, autenticação ou endereço.
  3. Use as ações do canto direito: Ativar, Desativar ou Alterar Plano em massa.
  4. Salve e verifique alertas de conflito (login/IP duplicados).

Dicas rápidas

  • O filtro “Vencimento (de/até)” ajuda a prever bloqueios.
  • Isentos aparecem com destaque azul no valor e vencimento.
  • Use o widget AssinaturaStatsOverview para visão geral.

Contratos

Armazena os documentos que formalizam o serviço. Ideal para acompanhar vigência e anexos assinados.

O que é

Um repositório de contratos vinculados aos clientes, com status (ativo, renovado, encerrado) e possibilidade de anexos.

Quando usar

  • Registrar um novo contrato assinado.
  • Consultar cláusulas antes de renegociar.
  • Garantir que o contrato está alinhado à assinatura ativa.

Como fazer

  1. Crie o contrato a partir do cliente ou da assinatura.
  2. Selecione o modelo padrão (se existir) e ajuste dados.
  3. Anexe o PDF assinado e informe vigência.
  4. Salve e acompanhe o status na lista.

Dicas rápidas

  • Use Modelos de Contrato para padronizar textos.
  • Registrar data de renovação evita caducidade.
  • Inclua observações sobre garantias ou multa.

Chamados

Central de atendimento. Controla solicitações, problemas e tarefas internas para cada cliente.

O que é

Uma fila de tickets com status, setor responsável e histórico de mensagens. Ajuda a garantir SLA.

Quando usar

  • Registrar chamado de suporte técnico.
  • Acompanhar tratativas de cobrança.
  • Distribuir tarefas entre setores (técnico, financeiro, comercial).

Como fazer

  1. Abra o módulo e filtre por status (Aberto, Em andamento, Finalizado).
  2. Clique no chamado para ver detalhes e anotações.
  3. Atualize o responsável ou setor quando necessário.
  4. Finalize com o status correto e registre a solução.

Dicas rápidas

  • Adicionar tags ajuda a priorizar temas críticos.
  • Relatórios de tempo médio dependem de status atualizados.
  • Integre com API WhatsApp para avisar o cliente automaticamente.

Categorias de Conta a Receber

Organiza as receitas por tipo. Ajuda o financeiro a entender de onde vem o dinheiro.

O que é

Uma tabela de etiquetas usadas ao lançar contas a receber. Exemplo: Mensalidade, Instalação, Multa.

Quando usar

  • Criar uma nova categoria para um serviço recém-oferecido.
  • Padronizar lançamentos feitos pela equipe de cobrança.
  • Filtrar relatórios por centro de receita.

Como fazer

  1. Clique em “Adicionar Categoria”.
  2. Informe nome amigável e descrição.
  3. Salve e informe à equipe a nova categoria disponível.

Dicas rápidas

  • Use nomes curtos para facilitar filtros.
  • Revise categorias inativas a cada trimestre.

Categorias Financeiro

Classificação geral de entradas e saídas. Funciona como um plano de contas simplificado.

O que é

Lista de categorias usadas em todos os lançamentos financeiros (receitas e despesas).

Quando usar

  • Mapear despesas recorrentes (Energia, Folha, Marketing).
  • Preparar relatórios contábeis.
  • Comparar gastos por área nos dashboards.

Como fazer

  1. Criar a categoria com nome e tipo (receita ou despesa).
  2. Adicionar uma descrição simples para orientar a equipe.
  3. Salvar e usar nas telas de contas a pagar/receber.

Dicas rápidas

  • Combine com o contador para alinhar plano de contas.
  • Evite criar categorias duplicadas com grafia diferente.

Plataformas de Recebimento

Onde você configura os meios de pagamento (PIX, boleto, cartão) e integrações com gateways.

O que é

Cadastro das contas ou gateways utilizados para cobrar clientes. Define taxas e credenciais.

Quando usar

  • Adicionar uma nova conta bancária para PIX.
  • Configurar integração com EFI Bank ou Lytex.
  • Alterar taxas repassadas ao cliente.

Como fazer

  1. Clique em “Adicionar plataforma”.
  2. Preencha nome, tipo (PIX, boleto, cartão) e credenciais.
  3. Teste o envio de uma cobrança antes de liberar para produção.

Dicas rápidas

  • Proteja tokens de API (evite expor em canais abertos).
  • Documente em Config Sistema quais plataformas estão ativas.

Contas a Receber

Controle das receitas do provedor: lançamentos, baixas e comprovantes.

O que é

Tela onde ficam os títulos que o cliente precisa pagar. Cada linha mostra valor, vencimento e status.

Quando usar

  • Lançar cobranças avulsas (instalação, multa).
  • Registrar baixa manual de um recebimento.
  • Anexar comprovantes enviados pelo cliente.

Como fazer

  1. Clique em “Criar conta a receber”.
  2. Informe cliente, valor, vencimento e categoria.
  3. Ao receber o pagamento, edite e marque como “Pago”, registrando data e forma.

Dicas rápidas

  • Integrações (EFI, Lytex) podem dar baixa automática.
  • Use filtros por atraso para direcionar cobranças.

Contas a Pagar

Acompanhamento das despesas do provedor: quem devemos, quanto e quando vence.

O que é

Tela para lançar despesas (fornecedor, conta, tributo) e controlar se já foram pagas.

Quando usar

  • Lançar nota fiscal de um fornecedor.
  • Controlar vencimentos de aluguel, energia, serviços.
  • Anexar comprovante após a quitação.

Como fazer

  1. Clique em “Criar conta a pagar”.
  2. Selecione o fornecedor, informe valor e vencimento.
  3. Quando pagar, edite e marque status como “Pago”, registrando dados do pagamento.

Dicas rápidas

  • Organize anexos para facilitar auditorias.
  • Use categorias financeiras para relatórios de despesas.

Planos

Catálogo das ofertas do provedor: velocidade, preço, servidor e autenticação.

O que é

Cadastro que define quanto cobrar, qual largura de banda entregar e onde o cliente será autenticado.

Quando usar

  • Lançar um novo plano comercial.
  • Ajustar preço ou franquia de um plano existente.
  • Marcar quais métodos de autenticação (PPPoE, hotspot, IP).

Como fazer

  1. Crie o plano informando nome, velocidade e valor.
  2. Associe a um servidor e marque os métodos disponíveis.
  3. Salve e comunique a equipe comercial.

Dicas rápidas

  • Planos com hotspot ou PPPoE precisam de configuração no servidor.
  • Use descrições para orientar vendedores sobre benefícios.

Faturas (Geral)

Centraliza todas as faturas geradas, independente do gateway. Mostra status, valores e ações.

O que é

Uma lista com as faturas emitidas para os clientes, permitindo reenviar boletos e verificar pagamentos.

Quando usar

  • Reenviar boleto ou link de pagamento.
  • Verificar faturas atrasadas ou com erro.
  • Sincronizar status com o módulo de Contas a Receber.

Como fazer

  1. Filtre por cliente ou status (Em aberto, Pago, Cancelado).
  2. Clique na fatura para ver detalhes e histórico de notificações.
  3. Use ações disponíveis para reenviar ou cancelar.

Dicas rápidas

  • Integrações específicas têm módulos dedicados (EFI, Lytex).
  • Registre justificativas ao cancelar faturas.

Faturas EFI Bank

Módulo dedicado às faturas enviadas via Gerencianet/EFI. Mostra callbacks e status em tempo real.

O que é

Visão detalhada das cobranças emitidas pelo gateway EFI, com logs das respostas da API.

Quando usar

  • Conferir se o pagamento foi confirmado pela EFI.
  • Gerar segunda via diretamente pelo painel.
  • Investigar falhas de comunicação entre sistemas.

Como fazer

  1. Filtre por status (Pago, Pendente, Cancelado).
  2. Acesse o detalhe para ver logs e webhooks recebidos.
  3. Utilize ações para reenviar notificações ou atualizar status manualmente.

Dicas rápidas

  • Verifique Config Sistema para garantir que os tokens estão corretos.
  • Mantenha o webhook configurado na conta EFI.

Faturas Lytex

Controle das cobranças processadas pela Lytex, com logs específicos dessa integração.

O que é

Tela especializada que mostra status, retorno da API Lytex e possíveis erros.

Quando usar

  • Verificar se houve falha na geração de boleto.
  • Acompanhar faturas com status pendente de retorno.
  • Refazer um envio que ficou em erro.

Como fazer

  1. Use filtros por data ou status para localizar faturas.
  2. Abra o detalhe para ver mensagem de erro ou comprovante.
  3. Se necessário, reenvie ou entre em contato com o gateway.

Dicas rápidas

  • Confira as credenciais no módulo Config Sistema.
  • Documente erros recorrentes para suporte Lytex.

Relatório Financeiro

Dashboards e exportações que mostram a saúde financeira: receitas, despesas e inadimplência.

O que é

Painel visual com gráficos, indicadores e filtros por período. Facilita reuniões gerenciais.

Quando usar

  • Preparar relatório mensal de diretoria.
  • Comparar receitas versus despesas.
  • Monitorar inadimplência por faixa de atraso.

Como fazer

  1. Abra o relatório e selecione o período desejado.
  2. Use filtros (categoria, plataforma) para refinar a visão.
  3. Exporte para Excel/PDF se precisar compartilhar.

Dicas rápidas

  • Verifique se lançamentos estão categorizados corretamente.
  • Inclua notas explicando picos atípicos (ex: campanhas).

Servidores

Cadastro dos equipamentos de autenticação (PPPoE, Hotspot, IP) usados para entregar internet.

O que é

Banco de dados com os servidores (RouterOS, Radius, etc.) que o provedor utiliza.

Quando usar

  • Cadastrar um novo concentrador de clientes.
  • Atualizar IP ou credenciais após manutenção.
  • Definir quais métodos de autenticação cada servidor suporta.

Como fazer

  1. Clique em “Adicionar servidor”.
  2. Informe nome, IP, porta, usuário e senha (com segurança).
  3. Associe planos e interfaces relevantes.

Dicas rápidas

  • Mantenha histórico de alterações para auditoria.
  • Combine com a equipe de rede antes de excluir um servidor.

Interfaces

Tabela de portas, VLANs ou bridges disponíveis nos servidores para autenticação IP Address.

O que é

Cadastro auxiliar que dá nomes amigáveis às interfaces de rede dos servidores.

Quando usar

  • Ao instalar uma nova VLAN para clientes corporativos.
  • Quando precisa identificar rapidamente a interface correta para IP fixo.
  • Para evitar erros ao selecionar interface no cadastro da assinatura.

Como fazer

  1. Selecione o servidor relacionado.
  2. Cadastre o nome da interface (ex: VLAN 200 - Centro).
  3. Salve e utilize nas assinaturas IP Address.

Dicas rápidas

  • Use padrão de nomenclatura (servidor + finalidade).
  • Revise sempre que alterar configuração no Mikrotik.

IP Pool

Gerencia as faixas de IP disponíveis para autenticação PPPoE ou IP Address.

O que é

Cadastro das redes (ex: 192.168.100.0/24) com observações para uso interno.

Quando usar

  • Adicionar nova faixa de IP comprada ou liberada.
  • Atualizar descrição para indicar qual bairro ela atende.
  • Verificar rapidamente qual pool está ligado a um plano.

Como fazer

  1. Clique em “Adicionar pool”.
  2. Informe faixa, máscara e observação.
  3. Associe ao servidor/plano correto.

Dicas rápidas

  • Evite sobreposição de redes entre servidores.
  • Mantenha documentado no campo observação.

Classe IP

Organiza faixas de IP em grupos lógicos (clientes, backbone, corporativos) para facilitar automações.

O que é

Uma classificação macro das faixas de IP. Ajuda a aplicar políticas ou filtros por grupo.

Quando usar

  • Criar grupos de IP para relatórios.
  • Organizar pools por finalidade (Residencial, Corporativo).
  • Planejar migração de rede.

Como fazer

  1. Defina o nome da classe (ex: Empresas Premium).
  2. Cadastre faixa ou referência aos pools.
  3. Utilize nos relatórios ou automações.

Dicas rápidas

  • Padronize nomenclatura para facilitar busca.
  • Revise quando expandir rede para novas cidades.

Equipamentos

Inventário de modems, ONUs, roteadores e aparelhos instalados nos clientes.

O que é

Registro dos equipamentos com número de série, MAC e status (instalado, estoque, manutenção).

Quando usar

  • Vincular um equipamento à assinatura do cliente.
  • Rastrear onde cada aparelho está instalado.
  • Controlar estoque e movimentações.

Como fazer

  1. Clique em “Adicionar equipamento”.
  2. Informe modelo, MAC address e status.
  3. Associe a um cliente/assinatura quando instalado.

Dicas rápidas

  • Use o campo observação para registrar garantia.
  • Combine com Assinaturas para saber quem está sem ONU.

Tenant

Administra provedores dentro da plataforma. Cada tenant possui configurações e limites próprios.

O que é

Cadastro mestre de cada empresa atendida. Define logotipo, dados fiscais, planos permitidos.

Quando usar

  • Criar um novo provedor dentro do sistema.
  • Atualizar dados de contato ou endereço fiscal.
  • Definir limites de usuários, assinaturas e integrações.

Como fazer

  1. Abra a tela Tenant e clique em “Adicionar”.
  2. Preencha informações comerciais, fiscais e técnicas.
  3. Associe domínios, parâmetros padrões e recursos ativos.

Dicas rápidas

  • Restrinja o acesso deste módulo a administradores.
  • Documente alterações significativas em Activity Log.

Usuários

Gerencia quem pode acessar o painel, qual tenant pertence e quais permissões possui.

O que é

Cadastro de contas de acesso internas. Inclui nome, e-mail, senha, setor e nível de permissão.

Quando usar

  • Dar acesso a um novo colaborador.
  • Bloquear usuário desligado.
  • Redefinir senha para alguém que esqueceu.

Como fazer

  1. Clique em “Adicionar usuário”.
  2. Informe nome, e-mail e selecione o tenant.
  3. Associe cargo ou permissões específicas.
  4. Envie instruções de acesso seguro.

Dicas rápidas

  • Ative a opção “Trocar senha no primeiro acesso” quando necessário.
  • Revise permissões semestrais ou após promoções.

Cargos

Conjuntos de permissões que você atribui aos usuários para definir o que cada um pode acessar.

O que é

Perfis prontos (ex: Financeiro, Suporte, Comercial) com permissões agrupadas.

Quando usar

  • Criar um cargo para um novo departamento.
  • Padronizar permissões para todos os analistas financeiros.
  • Revisar acessos após mudança organizacional.

Como fazer

  1. Clique em “Adicionar cargo”.
  2. Defina nome e descrição simples.
  3. Selecione as funcionalidades (permissões) que o cargo terá.

Dicas rápidas

  • Crie cargos por nível de acesso (Básico, Intermediário, Admin).
  • Documente quais cargos exigem aprovação gerencial.

Funcionalidades

Lista completa de permissões individuais (ver, criar, editar, excluir) aplicáveis aos recursos.

O que é

A base granular de permissões que alimenta cargos e usuários. Ex: “Assinaturas - Editar”.

Quando usar

  • Criar uma permissão específica para uma nova funcionalidade do sistema.
  • Ajustar texto das permissões exibidas na interface.
  • Controlar acesso quando não quer criar um novo cargo.

Como fazer

  1. Cadastre o nome da funcionalidade e descrição.
  2. Defina agrupamento (Clientes, Financeiro, etc.).
  3. Associe aos cargos e usuários conforme necessário.

Dicas rápidas

  • Mantenha uma planilha com o mapeamento de permissões e cargos.
  • Evite remover permissões sem checar cargos ligados.

Setores

Mapa dos departamentos internos. Ajuda a organizar chamados, usuários e relatórios.

O que é

Cadastro de setores como Suporte, Financeiro, Comercial. Usado em chamados e perfis de usuário.

Quando usar

  • Criar um setor para uma nova equipe.
  • Ajustar responsáveis por atendimento.
  • Filtrar relatórios por setor.

Como fazer

  1. Clique em “Adicionar setor”.
  2. Informe nome e descrição.
  3. Associe usuários ou defina responsáveis direto em Chamados.

Dicas rápidas

  • Mantenha os nomes alinhados com o organograma da empresa.
  • Revise quando houver fusões ou alterações de equipe.

Configurações Gerais

Parâmetros básicos do sistema: logo, e-mail, notificações e preferências gerais.

O que é

Formulário central com ajustes de branding, comunicação e integrações gerais.

Quando usar

  • Ao trocar a identidade visual ou dados de contato.
  • Para configurar textos padrão de e-mail e WhatsApp.
  • Quando ativar novas funcionalidades no painel.

Como fazer

  1. Acesse “Configurações Gerais”.
  2. Edite cada aba (Marca, Comunicação, Integrações) conforme necessário.
  3. Salve e teste os envios automáticos.

Dicas rápidas

  • Documente alterações relevantes (ex: mudança de remetente de e-mail).
  • Revise após migrações de domínio.

Config Sistema

Painel de ajustes avançados. Mexa aqui somente com autorização e registrando tudo.

O que é

Configurações técnicas que afetam integrações, limites, segurança e rotinas automáticas.

Quando usar

  • Integrar com novos serviços externos (API).
  • Ajustar limites de uso para tenants.
  • Ativar funcionalidades beta do sistema.

Como fazer

  1. Revise a documentação da funcionalidade a ser ativada.
  2. Aplique alterações e registre o motivo no campo observação.
  3. Teste o comportamento em ambiente controlado antes de liberar.

Dicas rápidas

  • Apenas administradores devem ter acesso.
  • Após ajustes, monitore Activity Log para detectar anomalias.

API WhatsApp

Integração para envio automático de mensagens (cobrança, avisos de manutenção, chamados).

O que é

Tela onde você cadastra tokens, remetentes e templates utilizados nas notificações via WhatsApp.

Quando usar

  • Configurar a API após contratar o serviço de mensageria.
  • Atualizar token expirado ou telefone remetente.
  • Testar novo template de mensagem (ex: cobrança amigável).

Como fazer

  1. Cadastre o token fornecido pelo parceiro de WhatsApp.
  2. Informe número remetente e nome exibido.
  3. Crie ou edite templates e faça um envio de teste.

Dicas rápidas

  • Guarde tokens em local seguro (gestor de senhas).
  • Integre com Chamados e Faturas para mensagens automáticas.

Modelos de Contrato

Biblioteca de textos padronizados utilizados na geração de contratos.

O que é

Armazena templates com placeholders (ex: {{cliente_nome}}) usados para gerar contratos rapidamente.

Quando usar

  • Atualizar cláusulas conforme legislação.
  • Criar versões diferentes (Residencial, Corporativo, Temporário).
  • Padronizar idioma antes de disponibilizar ao time comercial.

Como fazer

  1. Clique em “Adicionar modelo”.
  2. Defina nome e cole o texto com placeholders.
  3. Salve, teste a geração e associe ao módulo Contratos.

Dicas rápidas

  • Versão as alterações (ex: v1.2 - 2025).
  • Peça validação do departamento jurídico.