# Aba Linha MVNO - Contrato do Cliente

## Introdução
A aba **Linha MVNO** é uma funcionalidade integrada ao contrato do cliente que permite gerenciar informações relacionadas a serviços de telefonia móvel virtual (MVNO - Mobile Virtual Network Operator). O formulário de **Linha MVNO** no contrato do cliente permite realizar a ativação do ramal, controlar o acesso e gerar o faturamento, unificando com o serviço de internet.

> [!NOTA] Acesso à Aba Linha MVNO
> Caminho: Cadastros > Contratos > Editar Contrato > Aba Linha MVNO

### Requisitos de uso 
- Integração com uma plataforma de telefonia móvel (MVNO).

>[!EXAMPLE] Plataformas compatíveis:
>- [[integracao de telefonia movel - americanet|Integração de Telefonia Móvel - Americanet]]
>- [[integracao de telefonia movel - brazmovel|Integração de Telefonia Móvel - Brazmóvel]]
>- [[integracao de telefonia movel - contel|Integração de Telefonia Móvel - Contel]]
>- [[integracao de telefonia movel - controlcell|Integração de Telefonia Móvel - Controlcell]]
>- [[integracao de telefonia movel - eai|Integração de Telefonia Móvel - Eaí]]
>- [[integracao de telefonia movel - surf (class-systems)|Integração de Telefonia Móvel - Surf (Class-Systems)]]
>- [[integracao de telefonia movel - telecall|Integração de Telefonia Móvel - Telecall]]
>- [[integracao de telefonia movel - tgn|Integração de Telefonia Móvel - TGN]]
>- [[integracao de telefonia movel - tip brasil|Integração de Telefonia Móvel - TIP Brasil]]

## Entrega de Valor
- Centralização das informações de telefonia móvel no contrato do cliente;
- Facilita a gestão de serviços MVNO oferecidos pela empresa;
- Permite acompanhamento detalhado do uso e status das linhas móveis;

>[!INFO] Espelhamento:
>As linhas MVNO são cadastradas no sistema e a partir da integração, são espelhadas na plataforma integrada. Portanto, os dados irão coexistir no sistema e na plataforma integrada ao que se refere a ativação da linha e controle de acesso.

## Estrutura da Aba Linha MVNO

O formulário de **Linha MVNO** está relacionado ao [[formulario contrato do cliente|Contrato do Cliente]], em uma aba específica com a nomenclatura **Linha MVNO**. Esta aba permite a ativação de novas linhas e gerenciamento de linhas já cadastradas, bem como sua inativação, troca de titularidade, portabilidade e cancelamento.

>[!Caution] Atenção:
>Verifique as configurações individuais para cada plataforma de **Integração MVNO**, algumas configurações podem não estar disponíveis para todas as integrações.

A aba Linha MVNO está organizada em uma aba principal: **[[linha telefonia movel mvno|Linha Telefonia Móvel MVNO]]** **. Esta aba se relaciona com outros módulos:
- [[formulario contrato do cliente|Contrato do Cliente]]
- [[integracoes|Integrações]]
- [[integracoes mvno telefonia movel|Integrações MVNO Telefonia Móvel]]
- [[produtos ixc - mvno|Produtos IXC - MVNO]]
- [[dados adicionais mvno|Dados Adicionais MVNO]]
- [[trocar titularidade - mvno|Trocar titularidade - MVNO]]

### Campos Principais

| Campo               | Descrição                                                                                                                                                                                                                                                                                                   |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID                  | Identificador único da linha, gerado automaticamente pelo sistema                                                                                                                                                                                                                                           |
| API                 | Possibilidade de realizar alterações comunicando ou não a integração. A opção **Alterar na API e no IXC** permite efetuar alterações no IXC e na plataforma simultaneamente, já a opção **Ignorar API e alterar apenas no IXC** não comunica a plataforma integrada e realiza alterações somente no sistema |
| Integração          | Identificador da [[integracoes mvno telefonia movel|Integrações MVNO Telefonia Móvel]] cadastrada no sistema, estabelece a comunicação da linha com a plataforma                                                                                                                                                                         |
| Produto relacionado | Produto de MVNO relacionado à linha, define o plano que o cliente consumirá                                                                                                                                                                                                                                 |
| SIM Card            | Numeração do chip de rede móvel                                                                                                                                                                                                                                                                             |
| DDD                 | DDD (Discagem Direta à Distância) do número de telefone. É um código de dois números que identifica um estado/cidade no território nacional                                                                                                                                                                 |
| Portabilidade       | Indica se a linha é proveniente de portabilidade (linha já existente em outra operadora) ou se é uma nova linha                                                                                                                                                                                             |
| Número de telefone  | Número de telefone da linha                                                                                                                                                                                                                                                                                 |
| Dia recorrência     | Dia de recorrência da linha, quando o plano será renovado                                                                                                                                                                                                                                                   |

