# Integração SVA - EXA

## Introdução

>[!TIP] Definição - EXA:
> A [EXA](https://exa.com.br/) é uma empresa especializada em segurança digital, focada em oferecer soluções para a navegação segura de usuários à internet. Algumas das soluções oferecidas pela EXA, são:
>- App de proteção de aplicativos, disponível para Android e iOS;
>- Backup em nuvem, para armazenamento de fotos, vídeos, arquivos e outros;
>- Segurança financeira;
>- Gestão digital familiar, permitindo acompanhar a localização de convidados em tempo real;

A integração entre a plataforma **EXA** 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
Para utilizar este recurso, é necessário atender as seguintes condições:
- Conta ativa na EXA;
- Credenciais de acesso à API da EXA.

## Entrega de Valor
A integração do sistema com a **EXA** 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 EXA
- Segurança digital;
- Proteção de dispositivos móveis;
- Proteção à dados pessoais;
- Proteção à bancos;
- Backup em nuvem;
- Gestão digital familiar.

### Passo 1: Cadastro da Integração
Para estabelecer a comunicação entre o sistema e a **EXA** 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 **[[integracoes de sva|Integrações de 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 **EXA** no campo **Plataforma**;
4. Preencha os campos:
	- **URL:** este campo se refere à URL fornecida pela plataforma credenciada. Ela é responsável por liberar o acesso do sistema IXC Soft à plataforma **EXA**, para estabelecer a comunicação entre os sistemas. Insira a URL fornecida pela plataforma;
	- **Seu prefixo:** informação respectiva ao campo Seu prefixo na plataforma EXA;
	- **Permite criar usuários automaticamente:** ao marcar o filtro como **sim**, e um contrato for ativado com um produto SVA **EXA** inserido, o usuário SVA criado será criado automaticamente com os dados cadastrais do cliente. O mesmo se aplica quando inserido um produto EXA em contratos já ativos. Se marcado como **não**, necessário realizar o cadastro manual.
	  
5. Clique em **Salvar** para validar as modificações e finalizar o cadastro da integração. 

>[!TIP] Manual:
>Para configurar a criação automática de usuários, acesse o guia instrutivo: [[configuracao da criacao automatica de usuarios - exa|Configuração da Criação Automática de Usuários - EXA]].

### 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 EXA e vincule ao campo;
	- **Pacote SVA principal:** insira o código do pacote que será ofertado ao cliente. Este dado é informado pela plataforma credenciada.
	
>[!DANGER] Cuidado:
>O pacote SVA Principal deve conter apenas o vínculo de um único produto. Cada produto no sistema deve corresponder a um pacote específico na plataforma, garantindo melhor gerenciamento dos contratos e produtos fornecidos ao usuário SVA.	  
	  
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** e selecione o contrato desejado para inclusão do produto SVA;
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
A ativação do usuário SVA pode ocorrer de duas formas: automaticamente ou manualmente.

>[!TIP] Validação cadastral: 
A integração com a plataforma EXA valida as seguintes informações cadastrais do cliente para a ativação do usuário SVA:
>- E-mail principal;
>- Telefone celular;
>- CNPJ/CPF; 
>
>Se algum destes campos estiver vazio, não será possível realizar a criação do usuário.

>[!CAUTION] Parametrização:
>A configuração da ativação de usuários é baseada no parâmetro **Permite criar usuários automaticamente**, localizado em Configurações > Integrações > Integração SVA (cadastro da integração EXA).

#### 1. Ativação Automática
Ao manter o parâmetro de cadastro da integração **Permite criar usuários automaticamente** marcado como **sim**, ao realizar a ativação de um contrato que possua o produto de SVA EXA associado ou ao vincular o produto no contrato, o usuário é criado automaticamente no sistema e é espelhado na plataforma EXA, efetuando a comunicação.

>[!info] Manual:
>Para verificar como ocorre a ativação automática de usuários SVA, acesse: [[configuracao da criacao automatica de usuarios - exa|Criação automática de usuários EXA]].

#### 2. Ativação Manual
Ao manter o parâmetro de cadastro da integração **Permite criar usuários automaticamente** marcado como **não**, sendo necessário um operador para realizar o cadastramento do acesso de forma manual, conforme as orientações a seguir:

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;
	- **ID 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:** insira um e-mail válido;
	- **Telefone:** insira um número de 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 **EXA** 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.

#### 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 EXA 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 fFnais
A integração **EXA** com o Sistema proporciona uma oportunidade significativa para provedores de internet expandirem seus serviços e aumentarem 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.

## Etiquetas 
#Integracoes #IntegracoesSVA #IntegracaoEXA

## Leia também
- [EXA](https://exa.com.br/)
- [[integracoes|Integrações]]
- [[integracoes de sva|Integrações de SVA]]
- [[rotina de ajustar cadastros sva|Rotina de Ajustar Cadastros SVA]]
- [[aba sva - contrato do cliente|Aba SVA - Contrato do cliente]]
- [[formulario contrato do cliente|Contrato do Cliente]]
- [[formulario cliente|Formulário Cliente]]
- [[aba contato - cliente|Aba Contato - Cliente]]
- [[usuarios sva|Usuários SVA]]
- [[formulario cliente|Formulário Cliente]]