¶ Documentação MVNO
Mapeamento Técnico de Operações
¶ 01. Bloqueio e Desbloqueio de Inadimplentes
Interface centralizada para a gestão estratégica da inadimplência. Permite a suspensão ou reativação de serviços de telefonia com controle direto sobre a comunicação dos chips junto à rede.
¶ 1.1. Gestão de Inadimplentes
A listagem principal exibe contratos com pendências, permitindo monitoramento e intervenções rápidas.
- ✅ Filtros Avançados: Busca por datas, cliente, título ou contrato.
- ✅ Ações Rápidas: Gestão individual ou massiva de bloqueios.
- ✅ Exportação: Extração de relatórios em formato CSV.
¶ Resumo de Status
Dados em tempo real:
¶ 1.2. Painel de Ações
Gerencie cada contrato através da coluna de ações:
- Visualizar (Ícone de olho): Acesso ao histórico, faturas e logs.
- Controle de Acesso (Cadeado): Alterna entre bloqueio (vermelho) e desbloqueio (verde).
¶ 1.3. Detalhamento e Histórico
O modal de "Visualizar" centraliza a auditoria do cliente, exibindo faturas, status de linhas e logs cronológicos de eventos do sistema.
¶ 1.4. Filtragem e Exportação
A ferramenta de filtros permite segmentar a base de clientes para suporte ou auditoria financeira.
¶ 02. Gestão de Clientes
Este módulo é a central operacional destinada à visualização, busca e edição de clientes e seus respectivos contratos de telefonia. Ele permite o controle total sobre a jornada do assinante, desde o onboarding até o monitoramento diário do uso do chip.
¶ 2.1. Indicadores de Performance (Dashboards)
¶ 2.2. Tela Inicial (Listagem de Clientes)
A tela principal consolida um painel de filtros robusto abaixo dos indicadores:
- ✅ Filtros de Busca: Localize clientes instantaneamente sem percorrer listas intermináveis. Filtre por: Identificação Pessoal (Nome, CPF/CNPJ), Contato (E-mail, Telefone), Status da Linha (essencial para suporte e cobrança), Sincronização e Plano.
- ✅ Ações: O botão "+ Novo Cliente" é o ponto de partida. Ao clicar nele, você inicia o fluxo de integração (onboarding) do cliente no ERP.
¶ 2.3. Fluxo de Ativação (Dinâmico)
O sistema foi desenhado com uma interface dinâmica. Os campos de preenchimento são revelados progressivamente, garantindo uma entrada de dados estruturada e validada:
¶ Etapas de Seleção Técnica:
- Confirme o Plano: Seleção do pacote de dados (ex: 2GB a 30GB).
- Escolha o SIMCard: Registro do ICCID (número de série impresso no chip). Se estiver errado, o sistema não comunica com a operadora.
- Portabilidade: Caso traga número de outra operadora, preencha aqui o DDD e o número original.
¶ 2.4. Detalhamento do Ciclo de Vida da Linha
¶ 2.5. Ações do Cliente (Menu de Três Pontos)
Ferramentas de suporte rápido acessadas diretamente pelo menu da linha:
Gerenciamento detalhado do uso de recursos, adaptável ao mês selecionado:
- Visualização: Gráfico de consumo diário conforme o mês selecionado.
- Totalizadores: Resumo consolidado de Dados, SMS e Voz (ref. ao mês selecionado).
- Regra de Exibição (Mês Atual vs. Passado):
- Se mês selecionado não é o atual: O sistema exibe apenas os Totalizadores.
- Se mês selecionado é o atual: Além dos totalizadores, o sistema exibe a visualização do Saldo atual de Dados, SMS e Voz.
O "diário de bordo" com logs técnicos e rastreabilidade de todas as ações da linha.
Acesso direto ao contrato raiz vinculado no ERP.
Gestão completa de informações cadastrais, fiscais e encerramento de vínculo.
¶ 2.7. Detalhes do Contrato e Edição
• Nome, Mãe, CPF/CNPJ
• Nascimento, E-mail
• Telefone Móvel e Fixo
• Logradouro, CEP, Bairro
• Estado, UF e Código IBGE (necessário para notas fiscais)
¶ 3. Eventos (Logs e Auditoria)
Se a gestão de clientes é o "hoje", os Eventos são o histórico. Toda ação automática (ativação, bloqueio, atualização) é registrada aqui.
- Campos vitais: Data/Hora, Responsável (Sistema ou Humano), Status (Sucesso/Erro) e Ação realizada.
- Payload (Ver Response): Fundamental para diagnósticos técnicos. Se houver erro, aqui você encontrará a resposta bruta da operadora (ex: "ICCID inválido" ou "Plano indisponível").
- Filtros: Utilize o período e a descrição para investigar exatamente o que causou uma falha específica no passado.
¶ 03. Configurações Gerais
Definição de regras globais e parâmetros operacionais do módulo MVNO, seguindo rigorosamente a regra de negócio da empresa.
¶ 3.1. Automação e Infraestrutura
- Rotinas (CRON): Execução automatizada e pontual para garantir a consistência dos status de rede sem necessidade de intervenção humana.
- Dias Úteis e Feriados: Bloqueios automáticos ocorrem estritamente em dias úteis. Datas especiais podem ser gerenciadas em
/admin/feriado.
¶ 3.2. Parâmetros de Gestão e Bloqueio
- Bloqueio Padrão por Atraso: Chave global que deve estar Ativada em ambiente de produção para garantir o fluxo de cobrança.
- Bloqueio de SIMs: Controle centralizado para ativar/desativar o envio de comandos de bloqueio diretamente ao chip (SIMCard).
- Tempo Padrão de Atraso (Dias): Define o prazo de carência após o vencimento. Este valor é configurado exclusivamente de acordo com a nossa regra de negócio interna para tolerância de inadimplência.
- Mensagens SMS: Campos personalizados para configurar o texto automático que será enviado ao cliente no momento do bloqueio ou desbloqueio.
- Telefone de Teste: Número exclusivo para validar a entrega e o conteúdo das mensagens SMS antes de disparar para a base de clientes.
- Motivo de Bloqueio (Padrão Ta Telecom): Identifica a causa enviada à operadora: Suspensão Temporária (pausa solicitada), Roubo/Perda (segurança), Uso Indevido (violação contratual) ou Inadimplência (financeiro).
- Tipo de Bloqueio: Define o nível da restrição: Total (desconexão integral de voz/dados/SMS) ou Parcial (restrição apenas de dados/internet).
- Contratos de Teste: Sandbox dedicada, permitindo testes sem impacto na produção.
¶ 04. Eventos (Logs e Registros)
Módulo central de auditoria que registra todas as movimentações, alterações de status e interações entre o sistema e a API da operadora (Tatelecom).
¶ 4.1. Visualização de Logs
A interface de eventos permite o rastreamento cronológico de cada operação, desde o provisionamento de chips até atualizações manuais por parte da equipe de suporte.
¶ 4.2. Filtros de Auditoria
Ferramenta essencial para localizar registros específicos com base em:
- Período: Filtro por data de início e fim.
- Ação e Descrição: Busca por tipo de operação (ex: Bloqueio, Update, Create).
- Exportação: Botão "CSV" para extração de relatórios de auditoria.
¶ 4.3. Estrutura dos Registros
Cada linha na tabela de eventos detalha:
- Data/Hora: Registro preciso da execução.
- Responsável: Identifica quem executou a ação (Sistema ou Usuário/Suporte).
- Status (Sucesso): Indicador visual (Sim/Não) da conclusão da operação na API.
- Payload (Técnico): Disponibiliza o botão "Ver Payload" para inspeção do JSON enviado/recebido na comunicação com a Tatelecom, permitindo debugging avançado.
¶ 05. Planos
Módulo de gestão das ofertas de serviço, configurando regras de franquia de dados, voz, SMS e políticas de comercialização.
¶ 6.1. Listagem de Planos
A tela de listagem permite busca rápida e organização das ofertas vigentes. A tabela exibe o nome do plano, franquia (GB), minutos e SMS, com opções de edição e exclusão direta.
¶ 6.2. Cadastro e Edição
Interface para criação e manutenção de planos com integração total aos sistemas da operadora (Tatelecom):
- Vínculos: Integração direta com o ID do Plano Tatelecom e Plano CRM/ERP.
- Definições Técnicas: Configuração de Dados (MB), Minutos, SMS e Validade (Dias).
- Regras de Negócio (Toggles):
• Acumulativo: Transfere saldo residual.
• Reduzir Velocidade: Aplica política de *fair use* após 100%.
• Pacote Extra: Habilita venda de aditivos. - Comercial: Definição do Valor (R$) e descrição do plano.
¶ 06. Módulo MVNO - SIMCards
¶ 5.1. Listagem de SIMCards
Controle de estoque e vínculo hardware/assinante via ICCID (20 dígitos) e IMSI. A pesquisa funciona por identificador ou Status.
¶ 5.2. Cadastro de SIMCards
Solicita os identificadores únicos necessários para ativação:
- Tipo de Sim: Físico ou eSIM.
- ICCID: Número de série do chip físico.
- IMSI: Código de identificação na rede global.
¶ Status de Inventário
O sistema garante a rastreabilidade total do ativo, desde a entrada em estoque até o vínculo final com o número de telefone do cliente.
🔐 Permissões do Sistema (Clique para expandir)
Nota: As permissões devem ser concedidas pelo responsável da organização através deste link: Gerenciar Permissões
Permite bloquear cartões na página /mvno/bloqueio-desbloqueio
Permite desbloquear cartões na página /mvno/bloqueio-desbloqueio
Permite visualizar a página /mvno/bloqueio-desbloqueio
Permite adicionar novos clientes na página /mvno/clientes
Permite editar clientes cadastrados anteriormente na página /mvno/clientes
Permite excluir clientes cadastrados anteriormente na página /mvno/clientes
Permite visualizar a página /mvno/clientes
Permite atualizar as configurações gerais do módulo (/mvno/configuracoes)
Permite visualizar a página /mvno/configuracoes
Permite visualizar os eventos de cada cliente
Permite adicionar linha
Permite editar linha
Permite excluir linha
Permite ver linha
Permite adicionar novos planos na página /mvno/planos
Permite editar planos na página /mvno/planos
Permite excluir planos na página /mvno/planos
Permite visualizar a página /mvno/planos
Permite adicionar novos SIMCards na página /mvno/simcards
Permite editar SIMCards na página /mvno/simcards
Permite excluir SIMCards na página /mvno/simcards
Permite visualizar a página /mvno/simcards
Permite adicionar feriados
Permite editar feriados
Permite excluir feriados
Permite ver feriados
ÚLTIMA ATUALIZAÇÃO: 09 DE JULHO DE 2026