# Integrações TV - Panaccess

## Introdução

>[!TIP] Definição - Panaccess:
> A Panaccess é uma plataforma de transmissão de TV e processamento de sinais que oferece um amplo leque de serviços de conteúdo audiovisual ao seu provedor. Isso inclui acesso a filmes, séries, programas de TV, esportes, documentários e uma variedade de outros conteúdos, todos disponíveis online.

A integração entre a Panaccess e o Sistema foi desenvolvida para aprimorar a gestão de serviços de telecomunicações e conteúdo digital, oferecendo uma plataforma unificada para provedores de internet. Com esta solução, sua empresa consegue:
- Simplificar a administração dos serviços de TV e streaming;
- Unificar todos os dados do provedor em um único ambiente;
- Otimizar o gerenciamento de clientes e fluxo de receitas;
- Automatizar o monitoramento e controle de inadimplência.

> [!NOTA] **Acesso ao Formulário**
> **Caminho:** Configurações > Integrações > Integrações TV

### Requisitos de Uso
Para utilizar este recurso no sistema, é necessário atender as seguintes condições:
- Possuir uma conta ativa na Panaccess;
- Obter os dados de acesso API para realizar o cadastro da integração no sistema.

## Entrega de Valor
- Alinhar as necessidades dos clientes que utilizam streaming e TV por assinatura com a plataforma Panaccess;
- Centralizar as informações do provedor em um único local e facilitar o gerenciamento de inadimplentes, gestão de clientes e faturamento mensal.
- Simplificação do processo de ativação e manutenção de clientes;
- Otimização do controle de inadimplência.

## Configuração da Integração

>[!TIP] Credenciais:
>Assim que o seu provedor (ISP) realizar o credenciamento junto a plataforma citada, serão fornecidos os dados necessários para realizar a integração com o ERP IXC Soft. A partir destes dados, é possível realizar o cadastramento da integração no IXC, conforme o material a seguir.

### Passo 1: Cadastro da Integração
Neste passo, é efetuado o cadastro da integração. Este processo permite a comunicação e troca de dados entre o sistema e a plataforma Panaccess.

1. Acesse o formulário [[integracoes|Integrações]] através do caminho: Configurações > Integrações;
2. Clique em **Integrações TV**;
4. Pressione o botão **Novo**;
5. Selecione **Panaccess** no campo **Plataforma**;
6. Preencha os campos:
	- **Ambiente:** defina se a integração encontra-se em produção (uso ativo de disponibilização ao cliente) ou em homologação (testes);
	- **URL acesso:** insira a URL fornecida pela plataforma, essa URL será necessária para estabelecer a comunicação entre as duas plataformas e é o destino do qual o IXC irá enviar as informações cadastradas;
	- **Token acesso:** token fornecido pela plataforma;
	-  **Login TV:** refere-se à informação usuário API, informação fornecida pela plataforma;
	- **Senha TV:** refere-se à informação de senha do usuário API, informação fornecida pela plataforma;
	- **HC (Head Control):** código da licença do provedor, adquirida com a plataforma;
	- **Sessão:** preenchido automaticamente com a chave da sessão ao realizar a importação dos produtos.
	  
7. Clique em **Salvar** para estabelecer a comunicação entre o IXC e a plataforma e para concluir o cadastro da integração.

### Passo 2: Importação dos Pacotes Panaccess
A plataforma Panaccess atua com os produtos disponibilizados aos clientes através do cadastramento de pacotes na plataforma. Para a disponibilização destes pacotes ao usuário final a partir do vínculo com o produto, é necessário realizar a importação destes pacotes a partir de uma tarefa, visando a sincronização destes dados entre as plataformas envolvidas. A tarefa Importar Produtos Panaccess TV é responsável pela importação, e pode ser configurada realizando o seguinte processo:

1. Acesse o formulário de **Agenda de tarefas** através do caminho: Ferramentas > Ferramentas > Agenda de tarefas;
2. Clique no botão **Novo** para cadastrar a tarefa;
3. No campo **Tarefa**, selecione a opção **Importar Produtos Panaccess TV**;
4. Preencha o horário em que a tarefa executará a partir dos campos de Minuto e Hora. No campo **Minuto**, indique o minuto em que a tarefa executará, correlacionando ao campo de hora. No campo **Hora**, indique o horário em que a tarefa executará;
   
>[!QUOTE] **Exemplo:** 
>Para que uma tarefa execute as 7h30, insira o número 7 no campo **Hora** e o número 30 no campo **Minuto**.

