# Integrações TV - ITTV

## Introdução

>[!TIP] O que é a ITTV?
> A ITTV é uma plataforma de TV com conteúdo **on demand** com foco em provedores, que oferece um amplo leque de serviços de conteúdo audiovisual ao seu negócio. 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 ITTV com o Sistema visa otimizar a oferta de serviços de comunicação e multimídia, centralizando informações e fornecendo uma solução completa para provedores de internet. Esta integração permite:

Este guia aborda a integração entre os serviços ITTV e o Sistema, permitindo uma gestão eficiente e centralizada de serviços de streaming e TV para provedores de internet.

- Gerenciamento facilitado de serviços de TV e streaming;
- Centralização de informações do provedor;
- Gestão eficiente de clientes e receitas;
- Controle automatizado de inadimplência.

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

>[!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.

### Requisitos de Uso

>[!CAUTION] **Atenção:**
Para implementar a Integração da plataforma ITTV em seu sistema, é necessário solicitar à ITTV a liberação de acesso do endereço IP do seu servidor IXC no Firewall da plataforma. Este procedimento é fundamental para estabelecer uma conexão segura e eficiente entre os sistemas, permitindo estabelecer a comunicação entre as plataformas.

## Entrega de valor
- Alinhar as necessidades dos clientes que utilizam streaming e TV por assinatura com a plataforma ITTV;
 - 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

### Passo 1: Acesso ao Formulário de Integrações
Neste passo, é efetuado o cadastro da integração. Este processo permite a comunicação e troca de dados entre o sistema e a plataforma ITTV.

1. Acesse o formulário de [[integracoes de tv|Integrações de TV]] através do caminho: Configurações > Integrações > Integrações TV;
2. Pressione o botão **Novo**;
3. Selecione **ITTV** no campo **Plataforma**;
4. Preencha os campos:
	- **IP Integração:** este campo se refere à URL fornecida pela plataforma credenciada - [https://api-resellers.ittv.com.br/alpha/reseller/](https://api-resellers.ittv.com.br/alpha/reseller/). Ela é responsável por "liberar o acesso" do sistema IXC Soft à plataforma **ITTV** para estabelecer a comunicação entre as plataformas envolvidas;
	- **Token acesso:** preencha com a informação de token de acesso fornecida pela plataforma credenciada;
		
7. Clique em **Salvar** para estabelecer a comunicação entre o IXC e a plataforma e para concluir o cadastro da integração.
   
>[!CAUTION] **Importante:** 
>As informações de **IP Integração** e **Token acesso** são fornecidas pela própria ITTV.

### Passo 2: 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 **ITTV**;
6. Preencha o campo:
	- **ID Integração:** clique na lupa e selecione o cadastro da integração de TV da ITTV e vincule ao campo;
	- **ID Pacote:** clique sobre o botão **Buscar pacote** e selecione um pacote para o produto que está cadastrando. Este pacote é referente ao pacote principal que será disponibilizado ao cliente;
	
9. Clique em **Salvar** para validar e finalizar o cadastro do produto.

### Passo 3: Produto no Contrato
Para realizar a gestão do contrato associado ao produto de TV, é 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 formulário de [[formulario contrato do cliente|Contrato do Cliente]] através do caminho: Sistema > Cadastro > Contratos;
2. Pressione o botão **Editar** para acessar o contrato;
3. 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: Ativação do Usuário TV
A ativação do usuário TV consiste em criar as credenciais de acesso para o usuário final obter acesso à plataforma.

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 ITTV;
	- **Tipo de tecnologia TV:** defina o tipo de tecnologia do produto;
	- **Produto:** clique na lupa e selecione o produto de TV incluso no contrato;
	- **Usar e-mail principal:** se **sim**, utiliza o e-mail do cadastro do cliente. Se **não**, preencher manualmente;
	- **Login:** refere-se ao login de acesso à plataforma. Deve ser um e-mail válido;
	- **Senha:** clique em **Gerar senha** para gerar uma senha aleatória ou preencha manualmente;
	
4. Após preencher os campos, clique em **Salvar** para validar as modificações e efetivar a criação do usuário TV.

>[!SUCCESS] Finalização:
>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).

## Casos de Uso

### Ações do contrato
A integração com a plataforma da ITTV 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 ITTV 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 ITTV 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.
  
- **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.
  
- **Aguardando assinatura:** irá constar como online, com o acesso liberado.
  
- **Cancelamento**: O login TV será inativado automaticamente quando o contrato for cancelado. O cancelamento pode ser realizado de duas formas:
	1. Através dos botões disponíveis no contrato, com as opções:
    - **Status > Cancelar contrato e financeiro**
    - **Status > Cancelar contrato e financeiro não vencido**
    - **Status > Cancelar contrato e gerar financeiro remanescente**
      
	2. Através da [[tarefa - cancelamento automatico de contrato inadimplente|Tarefa - Cancelamento Automático de Contrato Inadimplente]], que processa o cancelamento automaticamente em casos de inadimplência, comunicando com o login TV e inativando-o, cortando o acesso à plataforma.
  
- **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 ITTV. A comunicação entre as plataformas ocorre apenas de IXC Provedor para a ITTV, 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.

## Conclusão
A integração ITTV com o sistema oferece uma solução completa para provedores de internet, otimizando a gestão de serviços de TV e streaming. Esta integração permite um gerenciamento eficiente de assinaturas, redução de erros operacionais e controle preciso dos serviços oferecidos. Como resultado, proporciona uma experiência superior aos clientes, além de automatizar processos e permitir monitoramento em tempo real. Esta tecnologia contribui significativamente para a modernização dos serviços de telecomunicações, tornando a gestão mais eficiente e confiável.

## Etiquetas
#Integracoes #IntegracaoTV #ITTV #UsuarioTV

## Para mais informações sobre funcionalidades específicas, consulte:
- [[integracoes|Integrações]]
- [[integracoes de tv|Integrações de TV]]
- [[public/menu sistema/cadastros/pasta tv sva/login tv/usuarios tv|Usuários TV]]
- [[formulario contrato do cliente|Contrato do Cliente]]
- [[aba - tv - contrato do cliente|Aba TV - Contrato do cliente]]
- [[tarefa - cancelamento automatico de contrato inadimplente|Tarefa - Cancelamento Automático de Contrato Inadimplente]]
- [[cancelar contrato e financeiro|Cancelar Contrato e Financeiro]]
- [[cancelar contrato e financeiro nao vencido|Cancelar Contrato e Financeiro Não Vencido]]
- [[cancelar contrato e gerar financeiro remanescente|Cancelar Contrato e Gerar Financeiro Remanescente]]
- [[public/guias tutoriais/geral/contratos/como cancelar contrato|Como Cancelar Contrato]]