# Integração SVA - IXER

## Introdução

>[!TIP] Definição - IXER:
> A [IXER](https://www.ixer.com.br/) é uma intermediadora de benefícios que atua em todo o território nacional, focada em proporcionar saúde e bem-estar aos brasileiros através de serviços de qualidade e valores acessíveis. Este documento apresenta uma visão geral do projeto de integração entre o Sistema e a IXER, destacando seus objetivos e justificativas.

A integração entre a IXER 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 TV

### Requisitos de Uso
- Conta ativa na IXER;
- Credenciais de acesso à API da IXER;

## Entrega de Valor
A integração do sistema com a IXER 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 IXER
- Telemedicina Ilimitada Sul América;
- Terapia Online (Saúde Mental);
- Nutricionista Online;
- Especialidades Médicas
- Descontos em Farmácias;
- Seguro Acidente Pessoal.

### Passo 1: Cadastro da Integração
A comunicação entre o sistema IXC e a plataforma **IXER** ocorre por meio de um fluxo estruturado, no qual é necessário obter os dados de integração API da plataforma e registrá-los no IXC, com o objetivo de estabelecer a troca de informações entre as plataformas envolvidas. Para realizar este procedimento, siga os passos a seguir:

1. Acesse o formulário de [[integracoes de sva|Integrações de SVA]] através do caminho: Configurações > Integrações > Integrações SVA;
2. Clique no botão **Novo**;
3. Preencha os campos obrigatórios:
	- **Plataforma:** Selecionar a integração IXER;
	- **Ambiente:** Insira o ambiente conforme fornecido pela plataforma IXER. O ambiente de **Homologação** é direcionado para testar e  o ambiente de **Produção**, para utilizar diretamente com os clientes;
	- **API Key:** Para informar o **clientID**, repassado no ato da contratação;
	- **API Secret:** Para informar o **clienteSecret**, repassado no ato da contratação.
	  
3. Clique em **Salvar** para validar o cadastro da integração.
4. Campos preenchidos automaticamente após a integração ser cadastrada:
	- **Token:** Preenchido automaticamente ao estabelecer a comunicação com a plataforma;
	- **Data atualização do token:** Registra a última data em que o token foi atualizado.

### 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. Clique no 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 IXER e vincule ao campo;
	- **Pacote SVA principal:** insira o código do pacote que será ofertado ao cliente. Este dado é informado pela plataforma credenciada.
	  
8. Clique em **Salvar** para validar e finalizar o cadastro do produto.

>[!Caution] Atenção:
>Os produtos exibidos pode variar conforme sua contratação. Consulte a plataforma IXERl para verificar os produtos disponíveis.

### 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 permitir o acesso do usuário à plataforma, é necessário realizar a ativação do usuário SVA. Siga os passos abaixo:

1. Acesse o formulário **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;
	- **Produto:** Clique na lupa e selecione o produto já vinculado ao contrato, para definir qual o plano que este usuário terá acesso;
	- **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.
   
 >[!INFO]  Importante:
 >Deve ser criado um usuário SVA para cada produto que o cliente possui acesso, essa é uma regra do parceiro, cada produto deve possuir um acesso (Podendo ter o mesmo e-mail ou e-mails diferentes).

  
## Casos de Uso

### Ações do Contrato
A integração com a plataforma da IXER valida ações de cancelamento sobre o contrato, impactando no acesso do usuário SVA, permitindo o controle de acesso pelo sistema em casos de cancelamento e espelhando na plataforma credenciada.

>[!CAUTION] Controle de inadimplência:
>A integração IXER não possui controle de inadimplência, portanto em casos de bloqueio do status de acesso do contrato o acesso aos produtos IXER continuarão funcionando. 


## Fluxo de Trabalho
```mermaid
graph TD
    A[Início] --> B[Configurar Integração]
    B --> C[Criar Usuário SVA no Contrato]
    C --> D[Sincronizar Status]
    D --> E{Status do Contrato}
    E -->|Ativo| F[Manter Acesso SVA]
    E -->|Cancelado| H[Inativar Acesso SVA]
    F --> I[Fim]
    H --> I
```


## Considerações Finais
A integração **IXER** (plataforma de serviços de valor agregado) com o Sistema oferece aos provedores de internet uma oportunidade significativa para expandir seus serviços, como streaming e segurança digital, e aumentar a fidelização de clientes. Ao centralizar a gestão desses serviços no Sistema, os provedores podem oferecer uma experiência mais completa e integrada aos seus clientes, simplificando o acesso e o suporte.
 
## Etiquetas 
#Integracoes #IntegracoesSVA #IntegracaoIXER #ServicosSVA #ServicoDeValorAgregado #IXER


## Leia também
- [[integracoes|Integrações]]
- [[integracoes de sva|Integrações de SVA]]
- [IXER](https://www.ixer.com.br/)
- [[cadastro de produtos|Cadastro de Produtos]]
- [[cadastro de contratos no sistema|Cadastro de contratos no Sistema]]
- [[formulario contrato do cliente|Contrato do Cliente]]
- [[aba sva - contrato do cliente|Aba SVA - Contrato do cliente]]
- [[usuarios sva|Usuários SVA]]
- [[formulario cliente|Formulário Cliente]]