Como podemos ajudar?

O que é o módulo de Telefonia / MVNO

O módulo de Telefonia / MVNO permite que o seu provedor revenda planos de telefonia móvel (chip) para os clientes que já possuem contrato de internet, transformando a telefonia em mais um serviço cobrado dentro do próprio sistema. Na prática, o Quaza se conecta a uma operadora móvel virtual (MVNO) — como Tá Telecom, Bora, Brazmóvel, Gertel ou DryTelecom — e passa a gerenciar, a partir da tela do sistema, todo o ciclo de vida do chip: importação, ativação, troca de plano/número, bloqueio, cancelamento e a cobrança correspondente no contrato do cliente.

Isso significa que o cliente pode contratar internet + celular em um único atendimento, com uma única fatura (ou faturas vinculadas ao mesmo contrato), sem que o provedor precise operar o painel da operadora separadamente para cada ativação.

Cada integração com uma operadora é cadastrada como um Integrador (menu Telefonia > Configurações). É esse cadastro que guarda as credenciais de acesso à operadora (API, usuário/senha, FTP, conforme o caso), define o dia de corte/faturamento e se o sistema deve gerar cobrança automática (Gerar cobranças) para o cliente. Sem um Integrador configurado e ativo, nenhuma das telas abaixo funciona — esse cadastro inicial normalmente é feito pela equipe de implantação da Quaza junto com o suporte da operadora escolhida.

Entendendo as quatro peças do módulo

Antes do passo a passo, vale entender como as telas se relacionam — isso evita confusão na hora de cadastrar algo:

Tela	O que representa	Como é criada
Plano	O "pacote" vendido (franquia de dados/minutos/SMS e valor)	Geralmente importado da operadora; poucos campos são editáveis manualmente
Número	A linha telefônica (o número em si) disponível para uso	Importado da operadora ou obtido por portabilidade
Chip SIM	O SIM card físico (ICCID) que será entregue ao cliente	Importado pelo ICCID e depois ativado no sistema
Usuário (MVNO)	O vínculo entre um Chip/Número e o contrato do cliente no Quaza	Cadastrado manualmente, indicando o cliente/contrato

Ou seja: o Plano e o Número normalmente não são digitados do zero — eles chegam da operadora através do botão Importar. O trabalho do atendente do provedor é, na prática, pegar um chip já importado, vincular a um cliente e ativar.

Passo a passo — Cadastrando um Plano de telefonia

Acesse Telefonia > Planos.

1. Clique em Importar Planos, selecione o Integrador (a operadora) e confirme. O sistema busca automaticamente na operadora todos os planos disponíveis para revenda, com suas franquias e valores já definidos por ela.
2. Depois de importado, abra o plano para revisar/ajustar os campos que o provedor pode alterar por conta própria:
   • Valor padrão — valor que será cobrado do cliente por esse plano (o provedor pode aplicar sua margem aqui).
   • Ilimitado — marque se o plano tem franquia ilimitada de minutos/dados.
   • Serviço (idContratoServico) — o serviço do contrato do cliente ao qual esse plano será associado na hora de gerar a cobrança. É esse campo que faz o sistema saber "em qual linha da fatura" lançar o valor.
   • Descrição — só pode ser editada para integradoras diferentes da Bora (nela a descrição vem travada da operadora).
3. Os demais campos — franquias de minutos por tipo de chamada (local, DDD nacional, internacional e chamadas para outras operadoras/regiões), tarifas e cadência de cobrança — vêm prontos da operadora e ficam somente leitura, pois representam o que foi contratado no atacado junto à MVNO.

Só é possível cadastrar um plano "do zero" pela tela do Quaza em cenários muito específicos de integração; no dia a dia, sempre use Importar Planos.

Passo a passo — Ativando um chip SIM e vinculando a um cliente

1. Cadastrar (ou vincular) o Usuário MVNO ao contrato

Acesse Telefonia > Usuário (MVNO) e adicione um novo registro, informando:

• Integrador — a operadora que fornecerá a linha.
• Cliente / Contrato — o contrato do cliente ao qual o chip será vinculado. O sistema não deixa vincular um usuário a um contrato que não tenha um serviço de telefonia disponível (veja a seção de erros comuns).
• Usuário e Senha — em algumas operadoras (as que exigem login) esses campos são obrigatórios; em outras, ficam ocultos automaticamente.

