¶ Integração Plataforma MVNO - Gertel
Uma plataforma MVNO é uma operadora de rede móvel virtual que, basicamente, compra o direito de utilizar parte da infraestrutura oferecida por uma ou mais operadoras móveis. Possibilitando que o usuário utilize várias redes (Vivo, TIM, Claro, etc…) com um único chip.
¶ Cadastrando a Integração
Para adicionar a integração, você deverá ir em Configuração > Integrações > MVNO > Adicionar
O usuário deverá selecionar o gateway Gertel e informar os parâmetros username e password, que devem ser disponibilizados pela própria plataforma.
Há também os seguintes parâmetros opcionais:
- tipo_bloqueio: Define se em caso de bloqueio da linha do cliente, o bloqueio deve ser ‘parcial’ ou ‘total’ na plataforma.
- bloqueio_total (PADRÃO): Irá realizar o bloqueio total da linha na platafoma.
- bloqueio_parcial: Irá realizar o bloqueio parcial da linha na platafoma.
Após configurar os parâmetros, o usuário deverá sincronizar os planos clicando no botão Sincronizar, através do menu Ações > Planos, na página da Integração MVNO.
Para finalizar a configuração, antes de atribuir o plano ao cliente, o usuário deverá marcar a opção Serviço Permite MVNO no módulo Configuração > Geral > Serviços / Planos.
Caso essa opção não esteja marcada, o sistema irá bloquear qualquer tentativa de adição de planos MVNO ao serviço.
¶ Adicionar ao Serviço do Cliente
Agora, com a integração e o serviço/plano configurados, o usuário poderá vincular os planos para o cliente acessando o menu de Serviços do Cliente > Outras Opções > Dados MVNO > Adicionar.
Será necessário selecionar a integração, o plano, o DDD, o Número e o ICCID e salvar, para que o sistema transmita os dados e gere o número de forma automática.
Obs: Para essa integração não é necessário selecionar o número, pois eles são gerados de forma automática pela API.
Há também os seguintes parâmetros opcionais para serem adicionados forma individual aos números:
-
tipo_bloqueio: Define se em caso de bloqueio da linha do cliente, o bloqueio deve ser ‘parcial’ ou ‘total’ na plataforma.
- bloqueio_total (PADRÃO): Irá realizar o bloqueio total da linha na platafoma.
- bloqueio_parcial: Irá realizar o bloqueio parcial da linha na platafoma.
-
portabilidade: Define se junto com o cadastro já é para realizar a portabilidade do cliente, para realizar a portabilidade no cadastro, deve ser selecionado o valor ‘true’.
- true: Irá realizar a portabilidade no cadastro.
- false: Não realiza a portabilidade (nesse caso não precisa adicionar essa variável).
¶ Troca de Titularidade
Para realizar a troca de titularidade, basta selecionar no menu de ações a opção de Troca de Titularidade.
Obs.: O número só será migrado para o novo cliente/plano, quando a troca for processada pela fila de transmissão.
¶ Recarga
Caso o cliente queira realizar uma Recarga para Linha dele, baste acessar o campo de MVNO de seu serviço, a opção Ações > Recarga do número.
Na tela apresentada adicione o plano que o cliente deseja recarregar, será necessário passar o Valor à cobrar, Tipo de Serviço e Data de Vencimento, pois é obrigatório gerar uma fatura para enviarmos para a plataforma, em seguida clique em Salvar.
- Gerar Fatura: com essa opção uma fatura é gerada logo após a recarga ser efetivada, podendo escolher a Data de Vencimento no campo apresentado no formulário.
¶ Alteração de Plano
Ao utilizar essa opção, o usuário conseguirá alterar o plano atual de um número, sem a necessidade de excluí-lo e adicioná-lo novamente, como era feito antes. Agora, basta clicar em Ações > Alterar Plano e selecionar o novo plano que será vinculado ao número do cliente.
Após confirmar a alteração, o número ficará com o status aguardando_cadastro e entrará na fila de transmissão para alteração do plano.
¶ Portabilidade no Cadastro
Para realizar a portabilidade juntamente com o cadastro do cliente, vai ser necessário preencher o campo Número, como número a ser portado do cliente e adicionar o parâmetro portabilidade como true.
Inicialmente a portabilidade vai ficar com status solicitado, até a rotina de verificação da portabilidade ser rodada e transmitir a portabildiade.
A portabilidade pode ser feita também após o cadastro do plano do cliente, caso ele não tenha sido cadastrado com o parâmetro de portabilidade, para ser feita no cadatro. Conforme o seguinte passo.
¶ Portabilidade Após Cadastro
Para cadastrar/remover a portabilidade, será necessário ir em Ações > Portabilidade marcar ou desmarcar a opção de portabilidade, sendo necessário informar número antigo para portabilidade.
Após cadastrar a portabilidade, ela ficará com o status aguardando e será processada por uma rotina interna no sistema, que irá rodar a cada hora.
Assim que cadastrada pela rotina, a portabilidade ficará com o status de solicitado, pois ela não é aceita de forma imediata. Portanto o sistema continuará processando essa portabilidade a cada hora para verificar se houve alguma alteração no status.
Se houver sucesso no status, o status ficará como transmitido e o detalhamento do retorno da consulta ficará disponível na guia Status, da página de portabilidade. Caso a portabilidade seja negada, o status também ficará como transmitido e o detalhamento da negação também ficará disponível na guia de Status.
¶ Transmissão
Na plataforma Gertel ao excluir algum plano/número, suspender/habilitar o serviço, o sistema colocará os dados em transmissão de acordo com a ação executada, funcionando da seguinte forma:
- O cadastro é feito selecionando o plano e o DDD, juntamente com os ICCIDs (SIM Cards) respectivos.
- Após o cadastro, o plano é adicionado para transmissão. Após a transmissão o sistema irá cadastrar o número gerado.
- Se for excluído/suspenso algum número ou o plano todo, eles serão colocados na fila de transmissão para cancelamento, que não acontece de forma imediata na plataforma. Pois se o número já tiver alguma recarga, ela irá valer até o fim do mês. Portanto o cancelamento é para não permitir recarga automática.
¶ Relatório
Foi disponibilizado em Relatórios > MVNO, um relatório de serviços que possuem planos de MVNOs cadastrados. Por ele será possível visualizar os erros na transmissão dos dados à plataforma.