5. Na seção **Dia do mês**, insira no campo **Valor** o intervalo "1-31" para que o sistema execute a tarefa todos os dias do mês;
6. Na seção **Mês**, insira no campo **Valor** o intervalo "1-12" para que o sistema execute a tarefa todos os meses;
7. Na seção **Dia da semana**, insira no campo **Valor** o intervalo "0-6" para que o sistema execute a tarefa todos os dias da semana.
5. Após preencher os campos, clique em **Salvar** para validar a criação da tarefa;
6. Execute a tarefa para efetuar a sincronização dos pacotes, o sistema irá buscar as informações dos produtos liberados pela Panaccess, possibilitando o cadastro dos produtos. Para isso, clique em **Listar** para verificar a tarefa criada, localize-a na agenda de tarefas e clique em **Executar Tarefa**.

Após efetuar a importação dos pacotes de TV, os produtos importados estarão disponíveis para visualização e edição no formulário de [[tv pacotes|TV Pacotes]].

>[!Nota] Acesso ao formulário [[tv pacotes|TV Pacotes]]
>**Caminho:** Sistema > Cadastros > pasta TV > Pacotes TV

### Passo 3: Configuração do Produto de TV
O cadastro do produto de TV é essencial para a gestão do produto no contrato, faturamento e também para permitir a ativação do usuário TV, pois o produto se relaciona com a integração pelos pacotes disponibilizados pela plataforma.

>[!INFO] Importante:
>O cadastro do produto no sistema é respectivo ao pacote disponível para a plataforma.

1. Acesse o formulário de [[cadastro de produtos|Cadastro de Produtos]] através do caminho: Sistema > Cadastros > Produtos;
2. Pressione o botão **Novo**;
3. Preencha os campos obrigatórios na aba **Produtos** e na aba **Planejamento**;
4. Acesse a aba **TV**;
5. No campo **Plataforma**, selecione a opção **Panaccess**;
6. Preencha os campos:
	- **ID integração:** clique na lupa e selecione a plataforma de TV cadastrada no sistema;
	- **Produtos disponíveis:** clique no botão de seleção e selecione o produto que será ofertado ao cliente. Será apresentada uma lista dos pacotes importados ao sistema, sendo os mesmos pacotes disponibilizados e cadastrados na plataforma Panaccess.
	
9. Clique em **Salvar** para validar e finalizar o cadastro do produto.

### Passo 3:  Produto no Contrato
Para realizar a gestão do contrato efetivamente, é necessário vincular o produto de TV ao contrato. Esta ação permite realizar a geração do faturamento, emitir notas fiscais e também efetuar ativação do usuário TV associado à integração. Esta ativação pode ocorrer diretamente pelo contrato ou por [[formulario planos de venda|Formulário Planos de Venda]].

1. Acesse o [[formulario contrato do cliente|Formulário Contrato do Cliente]] através do caminho: Sistema > Cadastros > Contratos;
2. Selecione o contrato do cliente do qual deseja incluir o produto no contrato;
3. Pressione o botão **Editar** para acessar o contrato;
4. Navegue até a aba **Produtos** e clique no botão **Novo**. Defina o tipo do produto como **TV/Streaming** e no campo **Produto/Serviço**, clique na lupa e selecione o produto de TV cadastrado. Clique em **Salvar** para validar as configurações.

### Passo 4: Cadastro do Assinante e Ativação do [[smartcard panaccess|SmartCard Panaccess]]
A ativação do usuário TV consiste em criar as credenciais de acesso para o usuário final e associar o SmartCard correspondente. A partir da ativação, o usuário TV obtém acesso à plataforma e aos produtos disponibilizados 

>[!Tip] Acesso do assinante ao produto:
>O acesso do assinante é baseado no vínculo do produto no contrato. Portanto, ao realizar a associação do produto no contrato do cliente, uma vez que ele esteja relacionado ao seu respectivo pacote na plataforma, será disponibilizado o produto a partir da ativação do usuário TV/SmartCard.

#### Ativação do Assinante

1. Ainda no contrato do cliente, navegue até a **aba TV**;
2. Clique no botão **Novo** e preencha os campos apresentados:
	- **Plataforma:** no botão de seleção, selecione a opção Panaccess;
	- **ID integração:** clique na lupa e selecione o cadastro da integração 
	- **Tipo de tecnologia TV:** defina o tipo de tecnologia do produto;
	- **Account ID:** campo preenchido automaticamente ao estabelecer a comunicação do login após salvá-lo. É o ID do usuário TV na plataforma;
	- **Portal:** clique em **Buscar portal** para definir o portal de acesso deste usuário TV;
	