Esse cadastro é o "elo" entre a operadora e o financeiro do cliente — é a partir dele que o sistema sabe a quem cobrar.

2. Importar o chip pelo ICCID

Acesse Telefonia > Chip (MVNO) e clique em Importar SimCards:

1. Escolha o Integrador.
2. Informe o ICCID do chip (o número de série gravado no próprio cartão SIM). Para operadoras como a Tá Telecom, esse campo nem aparece — a importação é feita diretamente pela integração.
3. Use o botão Importar e Ativar para já seguir direto para a tela de ativação, ou apenas Importar para deixar o chip disponível e ativá-lo depois.

3. Ativar o chip

Com o chip em situação Inativo, abra o registro e clique em Ativar SimCard. No formulário de ativação, informe:

• Contrato do cliente que receberá a linha;
• Plano que será aplicado ao chip;
• DDD desejado para o número;
• se aplicável, se o número é portado de outra operadora (informando o número de origem da portabilidade);
• opcionalmente, se deseja já criar um agendamento de pagamento vinculado a um débito existente do contrato.

Ao confirmar, o sistema fala diretamente com a operadora para efetivar a ativação — em algumas integradoras (como a Bora) isso pode levar alguns minutos e é processado em segundo plano. Após a ativação, o chip passa da situação Inativo para Ativo, já com número e plano definidos.

Importante: se o contrato do cliente ainda não tiver um serviço de telefonia cadastrado para aquele Integrador/Plano, o próprio sistema avisa na tela ("Não foi encontrado no contrato um serviço de telefonia...") e cria automaticamente esse serviço no contrato durante a ativação, com o valor do plano.

4. Gerenciar o chip depois de ativo

Com o chip Ativo, a tela de edição do Chip SIM passa a oferecer, conforme o suporte da operadora, as seguintes ações:

Ação	Para que serve
Atualizar dados	Sincroniza a situação do chip diretamente com a operadora
Troca de usuário	Move o chip para outro cliente/contrato
Troca de número	Troca a linha telefônica associada ao chip
Troca de plano	Muda o plano contratado para aquele chip
Bloqueio parcial	Bloqueia chamadas, SMS e dados móveis, mas o número continua recebendo chamadas/SMS
Bloqueio total	Bloqueia todos os serviços do chip
Desbloquear	Reverte um bloqueio parcial ou total
Cancelar SimCard / plano	Encerra a linha (ou o plano, em operadoras como a Brazmóvel)

Cada operadora habilita um subconjunto dessas funções — o sistema desabilita automaticamente os botões que a operadora escolhida não suporta.

Como consultar o consumo (CDR) de um número

O CDR (Call Detail Record, ou "registro de chamadas") é o extrato detalhado do uso da linha: cada ligação feita/recebida, cada consumo de dados tarifável. Acesse Telefonia > Extrato CDR.

1. Se o CDR ainda não tiver sido trazido automaticamente pela integração, use Realizar Importação, escolhendo o Integrador — o sistema busca o extrato de chamadas do período diretamente na operadora.
2. Use os filtros de número de origem, número de destino e período para localizar o consumo de um cliente específico.
3. Cada linha do extrato mostra: início da chamada, duração (total e a duração efetivamente cobrada, já descontando franquia), valor cobrado, custo, tipo e direção da chamada (entrada/saída).
4. A partir de um registro, é possível abrir diretamente o cliente, o contrato ou o lançamento financeiro relacionado àquela chamada, usando os botões de atalho na tela de edição.
5. Use Gerar Relatório para extrair um relatório de consumo de um usuário em um intervalo de datas específico.

O CDR é a base para o faturamento de minutagem excedente: é a partir dele que o sistema soma as ligações realizadas em cada categoria (local, DDD, internacional, outras operadoras) e calcula o que ultrapassou a franquia do plano.

Como funciona o faturamento do serviço de telefonia

Ao final de cada ciclo (definido pelo dia de corte configurado no Integrador), o sistema fecha, para cada Usuário MVNO, um registro de Faturamento (Telefonia > Faturamento) contendo:

• o valor da franquia do plano (fixo, já incluso na mensalidade);
• a quantidade de minutos consumidos e o valor cobrado por categoria (local, DDD nacional, internacional, outras operadoras) quando o consumo excede a franquia;
• o valor total do período.

