TIP - MVNO
Índice
Visão geral
A partir da release 44 da versão 108 o mk erp possui integração com API MVNO, telefonia móvel da TIP Brasil. A integração é feita através de webservices e conexões com o banco de dados. A integração disponibiliza:
➡️ A partir da release nº 67 o ERP possui integração também com a TIP 5G
Pré-requisitos
Ativação da integração com a TIP Brasil
Sistema na versão na release nº 43 - Amerincanet
Sistema na versão na release nº 67 - Surf 5G
Configurações
Cadastro da plataforma
O primeiro passo é registrar a plataforma. Acessando a área de Configurações → Menu Telefonia → Tip Brasil MVNO:
As informações devem serem preenchidas:
Identificação: identificação para a plataforma;
Token: token de acesso fornecido pela TIP Brasil;
Tipo de sinal: Aqui você define se deseja utilizar a Sufr 5G ou AmericanNet. Pode-se utilizar ambas, porém, para isso, é necessário criar uma configuração para cada uma e, em seguida, associá-las adequadamente aos planos de acesso.
Bloqueio pela regra: opcional caso deseje utilizar o bloqueio automático pela régua de bloqueio. Veja mais informações na nossa documentação sobre as ações de bloqueio.
Cadastro dos planos de acesso
O cadastro dos planos de acesso, ou configuração equivalente, deve ser feito na plataforma MVNO da TIP. Após a conclusão desta configuração deve ser criado no mk o plano de acesso correspondente:
Em Configurações → Menu Técnico → Menu Técnico - clique para incluir um novo plano e no campo "Tipo" selecione a opção "Telefonia", em "Plataforma" escolha o nome que colocou na configuração como identificação, nesse caso "MVNO" e no campo "Vínculo" informe o código do plano de acesso que cadastrou na plataforma.
No campo “Meses de contrato” deve ser informada a duração do plano. Como na integração MVNO da TIP Brasil disponibiliza não é disponibilizado faturamento, é necessário também utilizar o campo “Valor mensal” para gerar as contas do cliente.
Cadastro do assinante
Acesse Módulo Integradores → Menu Telefonia → Submenu Assinantes e localize o cadastro do cliente que deseja criar o contrato. Selecione então o cadastro e clique no ícone + para criar o assinante.
Observação
Nesta tela serão mostrados apenas os cadastros que tem contratos de telefonia ativos no painel financeiro.
Serão listados então os contratos que o cliente tem de planos de telefonia. Selecione o que deseja criar na plataforma e avance.
A partir desta tela os campos são definidos de acordo com as características da plataforma.
Nesta deve ser selecionado:
Sim card disponível, todos são buscados automaticamente com os que possuem dentro da plataforma da Tip MVNO
DDD
Número
Portabilidade (Sim ou não) Caso selecionar SIM ele envia o pedido de portabilidade para a plataforma.
Rede privada - É uma nova solução disponibilizada pela Tip para que o provedor possa utilizar a sua própria rede para o tráfego de dados de clientes com rede móvel. Para mais informações, pode entrar em contato com o time da Plataforma da TIP. (A partir da release 98 é possível marcar ambas as opções, rede padrão + rede privada, para o mesmo assinante)
Caso seja marcada a opção de rede privada, passam a aparecer (e são obrigatórios) os campos “Rede” e “APN”, que são consultados diretamente nas opções disponíveis na plataforma da TIP.
O chip de rede privada não possui número e pode ser selecionado qualquer DDD
A partir da release 98, foram incluídas estas colunas para sinalizar se o assinante terá rede padrão e/ou privada:
Após concluir o cadastro do assinante, o sistema já tem todos os dados necessários para que possa sincronizá-lo com a plataforma.
Recarga avulsa
Primeiro precisa ter o plano de acesso configurado e informar quantos GB irá liberar para o cliente ↓
Após a inclusão do plano, deve acessar o painel de integradores → localizar o assinante em questão → e ir na moeda de visualizar assinatura.
Basta selecionar o plano que foi criado anteriormente, marcar a checkbox e clicar em “enviar”, com isso será disparado para dentro da plataforma o saldo.
Faturamento (Extrato de ligações)
Importante
A integração MVNO não possui faturamento com importação de contas, não são disponibilizadas essas informações. A importação do faturamento então traz o informativo do extrato de ligações do cliente. O controle do valor de cobrança é feito através dos planos de acesso pelo próprio MK.
Essa informação não tem disponível para clientes que utilizam o 5G, apenas AmericanNet
Para importar o extrato de ligações para o MK acesse Integradores> Telefonia> Faturamento e clique no ícone + para incluir uma nova importação. Selecione então a plataforma MVNO, a competência (o mês que serão importadas as contas) e a data de vencimento.
Pode ser importado o faturamento de somente um assinante (basta seleciona-lo no campo 'Pessoa') ou de um mês específico informando o período no formato mês/ano (MM/AAAA) no campo 'Competência' e definir uma data de vencimento (Informativo apenas)
Após clicar no botão "Importar" ele vai retornar com as informações do cliente, vencimento que selecionou na tela inicial e o valor do plano do cliente;
Portabilidade
Pré-requisito: Certifique-se de que o assinante esteja ativo e sincronizado na plataforma. Após isso, deve seguir os processos abaixo:
No menu principal, acesse Integradores > Telefonia > Assinantes.
Localize e selecione o assinante desejado.
Acesse a opção "Visualizar Assinatura".
Navegue até a aba "SIM Card".
No campo "Portabilidade SIM CARD", informe o número desejado.
Marque a caixa de seleção para confirmar e clique em "Enviar".
Após a confirmação, a solicitação de portabilidade será enviada à plataforma.
Gerenciador MVNO
Importante
Esse recurso não está disponível para Surf 5G
O Gerenciador MVNO é o local em que poderá extrair informações como:
listagem dos SIM CARDS e seus status
Disponibilizar SIM CARDS cancelados
Consultar o consumo consolidado dos clientes.
Configurações → Telefonia → Gerenciador MVNO