4. Após preencher os campos, clique em **Salvar** para validar as modificações e efetivar a criação do usuário TV.

#### Associação do [[smartcard panaccess|SmartCard Panaccess]]

>[!INFO] **Definição SmartCard:**
>Um **SmartCard**, ou cartão inteligente em português, é um dispositivo portátil que contém um microprocessador incorporado e é projetado para armazenar, processar e fornecer informações de maneira segura.<br> 
>Um SmartCard para TV, é um cartão inteligente para sistemas de televisão por assinatura e tem como objetivo autenticar o usuário, desbloqueando canais para os quais o usuário tem direito, com base no pacote de assinatura que adquiriu.

1. Ainda no formulário de Usuário TV, acesse a aba **SmartCard** para vincular o SimCard ao assinante;
2. Na aba SmartCards, clique no botão **Novo**;
3. Preencha os campos:
	- **SmartCard (obrigatório):** clique no botão **Buscar SmartCard** e selecione uma das opções apresentadas;
	- **Validade (obrigatório):** indique uma quantidade numérica em unidade de medida de meses para definir a validade de acesso deste cartão;
	- **Status:** preenchido automaticamente de acordo com o acesso e uso do cartão.
	  
4. Clique em **Salvar** para finalizar a criação do usuário TV e ativação do SimCard.

>[!TIP] **Controle de acesso:**
> **Ativar/Desativar**: É possível realizar a ativação e desativação do assinante a partir do botão de ação **Ativar/Desativar**, gerenciando o acesso do usuário; <br>
> **Deletar:** É possível inativar um SimCard a partir da sua deleção, a partir do botão de ação **Deletar**, excluindo o registro do sistema.

Após realizar a ação de todos os passos, o usuário TV estará pronto para uso. O controle de acesso é feito diretamente pelas ações do contrato (bloqueio e liberação).

>[!Caution] **Lembrete:**
>Depois de criado o login, o sistema não permitirá sua edição.

## Casos de Uso

### Ações do contrato
A integração com a plataforma da Panaccess valida ações sobre o contrato, impactando no acesso do usuário TV, permitindo o controle de acesso pelo sistema e espelhando na plataforma credenciada.
#### Controle de acesso do usuário TV a partir do status do contrato:

A integração com a plataforma Panaccess valida as seguintes ações sobre o contrato, impactando no acesso do usuário TV. Estas ações incluem:

- **Aviso de atraso/Financeiro em atraso:** a integração com a plataforma Panaccess não valida o status do contrato em atraso por inadimplência, portanto, o acesso do login TV permanece **ativo**.

- **Bloqueio manual ou automático:** em casos de bloqueio automático ou manual devido inadimplência, o login TV terá seu acesso interrompido de **bloqueio total**.
  
- **Liberação automática:** ocorre sob pagamento, no momento em que o contrato é ativado, liberando o acesso à plataforma.
  
- **Liberação manual:** o login volta a constar como online e libera o acesso à plataforma.
  
- **Cancelamento**: ao cancelar o contrato, o login TV será inativado.
  
- **Deleção**: a integração valida deleção. Se o usuário TV for deletado no IXC, será deletado na plataforma.

>[!DANGER] **Atenção:**
>Evite deletar um usuário TV diretamente pelo painel de controle da Panaccess. A comunicação entre as plataformas ocorre apenas de IXC Provedor para a Panaccess, portanto, alterações feitas na plataforma não serão consideradas no IXC Provedor.  
> 
> Em caso de deleção do usuário TV, o sistema perderá a comunicação com a plataforma e não permitirá mais alterações no usuário TV através do IXC.

## Considerações Finais
A integração **Panaccess** com o sistema oferece uma solução robusta para provedores de internet, simplificando a gestão de serviços de TV e streaming. Esta tecnologia melhora a eficiência operacional, reduz erros de informação e proporciona uma experiência superior aos clientes.

## Etiquetas
#Integracoes #IntegracoesTV #IntegracaoPanaccess #Panaccess   #SmartCard 

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes de tv|Integrações de TV]]
- [[integracoes tv - panaccess|Integrações TV - Panaccess]]
- [[smartcard panaccess|SmartCard Panaccess]]
- [[tarefa - importar produtos panaccess tv|Tarefa - Importar Produtos Panaccess TV]]
- [[formulario contrato do cliente|Formulário Contrato do Cliente]]
- [[cadastro de produtos|Cadastro de Produtos]]
- [[aba - tv - contrato do cliente|Aba TV - Contrato do cliente]]
- [[tv pacotes|TV Pacotes]]