¶ Controlcel
Assim que o provedor realizar o credenciamento junto a Controlcel será fornecido a URL da integração e o usuário e senha utilizado para autenticação.
Passo 1 - Configuração de Integração:
Para realizar uma configuração basta acessar, menu Configurações > Integrações > Integrações (MVNO/Telefonia Móvel), em seguida crie uma nova integração, como mostra a figura abaixo:
Passo 2 - Cadastro de produto
Cadastrar um produto e vincular com um dos pacotes disponibilizadas pela Controlcel. Para isso acessar Cadastros > Produtos > Telefonia Móvel:
Passo 3 - Incluindo nos contratos
Agora precisamos vincular este produto ao contrato do cliente:.
Editando o contrato, deve ir até a aba Produtos e clicar em Novo, como apresentado abaixo:
Passo 4 - Ativar linha Mvno Controlcel
Acessar o contrato, ir até a aba Linha MVNO, clicar em Novo, selecionar a plataforma Controlcel, em seguida informe o DDD e o produto e preencha o campo de Sim Card.
Observações: É possível também criar o produto diretamente no plano de vendas, com isso esse produto fica padrão em todos os contratos.
¶ Surf
Para realizar uma configuração basta acessar, menu Configurações > Integrações > Integrações (MVNO/Telefonia Móvel), em seguida crie uma nova integração, como mostra a figura abaixo:
Passo 2 - Cadastro de produto
Cadastrar um produto e vincular com um dos pacotes disponibilizadas pela Surf. Para isso acessar Cadastros > Produtos > Telefonia Móvel:
Passo 3 - Incluindo nos contratos
Agora precisamos vincular este produto ao contrato do cliente:.
Editando o contrato, deve ir até a aba Produtos e clicar em Novo, como apresentado abaixo:
Passo 4 - Ativar linha Mvno Surf
Acessar o contrato, ir até a aba Linha MVNO, clicar em Novo, selecionar a plataforma Surf, em seguida informe o DDD e o produto e preencha o campo de Sim Card.
Observações: É possível também criar o produto diretamente no plano de vendas, com isso esse produto fica padrão em todos os contratos.
¶ TGN
Assim que o provedor realizar o credenciamento junto a TGN será fornecido a URL da integração e o usuário e senha utilizado para autenticação. (Necessário lembrar que o usuário utilizado para a integração precisa ter um perfil do tipo Sistema - API na plataforma da TGN!)
Passo 1 - Configuração de Integração
Para realizar uma configuração basta acessar, menu Configurações > Integrações > Integrações (MVNO/Telefonia Móvel), em seguida crie uma nova integração, como mostra a figura abaixo:
Passo 2 - Cadastro de produto
Cadastrar um produto e vincular com um dos pacotes disponibilizadas pela TGN. Para isso acessar Cadastros > Produtos > Telefonia Móvel:
Passo 3 - Incluindo nos contratos
Agora precisamos vincular este produto ao contrato do cliente.
Editando o contrato, deve ir até a aba Produtos e clicar em Novo, como apresentado abaixo:
Passo 4 - Ativar linha Mvno TGN
Acessar o contrato, ir até a aba Linha MVNO, clicar em Novo, selecionar a plataforma TGN, em seguida informe o DDD e o produto e preencha o campo de Sim Card.
Observações.: É possível também criar o produto diretamente no plano de vendas, com isso esse produto fica padrão em todos os contratos.
¶ TIP Brasil - Americanet
1 – No Menu Configurações > Integrações > Integração MVNO/Telefonia Móvel adicione uma nova configuração de integração da TIP.
MVNA: Selecione o valor (TIP).
Integração: Selecione o valor Amereicanet.
Url: Link da API da TIP que é disponibilizada ao cliente pela TIP.
Token: Chave de acesso Token que é disponibilizada ao cliente pela TIP.
Exemplo:
2 – Após adicionar as configurações vá até a Aba Produtos IXC/MVNO para adicionar os produtos relacionados a integração cadastrada. Clique no botão Novo e você será redirecionado para o formulário Produtos IXC/MVNO.
Clique no botão (Buscar plano Integração para que abra o formulário dos produtos relacionados a integração TIP).
Após abrir o formulário Planos MVNO clique no botão atualizar assim como indicado na imagem abaixo.
Após esta ação os planos deverão ser carregados na grid, então basta selecionar o plano desejado e clicar no botão (Inserir Registro Selecionado).
3 - Agora é necessário adicionar o Produto IXC, se o produto já foi cadastrado selecione o produto referente a TIP, caso contrário será necessário realizar o cadastro desse produto para continuar.
Após esta etapa o formulário de Produtos IXC/MVNO deverá estar semelhante o da imagem abaixo, clique em salvar e feche o formulário para visualizar o produto cadastrado.
Menu Sistema > Cadastros > Contratos, selecionar o contrato desejado e clicar em Editar. Na aba Produtos é necessário inserir o Produto TIP cadastrado e especificar no campo Tipo como MVNO/Telefonia Móvel e clicar em Salvar
Criar um novo assinante
4 - No contrato do cliente seguir até a aba linha MVNO e clicar em Novo:
Preencha os campos como do Exemplo:
API:
Ignorar API e Alterar apenas no IXC: Caso marcado a interação só vai ser executada no IXC, este efeito só funciona manualmente para as funções deste formulário.
Alterar na API e no IXC: Funções automáticas de bloqueio e liberação sempre vão realizar a execução da API, caso o retorno seja de sucesso, as alterações também serão realizadas no IXC.
Integração: Campo para Inserir uma integração cadastrada.
Produto relacionado: Se desejar poderá inserir um produto IXC/MVNO o qual foi cadastrado em Produtos;
Sim card: Número do cartão repassado pela integrada, deve conter 20 caracteres;
Portabilidade: "Sim" ou "Não".
DDD: Inserir DDD para que seja retornado o número do telefone equivalente ao DDD passado;
Buscar simcards disponíveis: Ao selecionar o botão, será listado os simcards para escolha no cadastro da linha MVNO.
¶ TIP Tá Telecom - Surf
1 – No Menu Configurações > Integrações > Integração MVNO/Telefonia Móvel adicione uma nova configuração de integração da TIP.
MVNA: Selecione o valor (TIP).
Url: Link da API da TIP que é disponibilizada ao cliente pela TIP.
Token: Chave de acesso Token que é disponibilizada ao cliente pela TIP.
Exemplo:
2 – Após adicionar as configurações siga até a aba "Produtos IXC/MVNO" para adicionar os produtos relacionados a integração cadastrada. Clique no botão Novo e você será redirecionado para o formulário "Produtos IXC/MVNO".
Clique no botão (Buscar plano Integração para que abra o formulário dos produtos relacionados a integração Surf).
Após abrir o formulário "Planos MVNO", clique no botão atualizar, conforme indicado na imagem abaixo.
Após esta ação os planos serão carregados na grid. Selecione o plano desejado e clique no botão (Inserir Registro Selecionado).
Em seguida, o plano ficará vinculado ao cadastro do produto na integração.
3 - Após a etapa anterior, o formulário de "Produtos IXC/MVNO" deverá ser semelhante ao da imagem abaixo, clique em salvar e feche o formulário para visualizar o produto cadastrado.
3.1 - Inserir produto MVNO no contrato do cliente.
Para vincular o produto no contrato de seu cliente, acesse: Menu Sistema > Cadastros > Contratos, selecione o contrato desejado e também o botão Editar. Na aba Produtos é necessário inserir o Produto TIP - Tá Telecom cadastrado e especificar no campo Tipo como MVNO/Telefonia Móvel e clicar em Salvar.
Criar um novo assinante.
4 - No contrato do cliente, siga até a aba Linha MVNO e clique em Novo:
Preencha os campos como do exemplo abaixo:
API:
Ignorar API e Alterar apenas no IXC: Caso marcado a interação só vai ser executada no IXC, este efeito só funciona manualmente para as funções deste formulário.
Alterar na API e no IXC: Funções automáticas de bloqueio e liberação sempre vão realizar a execução da API, caso o retorno seja de sucesso, as alterações também serão realizadas no IXC.
Integração: Campo para Inserir uma integração cadastrada.
Produto relacionado: Se desejar poderá inserir um produto IXC/MVNO o qual foi cadastrado em Produtos;
DDD: Inserir DDD para que seja retornado o número do telefone equivalente ao DDD passado;
Sim card: Número do cartão repassado pela integrada, deve conter 20 caracteres;
Portabilidade: "Sim" ou "Não".
4.1 - Em casos de solicitações de portabilidade pelo cliente, deve-se selecionar a opção "portabilidade Sim". Em seguida, será liberado o campo "Número do telefone" e "Token validação" para preenchimento do número a ser portado.
No campo token validação, será preenchido com um código que o cliente irá receber vis SMS, conforme indicado na imagem abaixo:
Obs: Em casos de linha portada, a linha ficará aguardando aprovação que pode ser acompanhando pela consulta e no status portabilidade, no cadastro da linha.
Concluindo o cadastro da linha MVNO com número de portabilidade, é necessário ter configurado a tarefa "Consultar portabilidades", para que, no momento em que a Tá Telecom aceitar a portabilidade, a linha seja liberada para uso no IXC Provedor.
Para cadastrar a tarefa, acesse: Menu Ferramentas > Ferramentas > Agenda de Tarefas > Novo > Consultar portabilidades. Defina um horário do dia em que a tarefa será gerada de forma automática.
- Tarefa: Selecione a tarefa "Consultar portabilidades".
- Minuto: preencher com o minuto que a tarefa ficará configurada para execução.
- Hora: preencher com a hora que a tarefa ficará configurada para execução.
- Dia do mês: preencher com o dia que a tarefa ficará configurada para execução.
- Mês: preencher com o número do mês que a tarefa ficará configurada para execução (exemplo: 1 se refere a janeiro e assim sucessivamente).
- Dia da semana: preencher com o dia da semana que a tarefa ficará configurada para execução (exemplo: (0-6) 0 = Domingo, 1 = segunda-feira...).
Caso seja recusado a sua portabilidade, será preciso solicitar um novo token validação com a Tá Telecom para abrir um novo pedido de portabilidade. A plataforma TIP - Surf, possui o tempo de até 3 dias uteis (não será contabilizado finais de semana e/ou feriado), para aceitar a portabilidade.
¶ Telecall
1 – No Menu Configurações > Integrações > Integração MVNO/Telefonia Móvel, adicione uma nova configuração de integração da Telecall.
MVNA: Selecione o valor (Telecall).
Url: Link da API da Telecall que é disponibilizado ao cliente pela Telecall.
Token: Gerado automaticamente ao salvar.
Data atualização token: Gerado automaticamente ao salvar
Exemplo:
2 – Após adicionar as configurações vá até a aba Produtos IXC/MVNO para adicionar os produtos relacionados a integração cadastrada. Clique no botão Novo e você será redirecionado para o formulário Produtos IXC/MVNO.
Clique no botão (Buscar plano Integração para que abra o formulário dos produtos relacionados a integração Telecall).
Após esta ação os planos deverão ser carregados na grid, então basta selecionar o plano desejado e clicar no botão (Inserir Registro Selecionado).
3 - Agora é necessário adicionar o Produto IXC, se o produto já foi cadastrado selecione o produto referente a Telecall e clique no botão (Inserir Registro selecionado), caso contrário será necessário realizar o cadastro desse produto para continuar.
Após esta etapa o formulário de Produtos IXC/MVNO deverá estar semelhante o da imagem abaixo, clique em Salvar e feche o formulário para visualizar o produto cadastrado.
Salve o registro e ele deverá ser listado nos produtos junto da configuração MVNO.
¶ Criar um novo assinanteeditareditar código-fonte
4 - No contrato do cliente seguir até a aba linha MVNO e clicar em Novo:
Preencha os campos como do Exemplo:
¶ API:editareditar código-fonte
Ignorar API e Alterar apenas no IXC: Caso marcado a interação só vai ser executada no IXC, este efeito só funciona manualmente para as funções deste formulário.
Alterar na API e no IXC: Funções automáticas de bloqueio e liberação sempre vão realizar a execução da API, caso o retorno seja de sucesso, as alterações também serão realizadas no IXC.
Integração: Campo para inserir a integração cadastrada;
Cliente Mvno: Campo que irá armazenar o cliente que será buscado na Telecall pelo botão (Buscar cliente Mvno);botão (Buscar cliente Mvno);
Cliente Mvno: Campo que irá armazenar a conta que será buscada na Telecall pelo botão (Buscar conta Mvno);
Profile Mvno: Campo que irá armazenar o tipo de perfil de internet (limitada ou ilimitada) que será buscada na Telecall pelo botão (Buscar perfil);
Produto relacionado: Se desejar poderá inserir um produto IXC/MVNO o qual foi cadastrado em Produtos;
Sim card: Número do cartão repassado pela integrada, deve conter 20 caracteres;
Portabilidade: Campo que irá declarar se o número será buscado da Telecall ou será utilizado um número existente de outra empresa para ser portado;
Tipo de número: Campo que indicará qual o tipo do número de telefone que será buscado na Telecall;
DDD: Inserir DDD para que seja retornado o número do telefone equivalente ao DDD passado.
Número de telefone: Em caso de Portabilidade ser não, o número poderá ser buscado através do botão (Buscar número linha), se não poderá ser colocado o número que será portado para a integrada.
Após realizar o procedimento e salvar a integração deverá estar funcionando corretamente e o campo ID linha integração deverá ser preenchido automaticamente com o ID que foi gerado na integrada.
5 - Após a criação bem sucedida da linha, você poderá verificar através da aba Produtos MVNO que o produto que foi adicionado na linha estará também listado como primeiro registro dos produtos.
Caso desejar outros produtos poderão ser adicionados a linha clicando no botão Novo e escolhendo um novo produto.
Após salvar o produto estará sendo listado junto com os demais cadastrados. Caso deseje, um produto também pode ser removido da linha clicando no botão Deletar da grid de Produto contrato mvno.
¶ Americanet
Para realizar a configuração, acesse: Menu Configurações > Integrações > Integrações (MVNO/Telefonia Móvel).
Em seguida, na guia Configuração MVNO, preencha os seguintes campos:
MVNA: Selecione Americanet
Login: Login do usuário API.
Senha: Senha do usuário API.
Token: Gerado automaticamente após salvar.
Conforme imagem abaixo:
Após preencher os campos e clicar no botão salvar, selecione a Aba Produtos IXC/MVNO para adicionar os produtos relacionados a integração cadastrada. Clique no botão Novo e você será redirecionado para o formulário Produtos IXC/MVNO.
Clique no botão Buscar plano Integração para que abra o formulário dos produtos relacionados a integração.
Após esta ação os planos deverão ser carregados na grid, então selecione o plano desejado e clique no botão inserir Registro Selecionado.
Agora é necessário adicionar o Produto IXC, se o produto já foi cadastrado selecione o produto referente a integração, caso contrário será necessário realizar o cadastro desse produto para continuar.
Após esta etapa, o formulário de Produtos IXC/MVNO deverá estar semelhante o da imagem abaixo.
após salvar, feche o formulário para visualizar o produto cadastrado.
2. Cadastrando uma linha
Acesse o Menu Sistema > Cadastros > Contratos, selecione o contrato desejado e clique no botão Editar. Na aba Produtos é necessário inserir o Produto Americanet cadastrado e especificar no campo Tipo como MVNO/Telefonia Móvel e clicar em Salvar.
No contrato do cliente selecione a aba linha MVNO e clicar em Novo:
Preencha os campos como do Exemplo:
Alterar na API e no IXC: Funções automáticas de bloqueio e liberação sempre vão realizar a execução da API. Caso o retorno seja de sucesso, as alterações também serão realizadas no IXC.
Ignorar API e Alterar apenas no IXC: Caso marcado a interação só vai ser executada no IXC, este efeito só funciona manualmente para as funções deste formulário.
Integração: Campo para Inserir a integração cadastrada.
Cliente Mvno: Numero identificador gerado automaticamente após salvar;
Produto relacionado: Selecionar o Produto que já está inserido no contrato;
Sim card: Número do cartão repassado pela plataforma, deve conter 20 caracteres;
DDD: Inserir DDD para que seja buscado o número do telefone equivalente ao DDD repassado;
Numero do telefone: Informar o numero que será portado.
Id contrato integração: Id gerado automaticamente, do contrato da linha na plataforma;
Buscar número linha: Ao selecionar o botão, será listado os números disponíveis.
Observações: Caso seja uma linha portada, ficará aguardando aprovação que pode ser acompanhando pela consulta e no status portabilidade, no cadastro da linha.
No botão “Consultar Portabilidade” será gerado um relatório informando mais detalhes da situação, conforme imagem abaixo:
Caso seja recusado a sua portabilidade, será habilitado o campo Data agendamento, onde pode ser enviado novamente a plataforma respeitando o tempo de 3 dias uteis (não será contabilizado finais de semana e/ou feriados).
As informações de portabilidade no IXC Provedor, são atualizadas de acordo com a execução da tarefa Consultar portabilidades. Para cadastrar a tarefa, acesse: Menu Ferramentas > Ferramentas > Agenda de tarefas.
Em seguida, clique no botão Novo. Após realizar esta ação é necessário preencher as seguintes informações:
- Tarefa: Consultar portabilidades;
- Minuto (0-59): Preencher o minuto de execução da tarefa;
- Hora (0-23): Preencher a hora de execução da tarefa;
- Dia do mês (1-31): Selecionando a opção Todos, será executado todos os dias do mês. Clicando em Valor, é possível definir quais dias do mês será executado a tarefa;
- Mês (1-12): Selecionando a opção Todos, será executado todos os meses do ano. Clicando em Valor, é possível definir quais meses será executado a tarefa;
- Dia da semana (0-6) 0 = dom, 1 = seg: Selecionando a opção Todos, será executado todos os dias da semana. Clicando em Valor, é possível definir quais dias da semana será executado a tarefa;
Observações: O sistema não permite editar uma tarefa já criada. Para editá-la, é necessário deletar e cadastrar novamente.