### Funcionalidades principais
- **Adicionar Nova Linha**: Permite associar uma nova linha MVNO ao contrato do cliente
- **Editar Linha**: Possibilita a atualização de informações da linha existente
- **Gerenciamento de status da linha:** Opções para gerenciar o status da linha diretamente pelo contrato ou por ações manuais da linha. Entre os status da linha, estão: 
	- **Ativa:** linha está ativa e o consumo permanece; 
	- **Bloqueio Roubo:** altera o status da linha para Bloqueio roubo, interrompendo totalmente o consumo do cliente devido ao dispositivo/simcard ter sofrido roubo;
	- **Bloqueio perda:** altera o status da linha para Bloqueio roubo, interrompendo totalmente o consumo do cliente devido à perda do simcard/dispositivo;
	- **Bloqueio parcial:** altera o status da linha para **Bloqueio parcial**, interrompendo parcialmente o consumo do cliente;
	- **Inativo:** linha inativa decorrente de cancelamento;
	 - **Bloqueio uso indevido:** realiza a alteração do status da linha para **Bloqueio Uso Indevido**, interrompendo totalmente o consumo do cliente por ser identificado mau uso do simcard;
	- **Bloqueio total:** realiza a alteração do status da linha para Bloqueio total, interrompendo totalmente o consumo do cliente.
	- **Cancelada:** altera o status da linha para **Cancelada**, efetuando o cancelamento total e permanente da linha;
	- **Aguardando ativação:** em casos de linhas portadas, a linha assume o status de **Aguardando ativação** até a portabilidade ser consultada através da [[tarefa - consultar portabilidade|Tarefa - Consultar Portabilidade]] ou mediante [[consulta manual de portabilidade - mvno|Consulta manual de portabilidade - MVNO]].
	
- **Gerenciamento de portabilidade:** é possível realizar a ativação de linhas portadas a partir do IXC, quando a linha for criada, assume o status de Aguardando Ativação e status de portabilidade Aguardando, podendo assumir os demais status de acordo com o andamento da portabilidade:
	- **Recusado:** a portabilidade foi recusada pela operadora;
	- **Concluído:** a portabilidade foi concluída pela operadora;
	- **Cancelado:** a portabilidade teve o processo interrompido e por este motivo, foi cancelada.
	
- **Histórico de Consumo**: Visualização do histórico de uso de dados, minutos e SMS (consultar integrações que possuem esta disponibilidade).

>[!CAUTION] Atenção:
>As funcionalidades podem variar de acordo com cada plataforma.

## Casos de Uso

### Ativação de Linha MVNO
A ativação de linhas de MVNO variam de acordo com a plataforma contratada. O processo geral de cadastro de linha ocorre da seguinte forma:

>[!CAUTION] Importante:
>Consulte o material individual de cada integração para garantir uma operação correta e a ativação de linhas adequada, considerando as limitações e recursos disponíveis para cada tipo de integração.

1. Acesse o contrato do cliente;
2. Navegue até a aba **Linha MVNO**;
3. Clique no botão **Novo**;
4. Preencha os campos obrigatórios e campos adicionais, como o campo Integração, Produto relacionado, SIM Card, se é uma portabilidade, número de telefone e demais informações relevantes;
5. Confirme a ativação clicando no botão **Salvar**.


## Fluxos de Trabalho

```mermaid
graph TD
    A[Acessar Contrato do Cliente] --> B[Abrir Aba Linha MVNO]
    B --> C{Linha Existente?}
    C -->|Sim| D[Gerenciar Linha]
    C -->|Não| E[Adicionar Nova Linha]
    D --> F[Editar Informações]
    D --> G[Alterar Status]
    D --> H[Verificar Consumo]
    E --> I[Preencher Dados]
    I --> J[Ativar Linha]
```

## Considerações Finais
A aba Linha MVNO no contrato do cliente oferece uma solução integrada para gerenciar serviços de telefonia móvel virtual. Ela simplifica processos como ativação, monitoramento e manutenção de linhas MVNO, proporcionando uma visão unificada dos serviços contratados pelo cliente.

## Etiquetas
#LinhasMVNO #ContratoCliente #TelefoniaMovel #Contratos 

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes mvno telefonia movel|Integrações MVNO Telefonia Móvel]]
- [[formulario contrato do cliente|Contrato do Cliente]]
- [[integracao de telefonia movel - americanet|Integração de Telefonia Móvel - Americanet]]
- [[integracao de telefonia movel - braz movel|Integração de Telefonia Móvel - Braz Móvel]]
- [[integracao de telefonia movel - contel|Integração de Telefonia Móvel - Contel]]
- [[integracao de telefonia movel - controlcell|Integração de Telefonia Móvel - Controlcell]]
- [[integracao de telefonia movel - eai|Integração de Telefonia Móvel - Eaí]]
- [[integracao de telefonia movel - surf (class-systems)|Integração de Telefonia Móvel - Surf (Class-Systems)]]
- [[integracao de telefonia movel - telecall|Integração de Telefonia Móvel - Telecall]]
- [[integracao de telefonia movel - tgn|Integração de Telefonia Móvel - TGN]]
- [[integracao de telefonia movel - tip brasil|Integração de Telefonia Móvel - TIP Brasil]]
- [[trocar titularidade - mvno|Trocar titularidade - MVNO]]
- [[produtos ixc - mvno|Produtos IXC - MVNO]]
- [[tarefa - consultar portabilidade|Tarefa - Consultar Portabilidade]]
- [[consulta manual de portabilidade - mvno|Consulta manual de portabilidade - MVNO]]