# Integração SVA - Superplayer & CO

## Introdução

>[!TIP] Definição - Superplayer & CO:
>A **[Superplayer & Co](https://superplayer.company/?utm_source=googleads&utm_medium=cpc&utm_campaign=sva_pmax&utm_term&gad_source=1&gclid=Cj0KCQiAvbm7BhC5ARIsAFjwNHunM0yGqj06emQjJ4XIFeqdoojMv3ZtkvjijX0nUTZL3qw4prZAE4MaApCHEALw_wcB)** é uma empresa brasileira especializada no desenvolvimento de **tecnologias personalizadas** para empresas e consumidores. A companhia oferece uma ampla gama de **Serviços de Valor Agregado (SVA)** para provedores, permitindo que seus assinantes acessem serviços como **antivírus**, **telemedicina**, **clubes de assinatura de livros**, entre outros. 

A integração entre a **Superplayer & CO** 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. Esta integração visa expandir o portfólio de serviços oferecidos pelos provedores de internet, incluindo benefícios de saúde, seguros e assistências. Esta integração permite:
- Oferta de serviços diferenciados;
- Centralização da gestão de clientes e faturamento;
- Aumento da competitividade no mercado;
- Diversificação de receitas;

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

### Requisitos de Uso
- Conta ativa na Superplayer & Co;
- Credenciais de acesso à API da Superplayer & Co.

## Entrega de valor
A integração do sistema com a Superplayer & Co visa centralizar as informações do provedor em um único local e facilitar a gestão de clientes e faturamento mensal. Além disso, promove:
- Otimização do controle de inadimplência;
- Informações centralizadas em um único ambiente;
- Diminui a taxa de imposto utilizando os produtos da integração SVA;
- Aumento do ticket médio;
- Fidelização de clientes;
- Expansão do portfólio de serviços do provedor;
- Aumento de receita e satisfação do cliente;
- Centralização da gestão de clientes e faturamento;
- Fortalecimento da posição competitiva no mercado.

## Configuração da Integração

### Serviços Oferecidos pela Superplayer & Co
- Energia Solar;
- Streaming de Música;
- Telemedicina;
- Segurança digital;
- Gerenciamento de lag para games;
- Educação e cursos;
- Revistas digitais.

### Passo 1: Cadastro da Integração
Para estabelecer a comunicação entre o sistema e a **Superplayer & Co**, e efetuar o gerenciamento da integração diretamente pelo sistema, é necessário efetuar o cadastro da integração, permitindo a troca de dados entre as plataformas envolvidas. Siga os passos abaixo:

1. Acesse o formulário de **Integrações SVA** através do caminho: Configurações > Integrações > Integrações SVA;
2. Clique no botão **Novo** para cadastrar a integração;
3. Selecione **Superplayer & Co** no campo **Plataforma**;
4. Preencha os campos:
	- **Ambiente:** defina Homologação para testar e Produção para utilizar;
	- **URL:** este campo se refere à URL fornecida pela plataforma credenciada. Ela é responsável por "liberar o acesso" do sistema IXC Soft à plataforma **Superplayer & Co** para estabelecer a comunicação entre os sistemas. Insira a URL fornecida pela plataforma;
	- **ID externo da plataforma:** chave para autenticação com a Superplayer, repassado no ato da contratação;
	- **Token:** Token para autenticação com a Superplayer, repassado no ato da contratação.
	  
5. Clique em **Salvar** para validar as informações e finalizar o cadastro da integração. 


### Passo 2: Configuração do Produto SVA
O cadastro do produto de SVA é essencial para a gestão do produto no contrato, faturamento e também para permitir a ativação do usuário SVA, 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 **SVA**;
5. Preencha os campos:
	- **ID Integração SVA:** clique na lupa e selecione o cadastro da integração de SVA Superplayer & Co e vincule ao campo;
	- **Pacote SVA principal:** insira o código do pacote que será ofertado ao cliente. Este dado é informado pela plataforma credenciada.
	  
6. 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 SVA ao contrato. Esta ação permite realizar a geração do faturamento, emitir notas fiscais e também efetuar ativação do usuário SVA associado à integração. Esta ativação pode ocorrer diretamente pelo contrato ou por [[formulario planos de venda|Formulário Planos de Venda]].

1. No menu principal, navegue até **Sistema**;
2. Selecione **Cadastros**;
3. Clique em **Contrato**;
4. Pressione o botão **Editar** para acessar o contrato;
5. Navegue até a aba **Produtos** e clique no botão **Novo**. Defina o tipo do produto como **SVA** e no campo **Produto/Serviço**, clique na lupa e selecione o produto de SVA cadastrado. Clique em **Salvar** para validar as configurações.

### Passo 4: Ativação do Usuário SVA
Para realizar o cadastramento do acesso SVA, siga as orientações a seguir:

1. Acesse o formulário **[[usuarios sva|Usuários SVA]]** através do caminho: Sistema > Contratos > selecione o contrato que deseja realizar a ativação do usuário SVA (já deve conter o produto no contrato) > Editar > aba SVA;
2. Clique no botão **Novo** para criar um usuário SVA;
3. Preencha os campos:
	- **ID integração:** clique na lupa e selecione o cadastro da integração, vincule-a ao campo em questão;
	- **Usar dados cadastro:** se **sim**, o sistema preencherá o campo CNPJ/CPF, campo usuário e campo telefone a partir dos dados de CNPJ/CPF, e-mail e telefone no cadastro do cliente. Se **não**, deve preencher estes dados manualmente;
	- **Usuário:** inserir um e-mail válido;
	- **Telefone:** inserir um telefone válido.
	  
	 **Campos preenchidos automaticamente:**
	  **ID contrato:** preenchido automaticamente devido ao formulário de Usuário SVA se relacionar ao contrato do cliente e, portanto, o usuário ser ativo a partir deste caminho;
	  
4. Clique em **Salvar** para finalizar a ativação do usuário SVA e promover o acesso do cliente à plataforma credenciada.

## Casos de Uso

### Ações do Contrato
A integração com a plataforma da **Superplayer & Co** valida ações sobre o contrato, impactando no acesso do usuário SVA, permitindo o controle de acesso pelo sistema e espelhando na plataforma credenciada.
#### Legenda de Status do Usuário SVA:
- **Ativo:** quando o usuário SVA está com o status de **ativo**, indica o consumo deste usuário sob o produto contratado;
- **Bloqueado:** quando o usuário SVA está com o status **bloqueado** no sistema, indica que o consumo está bloqueado;
- **Desativado:** assume o status de **desativado** o usuário SVA que estiver atrelado à um contrato que foi cancelado.

#### Controle de acesso do usuário SVA a partir do status do contrato e alterações manuais:

- **Ativação do usuário e liberação do contrato após bloqueio por inadimplência:** permanece **ativo** o usuário SVA;
- **Financeiro em atraso, bloqueio manual/automático e inativação do contrato:** o usuário permanece **bloqueado** quando estiver em atraso de pagamento ou quando desativado o contrato, corta o acesso do usuário SVA à plataforma;
- **Deleção do usuário:** permite a deleção do usuário, isto é, remove o registro do usuário no sistema.

## Fluxo de trabalho
```mermaid
graph TD
    A[Contratação da plataforma Superplayer & Co pelo provedor] -->|Após contratação| B[Cadastro da integração no sistema]
    B -->|Comunicação estabelecida| C[Cadastro do produto SVA no sistema]
    C -->|Produto cadastrado| D[Vínculo do produto SVA no contrato do cliente final]
    D -->|Contrato atualizado| E[Ativação do usuário SVA]
    E -->F[Usuário ativado] 
    F -->|Processo concluído| G[Cliente acessa benefícios]

```


## Considerações finais
A integração SVA **Superplayer & Co** oferece uma oportunidade valiosa para enriquecer o portfólio de serviços da sua empresa. Ao configurar e manter corretamente esta integração, você pode proporcionar uma experiência unica aos seus clientes, aumentando a satisfação e a fidelização.

## Etiquetas 
#Integracoes #IntegracoesSVA #IntegracaoSuperplayerECO #SuperplayerECO

## Leia também
- [[integracoes|Integrações]]
- [[integracoes de sva|Integrações de SVA]]
- [Superplayer & CO](https://superplayer.company/)
- [[aba sva - contrato do cliente|Aba SVA - Contrato do cliente]]
- [[usuarios sva|Usuários SVA]]
- [[formulario contrato do cliente|Contrato do Cliente]]
- [[formulario cliente|Formulário Cliente]]