# Linha Telefonia Móvel MVNO

## Introdução
O formulário **Linha Telefonia Móvel MVNO** é uma ferramenta essencial para gerenciar e controlar as linhas telefônicas móveis virtuais (MVNO - Mobile Virtual Network Operator) no sistema. Ele permite o cadastro, monitoramento e administração eficiente das linhas MVNO, facilitando o controle de ativação e desativação de linhas, além de fornecer informações cruciais para a gestão do serviço.

> [!NOTA] **Acesso ao Formulário**
> **Caminhos:**
> - Sistema > MVNO/Telefonia móvel > Assinantes
> - Sistema > Cadastros > Contratos > Linha telefonia móvel (Linha MVNO)

### Requisitos de Uso
Para fazer uso deste formulário adequadamente, é necessário possuir uma [[integracoes mvno telefonia movel|Integrações MVNO Telefonia Móvel]] cadastrada em seu sistema.

>[!example] MVNOs que são compatíveis com o sistema:
>- [[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 - 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]]
>- [[integracao de telefonia movel - tip ta telecom|Integração de Telefonia Móvel - TIP Tá Telecom]]

## Entrega de Valor
- Permite o gerenciamento de linhas telefônicas através do uso de uma [[integracoes mvno telefonia movel|Integrações MVNO Telefonia Móvel]];
- Permite a criação, edição e gerenciamento de linhas MVNO pelo sistema;
- Promove a centralização das informações sobre linhas MVNO;
- Facilidade na ativação e desativação de linhas;
- Permite iniciar o processo de portabilidade de linhas diretamente pelo IXC;
- Integração com outros módulos do sistema para faturamento e atendimento ao cliente;
- Geração de relatórios detalhados sobre o uso e desempenho das linhas MVNO.


## Estrutura do Formulário
O formulário de Linha Telefonia Móvel MVNO é uma interface central para o gerenciamento de linhas de telefonia móvel virtual. Ele permite que os usuários realizem uma variedade de operações, desde a criação de novas linhas até a consulta de saldos e iniciação de processos de portabilidade.

O formulário está organizado em uma grid que reúne todos os registros de cadastros de linhas de telefonia móvel. Ela é dedicada ao gerenciamento e visualização das linhas cadastradas, permitindo cadastrar novas linhas se acessar ao contrato, editar e visualizar as linhas já criadas. Esta grid está configurada em colunas, apresentando ordenadamente as informações de ID, ID contrato, SimCard, Portabilidade, Status Portabilidade, DDD, Número Telefone, Produto, Integração e ID linha integração.

A grid é disposta na estrutura descrita na tabela abaixo:

|Campo|Descrição|
|---|---|
|ID|Identificação única da linha telefônica no sistema.|
|ID contrato|Identificação do contrato associado à linha telefônica.|
|Status Linha|Estado atual da linha telefônica (ex.: Ativo, Bloqueado, Cancelado).|
|Simcard|Número do SIM card associado à linha telefônica.|
|Portabilidade|Indica se a linha veio de portabilidade (Sim/Não).|
|Status Portabilidade|Estado atual do processo de portabilidade (ex.: Concluído, Aguardando, Recusado).|
|DDD|Código de área da linha telefônica.|
|Número Telefone|Número de telefone associado à linha.|
|Produto|Identificação do produto relacionado à linha telefônica.|
|Integração|Número ou código da integração associada à linha.|
|ID linha integração|Identificação da linha de integração no sistema.|
É possível acessar o cadastro individual de cada linha clicando no registro correspondente. Para cadastrar uma nova linha (acessando pelo contrato do cliente), é necessário selecionar o botão **Novo**. Para editar um registro já existente, basta selecionar o registro desejado e clicar no botão **Editar**. Em ambas as situações, o direcionamento será para o formulário de Linha Telefonia Móvel MVNO, ele possui uma única aba, denominada por **Linha MVNO**.

Ao acessar este formulário, o sistema apresenta os principais campos relacionados à linha.