Esse registro de Faturamento nasce marcado como não faturado. A partir daí, existem dois caminhos, dependendo da configuração do Integrador e do tipo de fatura do contrato:

1. Cobrança automática: se o Integrador tiver a opção Gerar cobranças habilitada, o sistema já cria a cobrança sozinho ao processar o faturamento.
2. Geração manual: caso contrário, um operador do provedor abre o registro de Faturamento e clica em Gerar venda, escolhendo a forma de pagamento, o tipo de venda e o vencimento — o sistema então cria a venda/débito no financeiro do cliente, associado ao mesmo contrato da internet.

Um ponto importante para o dono do provedor: quando o contrato do cliente usa o modelo de mensalidade por vendas, o valor da telefonia é automaticamente encaixado na próxima fatura junto com a internet — ou seja, o cliente recebe uma única fatura com internet + telefonia. Em contratos com outro modelo de cobrança, o valor pode gerar uma cobrança à parte, vinculada ao mesmo contrato. Em qualquer um dos dois casos, o serviço de telefonia sempre aparece dentro do contrato do cliente (nunca como um cadastro solto), o que permite consultá-lo junto com os demais serviços contratados.

Erros comuns (e como resolver)

Situação	O que está acontecendo	Como resolver
"Usuário e senha são obrigatórios" ao salvar o Usuário MVNO	A operadora escolhida exige login (usuário e senha) para gerenciar a linha, e um dos dois campos ficou em branco	Preencha usuário e senha antes de salvar; se a operadora não exigir login, esses campos nem devem aparecer no formulário
"Não é possível adicionar um usuário para o contrato..., pois não existem serviços VOIP disponíveis"	O contrato do cliente já tem todos os seus serviços de telefonia ocupados por outros usuários/chips, ou não possui nenhum serviço de telefonia cadastrado	Adicione (ou libere) um serviço de telefonia no contrato do cliente antes de vincular um novo chip a ele
Chip sem plano vinculado (aparece o botão "Ativar plano" em vez das opções normais de troca/bloqueio)	O chip está ativo na operadora, mas nenhum plano foi associado a ele — o financeiro não consegue calcular franquia nem cobrança	Abra o chip e use o botão "Ativar plano" para selecionar o plano correspondente
"Este SimCard já possui um plano ativo!"	Foi feita uma tentativa de ativar plano em um chip que já tem plano — nesse caso o caminho correto é "Troca de plano", não "Ativar plano"	Use o botão "Troca de plano" no chip já ativo
"Não é possível desbloquear um SimCard cancelado!"	O chip tem data de cancelamento já efetivada; um chip cancelado não pode voltar a operar	É necessário importar/ativar um novo chip para o cliente, não reaproveitar o cancelado
"Operação indisponível para este integrador!"	A ação clicada (por exemplo, bloqueio parcial ou portabilidade) não é suportada pela operadora escolhida	Verifique quais funções aquela operadora realmente oferece; nem toda MVNO suporta as mesmas operações
"Registro já faturado!" / "Valor da fatura inválido!" ao gerar venda de um Faturamento	O faturamento já foi convertido em cobrança anteriormente, ou o valor a cobrar (total menos franquia) ficou zero/negativo	Confira se a venda já não foi gerada antes de tentar novamente; valores zerados normalmente indicam que o consumo do período não ultrapassou a franquia, então não há o que cobrar à parte

Como o módulo se conecta com o restante do sistema

O módulo de Telefonia/MVNO não é isolado — ele depende diretamente de outras partes do Quaza e alimenta informações nelas:

• Contrato do cliente: todo Usuário MVNO (e, por consequência, todo chip ativado) está sempre amarrado a um contrato específico. É no contrato que fica registrado o serviço de telefonia contratado, com seu valor.
• Fatura/Financeiro: os registros de Faturamento geram vendas e débitos no financeiro do cliente, na mesma lógica usada para os demais serviços (internet, equipamentos, etc.), podendo compor a mesma fatura mensal.
• Cadastro do cliente: a partir da tela de Chip, Usuário ou CDR, é possível abrir diretamente o cadastro do cliente e do contrato relacionado, facilitando o atendimento e a conferência de cobrança.

Em resumo: o fluxo natural é Plano importado → Chip importado → Usuário MVNO vinculado ao contrato → Ativação do chip → Consumo registrado via CDR → Faturamento gerado e lançado no contrato do cliente.