# Tarefa - Consulta Ativação Linha MVNO (Beta)

## Introdução

>[!tip] Atenção!
>Este conteúdo está presente na **versão [[clientes beta ixc soft|Beta]]** do sistema.
>A disponibilidade desta integração na **versão Estável** será a partir de Abril de 2025.

---

Tarefa de **Consulta Ativação Linha MVNO** é uma funcionalidade essencial para acompanhar o processo de ativação de números telefônicos em operações de Operadora Móvel Virtual (MVNO) ao utilizar a integração [[integracao de telefonia movel - play movel|Play Móvel]]. Essa rotina é responsável por verificar se a linha foi aprovada pela plataforma ou recusada e, portanto, atualizar o status da linha no Sistema IXC.

> [!NOTA] **Acesso à Configuração**
>  **Caminho:** Ferramentas > Ferramentas > Agenda de tarefas > **Tarefa Consultar Portabilidades**

## Entrega de Valor
- Automatização da consulta de status de linhas;
- Atualização em tempo real das informações no sistema;
- Redução de erros manuais e inconsistências de dados;
- Otimização do tempo da equipe operacional;
- Melhoria na gestão de recursos de numeração.

## Funcionamento da Tarefa
Quando executada, a tarefa de Consulta Ativação Linha MVNO realiza as seguintes ações:

1. Identifica todas as linhas no sistema que estão em processo de ativação
2. Consulta o status atual de cada linha na plataforma de integração MVNO
3. Atualiza o status das linhas no Sistema de acordo com as informações obtidas
4. Registra as alterações no log do sistema para auditoria

Quando uma linha MVNO é cadastrada no sistema, a Play Móvel verifica se ela pode ser ativada. Enquanto essa ativação não é concluída, a linha permanece com o status de **Aguardando Ativação**. Nesse contexto, a tarefa **Consultar Linha Ativa MVNO** tem a função de validar, na plataforma, se a linha já está apta para ativação. Executada periodicamente, essa tarefa ativa as linhas automaticamente após o cadastro. Para garantir que o processo de ativação ocorra corretamente, é necessário cadastrar a tarefa no sistema. Siga as etapas abaixo:

## Configuração
Para realizar a configuração da tarefa, siga os passos abaixo:

1. Acesse o menu Ferramentas > Agenda de Tarefas > Novo.
2. No campo **Tarefa**, selecione a opção **Consulta ativação linha MVNO**.
3. Configure o horário de execução:
	  - No campo **Minuto**, indique o minuto em que a tarefa será executada. Marque a opção **Valor** e insira um número entre 0 e 59;
	   - No campo **Hora**, marque a opção **Valor** e insira um número entre 0 e 23;
	     
4. Nos campos **Dia do mês** e Mês, **selecione** a opção **Todos**.
5. No campo **Dia da semana**, defina o período em que as linhas poderão ser ativadas:
	  - Para execução diária, selecione **Todos**;
	   - Para definir um intervalo específico, insira os dias separados por traço; Por exemplo: 1-5 (segunda a sexta-feira);
	
6. Clique em **Salvar** para concluir o cadastro da tarefa.

> [!info] **Importante:**  
> Recomenda-se que o horário de execução seja definido de acordo com o volume e a frequência de cadastro de linhas. Por exemplo, se novas linhas forem cadastradas com frequência ao longo do dia, configure a tarefa para ser executada em intervalos regulares. Para isso, no campo **"Hora"**, utilize a estrutura `*/1` (para execução a cada 1 hora) ou ajuste conforme necessário.


## Fluxo de Trabalho
```mermaid
graph TD
    A[Ativação da linha solicitada] --> B[Execução da Tarefa de Consulta Ativação Linha MVNO]
    B --> C{Plataforma aprovou a ativação da linha?}
    C -->|Sim| D[Linha ativa e status atualizado]
    C -->|Não| E[Ativação recusada]
```

## Considerações Finais
A tarefa agendada de Consulta Ativação Linha MVNO é uma ferramenta crucial para manter a integridade e atualidade dos dados de portabilidade no Sistema. Sua configuração adequada e monitoramento regular garantem uma gestão eficiente das linhas móveis e uma melhor experiência para os clientes durante o processo de ativação de linhas.

## Etiquetas
#Integracoes #IntegracoesMVNO #IntegracaoMVNOPlayMovel #TarefaAgendada #MVNO #Portabilidade #Automacao #IntegracaoTelefoniaMovel 

## Leia também
- [[integracoes|Integrações]]
- [[integracoes mvno telefonia movel|Integrações de MVNO]]
- [[integracao de telefonia movel - play movel|Integração MVNO - Play Móvel]]
- [[agenda de tarefas|Agenda de Tarefas]]
- [[logs de tarefas|Logs de Tarefas]]