### Aba Linha MVNO
Esta aba contém os campos principais para o gerenciamento da linha MVNO.
#### Campos Principais

|Campo|Descrição|
|---|---|
|**ID**|Identificador único da linha MVNO|
|**Contrato**|ID do contrato vinculado à linha MVNO|
|**Integração**|ID da integração associada à linha MVNO|

#### Campos adicionais
Os campos adicionais são descrições essenciais e necessárias para o bom funcionamento da integração e cadastramento correto da linha MVNO. São eles:

> [!INFO] Atenção:
> Os campos adicionais podem variar de acordo com a [[integracoes mvno telefonia movel|Integrações MVNO Telefonia Móvel]]. Cada plataforma exige dados específicos para o cadastramento de linhas, portanto, atente-se aos dados necessários apresentados 

- Produto relacionado;
- eSim;
- Link eSim;
- Simcard;
- Portabilidade, se sim ou não;
- Número do telefone;
- ID contrato integração (retorno da plataforma);
- Dia de recorrência;
- Status da linha (segue status do contrato ou conforme alteração manual na linha MVNO).

## Caso de Uso

### Ativação e gerenciamento de nova linha MVNO

1. Acesse menu **Sistema** e clique em **Cadastros**;
2. Selecione a opção **Contratos** e cadastre um novo contrato ou então edite o cadastro do cliente que está contratando este serviço;
3. Vincule o produto de telefonia associado à integração ao contrato do cliente;
4. Acesse a aba Linha MVNO e clique sobre o botão **Novo**;
5. Preencha o campo **Integração** com a [[integracoes mvno telefonia movel|Integrações MVNO Telefonia Móvel]] já cadastrada no sistema, para que os campos exigidos para o cadastro da linha sejam liberados;
6. Preencher os demais campos respectivos ao cadastro da linha MVNO e clicar em **Salvar**.

A nova linha MVNO será cadastrada e vinculada ao contrato correspondente. Isso permitirá o controle de acesso conforme as ações do contrato, como bloqueio, liberação, controle de inadimplência e ações manuais realizadas diretamente na linha. 

## Funcionalidades principais
- Cadastro de novas linhas MVNO;
- Ativação e cancelamento de linhas;
- Troca de titularidade da linha;
- Alteração de planos;
- Monitoramento de consumo de dados;
- Integração com módulo de faturamento;
- Gestão de estoque de chips.

## Fluxo de Trabalho

```mermaid
graph TD
    A[Início] --> C[Cadastrar Nova Linha]
    C --> E[Definir Plano]
    E --> F[Ativar Linha]
    F --> G[Gerenciamento/monitoramento do contrato]
    G --> H{Necessita Alteração?}
    H -->|Sim| I[Alterar Plano/Status]
    H -->|Não| J[Prosseguir Gerenciamento/monitoramento do contrato]
    I --> G
```

## Considerações Finais
O formulário de Linha Telefonia Móvel MVNO é uma ferramenta fundamental e versátil para o gerenciamento de linhas de telefonia móvel virtual. Sua integração com APIs externas e funcionalidades avançadas permitem um controle eficiente e preciso das operações MVNO.

## Etiquetas
#Integracoes #IntegracoesMVNO #IntegracoesDeTelefoniaMovel #MVNO #LinhasMVNO 

## Leia Também
- [[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]]
- [[relatorio mvno|Relatório MVNO]]
- [[aba linha mvno - contrato do cliente|Aba Linha MVNO - Contrato do Cliente]]
- [[trocar titularidade - mvno|Trocar titularidade - MVNO]]
- [[consulta manual de portabilidade - mvno|Consulta manual de portabilidade - MVNO]]
- [[status de portabilidade de linhas mvno|Status de Portabilidade de Linhas MVNO]]
- [[consulta manual de portabilidade - mvno|Consulta manual de portabilidade - MVNO]]
- [[tarefa - consultar portabilidade|Tarefa - Consultar Portabilidade]]