¶ Introdução (Plataforma MVNO – Iez)
Uma plataforma MVNO é uma operadora de rede móvel virtual que, essencialmente, 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.
¶ Configurando integração
Para adicionar a integração no sistema seria em Menu lateral > Configuração > Integrações > MVNO > Adicionar.
Ao clicar no campo Adicionar o usuário deverá selecionar o gateway Iez e informar o parâmetro:
- client_id
- client_secret
Parâmetros esses necessários para autenticação com a API da plataforma.
¶ Parâmetros opcionais
Os parâmetros opcionais configurados no painel da integração, irão ser validados como valores padrões para todas linhas inseridas.
- api_url: Parâmetro utilizado para alterar a URL padrão da API.
Utilizar apenas caso a API altere sua URL de acesso padrão
- recorrencia: Caso configurado com o valor true, a linha terá o pagamento processado automaticamente de acordo com o dia do vencimento das faturas no sistema.
Esse parâmetro pode ser configurado individualmente para uma linha
- metodo_pagamento: Método de pagamento utilizado para recorrência da linha.
Por padrão é utilizado o valor: BOLETO
¶ Sincronizar Planos
Após salvar a integração, será necessário sincronizar os planos da plataforma, na integração de MVNO Iez > ações > planos > sincronizar.
¶ Configurar Serviços
Para finalizar a configuração de MVNO, para atribuir o plano aos clientes, o usuário deverá marcar a opção Serviço Permite MVNO no Menu Lateral > Configuração > Geral > Serviços / Planos.
Caso essa opção não esteja marcada, o sistema bloqueará qualquer tentativa de adição de planos MVNO ao serviço.
¶ Adicionar número ao serviço
Com a integração e o serviço/plano configurados, poderá vincular os planos MVNO ao cliente acessando o menu de Serviços do Cliente > Outras Opções > Dados MVNO > Adicionar.
Será necessário selecionar a integração, informar o plano, o ICCID e o Número. Após salvar, é necessário aguardar a transmissão dos números.
¶ Parâmetros obrigatórios
Para adicionar um número MVNO para essa plataforma, alguns parâmetros são obrigatórios para continuar o processo.
-
aparelho: Modelo do aparelho utilizado pelo cliente
-
puk1 e pin2: São códigos do SIM Card, que serão utilizados para que o sistema consulte a disponibilidade dele na plataforma.
O código PIN é usado para proteger o cartão SIM do seu celular contra uso não autorizado. O código PUK (Personal Unblocking Key) é usado para desbloquear o SIM caso o PIN seja digitado incorretamente muitas vezes.
¶ Parâmetros opcionais
Os parâmetros opcionais configurados no painel da integração, irão ser validados como valores padrões para todas linhas inseridas.
- e_sim: Ativa nova linha com e-sim
- portabilidade: Ativa nova linha com portabilidade.
- operadora_origem: Operadora de origem da portabilidade.
Obrigatório quando o parâmetro portabilidade for configurado com o valor SIM!
- recorrencia: Caso configurado com o valor true, a linha terá o pagamento processado automaticamente de acordo com o dia do vencimento das faturas no sistema.
- metodo_pagamento: Método de pagamento utilizado para recorrência da linha.
Por padrão é utilizado o valor: BOLETO
- cliente_uuid: Código do cliente na plataforma.
Configurar esse parâmetro apenas se o cliente JÁ EXISTIR na plataforma. Caso contrário, o sistema irá cadastrar o cliente na Iez e esse código será criado automaticamente!
- contrato_uuid: Código do contrato do cliente na plataforma.
Configurar esse parâmetro apenas se o cliente JÁ POSSUIR um contrato na plataforma que queira utilizar para a linha. Caso contrário, o sistema irá criar um novo contrato na Iez e esse código será criado automaticamente!
- linha_uuid: Código da linha do cliente na plataforma.
Configurar esse parâmetro apenas se o cliente JÁ POSSUIR a linha cadastrada na plataforma. Caso contrário, o sistema irá criar uma nova linha na Iez e esse código será criado automaticamente!
¶ Portabilidade
Caso esteja realizando uma portabilidade, é necessário cadastrar o parâmetro portabilidade e informar a operadora_origem na ativação do número no serviço.
¶ Recorrência de pagamento
Para que o sistema atualize a situação financeira do cliente para a plataforma, deve-se configurar o parâmetro recorrencia no formulário de adição do número. Ou, caso deseje que esse comportamente seja padrão para todas linhas, configurar diretamente no painel da integração.
Tendo essa configuração ativa, o sistema validará as faturas lançadas para o cliente e caso esteja tudo em dia será enviado para a plataforma uma requisição de pagamento. Sinalizando a adimplência desse cliente.
Caso esteja inadimplente, o sistema irá suspender a linha do cliente até que a fatura seja paga.
A rotina que faz essa validação é executada apenas 1 vez ao dia, durante a madrugada!
¶ Ações disponíveis para o número
Abaixo é demonstrado algumas das opções que ficarão disponíveis após o cadastro de um número MVNO.
¶ Visualizar / Editar
¶ Vincular Pacote
A opção de vincular pacote irá aparecer quando na Integração estiver configurado essa Obrigatoriedade de vincular um pacote ao número de MVNO.
Obrigatório Vincular Pacote
Requisita ao usuário selecionar um pacote ao adicionar um número MVNO! Opção utilizada para que seja possível faturar os números pelo pacote
¶ Portabilidade da Linha
Para cadastrar/remover a portabilidade, será necessário ir no Serviço do cliente > Outras Opções > Dados MVNO > Ações > Portabilidade marcar ou desmarcar a opção de portabilidade, conforme necessário.
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 Iez, ao excluir algum plano/número, suspender/habilitar o serviço, o sistema colocará em transmissão os dados 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.
- Se for excluído algum número ou o plano todo, eles serão colocados na fila de transmissão para cancelamento.
- E se o serviço, que contém os Dados MVNO, for suspenso/habilitado, eles serão colocados na fila de transmissão para bloqueio/desbloqueio.
Assim que o número for transmitido para a plataforma, o parâmetro contrato será adicionado a ele.
¶ Inativação por roubo ou fraude
Ao apagar um número do plano do cliente o sistema irá exibir uma tela com a escolha de um status para a inativação desse número.
Caso seja escolhida as opções SUSPENSO_FRAUDE ou SUSPENSO_ROUBO, o sistema suspenderá o número na plataforma com esse status por 30 dias! Após passado esses 30 dias, o número será automaticamente reabilitado no sistema e na plataforma.
Essa configuração foi implementada para seguir de acordo com a regra de negócios da Iez
¶ Relatório MVNO
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.
¶ Perguntas/Problemas Frequentes
Abaixo serão listadas algumas perguntas/problemas frequentes relacionados a MVNO Iez. Caso alguma dessas situações aconteça e você tenha dificuldades para resolver, não hesite em chamar nosso suporte, pois estamos aqui para lhe ajudar.
¶ Se o serviço do cliente foi suspenso devido débito, ele é suspenso também na plataforma?
Caso o serviço do cliente, que contém os Dados MVNO, for suspenso/habilitado aqui no sistema, eles serão colocados na fila de transmissão para bloqueio/desbloqueio também na plataforma.